man: use <refsect1> instead of <refsection>

DocBook document model doesn't allow mixing of <refsection> with the
numbered variants (<refsect1> etc.). Therefore, any document that
included something from standard-conf.xml was invalid. Fortunately, all
the includes are at the 1st level, hence let's just change
standard-conf.xml to use <refsect1> to fix that.
This commit is contained in:
David Tardon 2023-12-25 10:50:13 +01:00
parent cfcdee7c16
commit bc6fdcbf5d

View file

@ -1,5 +1,5 @@
<?xml version="1.0"?> <?xml version="1.0"?>
<!DOCTYPE refsection PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
<!-- <!--
@ -7,10 +7,13 @@
Copyright © 2014 Josh Triplett Copyright © 2014 Josh Triplett
--> -->
<refsection> <refentry>
<title/> <refnamediv>
<refname/>
<refpurpose/>
</refnamediv>
<refsection id='confd'> <refsect1 id='confd'>
<title>Configuration Directories and Precedence</title> <title>Configuration Directories and Precedence</title>
<para>Configuration files are read from directories in <filename>/etc/</filename>, <para>Configuration files are read from directories in <filename>/etc/</filename>,
@ -38,9 +41,9 @@
way is to place a symlink to <filename>/dev/null</filename> in the configuration directory in way is to place a symlink to <filename>/dev/null</filename> in the configuration directory in
<filename>/etc/</filename>, with the same filename as the vendor configuration file. If the vendor <filename>/etc/</filename>, with the same filename as the vendor configuration file. If the vendor
configuration file is included in the initrd image, the image has to be regenerated.</para> configuration file is included in the initrd image, the image has to be regenerated.</para>
</refsection> </refsect1>
<refsection id='main-conf'> <refsect1 id='main-conf'>
<title>Configuration Directories and Precedence</title> <title>Configuration Directories and Precedence</title>
<para>The default configuration is set during compilation, so configuration is only needed when it is <para>The default configuration is set during compilation, so configuration is only needed when it is
@ -72,5 +75,5 @@
<para>To disable a configuration file supplied by the vendor, the recommended way is to place a symlink <para>To disable a configuration file supplied by the vendor, the recommended way is to place a symlink
to <filename>/dev/null</filename> in the configuration directory in <filename>/etc/</filename>, with the to <filename>/dev/null</filename> in the configuration directory in <filename>/etc/</filename>, with the
same filename as the vendor configuration file.</para> same filename as the vendor configuration file.</para>
</refsection> </refsect1>
</refsection> </refentry>