diff options
| author | Tom Lane <tgl@sss.pgh.pa.us> | 2016-05-20 14:59:48 -0400 |
|---|---|---|
| committer | Tom Lane <tgl@sss.pgh.pa.us> | 2016-05-20 14:59:48 -0400 |
| commit | 608e466141a3e55365c76b5e7667f272d3b9deb1 (patch) | |
| tree | 51723b57212362602e0d10d87f019adb94451513 | |
| parent | 79e4deaf8305e0a7622c4555ddbba8637ca1784b (diff) | |
| download | postgresql-608e466141a3e55365c76b5e7667f272d3b9deb1.tar.gz postgresql-608e466141a3e55365c76b5e7667f272d3b9deb1.zip | |
Improve documentation about pg_dump's --quote-all-identifiers switch.
Per bug #14152 from Alejandro MartÃnez. Back-patch to all supported
branches.
Discussion: <20160520165824.22598.31426@wrigleys.postgresql.org>
| -rw-r--r-- | doc/src/sgml/ref/pg_dump.sgml | 13 | ||||
| -rw-r--r-- | doc/src/sgml/ref/pg_dumpall.sgml | 13 |
2 files changed, 20 insertions, 6 deletions
diff --git a/doc/src/sgml/ref/pg_dump.sgml b/doc/src/sgml/ref/pg_dump.sgml index 3f44b26834c..d7a6d274ebe 100644 --- a/doc/src/sgml/ref/pg_dump.sgml +++ b/doc/src/sgml/ref/pg_dump.sgml @@ -688,9 +688,16 @@ PostgreSQL documentation <term><option>--quote-all-identifiers</></term> <listitem> <para> - Force quoting of all identifiers. This may be useful when dumping a - database for migration to a future version that may have introduced - additional keywords. + Force quoting of all identifiers. This option is recommended when + dumping a database from a server whose <productname>PostgreSQL</> + major version is different from <application>pg_dump</>'s, or when + the output is intended to be loaded into a server of a different + major version. By default, <application>pg_dump</> quotes only + identifiers that are reserved words in its own major version. + This sometimes results in compatibility issues when dealing with + servers of other versions that may have slightly different sets + of reserved words. Using <option>--quote-all-identifiers</> prevents + such issues, at the price of a harder-to-read dump script. </para> </listitem> </varlistentry> diff --git a/doc/src/sgml/ref/pg_dumpall.sgml b/doc/src/sgml/ref/pg_dumpall.sgml index 7c49c0364fb..ff23745d32d 100644 --- a/doc/src/sgml/ref/pg_dumpall.sgml +++ b/doc/src/sgml/ref/pg_dumpall.sgml @@ -367,9 +367,16 @@ PostgreSQL documentation <term><option>--quote-all-identifiers</></term> <listitem> <para> - Force quoting of all identifiers. This may be useful when dumping a - database for migration to a future version that may have introduced - additional keywords. + Force quoting of all identifiers. This option is recommended when + dumping a database from a server whose <productname>PostgreSQL</> + major version is different from <application>pg_dumpall</>'s, or when + the output is intended to be loaded into a server of a different + major version. By default, <application>pg_dumpall</> quotes only + identifiers that are reserved words in its own major version. + This sometimes results in compatibility issues when dealing with + servers of other versions that may have slightly different sets + of reserved words. Using <option>--quote-all-identifiers</> prevents + such issues, at the price of a harder-to-read dump script. </para> </listitem> </varlistentry> |