From: David Tardon <dtardon@redhat.com>
Date: Mon, 25 Dec 2023 09:50:13 +0000 (+0100)
Subject: man: use <refsect1> instead of <refsection>
X-Git-Tag: v256-rc1~1389^2
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=bc6fdcbf5d2c053ee0d27b713fa5e09cace9b44f;p=thirdparty%2Fsystemd.git

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.
---

diff --git a/man/standard-conf.xml b/man/standard-conf.xml
index 0174c090e91..2f56c95fbb4 100644
--- a/man/standard-conf.xml
+++ b/man/standard-conf.xml
@@ -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>