To: "Bruce Momjian" <pgman@candle.pha.pa.us>
Cc: pgsql-docs@postgresql.org
Subject: Re: Two points about docs
References: <200505100150.j4A1oGa03929@candle.pha.pa.us>
Message-ID: <op.sqlmlwmd1taxl4@kempc17.me.tut.fi>
Date: Wed, 11 May 2005 09:50:10 +0300
From: "Vladimir Chukharev" <chu@kemia.me.tut.fi>
Organization: Tampere University of Technology
Content-Type: text/plain; format=flowed; delsp=yes; charset=koi8-r
MIME-Version: 1.0
Content-Transfer-Encoding: 8bit
In-Reply-To: <200505100150.j4A1oGa03929@candle.pha.pa.us>
User-Agent: Opera M2/8.0 (FreeBSD, build 1095)

On Tue, 10 May 2005 04:50:16 +0300, Bruce Momjian <pgman@candle.pha.pa.us> wrote:

> Vladimir Chukharev wrote:
>> About the link to the lo_* functions. I thought about adding
>> a sentence to Charpter 9 like 'And functions to manipulate large
>> objects are presented in Charpter 28.' right after the phrase
>> 'Users can also define their own functions and operators, as
>> described in Part V.'
>>
>> Do you think it's suitable?
>
> Not really.  We don't mention pg_stat_activity functions either.  I
> think people have to realize that some functions are covered in other
> sections of the manual.  There is a clearly titled section for large
> objeccts.

OK, what about writing down this idea? "Not all functions are listed
in this Chapter, some are in other sections of the manual."

And I still think that an additional Appendix with a list of all
functions and referencies to their descriptions would be very usefull.
Can you comment on that?

Best regards,
-- 
V.Chukharev