Re: [DOCS] Re: [HACKERS] Re: 7.1 docs

2001-03-25 Thread Tom Lane
Roberto Mello <[EMAIL PROTECTED]> writes: > I like the way the Oracle functions are documented, except for the > fact that they have one huge page for all functions, which is hard on > those on slow connections reading docs online. > They have functions in tables grouped per functiona

Re: [DOCS] Re: [HACKERS] Re: 7.1 docs

2001-03-25 Thread Roberto Mello
On Sat, Mar 24, 2001 at 11:32:02AM -0500, Tom Lane wrote: > > A "page per function" approach is clearly overkill for the vast majority > of our functions. I think that's not unrelated to the fact that no one's > ever bothered to prepare such documentation ;-) Agreed. > On the other ha

Re: [HACKERS] Re: 7.1 docs

2001-03-24 Thread Tom Lane
Peter Eisentraut <[EMAIL PROTECTED]> writes: > All functions are documented (for appropriate values of "all") in the > User's Guide, chapter 4. There was probably once the idea of setting up a > reference page set for the functions, but I don't know if this is > particularly better than what we h

[HACKERS] Re: 7.1 docs

2001-03-24 Thread Peter Eisentraut
Thomas Lockhart writes: > I put in contacts.sgml a *long* time ago, thinking that something like > it should be in the docs. But it was not complete enough to consider > including at the time (now that I look, it only has my name ;), so it > was only a placeholder for the future. The "Resources"

Re: [HACKERS] Re: 7.1 docs

2001-03-23 Thread Roberto Mello
On Fri, Mar 23, 2001 at 02:51:33PM +, Thomas Lockhart wrote: > > The ref/current_{date,time...}.sgml files are there because (a) > functions should be documented, and (b) someone documented them. But we > never documented enough functions to justify setting up an entire > section of a manual

Re: [HACKERS] Re: 7.1 docs

2001-03-23 Thread Tatsuo Ishii
> > I have a plan to translate 7.1 docs into Japanases and I looked around > > current docs. I noticed that contacts.sgml and ref/current*.sgml are > > not used anywhere in the result html nor in man pages. > > Does anybody know the reason? Or am I missing something? > > I put in contacts.sgml a

[HACKERS] Re: 7.1 docs

2001-03-23 Thread Thomas Lockhart
> I have a plan to translate 7.1 docs into Japanases and I looked around > current docs. I noticed that contacts.sgml and ref/current*.sgml are > not used anywhere in the result html nor in man pages. > Does anybody know the reason? Or am I missing something? I put in contacts.sgml a *long* time