aboutsummaryrefslogtreecommitdiff
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
commitc77f31171c8349d9ae4d6328be1922f06c5d590f (patch)
tree112970714ee6760d34cede50f882f2b9c170e1a9
parentbff8d0fe3bff0ce52c0343d81afa8f1745d0209e (diff)
downloadpostgresql-c77f31171c8349d9ae4d6328be1922f06c5d590f.tar.gz
postgresql-c77f31171c8349d9ae4d6328be1922f06c5d590f.zip
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 8ff5b7417fc..aef96ec30fa 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>
@@ -208,8 +208,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>
@@ -455,8 +455,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>
@@ -702,8 +702,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>
@@ -933,8 +933,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>