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

tglsfdc · tglsfdc · commit 7bbe35a540f6 · 2006-11-28T22:54:18.000Z
switches.
diff --git 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>
 
