BUG #2223: Misleading info in docs on volatility level of functions

The following bug has been logged online:

Bug reference:      2223
Logged by:          
Email address:      dueyduey@freemail.hu
PostgreSQL version: 8.1
Operating system:   linux
Description:        Misleading info in docs on volatility level of functions
Details: 

Hi, all!
The documentation on how to and why declare a function STABLE or IMMUTABLE
is very laconic. It makes clear what promises I make when determining the
volatility of my functions but it fails to point out what exactly I can
expect in turn for my promises.
See also the discussion on bug#2150 on the pgsql-bugs list.
Thanks for bothering.