Skip site navigation (1) Skip section navigation (2)

Re: Suggestion on reorganizing functions

From: Rod Taylor <pg(at)rbt(dot)ca>
To: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
Cc: Jeff <threshar(at)torgo(dot)978(dot)org>,PostgreSQL Docs <pgsql-docs(at)postgresql(dot)org>
Subject: Re: Suggestion on reorganizing functions
Date: 2004-08-09 20:52:45
Message-ID: 1092084764.799.59.camel@jester (view raw or flat)
Thread:
Lists: pgsql-docs
On Mon, 2004-08-09 at 16:39, Tom Lane wrote:
> Jeff <threshar(at)torgo(dot)978(dot)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.



In response to

Responses

pgsql-docs by date

Next:From: Josh BerkusDate: 2004-08-09 20:53:59
Subject: Re: PostgreSQL.conf / runtime docs
Previous:From: Tom LaneDate: 2004-08-09 20:39:43
Subject: Re: Suggestion on reorganizing functions

Privacy Policy | About PostgreSQL
Copyright © 1996-2014 The PostgreSQL Global Development Group