Re: Documentation patch: change a name in a grammar rule - Mailing list pgsql-patches

From Tom Lane
Subject Re: Documentation patch: change a name in a grammar rule
Date
Msg-id 12799.1145074311@sss.pgh.pa.us
Whole thread Raw
In response to Re: Documentation patch: change a name in a grammar rule  (Neil Conway <neilc@samurai.com>)
Responses Re: Documentation patch: change a name in a grammar rule  ("Nicolas Barbier" <nicolas.barbier@gmail.com>)
List pgsql-patches
Neil Conway <neilc@samurai.com> writes:
> On Sat, 2006-04-15 at 01:59 +0200, Nicolas Barbier wrote:
>> the following patch changes "parameter" to "gucname" in the grammar
>> (and later references) for the SET syntax in ALTER ROLE and ALTER
>> USER.

> Wouldn't "var_name", "varname", or something similar be more clear?
> "GUC" is probably not an acronym we should be exposing prominently to
> the user.

s/prominently/at all/ ... I don't think the proposed patch is an
improvement, and in fact see nothing wrong with the use of "parameter"
here.  If we want to abandon "parameter" as the official documentation
term for GUC variables, then there are dozens or hundreds of changes
to be made in config.sgml, to say nothing of other files.

            regards, tom lane

pgsql-patches by date:

Previous
From: Neil Conway
Date:
Subject: Re: Documentation patch: change a name in a grammar rule
Next
From: Martijn van Oosterhout
Date:
Subject: [PATCH] Reduce noise from tsort