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 D7C859DC87C for ; Sat, 18 Mar 2006 02:31:09 -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 31751-02 for ; Sat, 18 Mar 2006 02:31:09 -0400 (AST) X-Greylist: from auto-whitelisted by SQLgrey- Received: from noel.decibel.org (noel.decibel.org [67.100.216.10]) by postgresql.org (Postfix) with ESMTP id 5A8309DC87B for ; Sat, 18 Mar 2006 02:31:07 -0400 (AST) Received: by noel.decibel.org (Postfix, from userid 1001) id 86C3556423; Sat, 18 Mar 2006 00:31:05 -0600 (CST) Received: (hashcash-sendmail, from uid 1001); Sat, 18 Mar 2006 00:31:04 -0600 Date: Sat, 18 Mar 2006 00:31:04 -0600 From: "Jim C. Nasby" To: Robert Treat Cc: pgsql-docs@postgresql.org, David Fetter Subject: Re: Get docs for contrib on the web somewhere Message-ID: <20060318063104.GF15742@pervasive.com> References: <20060308195047.GI45250@pervasive.com> <20060317182244.GE15742@pervasive.com> <20060317184012.GA11869@fetter.org> <200603171619.58860.xzilla@users.sourceforge.net> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <200603171619.58860.xzilla@users.sourceforge.net> X-Operating-System: FreeBSD 6.0-RELEASE-p4 amd64 X-Distributed: Join the Effort! http://www.distributed.net User-Agent: Mutt/1.5.11 X-Hashcash: 1:20:060318:xzilla@users.sourceforge.net::Ae3lI8PShi9CU3jn:000000000 0000000000000000000000000LlM X-Hashcash: 1:20:060318:pgsql-docs@postgresql.org::GJWtROS2EzjmJY+1:000000000000 0000000000000000000000000BQg X-Hashcash: 1:20:060318:david@fetter.org::AiI/FXIzeZEro3AC:07CCK X-Virus-Scanned: by amavisd-new at hub.org X-Spam-Status: No, score=0.108 required=5 tests=[AWL=0.108] X-Spam-Score: 0.108 X-Spam-Level: X-Archive-Number: 200603/18 X-Sequence-Number: 3475 On Fri, Mar 17, 2006 at 04:19:58PM -0500, Robert Treat wrote: > > > 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? Can't we just copy the text files over somewhere? Actually, there was talk of improving the way that the contrib installs handled the README's, so maybe part of that could be used here. -- Jim C. Nasby, Sr. Engineering Consultant jnasby@pervasive.com Pervasive Software http://pervasive.com work: 512-231-6117 vcard: http://jim.nasby.net/pervasive.vcf cell: 512-569-9461