Avoid <substeps> element in man pages
authorPeter Eisentraut <peter@eisentraut.org>
Thu, 7 Apr 2022 11:45:25 +0000 (13:45 +0200)
committerPeter Eisentraut <peter@eisentraut.org>
Thu, 7 Apr 2022 11:45:25 +0000 (13:45 +0200)
The upstream DocBook manpages stylesheet apparently does not handle
the <substeps> element at all, and so the content comes out
unformatted, which is not useful.

As a workaround, replace <substeps> with a nested <procedure>, which
ends up effectively the same in output.

doc/src/sgml/ref/pgupgrade.sgml

index 3fbe141456d9b2e012745527e09232de3a698319..f024c3ef2596e02d25ea0e06f18271d5175e1510 100644 (file)
@@ -499,7 +499,7 @@ pg_upgrade.exe
      is running.
     </para>
 
-    <substeps>
+    <procedure>
 
      <step>
       <title>Install the new PostgreSQL binaries on standby servers</title>
@@ -624,7 +624,7 @@ rsync --archive --delete --hard-links --size-only --no-inc-recursive /vol1/pg_tb
       </para>
      </step>
 
-    </substeps>
+    </procedure>
 
    </step>