Subject: Re: Suggestion on reorganizing functions
From: Rod Taylor <pg@rbt.ca>
To: Tom Lane <tgl@sss.pgh.pa.us>
Cc: Jeff <threshar@torgo.978.org>, PostgreSQL Docs <pgsql-docs@postgresql.org>
In-Reply-To: <19661.1092083983@sss.pgh.pa.us>
References: <6B84FBA0-EA28-11D8-A672-000D9366F0C4@torgo.978.org>
	<19661.1092083983@sss.pgh.pa.us>
Content-Type: text/plain
Message-Id: <1092084764.799.59.camel@jester>
Mime-Version: 1.0
Date: Mon, 09 Aug 2004 16:52:45 -0400
Content-Transfer-Encoding: 7bit

On Mon, 2004-08-09 at 16:39, Tom Lane wrote:
> Jeff <threshar@torgo.978.org> writes:
> > One idea to solve it would to have the flat list link to  
> > functions-foo.html#FOOBAR  - this would allow both methods of 
> > organization and only having function definitions in one spot.
> 
> Basically what you're proposing is an index.
> 
> I am not sure if DocBook could handle generating an index covering just
> functions, or if we'd have to merge it with the general index.  If the
> latter then it's pretty much done already.  (We may have missed indexing
> some function descriptions, but certainly a lot of them have an index entry.)

If we were using XML based docbook we could use an xmlinclude to
generate this type of content on the fly during output generation.

The big snag is that XML Docbook does not produce very nice printable
documents without a rather expensive toolkit.