X-Original-To: pgsql-docs-postgresql.org@localhost.postgresql.org Received: from localhost (av.hub.org [200.46.204.144]) by postgresql.org (Postfix) with ESMTP id 1C8069DC842; Fri, 24 Mar 2006 08:28:10 -0400 (AST) Received: from postgresql.org ([200.46.204.71]) by localhost (av.hub.org [200.46.204.144]) (amavisd-new, port 10024) with ESMTP id 94579-09; Fri, 24 Mar 2006 08:28:12 -0400 (AST) X-Greylist: from auto-whitelisted by SQLgrey- X-Greylist: from auto-whitelisted by SQLgrey- Received: from noel.decibel.org (noel.decibel.org [67.100.216.10]) by postgresql.org (Postfix) with ESMTP id 830FD9DC804; Fri, 24 Mar 2006 08:28:07 -0400 (AST) Received: by noel.decibel.org (Postfix, from userid 1001) id C2FCA56423; Fri, 24 Mar 2006 06:28:10 -0600 (CST) Received: (hashcash-sendmail, from uid 1001); Fri, 24 Mar 2006 06:28:09 -0600 Date: Fri, 24 Mar 2006 06:28:09 -0600 From: "Jim C. Nasby" To: Dave Page Cc: David Fetter , Oisin Glynn , pgsql general , PostgreSQL Docs Subject: Re: [GENERAL] COPY command documentation Message-ID: <20060324122809.GX90527@pervasive.com> References: <20060323201250.GC6106@fetter.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: X-Operating-System: FreeBSD 6.0-RELEASE-p4 amd64 X-Distributed: Join the Effort! http://www.distributed.net User-Agent: Mutt/1.5.11 X-Hashcash: 1:20:060324:dpage@vale-housing.co.uk::9yXseBjkQtV+2IDm:0000000000000 0000000000000000000000002oy2 X-Hashcash: 1:20:060324:david@fetter.org::PM2YQvZtkaOuUzdM:02/Qe X-Hashcash: 1:20:060324:me@oisinglynn.com::jG0PPdd+46R5hrh8:00000000000000000000 0000000000000000000000000gZr X-Hashcash: 1:20:060324:pgsql-general@postgresql.org::c0U+/BqrM9/Qq6/4:000000000 00000000000000000000000015+D X-Hashcash: 1:20:060324:pgsql-docs@postgresql.org::cmWF1ztUHUKm7WTx:000000000000 0000000000000000000000005P7z X-Virus-Scanned: by amavisd-new at hub.org X-Spam-Status: No, score=0.108 required=5 tests=[AWL=0.108] X-Spam-Score: 0.108 X-Spam-Level: X-Archive-Number: 200603/40 X-Sequence-Number: 3497 On Fri, Mar 24, 2006 at 08:58:55AM +0000, Dave Page wrote: > On 23/3/06 20:12, "David Fetter" 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