Re: Discrepancy in 9.1 Documentation on CREATE ROLE - Mailing list pgsql-docs

From Robert Haas
Subject Re: Discrepancy in 9.1 Documentation on CREATE ROLE
Date
Msg-id CA+TgmoZentW-XcJaSXLPN+2i0XebtU6BAKAB4JdtdFd2QBjiDQ@mail.gmail.com
Whole thread Raw
In response to Re: Discrepancy in 9.1 Documentation on CREATE ROLE  (Bruce Momjian <bruce@momjian.us>)
Responses Re: Discrepancy in 9.1 Documentation on CREATE ROLE
List pgsql-docs
On Tue, Oct 11, 2011 at 10:44 AM, Bruce Momjian <bruce@momjian.us> wrote:
> Robert Haas wrote:
>> On Thu, Oct 6, 2011 at 10:48 PM, Ron Adams <ron@constellationmedia.com> wrote:
>> > The help for LOGIN/NOLOGIN at
>> > http://www.postgresql.org/docs/9.1/static/sql-createrole.html: "...NOLOGIN
>> > is the default, except when CREATE ROLE is invoked through its alternative
>> > spelling CREATE USER." The help for CREATE USER: "These clauses are an
>> > obsolete, but still accepted, spelling of SUPERUSER and NOSUPERUSER. Note
>> > that they are not equivalent to CREATEROLE as one might naively expect!" Eh?
>>
>> OK, brace yourself...
>>
>> You're mixing up the CREATEUSER option to the CREATE ROLE command with
>> the completely separate command CREATE USER.
>>
>> See http://www.postgresql.org/docs/9.1/static/sql-createuser.html
>>
>> I wonder if we ought to consider removing CREATEUSER and NOCREATEUSER
>> as synonyms for SUPERUSER and NOSUPERUSER.  It looks like that change
>> was made in 8.1, which is now EOL.
>
> Agreed.  They might still appear in dumps so maybe just remove
> documentation about them.

They shouldn't appear in any non-ancient dumps, and we don't guarantee
that those will work anyway: you're suppose to pg_dump with the new
version of pg_dump, running against the old cluster.

--
Robert Haas
EnterpriseDB: http://www.enterprisedb.com
The Enterprise PostgreSQL Company

pgsql-docs by date:

Previous
From: Bruce Momjian
Date:
Subject: Re: Discrepancy in 9.1 Documentation on CREATE ROLE
Next
From: Bruce Momjian
Date:
Subject: Re: Discrepancy in 9.1 Documentation on CREATE ROLE