2017-11-05 Fred Gleason <fredg@paravelsystems.com>

* Removed the 'Genmeral Notes' section titles from the
	'Supported GPIO/Switcher Devices' appendix in the Operations Guide.

ChangeLog

@@ -16254,3 +16254,6 @@
 	* Fixed a typo in 'docs/opsguide/filepath_wildcards.xml'.
 2017-11-05 Fred Gleason <fredg@paravelsystems.com>
 	* Added DocBook stylesheets for books in 'docs/stylesheets/'.
+2017-11-05 Fred Gleason <fredg@paravelsystems.com>
+	* Removed the 'Genmeral Notes' section titles from the
+	'Supported GPIO/Switcher Devices' appendix in the Operations Guide.

docs/opsguide/gpio_switcher_devices.xml

@@ -25,8 +25,6 @@
 	</listitem>
       </varlistentry>
     </variablelist>
-    <sect2>
-      <title>General Notes</title>
       <para>
 	Control is done by means of MIDI connections to the 'MIDI IN' and
 	'MIDI OUT' ports on the back of the unit, with the appropriate
@@ -74,7 +72,6 @@
 	processing crosspoint changes; anything previously saved in
 	those programs will be overwritten!
       </para>
-    </sect2>
   </sect1>
 
   <sect1 xml:id="sect.gpio_switcher_devices.bt10x1">
@@ -99,8 +96,6 @@
 	</listitem>
       </varlistentry>
     </variablelist>
-    <sect2>
-      <title>General Notes</title>
     <para>
       Control is done by means of an RS-232C connection to a four pin RJ11
       modular jack on the back of the unit (an adapter to a standard DB9
@@ -108,7 +103,6 @@
       parameters should be set to 2400 baud rate, no parity, 8 data bits, 1
       stop bit, CR/LF termination.
     </para>
-    </sect2>
   </sect1>
 
   <sect1 xml:id="sect.gpio_switcher_devices.bt16x1">
@@ -133,8 +127,6 @@
 	</listitem>
       </varlistentry>
     </variablelist>
-    <sect2>
-      <title>General Notes</title>
     <para>
       Control is done by means of an RS-232C connection to a four pin RJ11
       modular jack on the back of the unit (an adapter to a standard DB9
@@ -142,7 +134,6 @@
       parameters should be set to 9600 baud rate, no parity, 8 data bits, 1
       stop bit, CR/LF termination.
     </para>
-    </sect2>
   </sect1>
 
   <sect1 xml:id="sect.gpio_switcher_devices.bt16x2">
@@ -168,8 +159,6 @@
 	</listitem>
       </varlistentry>
     </variablelist>
-    <sect2>
-      <title>General Notes</title>
     <para>
       Control is done by means of an RS-232C connection to a four pin RJ11
       modular jack on the back of the unit (an adapter to a standard DB9
@@ -180,7 +169,6 @@
     <para>
       Operation in 'multidrop' mode is not supported.
     </para>
-    </sect2>
   </sect1>
 
   <sect1 xml:id="sect.gpio_switcher_devices.8x2">
@@ -207,8 +195,6 @@
 	</listitem>
       </varlistentry>
     </variablelist>
-    <sect2>
-      <title>General Notes</title>
     <para>
       Control is done by means of an RS-232C connection to a four pin RJ11
       modular jack on the back of the unit (an adapter to a standard DB9
@@ -223,7 +209,6 @@
     <para>
       Operation in 'multidrop' mode is not supported.
     </para>
-    </sect2>
   </sect1>
 
   <sect1 xml:id="sect.gpio_switcher_devices.btacs82">
@@ -255,8 +240,6 @@
 	</listitem>
       </varlistentry>
     </variablelist>
-    <sect2>
-      <title>General Notes</title>
     <para>
       Control is done by means of an RS-232C connection to a four pin RJ11
       modular jack on the back of the unit (an adapter to a standard DB9
@@ -284,7 +267,6 @@
       to the next supported level.  For gain levels of less than -20 dB, the
       minimum supported gain (-20 dB) will be applied.
     </para>
-    </sect2>
   </sect1>
 
   <sect1 xml:id="sect.gpio_switcher_devices.btadms4422">
@@ -315,8 +297,6 @@
 	</listitem>
       </varlistentry>
     </variablelist>
-    <sect2>
-      <title>General Notes</title>
     <para>
       Control is done by means of a serial connection to the unit's integrated
       serial port.  The 'OPTIONS' switches on the back of the unit should
@@ -338,7 +318,6 @@
       The Rivendell serial interface should be set to use 9600 bits/sec,
       8 bits, 1 stop bit and no flow control.
     </para>
-    </sect2>
   </sect1>
 
   <sect1 xml:id="sect.gpio_switcher_devices.btgpi16">
@@ -364,8 +343,6 @@
 	</listitem>
       </varlistentry>
     </variablelist>
-    <sect2>
-      <title>General Notes</title>
     <para>
       Control is done by means of a serial connection to the unit's
       integrated serial port.  There is also a 'plus' version that
@@ -377,7 +354,6 @@
       The Rivendell serial interface should be set to use 9600 bits/sec,
       8 bits, 1 stop bit and no flow control.
     </para>
-    </sect2>
   </sect1>
 
   <sect1 xml:id="sect.gpio_switcher_devices.btsentinel4web">
@@ -402,8 +378,6 @@
 	</listitem>
       </varlistentry>
     </variablelist>
-    <sect2>
-      <title>General Notes</title>
     <para>
       Control is done by means of a TCP/IP connection to the unit's
       integrated Ethernet port.
@@ -417,7 +391,6 @@
       <computeroutput>IP Port</computeroutput> setting in Rivendell's
       driver configuration (<userinput>56</userinput> by default).
     </para>
-    </sect2>
   </sect1>
 
   <sect1 xml:id="sect.gpio_switcher_devices.btsrc16">
@@ -443,8 +416,6 @@
 	</listitem>
       </varlistentry>
     </variablelist>
-    <sect2>
-      <title>General Notes</title>
     <para>
       Control is done by means of a serial connection to the unit's integrated
       serial port.
@@ -454,7 +425,6 @@
       The Rivendell serial interface should be set to use 9600 bits/sec,
       8 bits, 1 stop bit and no flow control.
     </para>
-    </sect2>
   </sect1>
 
   <sect1 xml:id="sect.gpio_switcher_devices.btss124">
@@ -481,8 +451,6 @@
 	</listitem>
       </varlistentry>
     </variablelist>
-    <sect2>
-      <title>General Notes</title>
     <para>
       Control is done by means of an RS-232C connection to a four pin RJ11
       modular jack on the back of the unit (an adapter to a standard DB9
@@ -497,7 +465,6 @@
     <para>
       Operation in 'multidrop' mode is not supported.
     </para>
-    </sect2>
   </sect1>
 
   <sect1 xml:id="sect.gpio_switcher_devices.btss164">
@@ -527,8 +494,6 @@
 	</listitem>
       </varlistentry>
     </variablelist>
-    <sect2>
-      <title>General Notes</title>
     <para>
       Control is done by means of an RS-232C connection to a four pin RJ11
       modular jack on the back of the unit (an adapter to a standard DB9
@@ -549,7 +514,6 @@
     <para>
       Operation in 'multidrop' mode is not supported.
     </para>
-    </sect2>
   </sect1>
 
   <sect1 xml:id="sect.gpio_switcher_devices.btss41mlr">
@@ -576,8 +540,6 @@
 	</listitem>
       </varlistentry>
     </variablelist>
-    <sect2>
-      <title>General Notes</title>
     <para>
       Control is done by means of an RS-232C connection to a four pin RJ11
       modular jack on the back of the unit (an adapter to a standard DB9
@@ -597,7 +559,6 @@
       Tools documentation), then you will also need to be sure that DIP
       switch SW6-7 is ON.
     </para>
-    </sect2>
   </sect1>
 
   <sect1 xml:id="sect.gpio_switcher_devices.btss42">
@@ -627,8 +588,6 @@
 	</listitem>
       </varlistentry>
     </variablelist>
-    <sect2>
-      <title>General Notes</title>
     <para>
       Control is done by means of an RS-232C connection to a four pin RJ11
       modular jack on the back of the unit (an adapter to a standard DB9
@@ -649,7 +608,6 @@
       Tools documentation), then you will also need to be sure that DIP
       switch SW13-7 is ON.
     </para>
-    </sect2>
   </sect1>
 
   <sect1 xml:id="sect.gpio_switcher_devices.btss44">
@@ -679,8 +637,6 @@
 	</listitem>
       </varlistentry>
     </variablelist>
-    <sect2>
-      <title>General Notes</title>
     <para>
       Control is done by means of an RS-232C connection to a four pin RJ11
       modular jack on the back of the unit (an adapter to a standard DB9
@@ -702,7 +658,6 @@
       outputs as GPO, then you will also need to be sure that DIP switch
       SW6 is 'off'.
     </para>
-    </sect2>
   </sect1>
 
   <sect1 xml:id="sect.gpio_switcher_devices.btss82">
@@ -732,8 +687,6 @@
 	</listitem>
       </varlistentry>
     </variablelist>
-    <sect2>
-      <title>General Notes</title>
     <para>
       Control is done by means of an RS-232C connection to a four pin RJ11
       modular jack on the back of the unit (an adapter to a standard DB9
@@ -755,7 +708,6 @@
       Tools documentation), then you will also need to be sure that DIP
       switch SW-14-10 is ON.
     </para>
-    </sect2>
   </sect1>
 
   <sect1 xml:id="sect.gpio_switcher_devices.btu41mlrweb">
@@ -782,12 +734,9 @@
 	</listitem>
       </varlistentry>
     </variablelist>
-    <sect2>
-      <title>General Notes</title>
     <para>
       Control is by means of a TCP/IP connection to port 5002.
     </para>
-    </sect2>
   </sect1>
 
   <sect1 xml:id="sect.gpio_switcher_devices.harlond">
@@ -819,8 +768,6 @@
 	</listitem>
       </varlistentry>
     </variablelist>
-    <sect2>
-      <title>General Notes</title>
     <para>
       Control is by means of a TCP/IP connection to port 5002. Output
       busses are mapped as follows:
@@ -845,7 +792,6 @@
       Input channel ON/OFF is sensed/controlled by means of the
       respective GPIO number using GE/GI/GO RMLs.
     </para>
-    </sect2>
   </sect1>
 
   <sect1 xml:id="sect.gpio_switcher_devices.kernelgpio">
@@ -872,8 +818,6 @@
 	</listitem>
       </varlistentry>
     </variablelist>
-    <sect2>
-      <title>General Notes</title>
     <para>
       This driver can be used to control kernel-based GPIO interfaces,
       such as	the GPIO pins on a Raspberry Pi. Pins are allocated such that
@@ -883,7 +827,6 @@
       Further information on kernel GPIO devices can be found at
       https://www.kernel.org/doc/Documentation/gpio/sysfs.txt
     </para>
-    </sect2>
   </sect1>
 
   <sect1 xml:id="sect.gpio_switcher_devices.livewire_lwrpaudio">
@@ -908,8 +851,6 @@
 	</listitem>
       </varlistentry>
     </variablelist>
-    <sect2>
-      <title>General Notes</title>
     <para>
       Livewire is a distributed audio router and control system, with the 
       components (called 'nodes') configured and controled via TCP/IP.  More
@@ -931,7 +872,6 @@
       parameter and the the base output number+the slot number-1 for the
       <replaceable>output</replaceable> parameter.
     </para>
-    </sect2>
   </sect1>
 
   <sect1 xml:id="sect.gpio_switcher_devices.livewire_lwrpgpio">
@@ -958,8 +898,6 @@
 	</listitem>
       </varlistentry>
     </variablelist>
-    <sect2>
-      <title>General Notes</title>
     <para>
       Livewire is a distributed audio router and control system, with the 
       components (called 'nodes') configured and controled via TCP/IP.  More
@@ -981,7 +919,6 @@
       will autodetect all other parameters (e.g. the number of input and
       output lines) from the device itself.
     </para>
-    </sect2>
   </sect1>
 
   <sect1 xml:id="sect.gpio_switcher_devices.livewire_mcastgpio">
@@ -1008,8 +945,6 @@
 	</listitem>
       </varlistentry>
     </variablelist>
-    <sect2>
-      <title>General Notes</title>
     <para>
       Livewire is a distributed audio router and control system, with the 
       components (called 'nodes') configured and controled via TCP/IP.  More
@@ -1029,7 +964,6 @@
       populated with the stream
       number - GPIO line associations to be used.
     </para>
-    </sect2>
   </sect1>
 
   <sect1 xml:id="sect.gpio_switcher_devices.local_audio">
@@ -1057,8 +991,6 @@
 	</listitem>
       </varlistentry>
     </variablelist>
-    <sect2>
-      <title>General Notes</title>
     <para>
       It's possible to use one or more of the actual audio adapters as a
       switcher device using this driver.  Doing so makes it possible to
@@ -1073,7 +1005,6 @@
       number of inputs and outputs on the card (as found in
       <code>RDADmin->ManageHosts->AudioResources</code>.
     </para>
-    </sect2>
   </sect1>
 
   <sect1 xml:id="sect.gpio_switcher_devices.local_gpio">
@@ -1100,8 +1031,6 @@
 	</listitem>
       </varlistentry>
     </variablelist>
-    <sect2>
-      <title>General Notes</title>
     <para>
       This driver supports a variety of GPIO devices, including:
       <simplelist>
@@ -1110,7 +1039,7 @@
 	<member>MeasurementComputing GPIO Cards</member>
       </simplelist>
     </para>
-      <sect3 xml:id="sect.gpio_switcher_devices.joysticks">
+    <sect2 xml:id="sect.gpio_switcher_devices.joysticks">
       <title>15 Pin Joystick Port</title>
       <para>
 	Joystick support utilizes the Linux Input Device subsystem.  Inputs
@@ -1158,8 +1087,8 @@
 	connecting the ground for Inputs 3 and 4 to pins 04 or 05 should remedy
 	the problem.
 	</para>
-      </sect3>
+      </sect2>
-      <sect3 xml:id="sect.gpio_switcher_devices.measurementcomputing">
+      <sect2 xml:id="sect.gpio_switcher_devices.measurementcomputing">
 	<title>MeasurementComputing GPIO Cards</title>
 	<para>
 	  The following MeasurementComputing cards are supported:
@@ -1173,7 +1102,7 @@
 	  The device name for the card should be 
 	  <userinput>/dev/gpio<replaceable>n</replaceable></userinput>.
 	</para>
-	<sect4 xml:id="sect.gpio_switcher_devices.measurementcomputing.pci_pdis08_and_pci_pdis16">
+	<sect3 xml:id="sect.gpio_switcher_devices.measurementcomputing.pci_pdis08_and_pci_pdis16">
 	  <title>PCI-PDIS08 and PCI-PDIS16</title>
 	  <para>
 	    The Measurement Computing PCI-PDIS08 and PCI-PDIS16 boards
@@ -1246,8 +1175,8 @@
 	      </tbody>
 	    </tgroup>
 	  </table>
-	</sect4>
+	</sect3>
-	<sect4 xml:id="sect.gpio_switcher_devices.measurementcomputing.pci_dio24">
+	<sect3 xml:id="sect.gpio_switcher_devices.measurementcomputing.pci_dio24">
 	  <title>PCI-DIO24</title>
 	  <para>
 	    The Measurement Computing PCI-DIO24 board features 24
@@ -1304,7 +1233,6 @@
 	      </tbody>
 	    </tgroup>
 	  </table>
-	</sect4>
 	</sect3>
       </sect2>
   </sect1>
@@ -1335,8 +1263,6 @@
 	</listitem>
       </varlistentry>
     </variablelist>
-    <sect2>
-      <title>General Notes</title>
     <para>
       Before using the driver, the resources within the Logitek Audio Engine
       system that you wish to control must be made available in a 'vGuest'
@@ -1353,7 +1279,6 @@
       such as faders feeds, not just GPIO) are mapped to logical Rivendell
       GPIO lines by means of their Logitek Engine, Device and Buss numbers.
     </para>
-    </sect2>
   </sect1>
 
   <sect1 xml:id="sect.gpio_switcher_devices.modbus">
@@ -1380,15 +1305,12 @@
 	</listitem>
       </varlistentry>
     </variablelist>
-    <sect2>
-      <title>General Notes</title>
     <para>
       This driver supports GPI devices that use the industry-standard
       Modbus TCP protocol at TCP port 502. The device to be controlled
       should be configured to use Modbus ID #1. For more information on
       Modbus, see http://www.modbus.org/.
     </para>
-    </sect2>
   </sect1>
 
   <sect1 xml:id="sect.gpio_switcher_devices.quartz1">
@@ -1414,13 +1336,10 @@
 	</listitem>
       </varlistentry>
     </variablelist>
-    <sect2>
-      <title>General Notes</title>
     <para>
       Control can done either by means of an RS-232C connection or by means of
       TCP/IP to TCP port 23.
     </para>
-    </sect2>
   </sect1>
 
   <sect1 xml:id="sect.gpio_switcher_devices.rossnkscp">
@@ -1445,8 +1364,6 @@
 	</listitem>
       </varlistentry>
     </variablelist>
-    <sect2>
-      <title>General Notes</title>
     <para>
       Control is done by means of an RS-232C connection to a NK-SCP/A serial
       interface. Serial port parameters should be set to 9600 baud rate,
@@ -1454,7 +1371,6 @@
       to use is defined by setting the 'Card' parameter in the driver
       configuration, with Card 0 = Breakaway 1, Card 1 = Breakaway 2, etc.
     </para>
-    </sect2>
   </sect1>
 
   <sect1 xml:id="sect.gpio_switcher_devices.modemlines">
@@ -1481,8 +1397,6 @@
 	</listitem>
       </varlistentry>
     </variablelist>
-    <sect2>
-      <title>General Notes</title>
     <para>
       This driver enables GPIO via the modem control lines on an RS-232C
       serial device. The lines map as follows:
@@ -1517,7 +1431,6 @@
 	</tbody>
       </tgroup>
     </table>
-    </sect2>
   </sect1>
 
   <sect1 xml:id="sect.gpio_switcher_devices.sas16000">
@@ -1542,15 +1455,12 @@
 	</listitem>
       </varlistentry>
     </variablelist>
-    <sect2>
-      <title>General Notes</title>
     <para>
       Both analog and AES3 digital (D) variants are supported. Control
       can done by means of an RS-232C connection to the 'User Serial
       Interface' port on the unit.  Serial port parameters should be:
       9600,N,8,1.
     </para>
-    </sect2>
   </sect1>
 
   <sect1 xml:id="sect.gpio_switcher_devices.sas32000">
@@ -1578,8 +1488,6 @@
 	</listitem>
       </varlistentry>
     </variablelist>
-    <sect2>
-      <title>General Notes</title>
     <para>
       Control is done by means of an RS-232C connection to the 'Computer
       RS-232' port on the AXC-8 System Controller.  Serial port parameters
@@ -1588,7 +1496,6 @@
       use the 'conventional' command protocol -- the 'enhanced' version will
       not work!
     </para>
-    </sect2>
   </sect1>
 
   <sect1 xml:id="sect.gpio_switcher_devices.sas64000">
@@ -1613,8 +1520,6 @@
 	</listitem>
       </varlistentry>
     </variablelist>
-    <sect2>
-      <title>General Notes</title>
     <para>
       Control is done by means of an RS-232C connection to the 'Computer
       RS-232' port on the AXC-8 System Controller.  Serial port parameters
@@ -1623,7 +1528,6 @@
       use the 'conventional' command protocol -- the 'enhanced' version will
       not work!
     </para>
-    </sect2>
   </sect1>
 
   <sect1 xml:id="sect.gpio_switcher_devices.sas64000gpi">
@@ -1649,8 +1553,6 @@
 	</listitem>
       </varlistentry>
     </variablelist>
-    <sect2>
-      <title>General Notes</title>
     <para>
       Control is done by means of an RS-232C connection to the 'Computer
       RS-232' port on a GPI-1600 GPIO interface.  Serial port parameters
@@ -1658,7 +1560,6 @@
       and no terminator.  This driver allows control of the system's GPO
       outputs as well as audio crosspoints.
     </para>
-    </sect2>
   </sect1>
 
   <sect1 xml:id="sect.gpio_switcher_devices.sasusi">
@@ -1691,15 +1592,12 @@
 	</listitem>
       </varlistentry>
     </variablelist>
-    <sect2>
-      <title>General Notes</title>
     <para>
       Control can done either by means of an RS-232C connection to one of
       the serial ports on a DRC-16E card or by means of TCP/IP to a PC
       running SAS's Server Module software. TCP connections are normally
       made to port 1350 on the Server Module system.
     </para>
-    </sect2>
   </sect1>
 
   <sect1 xml:id="sect.gpio_switcher_devices.acu1p">
@@ -1726,8 +1624,6 @@
 	</listitem>
       </varlistentry>
     </variablelist>
-    <sect2>
-      <title>General Notes</title>
     <para>
       Control is done by means of an RS-232C connection to the RS-232
       port on the unit.  Serial port parameters in RDAdmin should be set
@@ -1739,7 +1635,6 @@
       be done by simultaneously pressing buttons 1 and 8 on the front
       panel of the unit for at least one second.
     </para>
-    </sect2>
   </sect1>
 
   <sect1 xml:id="sect.gpio_switcher_devices.swauthority">
@@ -1767,8 +1662,6 @@
 	</listitem>
       </varlistentry>
     </variablelist>
-    <sect2>
-      <title>General Notes</title>
     <para>
       Used to control devices (such as the Axia 'PathFinder' system)
       by means of the 'Software Authority' protocol. Control is by
@@ -1781,7 +1674,6 @@
       Most parameters, including the number of inputs and outputs as
       well as the endpoint names, are autodetected by the driver.
     </para>
-    </sect2>
   </sect1>
 
   <sect1 xml:id="sect.gpio_switcher_devices.starguide3">
@@ -1806,8 +1698,6 @@
 	</listitem>
       </varlistentry>
     </variablelist>
-    <sect2>
-      <title>General Notes</title>
     <para>
       Control is done by means of an RS-232C connection to the
       RS-232 port on the unit. The port should be configured on the
@@ -1818,7 +1708,6 @@
       selected DVB carrier. Provider and Source ID data is available from
       the provider network.
     </para>
-    </sect2>
   </sect1>
 
   <sect1 xml:id="sect.gpio_switcher_devices.unity4000">
@@ -1843,8 +1732,6 @@
 	</listitem>
       </varlistentry>
     </variablelist>
-    <sect2>
-      <title>General Notes</title>
     <para>
       Control is done by means of an RS-232C connection to one of the two
       RS-232 ports on the unit. If possible, use serial port number one,
@@ -1862,7 +1749,6 @@
       output at a time. Commanding a stream to an output will cause that 
       stream to be silently deselected from a previously selected output.
     </para>
-    </sect2>
   </sect1>
 
   <sect1 xml:id="sect.gpio_switcher_devices.wheatnet_lio">
@@ -1889,8 +1775,6 @@
 	</listitem>
       </varlistentry>
     </variablelist>
-    <sect2>
-      <title>General Notes</title>
     <para>
       Control is done by means of a TCP/IP connection to port 55776 on a
       blade. The only required configuration parameters are
@@ -1898,7 +1782,6 @@
       <computeroutput>IP Port</computeroutput>. The number of pins is
       auto-detected at driver startup.
     </para>
-    </sect2>
   </sect1>
 
   <sect1 xml:id="sect.gpio_switcher_devices.wheatnet_slio">
@@ -1925,8 +1808,6 @@
 	</listitem>
       </varlistentry>
     </variablelist>
-    <sect2>
-      <title>General Notes</title>
     <para>
       Control is done by means of a TCP/IP connection to port 55776 on a
       blade. The only required configuration parameters are
@@ -1934,6 +1815,5 @@
       <computeroutput>IP Port</computeroutput>. The number of pins is
       auto-detected at driver startup.
     </para>
-    </sect2>
   </sect1>
 </appendix>