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
===