Documentation patch: change a name in a grammar rule to prevent confusion

Поиск
Список
Период
Сортировка
От Nicolas Barbier
Тема Documentation patch: change a name in a grammar rule to prevent confusion
Дата
Msg-id b0f3f5a10604141659l7bcf1956t98b809d5090f2147@mail.gmail.com
обсуждение исходный текст
Ответы Re: Documentation patch: change a name in a grammar rule  (Neil Conway <neilc@samurai.com>)
Список 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

Вложения

В списке pgsql-patches по дате отправления:

Предыдущее
От: Bruce Momjian
Дата:
Сообщение: Re: pg_ctl options checking
Следующее
От: Neil Conway
Дата:
Сообщение: Re: Documentation patch: change a name in a grammar rule