From: Dave Page <dpage@vale-housing.co.uk>
To: David Fetter <david@fetter.org>
To: Jim Nasby <jnasby@pervasive.com>
Cc: Oisin Glynn <me@oisinglynn.com>
Cc: pgsql general <pgsql-general@postgresql.org>
Cc: PostgreSQL Docs <pgsql-docs@postgresql.org>
Subject: Re: COPY command documentation
Date: Fri, 24 Mar 2006 08:58:55 +0000
Message-ID: <C049654F.88A3%dpage@vale-housing.co.uk> (raw)
In-Reply-To: <20060323201250.GC6106@fetter.org>
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.
Regards, Dave.
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: dpage@vale-housing.co.uk, david@fetter.org, jnasby@pervasive.com, me@oisinglynn.com, pgsql-general@postgresql.org
Subject: Re: COPY command documentation
In-Reply-To: <C049654F.88A3%dpage@vale-housing.co.uk>
* 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