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
commit89160369ec8b706285478bbcb2096c65dd5295ba (patch)
treecad3cf90efe1c6b616abfe1611439aafe55c5021
parent636b6f99c215217b7e112dc2a97ff1a12f0bd21e (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 948e5e361d1..18a88d51a21 100644
--- a/doc/src/sgml/ref/pg_dump.sgml
+++ b/doc/src/sgml/ref/pg_dump.sgml
@@ -176,8 +176,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>
@@ -197,8 +197,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>
@@ -458,8 +458,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>
@@ -699,8 +699,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>
@@ -853,8 +853,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>