User-Agent: Microsoft-Entourage/11.2.3.060209
Date: Fri, 24 Mar 2006 08:58:55 +0000
Subject: Re: COPY command documentation
From: Dave Page <dpage@vale-housing.co.uk>
To: David Fetter <david@fetter.org>,
	Jim Nasby <jnasby@pervasive.com>
CC: Oisin Glynn <me@oisinglynn.com>,
	pgsql general <pgsql-general@postgresql.org>,
	PostgreSQL Docs <pgsql-docs@postgresql.org>
Message-ID: <C049654F.88A3%dpage@vale-housing.co.uk>
Thread-Topic: [GENERAL] COPY command documentation
Thread-Index: AcZOtkEIe8OH1KAyQcKrk5HX5mmmYgAauzqL
In-Reply-To: <20060323201250.GC6106@fetter.org>
Mime-version: 1.0
Content-type: text/plain;
	charset="ISO-8859-1"
Content-transfer-encoding: quoted-printable


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:
>>=20
>>> 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?
>>>=20
>>> http://www.postgresql.org/docs/8.1/interactive/sql-copy.html
>>>=20
>>> http://www.postgresql.org/docs/8.0/interactive/sql-copy.html
>>=20
>> No, comments don't roll forward.
>=20
> ...and it's unlikely that they will, now or later, without somebody
> whose whole job is to monitor those comments and make patches.
>=20
> I'd like to make a Modest Proposal=E2=84=A2:  Let's take down the interactive
> documents and, in their place, put up a request that doc patches be
> sent to -docs.
>=20
> 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 tha=
t
people post. It's useful stuff, but would clutter the docs.

Regards, Dave.