From: Martijn van Oosterhout <kleptog@svana.org>
To: Oisin Glynn <me@oisinglynn.com>
Cc: pgsql general <pgsql-general@postgresql.org>
Cc: PostgreSQL Docs <pgsql-docs@postgresql.org>
Subject: Re: [DOCS] COPY command documentation
Date: Thu, 23 Mar 2006 21:49:36 +0100
Message-ID: <20060323204936.GD17969@svana.org> (raw)
In-Reply-To: <442305AE.4010507@oisinglynn.com>
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>
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
> using postgres allot and are impressed by it but the *NIX centric
> examples in the docs can sometimes be a challenge, if there is a clear
> difference between Windows/*NIX operation and it is not obvious what the
> Windows equivalent is then there should be a Windows example or a note
> 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
> 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
> 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,
--
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.
Attachments:
signature.asc (application/pgp-signature, 188B) download
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: kleptog@svana.org, me@oisinglynn.com, pgsql-general@postgresql.org
Subject: Re: [DOCS] COPY command documentation
In-Reply-To: <20060323204936.GD17969@svana.org>
* 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