docs: add notes for readline, readlines, writelines, IOBase

see pyserial#285

Author: zsquareplusc

documentation/pyserial_api.rst

@@ -465,6 +465,18 @@ Native ports
 
         .. versionadded:: 2.5
 
+    .. method:: readline(size=-1)
+
+        Provided via :meth:`io.IOBase.readline`
+
+    .. method:: readlines(hint=-1)
+
+        Provided via :meth:`io.IOBase.readlines`
+
+    .. method:: writelines(lines)
+
+        Provided via :meth:`io.IOBase.writelines`
+
     The port settings can be read and written as dictionary. The following
     keys are supported: ``write_timeout``, ``inter_byte_timeout``,
     ``dsrdtr``, ``baudrate``, ``timeout``, ``parity``, ``bytesize``,
@@ -706,8 +718,9 @@ Native ports
 
 
 Implementation detail: some attributes and functions are provided by the
-class :class:`SerialBase` and some by the platform specific class and
-others by the base class mentioned above.
+class :class:`serial.SerialBase` which inherits from :class:`io.RawIOBase`
+and some by the platform specific class and others by the base class
+mentioned above.
 
 
 RS485 support

serial/serialposix.py

@@ -789,6 +789,9 @@ class VTIMESerial(Serial):
     the error handling is degraded.
 
     Overall timeout is disabled when inter-character timeout is used.
+
+    Note that this implementation does NOT support cancel_read(), it will
+    just ignore that.
     """
 
     def _reconfigure_port(self, force_update=True):