X-Original-To: pgsql-docs-postgresql.org@localhost.postgresql.org Received: from localhost (av.hub.org [200.46.204.144]) by postgresql.org (Postfix) with ESMTP id 72A709DC842 for ; Sat, 18 Mar 2006 03:04:18 -0400 (AST) Received: from postgresql.org ([200.46.204.71]) by localhost (av.hub.org [200.46.204.144]) (amavisd-new, port 10024) with ESMTP id 35639-08 for ; Sat, 18 Mar 2006 03:04:17 -0400 (AST) X-Greylist: from auto-whitelisted by SQLgrey- Received: from sss.pgh.pa.us (sss.pgh.pa.us [66.207.139.130]) by postgresql.org (Postfix) with ESMTP id E30809DC848 for ; Sat, 18 Mar 2006 03:04:15 -0400 (AST) Received: from sss2.sss.pgh.pa.us (tgl@localhost [127.0.0.1]) by sss.pgh.pa.us (8.13.1/8.13.1) with ESMTP id k2I7030t013876; Sat, 18 Mar 2006 02:00:03 -0500 (EST) To: "Jim C. Nasby" cc: Robert Treat , pgsql-docs@postgresql.org, David Fetter Subject: Re: Get docs for contrib on the web somewhere 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> Comments: In-reply-to "Jim C. Nasby" message dated "Sat, 18 Mar 2006 00:31:04 -0600" Date: Sat, 18 Mar 2006 02:00:03 -0500 Message-ID: <13875.1142665203@sss.pgh.pa.us> From: Tom Lane X-Virus-Scanned: by amavisd-new at hub.org X-Spam-Status: No, score=0.113 required=5 tests=[AWL=0.113] X-Spam-Score: 0.113 X-Spam-Level: X-Archive-Number: 200603/19 X-Sequence-Number: 3476 "Jim C. Nasby" 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