From: Robert Treat <xzilla@users.sourceforge.net>
To: pgsql-docs@postgresql.org
Subject: Re: Get docs for contrib on the web somewhere
Date: Fri, 17 Mar 2006 16:19:58 -0500
User-Agent: KMail/1.8.3
Cc: David Fetter <david@fetter.org>,
 "Jim C. Nasby" <jnasby@pervasive.com>
References: <20060308195047.GI45250@pervasive.com>
	<20060317182244.GE15742@pervasive.com>
	<20060317184012.GA11869@fetter.org>
In-Reply-To: <20060317184012.GA11869@fetter.org>
MIME-Version: 1.0
Content-Type: text/plain;
  charset="iso-8859-1"
Content-Transfer-Encoding: 7bit
Content-Disposition: inline
Message-Id: <200603171619.58860.xzilla@users.sourceforge.net>

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