Doc updates. (#1493)

Author: janiversen

doc/source/library/client.rst

@@ -7,12 +7,8 @@ Pymodbus offers clients with transport protocols for
 - *TCP*
 - *TLS*
 - *UDP*
-- possibility to add a custom transport protocol
 
-communication in 2 versions:
-
-- :mod:`synchronous client`,
-- :mod:`asynchronous client` using asyncio.
+communication can be either using a :mod:`synchronous client` or a :mod:`asynchronous client` using asyncio.
 
 Using pymodbus client to set/get information from a device (server)
 is done in a few simple steps, like the following synchronous example::

pymodbus/client/base.py

@@ -43,23 +43,7 @@ class ModbusBaseClient(ModbusClientMixin):
         **reconnect_delay** to **reconnect_delay_max**.
         Set `reconnect_delay=0` to avoid automatic reconnection.
 
-    :mod:`ModbusBaseClient` is normally not referenced outside :mod:`pymodbus`,
-    unless you want to make a custom client.
-
-    Custom client class **must** inherit :mod:`ModbusBaseClient`, example::
-
-        from pymodbus.client import ModbusBaseClient
-
-        class myOwnClient(ModbusBaseClient):
-
-            def __init__(self, **kwargs):
-                super().__init__(kwargs)
-
-        def run():
-            client = myOwnClient(...)
-            client.connect()
-            rr = client.read_coils(0x01)
-            client.close()
+    :mod:`ModbusBaseClient` is normally not referenced outside :mod:`pymodbus`.
 
     **Application methods, common to all clients**:
     """

pymodbus/client/tls.py

@@ -54,6 +54,9 @@ class AsyncModbusTlsClient(AsyncModbusTcpClient, asyncio.Protocol):
     :param server_hostname: (optional) Bind certificate to host
     :param kwargs: (optional) Experimental parameters
 
+    ..tip::
+        See ModbusBaseClient for common parameters.
+
     Example::
 
         from pymodbus.client import AsyncModbusTlsClient
@@ -122,6 +125,9 @@ class ModbusTlsClient(ModbusTcpClient):
     :param server_hostname: (optional) Bind certificate to host
     :param kwargs: (optional) Experimental parameters
 
+    ..tip::
+        See ModbusBaseClient for common parameters.
+
     Example::
 
         from pymodbus.client import ModbusTlsClient

pymodbus/client/udp.py

@@ -25,6 +25,9 @@ class AsyncModbusUdpClient(
     :param source_address: (optional) source address of client,
     :param kwargs: (optional) Experimental parameters
 
+    ..tip::
+        See ModbusBaseClient for common parameters.
+
     Example::
 
         from pymodbus.client import AsyncModbusUdpClient
@@ -164,6 +167,9 @@ class ModbusUdpClient(ModbusBaseClient):
     :param source_address: (optional) source address of client,
     :param kwargs: (optional) Experimental parameters
 
+    ..tip::
+        See ModbusBaseClient for common parameters.
+
     Example::
 
         from pymodbus.client import ModbusUdpClient