docs/library/pyb.CAN: Clean up documentation of data constants.

dpgeorge · dpgeorge · commit b7d576d69a8e · 2018-03-16T18:29:43.000+11:00
diff --git a/docs/library/pyb.CAN.rst b/docs/library/pyb.CAN.rst
@@ -259,23 +259,23 @@ Constants
 ---------
 
 .. data:: CAN.NORMAL
-.. data:: CAN.LOOPBACK
-.. data:: CAN.SILENT
-.. data:: CAN.SILENT_LOOPBACK
+          CAN.LOOPBACK
+          CAN.SILENT
+          CAN.SILENT_LOOPBACK
 
-   the mode of the CAN bus
+   The mode of the CAN bus used in :meth:`~CAN.init()`.
 
 .. data:: CAN.STOPPED
           CAN.ERROR_ACTIVE
           CAN.ERROR_WARNING
           CAN.ERROR_PASSIVE
           CAN.BUS_OFF
 
-   Possible states of the CAN controller.
+   Possible states of the CAN controller returned from :meth:`~CAN.state()`.
 
 .. data:: CAN.LIST16
-.. data:: CAN.MASK16
-.. data:: CAN.LIST32
-.. data:: CAN.MASK32
+          CAN.MASK16
+          CAN.LIST32
+          CAN.MASK32
 
-   the operation mode of a filter
+   The operation mode of a filter used in :meth:`~CAN.setfilter()`.
