Content-Type: text/plain; charset=UTF-8
Cc: pgsql-docs <pgsql-docs@postgresql.org>
Subject: Re: Documentation tweaks: ALTER USER, statement-based middleware
From: Alvaro Herrera <alvherre@commandprompt.com>
To: Greg Smith <greg@2ndquadrant.com>
In-reply-to: <4DBB8614.70307@2ndQuadrant.com>
References: <4DBB8614.70307@2ndQuadrant.com>
Date: Mon, 02 May 2011 13:47:01 -0300
Message-Id: <1304354640-sup-6836@alvh.no-ip.org>
User-Agent: Sup/git
Content-Transfer-Encoding: 8bit

Excerpts from Greg Smith's message of sáb abr 30 00:46:28 -0300 2011:
> Two small patches attached, based on recent documentation comments 
> suggested on the web site.
> 
> First alters a few places that ALTER USER is suggested, mainly in the 
> context of changing per-user settings.  If you're reading the HTML 
> documentation, and you click on ALTER USER, it takes you to a slim page 
> that tells you what you really wanted was ALTER ROLE.  That's kind of 
> wasteful, and thus the idea to go directly there.  Original doc 
> suggestion from Grzegorz Szpetkowski, I found a few more places to tweak 
> when assembling the patch.

I applied this bit.  I am unsure about the CREATE USER mentions that
appear just before each ALTER USER spot that got modified; should those
be updated to CREATE ROLE as well?  The only difference is that CREATE
USER adds the LOGIN privileges automatically, but the CREATE USER as as
skinny as ALTER USER.  Thoughts?

-- 
Álvaro Herrera <alvherre@commandprompt.com>
The PostgreSQL Company - Command Prompt, Inc.
PostgreSQL Replication, Consulting, Custom Development, 24x7 support