| From: | "Nicolas Barbier" <nicolas(dot)barbier(at)gmail(dot)com> |
|---|---|
| To: | "PostgreSQL Patches" <pgsql-patches(at)postgresql(dot)org> |
| Subject: | Documentation patch: change a name in a grammar rule to prevent confusion |
| Date: | 2006-04-14 23:59:09 |
| Message-ID: | b0f3f5a10604141659l7bcf1956t98b809d5090f2147@mail.gmail.com |
| Views: | Whole Thread | Raw Message | Download mbox | Resend email |
| Thread: | |
| Lists: | 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 | Content-Type | Size |
|---|---|---|
| pgsql_doc_alter_role_clarification.patch | text/x-patch | 2.5 KB |
| From | Date | Subject | |
|---|---|---|---|
| Next Message | Neil Conway | 2006-04-15 01:11:55 | Re: Documentation patch: change a name in a grammar rule |
| Previous Message | Tom Lane | 2006-04-14 16:07:15 | Re: Proposed doc-patch: Identifying the Current WAL file |