aboutsummaryrefslogtreecommitdiff
path: root/doc/src
diff options
context:
space:
mode:
authorPeter Eisentraut <peter@eisentraut.org>2024-05-08 10:17:51 +0200
committerPeter Eisentraut <peter@eisentraut.org>2024-05-08 10:17:51 +0200
commit84f08f2215754cd03feaa82bbdf10fc114458b26 (patch)
tree7bc3645ba15032619c25da4b0b27649f71758eca /doc/src
parent4364e0126ec7663363cf2dff86a0f6da949fc002 (diff)
downloadpostgresql-84f08f2215754cd03feaa82bbdf10fc114458b26.tar.gz
postgresql-84f08f2215754cd03feaa82bbdf10fc114458b26.zip
doc: Improve order of options on pg_upgrade reference page
Put the new long-only options in a location that is consistent with the existing long-only options and also the --help output.
Diffstat (limited to 'doc/src')
-rw-r--r--doc/src/sgml/ref/pgupgrade.sgml46
1 files changed, 23 insertions, 23 deletions
diff --git a/doc/src/sgml/ref/pgupgrade.sgml b/doc/src/sgml/ref/pgupgrade.sgml
index 80a50377b1d..10c842adb14 100644
--- a/doc/src/sgml/ref/pgupgrade.sgml
+++ b/doc/src/sgml/ref/pgupgrade.sgml
@@ -191,29 +191,6 @@ PostgreSQL documentation
</varlistentry>
<varlistentry>
- <term><option>--sync-method=</option><replaceable>method</replaceable></term>
- <listitem>
- <para>
- When set to <literal>fsync</literal>, which is the default,
- <command>pg_upgrade</command> will recursively open and synchronize all
- files in the upgraded cluster's data directory. The search for files
- will follow symbolic links for the WAL directory and each configured
- tablespace.
- </para>
- <para>
- On Linux, <literal>syncfs</literal> may be used instead to ask the
- operating system to synchronize the whole file systems that contain the
- upgraded cluster's data directory, its WAL files, and each tablespace.
- See <xref linkend="guc-recovery-init-sync-method"/> for information
- about the caveats to be aware of when using <literal>syncfs</literal>.
- </para>
- <para>
- This option has no effect when <option>--no-sync</option> is used.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
<term><option>-U</option> <replaceable>username</replaceable></term>
<term><option>--username=</option><replaceable>username</replaceable></term>
<listitem><para>cluster's install user name; environment
@@ -277,6 +254,29 @@ PostgreSQL documentation
</varlistentry>
<varlistentry>
+ <term><option>--sync-method=</option><replaceable>method</replaceable></term>
+ <listitem>
+ <para>
+ When set to <literal>fsync</literal>, which is the default,
+ <command>pg_upgrade</command> will recursively open and synchronize all
+ files in the upgraded cluster's data directory. The search for files
+ will follow symbolic links for the WAL directory and each configured
+ tablespace.
+ </para>
+ <para>
+ On Linux, <literal>syncfs</literal> may be used instead to ask the
+ operating system to synchronize the whole file systems that contain the
+ upgraded cluster's data directory, its WAL files, and each tablespace.
+ See <xref linkend="guc-recovery-init-sync-method"/> for information
+ about the caveats to be aware of when using <literal>syncfs</literal>.
+ </para>
+ <para>
+ This option has no effect when <option>--no-sync</option> is used.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
<term><option>-?</option></term>
<term><option>--help</option></term>
<listitem><para>show help, then exit</para></listitem>