summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorTom Lane <tgl@sss.pgh.pa.us>2021-01-13 13:30:04 -0500
committerTom Lane <tgl@sss.pgh.pa.us>2021-01-13 13:30:04 -0500
commit7343a155925107aec07676ab5c5247b4c16f4bdc (patch)
tree700c3c0596e8c60a1373a1e78e9e85f140a3da51
parentf2b268ee0626286d15a1eaa78fe1704811d51cd4 (diff)
Doc: clarify behavior of back-half options in pg_dump.
Options that change how the archive data is converted to SQL text are ignored when dumping to archive formats. The documentation previously said "not meaningful", which is not helpful. Discussion: https://postgr.es/m/161052021249.12228.9598689907884726185@wrigleys.postgresql.org
-rw-r--r--doc/src/sgml/ref/pg_dump.sgml20
1 files changed, 10 insertions, 10 deletions
diff --git a/doc/src/sgml/ref/pg_dump.sgml b/doc/src/sgml/ref/pg_dump.sgml
index aa938cf10c3..b48a4b59c20 100644
--- a/doc/src/sgml/ref/pg_dump.sgml
+++ b/doc/src/sgml/ref/pg_dump.sgml
@@ -160,8 +160,8 @@ PostgreSQL documentation
</para>
<para>
- This option is only meaningful for the plain-text format. For
- the archive formats, you can specify the option when you
+ This option is ignored when emitting an archive (non-text) output
+ file. For the archive formats, you can specify the option when you
call <command>pg_restore</command>.
</para>
</listitem>
@@ -181,8 +181,8 @@ PostgreSQL documentation
</para>
<para>
- This option is only meaningful for the plain-text format. For
- the archive formats, you can specify the option when you
+ This option is ignored when emitting an archive (non-text) output
+ file. For the archive formats, you can specify the option when you
call <command>pg_restore</command>.
</para>
</listitem>
@@ -440,8 +440,8 @@ PostgreSQL documentation
</para>
<para>
- This option is only meaningful for the plain-text format. For
- the archive formats, you can specify the option when you
+ This option is ignored when emitting an archive (non-text) output
+ file. For the archive formats, you can specify the option when you
call <command>pg_restore</command>.
</para>
</listitem>
@@ -681,8 +681,8 @@ PostgreSQL documentation
</para>
<para>
- This option is only meaningful for the plain-text format. For
- the archive formats, you can specify the option when you
+ This option is ignored when emitting an archive (non-text) output
+ file. For the archive formats, you can specify the option when you
call <command>pg_restore</command>.
</para>
</listitem>
@@ -804,8 +804,8 @@ PostgreSQL documentation
</para>
<para>
- This option is only meaningful for the plain-text format. For
- the archive formats, you can specify the option when you
+ This option is ignored when emitting an archive (non-text) output
+ file. For the archive formats, you can specify the option when you
call <command>pg_restore</command>.
</para>
</listitem>