Re: Discrepancy in 9.1 Documentation on CREATE ROLE

From: Robert Haas <robertmhaas(at)gmail(dot)com>
To: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
Cc: Bruce Momjian <bruce(at)momjian(dot)us>, Ron Adams <ron(at)constellationmedia(dot)com>, pgsql-docs(at)postgresql(dot)org
Subject: Re: Discrepancy in 9.1 Documentation on CREATE ROLE
Date: 2011-10-12 04:38:55
Message-ID: CA+Tgmoa5P5epGBLeMPopk+6sH03cwiwUrB9ZnPEk4rc7Sp7UdA@mail.gmail.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

On Tue, Oct 11, 2011 at 11:59 AM, Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us> wrote:
> Bruce Momjian <bruce(at)momjian(dot)us> writes:
>> Robert Haas wrote:
>>> On Tue, Oct 11, 2011 at 10:44 AM, Bruce Momjian <bruce(at)momjian(dot)us> wrote:
>>>> Robert Haas wrote:
>>>>> 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.
>
>> Well, we have pg_dump support for 7.3 dumps (2002), so I don't see a
>> reason to remove that capability.  Now, if we want to remove that
>> support, then it would make sense to remove the rest, but I think people
>> are still assuming old dumps can load, especially if they have the dump
>> but not the 7.3 server installed.
>
> I think removing them from the docs but continuing to accept them makes
> sense.  We do still hear from people migrating from 7.4 or older, and
> it's not always going to be practical for them to make a dump with a
> newer pg_dump.

Personally, I loathe all that is undocumented. But that might just be me.

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

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Tom Lane 2011-10-12 04:59:23 Re: Discrepancy in 9.1 Documentation on CREATE ROLE
Previous Message Josh Kupershmidt 2011-10-12 03:02:17 description of CHECKPOINT command confusing