From: Tom Lane <tgl@sss.pgh.pa.us>
To: Jim C. Nasby <jnasby@pervasive.com>
Cc: Robert Treat <xzilla@users.sourceforge.net>
Cc: pgsql-docs@postgresql.org, David Fetter <david@fetter.org>
Subject: Re: Get docs for contrib on the web somewhere
Date: Sat, 18 Mar 2006 02:00:03 -0500
Message-ID: <13875.1142665203@sss.pgh.pa.us> (raw)
In-Reply-To: <20060318063104.GF15742@pervasive.com>
References: <20060308195047.GI45250@pervasive.com>
<20060317182244.GE15742@pervasive.com>
<20060317184012.GA11869@fetter.org>
<200603171619.58860.xzilla@users.sourceforge.net>
<20060318063104.GF15742@pervasive.com>
"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
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: tgl@sss.pgh.pa.us, jnasby@pervasive.com, xzilla@users.sourceforge.net, david@fetter.org
Subject: Re: Get docs for contrib on the web somewhere
In-Reply-To: <13875.1142665203@sss.pgh.pa.us>
* 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