Re: doc - add missing documentation for "acldefault"

Hello,

>> However, the point of having hidden and/or undocumented functions fails me:
>> they are hard/impossible to find if you do not know they exist from
>> the start, and if you ever find one you do not know what they do without
>> reading the source code in detail, eg to know what to give arguments to get
>> an answer.

> At first, we must decide in which cases users will use them. And I don't
> see such cases. I must to know how to grant privileges, how to revoke
> them and how to check existing priveleges. All theese tasks documented
> in GRANT, REVOKE commands and system catalog descriptions.

These are end-user needs.

There are also other needs, such as devs. I see no reason to make the
developer work harder by not providing documentation about available
functions. Tom mention the "acldefault" function that I did not know
existed, and I have read the doc!

So I'm still favorable to documenting all functions:-)

Maybe there could be a special section about special/internal functions,
separate from functions which are more of interest to the end-user? But
for me this is already the purpose of the "System information" sections in
the documentation. Maybe there could be another sub-section about aclitem
related functions in the "System information" section for these.

> Your's patch from another thread closes the last hole - describing default
> privileges in various psql commands.

Yep.

--
Fabien.