X-Original-To: pgsql-general-postgresql.org@localhost.postgresql.org
Received: from localhost (av.hub.org [200.46.204.144])
	by postgresql.org (Postfix) with ESMTP id 9ADD19DC9D4;
	Thu, 23 Mar 2006 16:49:42 -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 25687-03; Thu, 23 Mar 2006 16:49:42 -0400 (AST)
X-Greylist: from auto-whitelisted by SQLgrey-
X-Greylist: from auto-whitelisted by SQLgrey-
Received: from svana.org (svana.org [125.62.94.225])
	by postgresql.org (Postfix) with ESMTP id 04DFD9DC9D6;
	Thu, 23 Mar 2006 16:49:38 -0400 (AST)
Received: from kleptog by svana.org with local (Exim 4.50)
	id 1FMWkS-0006PM-37; Fri, 24 Mar 2006 07:49:36 +1100
Date: Thu, 23 Mar 2006 21:49:36 +0100
From: Martijn van Oosterhout <kleptog@svana.org>
To: Oisin Glynn <me@oisinglynn.com>
Cc: pgsql general <pgsql-general@postgresql.org>,
	PostgreSQL Docs <pgsql-docs@postgresql.org>
Subject: Re: [DOCS] COPY command documentation
Message-ID: <20060323204936.GD17969@svana.org>
Reply-To: Martijn van Oosterhout <kleptog@svana.org>
Mail-Followup-To: Oisin Glynn <me@oisinglynn.com>,
	pgsql general <pgsql-general@postgresql.org>,
	PostgreSQL Docs <pgsql-docs@postgresql.org>
References: <4422B9F8.60100@oisinglynn.com>
	<483F344B-FF17-4DC5-8922-775213566788@pervasive.com>
	<20060323201250.GC6106@fetter.org>
	<1143144857.17999.89.camel@state.g2switchworks.com>
	<442305AE.4010507@oisinglynn.com>
Mime-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-sha1;
	protocol="application/pgp-signature"; boundary="n2Pv11Ogg/Ox8ay5"
Content-Disposition: inline
In-Reply-To: <442305AE.4010507@oisinglynn.com>
X-PGP-Key-ID: Length=1024; ID=0x0DC67BE6
X-PGP-Key-Fingerprint: 295F A899 A81A 156D B522  48A7 6394 F08A 0DC6 7BE6
X-PGP-Key-URL: <http://svana.org/kleptog/0DC67BE6.pgp.asc>
User-Agent: Mutt/1.5.9i
X-SA-Exim-Connect-IP: <locally generated>
X-SA-Exim-Mail-From: kleptog@svana.org
X-SA-Exim-Scanned: No (on svana.org); SAEximRunCond expanded to false
X-Virus-Scanned: by amavisd-new at hub.org
X-Spam-Status: No, score=0.124 required=5 tests=[AWL=0.124]
X-Spam-Score: 0.124
X-Spam-Level: 
X-Archive-Number: 200603/1108
X-Sequence-Number: 92973


--n2Pv11Ogg/Ox8ay5
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

On Thu, Mar 23, 2006 at 03:31:42PM -0500, Oisin Glynn wrote:
> I am a Windows only developer (for my sins) and to be honest we are=20
> using postgres allot and are impressed by it but the *NIX centric=20
> examples in the docs can sometimes be a challenge, if there is a clear=20
> difference between Windows/*NIX operation and it is not obvious what the=
=20
> Windows equivalent is then there should be a Windows example or a note=20
> within the example explaining the difference.

You're right, but the number of UNIX developers here far exceeds the
number of Windows developers. Most UNIX developers (like me) would have
absolutly no idea which examples would not translate obviously to
Windows. For that you need someone experienced in Windows programming
to indicate that.

We could probably use a section in the docs indicating the major
differences. Maybe it's there already, I can't see it straight off.

> Maybe a did you find this note useful button and useful notes get=20
> priority for doc inclusion?

That would be nice, no idea how to implement it though. Maybe even
sharing the comments across version would be good, except that the page
names have changed over time.

> What is the process for submitting a doc patch?  I am sure I should be=20
> asking that on the doc list.

Go to the source tree, edit the SGML files and send the diff to
pgsql-patches.

Have a nice day,
--=20
Martijn van Oosterhout   <kleptog@svana.org>   http://svana.org/kleptog/
> Patent. n. Genius is 5% inspiration and 95% perspiration. A patent is a
> tool for doing 5% of the work and then sitting around waiting for someone
> else to do the other 95% so you can sue them.

--n2Pv11Ogg/Ox8ay5
Content-Type: application/pgp-signature; name="signature.asc"
Content-Description: Digital signature
Content-Disposition: inline

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.1 (GNU/Linux)

iD8DBQFEIwnfIB7bNG8LQkwRAjx3AJ9LivXAHpN7PqgMeHB0fZ0QENfZdQCdG0Ml
jksXj9ugwxGXlj0Y3LOgbCE=
=m4V/
-----END PGP SIGNATURE-----

--n2Pv11Ogg/Ox8ay5--