Received: from localhost (unknown [200.46.204.187])
	by postgresql.org (Postfix) with ESMTP id 0E73D9F9B2F
	for <pgsql-docs-postgresql.org@postgresql.org>;
	Sun, 14 Oct 2007 20:49:24 -0300 (ADT)
Received: from postgresql.org ([200.46.204.71])
	by localhost (mx1.hub.org [200.46.204.187]) (amavisd-maia, port 10024)
	with ESMTP id 36051-06 for <pgsql-docs-postgresql.org@postgresql.org>;
	Sun, 14 Oct 2007 20:48:07 -0300 (ADT)
X-Greylist: from auto-whitelisted by SQLgrey-1.7.5
Received: from k2smtpout05-01.prod.mesa1.secureserver.net
	(k2smtpout05-01.prod.mesa1.secureserver.net [64.202.189.56])
	by postgresql.org (Postfix) with SMTP id 8C4889F9B19
	for <pgsql-docs@postgresql.org>; Sun, 14 Oct 2007 20:48:41 -0300 (ADT)
Received: (qmail 22174 invoked from network); 14 Oct 2007 23:48:40 -0000
Received: from unknown (HELO mail.cowdot.com) (208.109.83.21)
	by k2smtpout05-01.prod.mesa1.secureserver.net (64.202.189.56) with
	ESMTP; 14 Oct 2007 23:48:39 -0000
Received: by mail.cowdot.com (Postfix, from userid 99)
	id 8DDCE2A8F22; Sun, 14 Oct 2007 16:48:31 -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 D81F02A8F22;
	Sun, 14 Oct 2007 16:48:26 -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: Mon, 15 Oct 2007 01:48:55 +0200
User-Agent: KMail/1.9.7
Cc: pgsql-docs@postgresql.org
References: <200710102315.50067.albert@nan-tic.com>
	<200710142017.53672.albert@nan-tic.com>
	<200710142333.34257.peter_e@gmx.net>
In-Reply-To: <200710142333.34257.peter_e@gmx.net>
MIME-Version: 1.0
Content-Type: text/plain;
  charset="iso-8859-15"
Content-Transfer-Encoding: 7bit
Content-Disposition: inline
Message-Id: <200710150148.56413.albert@nan-tic.com>
X-Virus-Scanned: Maia Mailguard 1.0.1
X-Archive-Number: 200710/48
X-Sequence-Number: 4469

A Diumenge 14 Octubre 2007, Peter Eisentraut va escriure:
> Albert Cervera i Areny wrote:
> > The problem is that if we want these docs in the Reference section of
> > the documentation right after "PostgreSQL Server Applications" they
> > can't be chapters nor sections, they need to be <refentry>'s.
>
> That is not true, AFAICT.  What do you base this assertion on?

You're right, that's not exactly true:

Reference is a Part. If we still want contrib inside Reference, contrib can be 
a <chapter>, <reference> or other elements defined at 
http://www.docbook.org/tdg5/en/html/part.html. But I cant' make the contrib 
section a <part> inside reference (that means no chapter per module!).

If I make it a chapter the numbering inside Reference becomes:

"I. SQL Commands"
"II. PostgreSQL Client Applications"
"III. PostgreSQL Server Applications"
"43. Standard Modules"

Not sure if that's a problem, but that's why I'm asking. That allows, however, 
having each contrib module in a section in this chapter and thus fits in one 
page.

Though I agree I should concentrate on content, not style, having lots of very 
small pages isn't very nice either. You can see that in the docs I have 
online. In that case each module is a chapter as Tom suggests and it's a 
completely new Part after "Internals"

IMHO having it in reference would make sense if contrib docs where organized 
like, well... references but that's not the case for most of them. After all 
you need some introduction to the module, some examples, etc.


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