Re: Code examples

From: Oleg Bartunov <oleg(at)sai(dot)msu(dot)su>
To: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
Cc: Alvaro Herrera <alvherre(at)commandprompt(dot)com>, Peter Eisentraut <peter_e(at)gmx(dot)net>, pgsql-docs(at)postgresql(dot)org, Decibel! <decibel(at)decibel(dot)org>, Pavel Stehule <pavel(dot)stehule(at)gmail(dot)com>
Subject: Re: Code examples
Date: 2007-09-04 16:37:47
Message-ID: Pine.LNX.4.64.0709042033511.2767@sn.sai.msu.ru
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs pgsql-hackers

On Tue, 4 Sep 2007, Tom Lane wrote:

> Alvaro Herrera <alvherre(at)commandprompt(dot)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(at)sai(dot)msu(dot)su, http://www.sai.msu.su/~megera/
phone: +007(495)939-16-83, +007(495)939-23-83

In response to

Browse pgsql-docs by date

  From Date Subject
Next Message Oleg Bartunov 2007-09-09 04:38:37 Re: tsearch filenames unlikes special symbols and numbers
Previous Message Tom Lane 2007-09-04 16:19:14 Re: Code examples

Browse pgsql-hackers by date

  From Date Subject
Next Message Andrew Dunstan 2007-09-04 16:46:19 Re: [HACKERS] enum types and binary queries
Previous Message Cédric Villemain 2007-09-04 16:22:35 pg_dump and insert multi-rows option