Re: Get docs for contrib on the web somewhere - Mailing list pgsql-docs

From Tom Lane
Subject Re: Get docs for contrib on the web somewhere
Date
Msg-id 13875.1142665203@sss.pgh.pa.us
Whole thread Raw
In response to Re: Get docs for contrib on the web somewhere  ("Jim C. Nasby" <jnasby@pervasive.com>)
Responses Re: Get docs for contrib on the web somewhere  (Robert Treat <xzilla@users.sourceforge.net>)
List pgsql-docs
"Jim C. Nasby" <jnasby@pervasive.com> writes:
> On Fri, Mar 17, 2006 at 04:19:58PM -0500, Robert Treat wrote:
>> 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?

> Can't we just copy the text files over somewhere?

I think the entire point of contrib is that it's "not ready for prime
time" code, and one of the ways in which it's likely to be not ready
is not having sgml-format documentation.

If someone wants to step up and do the work to convert the existing
contrib doc files to sgml, I certainly won't stand in the way --- but
I'm not prepared to remove contrib entries just because they don't have
sgml-format docs.

            regards, tom lane

pgsql-docs by date:

Previous
From: "Jim C. Nasby"
Date:
Subject: Re: Get docs for contrib on the web somewhere
Next
From: Robert Treat
Date:
Subject: Re: Get docs for contrib on the web somewhere