From: | Bruce Momjian <bruce(at)momjian(dot)us> |
---|---|
To: | Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us> |
Cc: | Albert Cervera i Areny <albert(at)nan-tic(dot)com>, PostgreSQL-documentation <pgsql-docs(at)postgresql(dot)org> |
Subject: | Re: [PATCHES] Contrib docs v1 |
Date: | 2007-11-11 18:16:39 |
Message-ID: | 200711111816.lABIGdU15448@momjian.us |
Views: | Raw Message | Whole Thread | Download mbox | Resend email |
Thread: | |
Lists: | pgsql-docs pgsql-patches |
Tom Lane wrote:
> Bruce Momjian <bruce(at)momjian(dot)us> writes:
> > Uh, don't start converting them yet. I now realize that
> > /contrib/dict_int is an example and just like the stuff in /contrib/spi
> > perhaps shouldn't have its docs moved to SGML.
>
> What makes you realize any such thing? You could make that argument for
> test_parser, probably, but the dict modules are useful in their own
> right.
>
> > Should we leave example /contrib modules documented in READMEs?
>
> What is the point of such a distinction?
If the contrib value is the source code itself then it seems a README is
more appropriate as people are not going to install the contrib module
itself --- they are using it only to learn.
--
Bruce Momjian <bruce(at)momjian(dot)us> http://momjian.us
EnterpriseDB http://postgres.enterprisedb.com
+ If your life is a hard drive, Christ can be your backup. +
From | Date | Subject | |
---|---|---|---|
Next Message | Tom Lane | 2007-11-11 19:29:35 | Re: [PATCHES] Contrib docs v1 |
Previous Message | Tom Lane | 2007-11-11 15:42:17 | Re: [PATCHES] Contrib docs v1 |
From | Date | Subject | |
---|---|---|---|
Next Message | Tom Lane | 2007-11-11 19:29:35 | Re: [PATCHES] Contrib docs v1 |
Previous Message | Tom Lane | 2007-11-11 15:42:17 | Re: [PATCHES] Contrib docs v1 |