public inbox for [email protected]
help / color / mirror / Atom feedFrom: Jeff <[email protected]>
To: [email protected]
Subject: Suggestion on reorganizing functions
Date: Mon, 9 Aug 2004 13:20:33 -0400
Message-ID: <[email protected]> (raw)
After some discussion on IRC about improvments that could be made to
the documentation I have a suggestion. Note: I don't have much time to
work on it and I'm not an sgml-wiz.
(Note: Using .html names of things as I don't know what sgml makes what)
The basic idea is to make the equivalent of sql-commands.html (A flat
list of all SQL commands) but for functions. Usually when I need to
go find functions it involves google. The flat list would allow a Joe
User to come along and scroll down to find out what FOOBAR() is instead
of going to functions.html and trying to decide what type of function
FOOBAR is.
The organization by category is useful (ie getting all date manip
functions) but the flat list would also be quite useful - especially if
you are a newcomer to PG and are trying to dissect some code.
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.
Perhaps there is some other spiffy sgml way of defining the type of
function FOOBAR() is inside the sgml? We could have it scan all the
little sgml files for functions (ala ref/ files) and automatically
make function-TYPE.html files?
any thoughts?
--
Jeff Trout <[email protected]>
http://www.jefftrout.com/
http://www.stuarthamm.net/
view thread (10+ messages) latest in thread
reply
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients using the --to and --cc options:
reply via email
To: [email protected]
Cc: [email protected]
Subject: Re: Suggestion on reorganizing functions
In-Reply-To: <[email protected]>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox