Message-ID: <3ABB62F5.56C963C3@alumni.caltech.edu>
Date: Fri, 23 Mar 2001 14:51:33 +0000
From: Thomas Lockhart <lockhart@alumni.caltech.edu>
Reply-To: lockhart@fourpalms.org
Organization: Yes
MIME-Version: 1.0
To: Tatsuo Ishii <t-ishii@sra.co.jp>, Peter Eisentraut <peter_e@gmx.net>
Cc: pgsql-hackers@postgresql.org
Subject: Re: 7.1 docs
References: <20010323175044L.t-ishii@sra.co.jp>
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit

> 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 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.

We could take it out altogether if we want. Peter?

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 to cover them. I think that these are more likely to
be used in the future, but we do need additional pages written covering
other functions.

                  - Thomas