From: Peter Eisentraut <peter@eisentraut.org>
Date: Tue, 7 May 2024 09:25:55 +0000 (+0200)
Subject: doc: Improve order of options on pgbench reference page
X-Git-Tag: REL_17_BETA1~98
X-Git-Url: http://git.postgresql.org/gitweb/?a=commitdiff_plain;h=09fe9659fd5ea73fb721e270664943cab727354b;p=postgresql.git

doc: Improve order of options on pgbench reference page

Both the pgbench --help output and the reference page have sections
for initialization options, benchmarking options, and common options.
But the --debug option ended up in the wrong place on the reference
page.  Fix that by making the documentation match the --help output.
---

diff --git a/doc/src/sgml/ref/pgbench.sgml b/doc/src/sgml/ref/pgbench.sgml
index c3d0ec240b1..46240e3f725 100644
--- a/doc/src/sgml/ref/pgbench.sgml
+++ b/doc/src/sgml/ref/pgbench.sgml
@@ -463,15 +463,6 @@ pgbench <optional> <replaceable>options</replaceable> </optional> <replaceable>d
       </listitem>
      </varlistentry>
 
-     <varlistentry id="pgbench-option-debug">
-      <term><option>--debug</option></term>
-      <listitem>
-       <para>
-        Print debugging output.
-       </para>
-      </listitem>
-     </varlistentry>
-
      <varlistentry id="pgbench-option-define">
       <term><option>-D</option> <replaceable>varname</replaceable><literal>=</literal><replaceable>value</replaceable></term>
       <term><option>--define=</option><replaceable>varname</replaceable><literal>=</literal><replaceable>value</replaceable></term>
@@ -934,9 +925,17 @@ pgbench <optional> <replaceable>options</replaceable> </optional> <replaceable>d
 
    <para>
     <application>pgbench</application> also accepts the following common command-line
-    arguments for connection parameters:
+    arguments for connection parameters and other common settings:
 
     <variablelist>
+     <varlistentry id="pgbench-option-debug">
+      <term><option>--debug</option></term>
+      <listitem>
+       <para>
+        Print debugging output.
+       </para>
+      </listitem>
+     </varlistentry>
 
      <varlistentry id="pgbench-option-host">
       <term><option>-h</option> <replaceable>hostname</replaceable></term>