1
0
mirror of https://github.com/postgres/postgres.git synced 2025-05-28 05:21:27 +03:00

doc: mention datadir locations are actually config locations

Technically, pg_upgrade's --old-datadir and --new-datadir are
configuration directories, not necessarily data directories.  This is
reflected in the 'postgres' manual page, so do the same for pg_upgrade.

Reported-by: Yves Goergen

Bug: 14898

Discussion: https://postgr.es/m/20171110220912.31513.13322@wrigleys.postgresql.org

Backpatch-through: 10
This commit is contained in:
Bruce Momjian 2018-01-31 16:25:21 -05:00
parent 86fba28657
commit 3dcc7ceec0

View File

@ -24,9 +24,9 @@
<arg choice="plain"><option>-B</option></arg>
<arg choice="plain"><replaceable>newbindir</replaceable></arg>
<arg choice="plain"><option>-d</option></arg>
<arg choice="plain"><replaceable>olddatadir</replaceable></arg>
<arg choice="plain"><replaceable>oldconfigdir</replaceable></arg>
<arg choice="plain"><option>-D</option></arg>
<arg choice="plain"><replaceable>newdatadir</replaceable></arg>
<arg choice="plain"><replaceable>newconfigdir</replaceable></arg>
<arg rep="repeat"><replaceable>option</replaceable></arg>
</cmdsynopsis>
</refsynopsisdiv>
@ -99,16 +99,16 @@
</varlistentry>
<varlistentry>
<term><option>-d</option> <replaceable>datadir</></term>
<term><option>--old-datadir=</option><replaceable>datadir</></term>
<listitem><para>the old cluster data directory; environment
<term><option>-d</option> <replaceable>configdir</></term>
<term><option>--old-datadir=</option><replaceable>configdir</></term>
<listitem><para>the old database cluster configuration directory; environment
variable <envar>PGDATAOLD</></para></listitem>
</varlistentry>
<varlistentry>
<term><option>-D</option> <replaceable>datadir</></term>
<term><option>--new-datadir=</option><replaceable>datadir</></term>
<listitem><para>the new cluster data directory; environment
<term><option>-D</option> <replaceable>configdir</></term>
<term><option>--new-datadir=</option><replaceable>configdir</>y</term>
<listitem><para>the new database cluster configuration directory; environment
variable <envar>PGDATANEW</></para></listitem>
</varlistentry>
@ -476,7 +476,7 @@ pg_upgrade.exe
<title>Save configuration files</title>
<para>
Save any configuration files from the old standbys' data
Save any configuration files from the old standbys' configuration
directories you need to keep, e.g. <filename>postgresql.conf</>,
<literal>recovery.conf</>, because these will be overwritten or
removed in the next step.