Documentation patch: change a name in a grammar rule to prevent confusion - Mailing list pgsql-patches

From Nicolas Barbier
Subject Documentation patch: change a name in a grammar rule to prevent confusion
Date
Msg-id b0f3f5a10604141659l7bcf1956t98b809d5090f2147@mail.gmail.com
Whole thread Raw
Responses Re: Documentation patch: change a name in a grammar rule  (Neil Conway <neilc@samurai.com>)
List pgsql-patches
Hello,

the following patch changes "parameter" to "gucname" in the grammar
(and later references) for the SET syntax in ALTER ROLE and ALTER
USER. The rationale for this is that on #postgresql (IRC), we observe
many people trying to change the password for a role as follows:

ALTER ROLE blah SET PASSWORD = 'password';

(the correct syntax is "ALTER ROLE blah PASSWORD 'password';")

The confusion is induced by the usage of the word "parameter" and the
name of a section called "Parameters", which then lists the possible
non-GUC parameters. This apparently makes readers think that those are
the "parameters" that can be changed with above syntax.

Nicolas

--
Nicolas Barbier
http://www.gnu.org/philosophy/no-word-attachments.html

Attachment

pgsql-patches by date:

Previous
From: Bruce Momjian
Date:
Subject: Re: pg_ctl options checking
Next
From: Neil Conway
Date:
Subject: Re: Documentation patch: change a name in a grammar rule