Add an example showing how to cope with mixed-case names in pg_dump

switches.

diff --git a/doc/src/sgml/ref/pg_dump.sgml b/doc/src/sgml/ref/pg_dump.sgml
index 13fde9d2faf00c45a7a4ab22e571a6751be209f0..389ac09995c4c18377fdad1871b677220b0e56f4 100644 (file)
--- a/doc/src/sgml/ref/pg_dump.sgml
+++ b/doc/src/sgml/ref/pg_dump.sgml
@@ -1,5 +1,5 @@
 <!--
-$PostgreSQL: pgsql/doc/src/sgml/ref/pg_dump.sgml,v 1.91 2006/10/23 18:10:32 petere Exp $
+$PostgreSQL: pgsql/doc/src/sgml/ref/pg_dump.sgml,v 1.92 2006/11/28 22:54:18 tgl Exp $
 PostgreSQL documentation
 -->
 
@@ -838,6 +838,20 @@ CREATE DATABASE foo WITH TEMPLATE template0;
 
 <screen>
 <prompt>$</prompt> <userinput>pg_dump -T 'ts_*' mydb &gt; db.sql</userinput>
+</screen>
+  </para>
+
+  <para>
+   To specify an upper-case or mixed-case name in <option>-t</> and related
+   switches, you need to double-quote the name; else it will be folded to
+   lower case (see <xref
+   linkend="APP-PSQL-patterns" endterm="APP-PSQL-patterns-title">).  But
+   double quotes are special to the shell, so in turn they must be quoted.
+   Thus, to dump a single table with a mixed-case name, you need something
+   like
+
+<screen>
+<prompt>$</prompt> <userinput>pg_dump -t '"MixedCaseName"' mydb &gt; mytab.sql</userinput>
 </screen>
   </para>