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

Re: Get docs for contrib on the web somewhere

From: Robert Treat <xzilla(at)users(dot)sourceforge(dot)net>
To: pgsql-docs(at)postgresql(dot)org
Cc: David Fetter <david(at)fetter(dot)org>, "Jim C(dot) Nasby" <jnasby(at)pervasive(dot)com>
Subject: Re: Get docs for contrib on the web somewhere
Date: 2006-03-17 21:19:58
Message-ID: 200603171619.58860.xzilla@users.sourceforge.net (view raw or flat)
Thread:
Lists: pgsql-docs
On Friday 17 March 2006 13:40, David Fetter wrote:
> On Fri, Mar 17, 2006 at 12:22:44PM -0600, Jim C. Nasby wrote:
> > On Wed, Mar 08, 2006 at 02:05:44PM -0800, David Fetter wrote:
> > > On Wed, Mar 08, 2006 at 01:50:47PM -0600, Jim C. Nasby wrote:
> > > > It would be nice if there was an easy place to see the documentation
> > > > for the various contrib projects.  Would this be hard to setup?  I
> > > > think the plain text would be fine, just need to post the readme's
> > > > somewhere and link to them.
> > >
> > > http://developer.postgresql.org/cvsweb.cgi/pgsql/contrib/ has at least
> > > the raw files.  I'd be delighted to put up something more, tho :)
> >
> > Yeah, but very few people would ever think to look in CVS for
> > documentation. I think it'd be much better if we could include the
> > README's in the documentation build process somehow...
>
> I'm all for it.  Do you have an idea of how this might work?  I
> suppose some kind of idiot conversion of READMEs to man pages might be
> appropriate.  Dunno about what would happen on Windows.  Um, help?
>

Could we require contrib authors to provide their documentation as sgml, and 
then have the doc build process loop in each contrib module as an appendix 
inside the official docs? 

-- 
Robert Treat
Build A Brighter Lamp :: Linux Apache {middleware} PostgreSQL

In response to

Responses

pgsql-docs by date

Next:From: Jim C. NasbyDate: 2006-03-18 06:31:04
Subject: Re: Get docs for contrib on the web somewhere
Previous:From: David FetterDate: 2006-03-17 18:40:12
Subject: Re: Get docs for contrib on the web somewhere

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