Re: Improve pg_restore docs - Mailing list pgsql-docs

From Bruce Momjian
Subject Re: Improve pg_restore docs
Date
Msg-id 201002241628.o1OGSi425961@momjian.us
Whole thread Raw
In response to Improve pg_restore docs  (Mike Toews <mwtoews@sfu.ca>)
List pgsql-docs
Mike Toews wrote:
> Hi,
>
>  From a quick discussion on hackers
> (http://archives.postgresql.org/pgsql-hackers/2009-06/msg01434.php), it
> appears the documentation can improve for pg_restore.
>
> I've prepared some quick diff output from
> pgsql/doc/src/sgml/ref/pg_restore.sgml for some changes that I think
> would help. Note that I'm not entirely sure about the default namespace
> from default_path .. please verify this before accepting. Edit as necessary.
>
> 291c291,292
> <         specific table.
> ---
>  >         specific table.  The default is taken from the
>  >         <envar>default_path</envar> variable.
> 379c380,382
> <         Restore definition and/or data of named table only.
> ---
>  >         Restore definition and/or data of named table only. This can be
>  >         combined with the <option>-n</option> option to restore a table
>  >         from a specific schema.

I have applied a modified version of your second change to our
documentation.

--
  Bruce Momjian  <bruce@momjian.us>        http://momjian.us
  EnterpriseDB                             http://enterprisedb.com
  PG East:  http://www.enterprisedb.com/community/nav-pg-east-2010.do
  + If your life is a hard drive, Christ can be your backup. +
Index: doc/src/sgml/ref/pg_restore.sgml
===================================================================
RCS file: /cvsroot/pgsql/doc/src/sgml/ref/pg_restore.sgml,v
retrieving revision 1.85
diff -c -c -r1.85 pg_restore.sgml
*** doc/src/sgml/ref/pg_restore.sgml    23 Feb 2010 00:21:19 -0000    1.85
--- doc/src/sgml/ref/pg_restore.sgml    24 Feb 2010 16:27:14 -0000
***************
*** 377,383 ****
        <term><option>--table=<replaceable class="parameter">table</replaceable></option></term>
        <listitem>
         <para>
!         Restore definition and/or data of named table only.
         </para>
        </listitem>
       </varlistentry>
--- 377,384 ----
        <term><option>--table=<replaceable class="parameter">table</replaceable></option></term>
        <listitem>
         <para>
!         Restore definition and/or data of named table only.  This can be
!         combined with the <option>-n</option> option to specify a schema.
         </para>
        </listitem>
       </varlistentry>

pgsql-docs by date:

Previous
From: Bruce Momjian
Date:
Subject: Re: Removal of pre-7.4 documentation items
Next
From: Josh Berkus
Date:
Subject: libpq-example.html needs to use <> includes