[media] DocBook media: xmllint fixes

Fixes a large number of xmllint errors.

Signed-off-by: Hans Verkuil <[e-mail]>
Signed-off-by: Mauro Carvalho Chehab <[e-mail]>

Documentation/DocBook/media/dvb/dvbproperty.xml

···
     rate of 5.217 Mbauds, those properties should be sent to
     <link linkend="FE_GET_PROPERTY"><constant>FE_SET_PROPERTY</constant></link> ioctl:</para>
     <itemizedlist>
-	<listitem>&DTV-DELIVERY-SYSTEM; = SYS_DVBC_ANNEX_A</listitem>
-	<listitem>&DTV-FREQUENCY; = 651000000</listitem>
-	<listitem>&DTV-MODULATION; = QAM_256</listitem>
-	<listitem>&DTV-INVERSION; = INVERSION_AUTO</listitem>
-	<listitem>&DTV-SYMBOL-RATE; = 5217000</listitem>
-	<listitem>&DTV-INNER-FEC; = FEC_3_4</listitem>
-	<listitem>&DTV-TUNE;</listitem>
+	<listitem><para>&DTV-DELIVERY-SYSTEM; = SYS_DVBC_ANNEX_A</para></listitem>
+	<listitem><para>&DTV-FREQUENCY; = 651000000</para></listitem>
+	<listitem><para>&DTV-MODULATION; = QAM_256</para></listitem>
+	<listitem><para>&DTV-INVERSION; = INVERSION_AUTO</para></listitem>
+	<listitem><para>&DTV-SYMBOL-RATE; = 5217000</para></listitem>
+	<listitem><para>&DTV-INNER-FEC; = FEC_3_4</para></listitem>
+	<listitem><para>&DTV-TUNE;</para></listitem>
     </itemizedlist>
 
 <para>The code that would do the above is:</para>
···
 	</row><row>
 	    <entry>FEC_3_5</entry>
 	    <entry>Forward Error Correction Code 3/5</entry>
-	</row><row>
 	</row>
         </tbody>
     </tgroup>
···
         </tbody>
     </tgroup>
 </table>
-</section>
 
 		<para>Notes:</para>
 		<para>1) If <constant>DTV_GUARD_INTERVAL</constant> is set the <constant>GUARD_INTERVAL_AUTO</constant> the hardware will
···
 			in the missing parameters.</para>
 		<para>2) Intervals 1/128, 19/128 and 19/256 are used only for DVB-T2 at present</para>
 		<para>3) DTMB specifies PN420, PN595 and PN945.</para>
+</section>
 	</section>
 	<section id="DTV-TRANSMISSION-MODE">
 		<title><constant>DTV_TRANSMISSION_MODE</constant></title>
···
 	</row><row>
 	    <entry>TRANSMISSION_MODE_C3780</entry>
 	    <entry>Multi Carrier (C=3780) transmission mode (DTMB)</entry>
-	</row><row>
 	</row>
         </tbody>
     </tgroup>
 </table>
-</section>
 
 
 		<para>Notes:</para>
···
 		<para>3) DVB-T specifies 2K and 8K as valid sizes.</para>
 		<para>4) DVB-T2 specifies 1K, 2K, 4K, 8K, 16K and 32K.</para>
 		<para>5) DTMB specifies C1 and C3780.</para>
+</section>
 	</section>
 	<section id="DTV-HIERARCHY">
 	<title><constant>DTV_HIERARCHY</constant></title>

Documentation/DocBook/media/dvb/fe-diseqc-recv-slave-reply.xml

···
 	<funcdef>int <function>ioctl</function></funcdef>
 	<paramdef>int <parameter>fd</parameter></paramdef>
 	<paramdef>int <parameter>request</parameter></paramdef>
-	<paramdef>&dvb-diseqc-slave-reply; *<parameter>argp</parameter></paramdef>
+	<paramdef>struct dvb_diseqc_slave_reply *<parameter>argp</parameter></paramdef>
       </funcprototype>
     </funcsynopsis>
   </refsynopsisdiv>

Documentation/DocBook/media/dvb/fe-diseqc-send-burst.xml

···
 	<funcdef>int <function>ioctl</function></funcdef>
 	<paramdef>int <parameter>fd</parameter></paramdef>
 	<paramdef>int <parameter>request</parameter></paramdef>
-	<paramdef>&fe-sec-mini-cmd; *<parameter>tone</parameter></paramdef>
+	<paramdef>enum fe_sec_mini_cmd *<parameter>tone</parameter></paramdef>
       </funcprototype>
     </funcsynopsis>
   </refsynopsisdiv>
···
 &return-value-dvb;
 </refsect1>
 
-<section id="fe-sec-mini-cmd-t">
+<refsect1 id="fe-sec-mini-cmd-t">
 <title>enum fe_sec_mini_cmd</title>
 
 <table pgwide="1" frame="none" id="fe-sec-mini-cmd">
-    <title>enum fe_sec_tone_mode</title>
+    <title>enum fe_sec_mini_cmd</title>
     <tgroup cols="2">
 	&cs-def;
 	<thead>
···
         </tbody>
     </tgroup>
 </table>
-</section>
+</refsect1>
 
 </refentry>

Documentation/DocBook/media/dvb/fe-diseqc-send-master-cmd.xml

···
 	<funcdef>int <function>ioctl</function></funcdef>
 	<paramdef>int <parameter>fd</parameter></paramdef>
 	<paramdef>int <parameter>request</parameter></paramdef>
-	<paramdef>&dvb-diseqc-master-cmd; *<parameter>argp</parameter></paramdef>
+	<paramdef>struct dvb_diseqc_master_cmd *<parameter>argp</parameter></paramdef>
       </funcprototype>
     </funcsynopsis>
   </refsynopsisdiv>

Documentation/DocBook/media/dvb/fe-enable-high-lnb-voltage.xml

···
 	<listitem>
 	    <para>Valid flags:</para>
 	    <itemizedlist>
-		<listitem>0 - normal 13V and 18V.</listitem>
-		<listitem>&gt;0 - enables slightly higher voltages instead of
-		    13/18V, in order to compensate for long antena cables.</listitem>
+		<listitem><para>0 - normal 13V and 18V.</para></listitem>
+		<listitem><para>&gt;0 - enables slightly higher voltages instead of
+		    13/18V, in order to compensate for long antenna cables.</para></listitem>
 	    </itemizedlist>
 	</listitem>
       </varlistentry>

Documentation/DocBook/media/dvb/fe-get-info.xml

···
 	<funcdef>int <function>ioctl</function></funcdef>
 	<paramdef>int <parameter>fd</parameter></paramdef>
 	<paramdef>int <parameter>request</parameter></paramdef>
-	<paramdef>&dvb-frontend-info; *<parameter>argp</parameter></paramdef>
+	<paramdef>struct dvb_frontend_info *<parameter>argp</parameter></paramdef>
       </funcprototype>
     </funcsynopsis>
   </refsynopsisdiv>
···
 	</tbody>
       </tgroup>
     </table>
-  </refsect1>
 
   <para>NOTE: The frequencies are specified in Hz for Terrestrial and Cable
       systems. They're specified in kHz for Satellite systems</para>
+  </refsect1>
 
-<section id="fe-caps-t">
+<refsect1 id="fe-caps-t">
 <title>frontend capabilities</title>
 
 <para>Capabilities describe what a frontend can do. Some capabilities are
···
         </tbody>
     </tgroup>
 </table>
-</section>
+</refsect1>
 </refentry>

Documentation/DocBook/media/dvb/fe-get-property.xml

···
 	<funcdef>int <function>ioctl</function></funcdef>
 	<paramdef>int <parameter>fd</parameter></paramdef>
 	<paramdef>int <parameter>request</parameter></paramdef>
-	<paramdef>&dtv-properties; *<parameter>argp</parameter></paramdef>
+	<paramdef>struct dtv_property *<parameter>argp</parameter></paramdef>
       </funcprototype>
     </funcsynopsis>
   </refsynopsisdiv>
···
 <listitem>
     <para><constant>FE_SET_PROPERTY:</constant></para>
 <itemizedlist>
-<listitem>This ioctl is used to set one or more
-	frontend properties.</listitem>
-<listitem>This is the basic command to request the frontend to tune into some
-    frequency and to start decoding the digital TV signal.</listitem>
-<listitem>This call requires read/write access to the device.</listitem>
-<listitem>At return, the values are updated to reflect the
-    actual parameters used.</listitem>
+<listitem><para>This ioctl is used to set one or more
+	frontend properties.</para></listitem>
+<listitem><para>This is the basic command to request the frontend to tune into some
+    frequency and to start decoding the digital TV signal.</para></listitem>
+<listitem><para>This call requires read/write access to the device.</para></listitem>
+<listitem><para>At return, the values are updated to reflect the
+    actual parameters used.</para></listitem>
 </itemizedlist>
 </listitem>
 <listitem>
     <para><constant>FE_GET_PROPERTY:</constant></para>
 <itemizedlist>
-<listitem>This ioctl is used to get properties and
-statistics from the frontend.</listitem>
-<listitem>No properties are changed, and statistics aren't reset.</listitem>
-<listitem>This call only requires read-only access to the device.</listitem>
+<listitem><para>This ioctl is used to get properties and
+statistics from the frontend.</para></listitem>
+<listitem><para>No properties are changed, and statistics aren't reset.</para></listitem>
+<listitem><para>This call only requires read-only access to the device.</para></listitem>
 </itemizedlist>
 </listitem>
 </itemizedlist>
-&return-value-dvb;.
+&return-value-dvb;
 </refsect1>
 </refentry>

Documentation/DocBook/media/dvb/fe-read-status.xml

···
 &return-value-dvb;
 </refsect1>
 
-<section id="fe-status-t">
+<refsect1 id="fe-status-t">
 <title>int fe_status</title>
 
 <para>The fe_status parameter is used to indicate the current state
···
         </tbody>
     </tgroup>
 </table>
-</section>
+</refsect1>
 </refentry>

Documentation/DocBook/media/dvb/fe-set-frontend-tune-mode.xml

···
 	<listitem>
 	    <para>Valid flags:</para>
 	    <itemizedlist>
-		<listitem>0 - normal tune mode</listitem>
-		<listitem>FE_TUNE_MODE_ONESHOT - When set, this flag will
+		<listitem><para>0 - normal tune mode</para></listitem>
+		<listitem><para>FE_TUNE_MODE_ONESHOT - When set, this flag will
 		    disable any zigzagging or other "normal" tuning behaviour.
 		    Additionally, there will be no automatic monitoring of the
 		    lock status, and hence no frontend events will be
 		    generated. If a frontend device is closed, this flag will
 		    be automatically turned off when the device is reopened
-		    read-write.</listitem>
+		    read-write.</para></listitem>
 	    </itemizedlist>
 	</listitem>
       </varlistentry>

Documentation/DocBook/media/dvb/fe-set-tone.xml

···
 	<funcdef>int <function>ioctl</function></funcdef>
 	<paramdef>int <parameter>fd</parameter></paramdef>
 	<paramdef>int <parameter>request</parameter></paramdef>
-	<paramdef>&fe-sec-tone-mode; *<parameter>tone</parameter></paramdef>
+	<paramdef>enum fe_sec_tone_mode *<parameter>tone</parameter></paramdef>
       </funcprototype>
     </funcsynopsis>
   </refsynopsisdiv>
···
 &return-value-dvb;
 </refsect1>
 
-<section id="fe-sec-tone-mode-t">
-<title>enum fe_sec_voltage</title>
+<refsect1 id="fe-sec-tone-mode-t">
+<title>enum fe_sec_tone_mode</title>
 
 <table pgwide="1" frame="none" id="fe-sec-tone-mode">
     <title>enum fe_sec_tone_mode</title>
···
         </tbody>
     </tgroup>
 </table>
-</section>
+</refsect1>
 
 </refentry>

Documentation/DocBook/media/dvb/fe-set-voltage.xml

···
 	<funcdef>int <function>ioctl</function></funcdef>
 	<paramdef>int <parameter>fd</parameter></paramdef>
 	<paramdef>int <parameter>request</parameter></paramdef>
-	<paramdef>&fe-sec-voltage; *<parameter>voltage</parameter></paramdef>
+	<paramdef>enum fe_sec_voltage *<parameter>voltage</parameter></paramdef>
       </funcprototype>
     </funcsynopsis>
   </refsynopsisdiv>
···
 &return-value-dvb;
 </refsect1>
 
-<section id="fe-sec-voltage-t">
+<refsect1 id="fe-sec-voltage-t">
 <title>enum fe_sec_voltage</title>
 
 <table pgwide="1" frame="none" id="fe-sec-voltage">
···
         </tbody>
     </tgroup>
 </table>
-</section>
+</refsect1>
 
 </refentry>

Documentation/DocBook/media/dvb/frontend.xml

···
 
 <para>The DVB frontend API was designed to support three types of delivery systems:</para>
 <itemizedlist>
-    <listitem>Terrestrial systems: DVB-T, DVB-T2, ATSC, ATSC M/H, ISDB-T, DVB-H, DTMB, CMMB</listitem>
-    <listitem>Cable systems: DVB-C Annex A/C, ClearQAM (DVB-C Annex B), ISDB-C</listitem>
-    <listitem>Satellite systems: DVB-S, DVB-S2, DVB Turbo, ISDB-S, DSS</listitem>
+    <listitem><para>Terrestrial systems: DVB-T, DVB-T2, ATSC, ATSC M/H, ISDB-T, DVB-H, DTMB, CMMB</para></listitem>
+    <listitem><para>Cable systems: DVB-C Annex A/C, ClearQAM (DVB-C Annex B), ISDB-C</para></listitem>
+    <listitem><para>Satellite systems: DVB-S, DVB-S2, DVB Turbo, ISDB-S, DSS</para></listitem>
 </itemizedlist>
 <para>The DVB frontend controls several sub-devices including:</para>
 <itemizedlist>
-    <listitem>Tuner</listitem>,
-    <listitem>Digital TV demodulator</listitem>
-    <listitem>Low noise amplifier (LNA)</listitem>
-    <listitem>Satellite Equipment Control (SEC) hardware (only for Satellite).</listitem>
+    <listitem><para>Tuner</para></listitem>
+    <listitem><para>Digital TV demodulator</para></listitem>
+    <listitem><para>Low noise amplifier (LNA)</para></listitem>
+    <listitem><para>Satellite Equipment Control (SEC) hardware (only for Satellite).</para></listitem>
 </itemizedlist>
 <para>The frontend can be accessed through
     <emphasis role="bold">/dev/dvb/adapter?/frontend?</emphasis>. Data types and
···
 <para>Signal statistics are provided via <link linkend="FE_GET_PROPERTY"><constant>FE_GET_PROPERTY</constant></link>.
     Please notice that several statistics require the demodulator to be fully
     locked (e. g. with FE_HAS_LOCK bit set). See
-    <xref linkend="frontend-stat-properties">Frontend statistics indicators</xref>
+    <link linkend="frontend-stat-properties">Frontend statistics indicators</link>
     for more details.</para>
 </section>
 

Documentation/DocBook/media/dvb/frontend_legacy_api.xml

···
 	</row><row>
 	    <entry>BANDWIDTH_10_MHZ</entry>
 	    <entry>10 MHz</entry>
-	</row><row>
 	</row>
         </tbody>
     </tgroup>
···
  </section>
 </section>
 
-<section id="frontend_fcalls">
+<section id="frontend_legacy_fcalls">
 <title>Frontend Legacy Function Calls</title>
 
 <para>Those functions are defined at DVB version 3. The support is kept in