@@ -817,9 +817,16 @@ doc/src/sgml/ref/pg_dump.sgml
817817 <term><option>--quote-all-identifiers</></term>
818818 <listitem>
819819 <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.
823830 </para>
824831 </listitem>
825832 </varlistentry>
@@ -1150,6 +1157,9 @@ CREATE DATABASE foo WITH TEMPLATE template0;
11501157 dump was taken from a server of that version. Loading a dump file
11511158 into an older server may require manual editing of the dump file
11521159 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.
11531163 </para>
11541164 </refsect1>
11551165