]> git.ipfire.org Git - thirdparty/systemd.git/commitdiff
man: use <refsect1> instead of <refsection> 30616/head
authorDavid Tardon <dtardon@redhat.com>
Mon, 25 Dec 2023 09:50:13 +0000 (10:50 +0100)
committerDavid Tardon <dtardon@redhat.com>
Mon, 25 Dec 2023 09:50:13 +0000 (10:50 +0100)
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.

man/standard-conf.xml

index 0174c090e91224796ce8cf63d238de41692de73c..2f56c95fbb40cf069eea1351655d65b0ee0d3f5a 100644 (file)
@@ -1,5 +1,5 @@
 <?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">
 
 <!--
@@ -7,10 +7,13 @@
   Copyright © 2014 Josh Triplett
 -->
 
-<refsection>
-  <title/>
+<refentry>
+  <refnamediv>
+    <refname/>
+    <refpurpose/>
+  </refnamediv>
 
-  <refsection id='confd'>
+  <refsect1 id='confd'>
     <title>Configuration Directories and Precedence</title>
 
     <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
     <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>
-  </refsection>
+  </refsect1>
 
-  <refsection id='main-conf'>
+  <refsect1 id='main-conf'>
     <title>Configuration Directories and Precedence</title>
 
     <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
     to <filename>/dev/null</filename> in the configuration directory in <filename>/etc/</filename>, with the
     same filename as the vendor configuration file.</para>
-  </refsection>
-</refsection>
+  </refsect1>
+</refentry>