Svenne Krap wrote:
Rick Vernam wrote:
The reference documentation is *always* intended to be more complete and
more authoritative than the narrative description. If you don't think
so then you need to readjust your expectations.
very well, I did not know that.
expectations readjusted. thanks.
Me neither. I wonder how many other long term users (I have used pgsql
for more than a decade - 6.2 was my first version if memory serves)
and have never caught that nuance either.
Maybe that should be printed as a note on the "narrative description
pages".. something like: "Note this is a simplified introduction to
the subject. For authorative description please see topic x in section
y (and link to it of course ;))
In effect it does say that - perhaps not quite as explicitly as you
might have wanted. It says: "The information in this part is presented
in a narrative fashion in topical units. Readers looking for a complete
description of a particular command should look into Part VI. " (the
"PART VI" is a link).
cheers
andrew
--
Sent via pgsql-hackers mailing list (pgsql-hackers@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-hackers
