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
Views: Raw Message | Whole Thread | Download mbox | Resend email
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

Browse pgsql-docs by date

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