From: Jim C. Nasby <jnasby@pervasive.com>
To: Dave Page <dpage@vale-housing.co.uk>
Cc: David Fetter <david@fetter.org>
Cc: Oisin Glynn <me@oisinglynn.com>
Cc: pgsql general <pgsql-general@postgresql.org>
Cc: PostgreSQL Docs <pgsql-docs@postgresql.org>
Subject: Re: [GENERAL] COPY command documentation
Date: Fri, 24 Mar 2006 06:28:09 -0600
Message-ID: <20060324122809.GX90527@pervasive.com> (raw)
In-Reply-To: <C049654F.88A3%dpage@vale-housing.co.uk>
References: <20060323201250.GC6106@fetter.org>
<C049654F.88A3%dpage@vale-housing.co.uk>
On Fri, Mar 24, 2006 at 08:58:55AM +0000, Dave Page wrote:
> On 23/3/06 20:12, "David Fetter" <david@fetter.org> wrote:
>
> > On Thu, Mar 23, 2006 at 07:00:13PM +0100, Jim Nasby wrote:
> >> On Mar 23, 2006, at 4:08 PM, Oisin Glynn wrote:
> >>
> >>> I just discovered that the comments from 8.0 had the answer I was
> >>> looking for but these comments are not in the 8.1 docs. Should the
> >>> comments be rolled forward as new versions are created? Or if valid
> >>> comments added to the docs themselves?
> >>>
> >>> http://www.postgresql.org/docs/8.1/interactive/sql-copy.html
> >>>
> >>> http://www.postgresql.org/docs/8.0/interactive/sql-copy.html
> >>
> >> No, comments don't roll forward.
> >
> > ...and it's unlikely that they will, now or later, without somebody
> > whose whole job is to monitor those comments and make patches.
> >
> > I'd like to make a Modest Proposal???: Let's take down the interactive
> > documents and, in their place, put up a request that doc patches be
> > sent to -docs.
> >
> > What say?
>
> I say no, because whilst some comments should (and do) end up in the docs,
> many are simply useful real-world code examples and related information that
> people post. It's useful stuff, but would clutter the docs.
But now that stuff gets 'lost' with ever new major version. It'd
probably be better if it was posted somewhere like
http://www.pervasivepostgres.com/instantkb13/
--
Jim C. Nasby, Sr. Engineering Consultant jnasby@pervasive.com
Pervasive Software http://pervasive.com work: 512-231-6117
vcard: http://jim.nasby.net/pervasive.vcf cell: 512-569-9461
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients using the --to and --cc options:
reply via email
To: pgsql-docs@postgresql.org
Cc: jnasby@pervasive.com, dpage@vale-housing.co.uk, david@fetter.org, me@oisinglynn.com, pgsql-general@postgresql.org
Subject: Re: [GENERAL] COPY command documentation
In-Reply-To: <20060324122809.GX90527@pervasive.com>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox