Re: [PATCHES] Contrib docs v1

Поиск
Список
Период
Сортировка
От Bruce Momjian
Тема Re: [PATCHES] Contrib docs v1
Дата
Msg-id 200711111816.lABIGdU15448@momjian.us
обсуждение исходный текст
Ответ на Re: [PATCHES] Contrib docs v1  (Tom Lane <tgl@sss.pgh.pa.us>)
Ответы Re: [PATCHES] Contrib docs v1  (Tom Lane <tgl@sss.pgh.pa.us>)
Список pgsql-docs
Tom Lane wrote:
> Bruce Momjian <bruce@momjian.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@momjian.us>        http://momjian.us
  EnterpriseDB                             http://postgres.enterprisedb.com

  + If your life is a hard drive, Christ can be your backup. +

В списке pgsql-docs по дате отправления:

Предыдущее
От: Tom Lane
Дата:
Сообщение: Re: [PATCHES] Contrib docs v1
Следующее
От: Tom Lane
Дата:
Сообщение: Re: [PATCHES] Contrib docs v1