Received: from localhost (unknown [200.46.204.183])
	by postgresql.org (Postfix) with ESMTP id 1D0109FB62A
	for <pgsql-docs-postgresql.org@postgresql.org>;
	Wed, 10 Oct 2007 18:16:09 -0300 (ADT)
Received: from postgresql.org ([200.46.204.71])
	by localhost (mx1.hub.org [200.46.204.183]) (amavisd-maia, port 10024)
	with ESMTP id 54336-10 for <pgsql-docs-postgresql.org@postgresql.org>;
	Wed, 10 Oct 2007 18:16:00 -0300 (ADT)
X-Greylist: from auto-whitelisted by SQLgrey-1.7.5
Received: from k2smtpout02-02.prod.mesa1.secureserver.net
	(k2smtpout02-02.prod.mesa1.secureserver.net [64.202.189.91])
	by postgresql.org (Postfix) with SMTP id E60E99FB573
	for <pgsql-docs@postgresql.org>; Wed, 10 Oct 2007 18:15:59 -0300 (ADT)
Received: (qmail 17355 invoked from network); 10 Oct 2007 21:15:57 -0000
Received: from unknown (HELO mail.cowdot.com) (208.109.83.21)
	by k2smtpout02-02.prod.mesa1.secureserver.net (64.202.189.91) with
	ESMTP; 10 Oct 2007 21:15:56 -0000
Received: by mail.cowdot.com (Postfix, from userid 99)
	id 8302D2A8E2C; Wed, 10 Oct 2007 14:15:53 -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 244282A8E0A
	for <pgsql-docs@postgresql.org>; Wed, 10 Oct 2007 14:15:50 -0700 (MST)
From: Albert Cervera i Areny <albert@nan-tic.com>
Organization: NaN
To: pgsql-docs@postgresql.org
Subject: Tips needed for contrib doc
Date: Wed, 10 Oct 2007 23:15:49 +0200
User-Agent: KMail/1.9.7
MIME-Version: 1.0
Content-Type: text/plain;
  charset="iso-8859-15"
Content-Transfer-Encoding: 7bit
Content-Disposition: inline
Message-Id: <200710102315.50067.albert@nan-tic.com>
X-Virus-Scanned: Maia Mailguard 1.0.1
X-Archive-Number: 200710/34
X-Sequence-Number: 4455

Hi,
	I wanted to spend a week or so putting the contrib doc into shape so I want 
to start by moving the contrib part from a new appendix to the Reference 
part.
	The problems I find are:
	- I can't make this "contrib" doc a part because Reference already is a part 
and can't be nested.
	Structure:
	<part id="reference">
		<part id="contrib">
		
	- If I make the contrib doc a chapter in the index shows with an arabic 
number not as a roman one.
	Structure:
	<part id="reference">
		<chapter id="contrib">

	- I can't make the doc a <reference> because first I need to point to the 
modules and not all of them are documented like a reference.
	Structure:
	<part id="reference">
		<reference id="contrib">

	- If I leave it as it is now [1] the problem is that very small chapters just 
don't look right IMHO. Take a look at [2], for example. It should be a module 
per page in most cases except very long ones.
	Structure:
	<part id="contrib">
		<chapter id="adminpack">

Does anyone have a solution on this? I'm no docbook expert, so I might be very 
wrong.

[1] You can find the current state at 
http://www.nan-tic.com/ftp/pgdoc-0.0.2/index.html
[2] http://www.nan-tic.com/ftp/pgdoc-0.0.2/adminpack.html

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