Received: from localhost (unknown [200.46.204.187])
	by postgresql.org (Postfix) with ESMTP id 3F1A49F9E91
	for <pgsql-docs-postgresql.org@postgresql.org>;
	Sun, 14 Oct 2007 16:06:01 -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 50088-02-9 for <pgsql-docs-postgresql.org@postgresql.org>;
	Sun, 14 Oct 2007 16:05:24 -0300 (ADT)
X-Greylist: from auto-whitelisted by SQLgrey-1.7.5
Received: from sss.pgh.pa.us (sss.pgh.pa.us [66.207.139.130])
	by postgresql.org (Postfix) with ESMTP id DAE039F9F61
	for <pgsql-docs@postgresql.org>; Sun, 14 Oct 2007 16:05:52 -0300 (ADT)
Received: from sss2.sss.pgh.pa.us (tgl@localhost [127.0.0.1])
	by sss.pgh.pa.us (8.14.1/8.14.1) with ESMTP id l9EJ5kYq003003;
	Sun, 14 Oct 2007 15:05:46 -0400 (EDT)
To: Albert Cervera i Areny <albert@nan-tic.com>
cc: Peter Eisentraut <peter_e@gmx.net>, pgsql-docs@postgresql.org
Subject: Re: Tips needed for contrib doc 
In-reply-to: <200710142017.53672.albert@nan-tic.com> 
References: <200710102315.50067.albert@nan-tic.com>
	<200710122004.44884.albert@nan-tic.com>
	<200710141505.14690.peter_e@gmx.net>
	<200710142017.53672.albert@nan-tic.com>
Comments: In-reply-to Albert Cervera i Areny <albert@nan-tic.com>
	message dated "Sun, 14 Oct 2007 20:17:53 +0200"
Date: Sun, 14 Oct 2007 15:05:46 -0400
Message-ID: <3002.1192388746@sss.pgh.pa.us>
From: Tom Lane <tgl@sss.pgh.pa.us>
X-Virus-Scanned: Maia Mailguard 1.0.1
X-Archive-Number: 200710/46
X-Sequence-Number: 4467

Albert Cervera i Areny <albert@nan-tic.com> writes:
> 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's the problem...

In any case one would think that each contrib module should be at the
same logical level in the docs --- if some of them are only sections,
what chapter are they inside of?

One point here is that a lot of the contrib material is not really
written in reference style anyway.  I wonder if the best solution is
to make it a separate <part>, with each contrib module being a
<chapter>, and then sections and subsections if needed.

			regards, tom lane