Typo in pg_dump documentation and new suggestion for Release Notes

Started by Mike Gabout 19 years ago3 messages
#1Mike G
mike@thegodshalls.com

In the online documentation for 8.2, pg_dump page, --table=table section, in the second
"Note:" paragraph, "rather than the old locution of -n sch -t tab" probably should be
"rather than the old location of -n sch -t tab"

Also maybe this section on pg_dump in the release notes page for 8.2 should be changed from
"pg_dump now supports multiple -n (schema) and -t (table) options, and adds -N and -T
options to exclude objects. Also, the arguments of these switches can now be wild-card
expressions rather than single object names, for example -t 'foo*', and a schema can be
part of a -t or -T switch, for example -t schema1.table1."

to the following: "pg_dump now supports multiple -n (schema) and -t (table) options, and
adds -N and -T options to exclude objects. Also, the arguments of these switches can now
be wild-card expressions rather than single object names, for example -t 'foo*', and a
schema can be part of a -t or -T switch, for example -t schema1.table1.

The pre-8.2 syntax for dumping an individual table is no longer supported. You must
write something like -t sch.tab to select a table in a particular schema, rather than
the old location of -n sch -t tab.
"

--
Open WebMail Project (http://openwebmail.org)

#2Tom Lane
tgl@sss.pgh.pa.us
In reply to: Mike G (#1)
Re: Typo in pg_dump documentation and new suggestion for Release Notes

"Mike G" <mike@thegodshalls.com> writes:

In the online documentation for 8.2, pg_dump page, --table=table section, in the second
"Note:" paragraph, "rather than the old locution of -n sch -t tab" probably should be
"rather than the old location of -n sch -t tab"

No, locution is a real word, and the right one in this context, which
location certainly isn't. But if it's too hi-falutin for you we could
change it to something else.

regards, tom lane

#3Bruce Momjian
bruce@momjian.us
In reply to: Mike G (#1)
1 attachment(s)
Re: [HACKERS] Typo in pg_dump documentation and new suggestion for Release Notes

Sorry we forgot the list this incompatibility in the 8.2.0 release
notes. I have applied the attached patch to list this item in the 8.2.0
documentation section. This will appear in the next 8.2.X release.

---------------------------------------------------------------------------

Mike G wrote:

In the online documentation for 8.2, pg_dump page, --table=table section, in the second
"Note:" paragraph, "rather than the old locution of -n sch -t tab" probably should be
"rather than the old location of -n sch -t tab"

Also maybe this section on pg_dump in the release notes page for 8.2 should be changed from
"pg_dump now supports multiple -n (schema) and -t (table) options, and adds -N and -T
options to exclude objects. Also, the arguments of these switches can now be wild-card
expressions rather than single object names, for example -t 'foo*', and a schema can be
part of a -t or -T switch, for example -t schema1.table1."

to the following: "pg_dump now supports multiple -n (schema) and -t (table) options, and
adds -N and -T options to exclude objects. Also, the arguments of these switches can now
be wild-card expressions rather than single object names, for example -t 'foo*', and a
schema can be part of a -t or -T switch, for example -t schema1.table1.

The pre-8.2 syntax for dumping an individual table is no longer supported. You must
write something like -t sch.tab to select a table in a particular schema, rather than
the old location of -n sch -t tab.
"

--
Open WebMail Project (http://openwebmail.org)

---------------------------(end of broadcast)---------------------------
TIP 2: Don't 'kill -9' the postmaster

--
Bruce Momjian bruce@momjian.us
EnterpriseDB http://www.enterprisedb.com

+ If your life is a hard drive, Christ can be your backup. +

Attachments:

/rtmp/difftext/x-diffDownload
Index: doc/src/sgml/release.sgml
===================================================================
RCS file: /cvsroot/pgsql/doc/src/sgml/release.sgml,v
retrieving revision 1.493
diff -c -c -r1.493 release.sgml
*** doc/src/sgml/release.sgml	1 Feb 2007 00:28:17 -0000	1.493
--- doc/src/sgml/release.sgml	1 Feb 2007 05:08:00 -0000
***************
*** 514,519 ****
--- 514,528 ----
  
        <listitem>
         <para>
+         Change behavior of <command>pg_dump</> <literal>-n</> and
+         <literal>-t</> options.  (Greg Sabino Mullane)
+        </para>
+        <para>
+         See the <command>pg_dump</> manual page for more details.
+       </listitem>
+ 
+       <listitem>
+        <para>
          Change <link linkend="libpq"><application>libpq</></link>
          <function>PQdsplen()</> to return a useful value (Martijn
          van Oosterhout)