Re: createuser --memeber and PG 16

Michael Paquier <michael@paquier.xyz>

From: Michael Paquier <michael@paquier.xyz>
To: Bruce Momjian <bruce@momjian.us>
Cc: Daniel Gustafsson <daniel@yesql.se>, PostgreSQL Hackers <pgsql-hackers@postgresql.org>
Date: 2023-05-15T07:33:27Z
Lists: pgsql-hackers
On Thu, May 11, 2023 at 09:34:42AM -0400, Bruce Momjian wrote:
> On Thu, May 11, 2023 at 02:21:22PM +0200, Daniel Gustafsson wrote:
>> IIRC there were a number of ideas presented in that thread but backwards
>> compatibility with --role already "taken" made it complicated, so --role and
>> --member were the least bad options.
>> 
>>> At a minimum I would like to apply the attached doc patch to PG 16 to
>>> improve awkward wording in CREATE ROLE and createuser.
>> 
>> No objection.

None from here as well.

>> +        role.  (This in effect makes the new role a <quote>group</quote>.)
>> While not introduced here, isn't the latter part interesting enough to warrant
>> not being inside parenthesis?
> 
> The concept of group itself is deprecated, which I think is why the
> parenthesis are used.

Not sure on this one.  The original docs come from 58d214e, and this
sentence was already in there.
--
Michael

Commits

  1. Document deprecated createuser option.

  2. Rename some createuser options.

  3. doc: improve description of adding roles as members

  4. Mark options as deprecated in usage output