docs: extend how-to section, link to old releases
diff --git a/documentation/appendix.rst b/documentation/appendix.rst
index aff9cdd..8bc2c1a 100644
--- a/documentation/appendix.rst
+++ b/documentation/appendix.rst
@@ -5,10 +5,18 @@
How To
======
-Enable :rfc:`2217` in programs using pySerial.
- Patch the code where the :class:`serial.Serial` is instantiated. Replace
+Enable :rfc:`2217` (and other URL handlers) in programs using pySerial.
+ Patch the code where the :class:`serial.Serial` is instantiated.
+ E.g. replace::
+
+ s = serial.Serial(...)
+
it with::
+ s = serial.serial_for_url(...)
+
+ or for backwards compatibility to old pySerial installations::
+
try:
s = serial.serial_for_url(...)
except AttributeError:
@@ -33,6 +41,10 @@
on the screen, then at least RX and TX work (they still could be swapped
though).
+ There is also a ``spy:://`` URL handler. It prints all calls (read/write,
+ control lines) to the serial port to a file or stderr. See :ref:`spy`
+ for details.
+
FAQ
===
diff --git a/documentation/pyserial.rst b/documentation/pyserial.rst
index f063385..602134d 100644
--- a/documentation/pyserial.rst
+++ b/documentation/pyserial.rst
@@ -124,7 +124,7 @@
.. _`old download`: https://sourceforge.net/projects/pyserial/files/pyserial/
-.. _download: https://pypi.python.org/pypi/pyserial
+.. _download: https://pypi.python.org/simple/pyserial/
.. _pywin32: http://pypi.python.org/pypi/pywin32
.. _`2.7`: https://pypi.python.org/pypi/pyserial/2.7
.. _`1.21`: https://sourceforge.net/projects/pyserial/files/pyserial/1.21/pyserial-1.21.zip/download
diff --git a/documentation/url_handlers.rst b/documentation/url_handlers.rst
index ae331f9..81e6ff8 100644
--- a/documentation/url_handlers.rst
+++ b/documentation/url_handlers.rst
@@ -122,6 +122,8 @@
not locked automatically (e.g. Posix).
+.. _spy:
+
``spy://``
==========
Wrapping the native serial port, this protocol makes it possible to