L2SS-434: Improved presentation of mask attributes

docs/source/devices/devices.rst

@@ -4,23 +4,26 @@ Devices
 RECV
 ----------
 
-The ``recv == Device("LTS/RECV/1")`` device controls the RCUs, the LBA antennas, and HBA tiles. Central to its operation are the masks:
+The ``recv == Device("LTS/RECV/1")`` device controls the RCUs, the LBA antennas, and HBA tiles. Central to its operation are the masks (see also :ref:`attribute-masks`):
 
-- The ``RCU_mask_RW`` attribute is an array of ``bool[N_RCUs]``. It controls which RCUs will actually be configured, when fields referring to RCUs are set.
-- The ``Ant_mask_RW`` attribute is an array of ``bool[N_RCUs][N_Antennas_per_RCU]``. It controls which antennas will actually be configured, when fields referring to antennas are set.
+:RCU_mask_RW: Controls which RCUs will actually be configured when attributes referring to RCUs are written.
 
-See :ref:`attribute-masks` for how the masks are used.
+  :type: ``bool[N_RCUs]``
+
+:Ant_mask_RW: Controls which antennas will actually be configured when attributes referring to antennas are written.
+
+  :type: ``bool[N_RCUs][N_Antennas_per_RCU]``
 
 Typically, ``N_RCUs == 32``, and ``N_Antennas_per_RCU == 3``.
 
 SDP
 -----------
 
-The ``sdp == Device("LTS/SDP/1")``` device controls the digital signal processing in SDP, performed by the firmware on the FPGAs on the Uniboards. Central to its operation is the mask:
+The ``sdp == Device("LTS/SDP/1")``` device controls the digital signal processing in SDP, performed by the firmware on the FPGAs on the Uniboards. Central to its operation is the mask (see also :ref:`attribute-masks`):
 
-- The ``TR_fpga_mask_RW`` attribute is an array of ``bool[N_fpgas]``. It controls which FPGAs will actually be configured, when fields referring to FPGAs are set.
+:TR_fpga_mask_RW: Controls which FPGAs will actually be configured when attributes referring to FPGAs are written.
 
-See :ref:`attribute-masks` for how the masks are used.
+  :type: ``bool[N_fpgas]``
 
 Typically, ``N_fpgas == 16``.