Re: Code examples - Mailing list pgsql-docs

From Oleg Bartunov
Subject Re: Code examples
Date
Msg-id Pine.LNX.4.64.0709042033511.2767@sn.sai.msu.ru
Whole thread Raw
In response to Re: Code examples  (Tom Lane <tgl@sss.pgh.pa.us>)
List pgsql-docs
On Tue, 4 Sep 2007, Tom Lane wrote:

> Alvaro Herrera <alvherre@commandprompt.com> writes:
>> Maybe we could set things up so that there are actual files which are
>> programatically preprocessed to SGML to be included in the docs?  That
>> way, the docs always reflect the actual file, which by itself is
>> compilable.  The SGML source would only contain something like
>> <include file="examples/foo.c" /> or something like that.
>
> Well, if we have actual contrib modules (which is still a good idea
> so that they get tested on a regular basis), I don't see any need to
> copy the code into the docs at all.  The docs should just say "a working
> example can be found in contrib/whatever".

I thin Tom is right. We already have many user's dictionaries which
would be worth to distribute.

>
>             regards, tom lane
>

     Regards,
         Oleg
_____________________________________________________________
Oleg Bartunov, Research Scientist, Head of AstroNet (www.astronet.ru),
Sternberg Astronomical Institute, Moscow University, Russia
Internet: oleg@sai.msu.su, http://www.sai.msu.su/~megera/
phone: +007(495)939-16-83, +007(495)939-23-83

pgsql-docs by date:

Previous
From: Tom Lane
Date:
Subject: Re: Code examples
Next
From: Josh Berkus
Date:
Subject: Improve doc: RETURNING and RULES