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

From Nicolas Barbier
Subject Re: Documentation patch: change a name in a grammar rule
Date
Msg-id b0f3f5a10604151421j1e24def1m3560ef35bb0fa229@mail.gmail.com
Whole thread Raw
In response to Re: Documentation patch: change a name in a grammar rule  (Tom Lane <tgl@sss.pgh.pa.us>)
Responses Re: Documentation patch: change a name in a grammar rule
List pgsql-patches
2006/4/15, Tom Lane <tgl@sss.pgh.pa.us>:

> 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.

In for example set.sgml, just "name" is used for the exact same
concept. I changed the patch so that "varname" is used, because "name"
was already in use by this specific grammar. Maybe the usage of "var"
makes it less clear indeed, for people that know that those things are
always referred to as "parameters" and never as "variables". But then,
leaving it as-is doesn't solve the apparently occuring confusion
between "parameter" the GUC and "parameter" the "parameter to the
statement", as we have had at least three people in #postgresql that
made that exact mistake.

Nicolas

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

pgsql-patches by date:

Previous
From: Tom Lane
Date:
Subject: Re: [PATCH] Reduce noise from tsort
Next
From: Dhanaraj M - Sun Microsystems
Date:
Subject: Re: Patch for bug #2073 (Can't drop sequence when created