From: Robert Treat <xzilla@users.sourceforge.net>
To: pgsql-docs@postgresql.org
Cc: David Fetter <david@fetter.org>
Cc: Jim C. Nasby <jnasby@pervasive.com>
Subject: Re: Get docs for contrib on the web somewhere
Date: Fri, 17 Mar 2006 16:19:58 -0500
Message-ID: <200603171619.58860.xzilla@users.sourceforge.net> (raw)
In-Reply-To: <20060317184012.GA11869@fetter.org>
References: <20060308195047.GI45250@pervasive.com>
<20060317182244.GE15742@pervasive.com>
<20060317184012.GA11869@fetter.org>
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
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients using the --to and --cc options:
reply via email
To: pgsql-docs@postgresql.org
Cc: xzilla@users.sourceforge.net, david@fetter.org, jnasby@pervasive.com
Subject: Re: Get docs for contrib on the web somewhere
In-Reply-To: <200603171619.58860.xzilla@users.sourceforge.net>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox