Received: from localhost (unknown [200.46.204.184])
	by postgresql.org (Postfix) with ESMTP id 8F3589FC06D
	for <pgsql-docs-postgresql.org@postgresql.org>;
	Fri, 12 Oct 2007 15:05:26 -0300 (ADT)
Received: from postgresql.org ([200.46.204.71])
	by localhost (mx1.hub.org [200.46.204.184]) (amavisd-maia, port 10024)
	with ESMTP id 88060-01-7 for <pgsql-docs-postgresql.org@postgresql.org>;
	Fri, 12 Oct 2007 15:04:40 -0300 (ADT)
X-Greylist: from auto-whitelisted by SQLgrey-1.7.5
Received: from k2smtpout01-01.prod.mesa1.secureserver.net
	(k2smtpout01-02.prod.mesa1.secureserver.net [64.202.189.89])
	by postgresql.org (Postfix) with SMTP id BA9B19FC0B0
	for <pgsql-docs@postgresql.org>; Fri, 12 Oct 2007 15:04:42 -0300 (ADT)
Received: (qmail 32594 invoked from network); 12 Oct 2007 18:04:41 -0000
Received: from unknown (HELO mail.cowdot.com) (208.109.83.21)
	by k2smtpout01-01.prod.mesa1.secureserver.net (64.202.189.88) with
	ESMTP; 12 Oct 2007 18:04:41 -0000
Received: by mail.cowdot.com (Postfix, from userid 99)
	id 90A222A99B2; Fri, 12 Oct 2007 11:04:24 -0700 (MST)
Received: from albert.local (111.pool85-52-225.static.orange.es
	[85.52.225.111])
	by mail.cowdot.com (Postfix) with ESMTP id C7D562A99A2;
	Fri, 12 Oct 2007 11:04:20 -0700 (MST)
From: Albert Cervera i Areny <albert@nan-tic.com>
Organization: NaN
To: Peter Eisentraut <peter_e@gmx.net>
Subject: Re: Tips needed for contrib doc
Date: Fri, 12 Oct 2007 20:04:44 +0200
User-Agent: KMail/1.9.7
Cc: pgsql-docs@postgresql.org
References: <200710102315.50067.albert@nan-tic.com>
	<200710121947.15037.peter_e@gmx.net>
In-Reply-To: <200710121947.15037.peter_e@gmx.net>
MIME-Version: 1.0
Content-Type: text/plain;
  charset="iso-8859-15"
Content-Transfer-Encoding: 8bit
Content-Disposition: inline
Message-Id: <200710122004.44884.albert@nan-tic.com>
X-Virus-Scanned: Maia Mailguard 1.0.1
X-Archive-Number: 200710/41
X-Sequence-Number: 4462

Not that I want to make each module a reference. With previous discussions we 
seemed to agree that:

- It should go into the References part of the documentation (right 
after "III. PostgreSQL Server Applications).
- Each module docs should be in a single page, mainly because some contrib 
modules have/require very little documentation.

So it seems that the only way of achieving both things is to make each contrib 
module a <refentry> inside a new <reference id="contrib">. I don't like this 
idea, among other things because dblink won't be abe to be treated as a 
<reference> which I think is appropiate in this case.

If you've got another solution for this, it'll be very welcome!

A Divendres 12 Octubre 2007, Peter Eisentraut va escriure:
> Am Mittwoch, 10. Oktober 2007 schrieb Albert Cervera i Areny:
> >         - I can't make this "contrib" doc a part because Reference
> > already is a part and can't be nested.
>
> The Reference things in DocBook are mostly to support legacy man pages, and
> man pages are not necessary the greatest format to document everything. 
> What is your reason that you want this as a reference rather than a part
> with chapters?



-- 
Albert Cervera i Areny
http://www.NaN-tic.com