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
commit2d19f13773cac817ff254954142a458a256e8232 (patch)
treebe194b66cb11186943f9b8e85374493e109cf417
parent4bccceaa9179bffbe3469909e28ce4ded34f0a09 (diff)
downloadpostgresql-2d19f13773cac817ff254954142a458a256e8232.tar.gz
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 762b81cde9..8ca146d932 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>
@@ -679,8 +679,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>
@@ -802,8 +802,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>