doc update
diff --git a/documentation/appendix.rst b/documentation/appendix.rst
index f092d98..5d8bae0 100644
--- a/documentation/appendix.rst
+++ b/documentation/appendix.rst
@@ -81,7 +81,7 @@
License
=======
-Copyright (c) 2001-2015 Chris Liechti <cliechti@gmx.net>
+Copyright (c) 2001-2016 Chris Liechti <cliechti@gmx.net>
All Rights Reserved.
Redistribution and use in source and binary forms, with or without
diff --git a/documentation/conf.py b/documentation/conf.py
index 3a2d23e..27f12c4 100644
--- a/documentation/conf.py
+++ b/documentation/conf.py
@@ -38,7 +38,7 @@
# General information about the project.
project = u'pySerial'
-copyright = u'2001-2015, Chris Liechti'
+copyright = u'2001-2016, Chris Liechti'
# The version info for the project you're documenting, acts as replacement for
# |version| and |release|, also used in various other places throughout the
diff --git a/documentation/tools.rst b/documentation/tools.rst
index 6431430..45e7aef 100644
--- a/documentation/tools.rst
+++ b/documentation/tools.rst
@@ -14,9 +14,9 @@
.. function:: comports()
- :return: an iterable that yields :class:`ListPortInfo` objects.
+ :return: a list containing :class:`ListPortInfo` objects.
- The function returns an iterable that yields :obj:`ListPortInfo` objects.
+ The function returns a list of :obj:`ListPortInfo` objects.
Items are returned in no particular order. It may make sense to sort the
items. Also note that the reported strings are different across platforms
diff --git a/documentation/url_handlers.rst b/documentation/url_handlers.rst
index e9c5efc..ae331f9 100644
--- a/documentation/url_handlers.rst
+++ b/documentation/url_handlers.rst
@@ -15,6 +15,7 @@
- ``loop://[?logging={debug|info|warning|error}]``
- ``hwgrep://<regexp>[&skip_busy][&n=N]``
- ``spy://port[?option[=value][&option[=value]]]``
+- ``alt://port?class=<classname>``
.. versionchanged:: 3.0 Options are specified with ``?`` and ``&`` instead of ``/``
@@ -105,11 +106,11 @@
the first, where URLs usually use ``?``. This exception is made as the question
mark is used in regexp itself.
-Depending on the capabilities of the list_ports module on the system, it is
+Depending on the capabilities of the ``list_ports`` module on the system, it is
possible to search for the description or hardware ID of a device, e.g. USB
VID:PID or texts.
-Unfortunately, on some systems list_ports only lists a subset of the port
+Unfortunately, on some systems ``list_ports`` only lists a subset of the port
names with no additional information. Currently, on Windows and Linux and
OSX it should find additional information.