From: Tom Lane <tgl@sss.pgh.pa.us>
Date: Tue, 28 Nov 2006 22:54:18 +0000 (+0000)
Subject: Add an example showing how to cope with mixed-case names in pg_dump
X-Git-Tag: REL8_2_0~26
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=7bbe35a540f6d52fe12d0fc177af876925455459;p=thirdparty%2Fpostgresql.git

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 13fde9d2faf..389ac09995c 100644
--- 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>