@@ -817,9 +817,16 @@ doc/src/sgml/ref/pg_dump.sgml
817
817
<term><option>--quote-all-identifiers</></term>
818
818
<listitem>
819
819
<para>
820
- Force quoting of all identifiers. This may be useful when dumping a
821
- database for migration to a future version that may have introduced
822
- additional keywords.
820
+ Force quoting of all identifiers. This option is recommended when
821
+ dumping a database from a server whose <productname>PostgreSQL</>
822
+ major version is different from <application>pg_dump</>'s, or when
823
+ the output is intended to be loaded into a server of a different
824
+ major version. By default, <application>pg_dump</> quotes only
825
+ identifiers that are reserved words in its own major version.
826
+ This sometimes results in compatibility issues when dealing with
827
+ servers of other versions that may have slightly different sets
828
+ of reserved words. Using <option>--quote-all-identifiers</> prevents
829
+ such issues, at the price of a harder-to-read dump script.
823
830
</para>
824
831
</listitem>
825
832
</varlistentry>
@@ -1150,6 +1157,9 @@ CREATE DATABASE foo WITH TEMPLATE template0;
1150
1157
dump was taken from a server of that version. Loading a dump file
1151
1158
into an older server may require manual editing of the dump file
1152
1159
to remove syntax not understood by the older server.
1160
+ Use of the <option>--quote-all-identifiers</option> option is recommended
1161
+ in cross-version cases, as it can prevent problems arising from varying
1162
+ reserved-word lists in different <productname>PostgreSQL</> versions.
1153
1163
</para>
1154
1164
</refsect1>
1155
1165