Avoid <substeps> element in man pages

petere · petere · commit d772b18d44c2 · 2022-04-07T13:45:25.000+02:00
The upstream DocBook manpages stylesheet apparently does not handle
the &lt;substeps&gt; element at all, and so the content comes out
unformatted, which is not useful.

As a workaround, replace &lt;substeps&gt; with a nested &lt;procedure&gt;, which
ends up effectively the same in output.
diff --git a/doc/src/sgml/ref/pgupgrade.sgml b/doc/src/sgml/ref/pgupgrade.sgml
@@ -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>
 
