Skip site navigation (1) Skip section navigation (2)

Re: [PATCHES] Contrib docs v1

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 (view raw or flat)
Thread:
Lists: pgsql-docspgsql-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. +

In response to

Responses

pgsql-docs by date

Next:From: Tom LaneDate: 2007-11-11 19:29:35
Subject: Re: [PATCHES] Contrib docs v1
Previous:From: Tom LaneDate: 2007-11-11 15:42:17
Subject: Re: [PATCHES] Contrib docs v1

pgsql-patches by date

Next:From: Tom LaneDate: 2007-11-11 19:29:35
Subject: Re: [PATCHES] Contrib docs v1
Previous:From: Tom LaneDate: 2007-11-11 15:42:17
Subject: Re: [PATCHES] Contrib docs v1

Privacy Policy | About PostgreSQL
Copyright © 1996-2014 The PostgreSQL Global Development Group