From: Tom Lane <tgl@sss.pgh.pa.us>
To: "David G. Johnston" <david.g.johnston@gmail.com>
cc: Bruce Momjian <bruce@momjian.us>, davs2rt@gmail.com,
        Pg Docs <pgsql-docs@lists.postgresql.org>
Subject: Re: Conventions
In-reply-to: 
 <CAKFQuwaqq3euLYDdZ+Uy5mdGUX-CjJ_a-8v0_tYwQwTZ60FpXQ@mail.gmail.com>
References: <164308146320.12460.3590769444508751574@wrigleys.postgresql.org>
 <YfBcY1QFX038/aZ8@momjian.us>
 <CAKFQuwaqq3euLYDdZ+Uy5mdGUX-CjJ_a-8v0_tYwQwTZ60FpXQ@mail.gmail.com>
Comments: In-reply-to "David G. Johnston" <david.g.johnston@gmail.com>
	message dated "Tue, 25 Jan 2022 15:20:52 -0700"
MIME-Version: 1.0
Content-Type: text/plain; charset="us-ascii"
Content-ID: <2352061.1643156145.1@sss.pgh.pa.us>
Date: Tue, 25 Jan 2022 19:15:45 -0500
Message-ID: <2352062.1643156145@sss.pgh.pa.us>
Archived-At: 
 <https://www.postgresql.org/message-id/2352062.1643156145%40sss.pgh.pa.us>
Precedence: bulk

"David G. Johnston" <david.g.johnston@gmail.com> writes:
> There is an implied "anything else not noted here should be taken as
> literal token to type, or a variable, as context dictates" [1] - and since
> () isn't mentioned...
> I'd probably rather make that implied part explicit and avoid mentioning
> parentheses explicitly.

+1.  I mean, if we have to say this for parentheses, what about
commas, dashes, etc?

> I would suggest moving the Tcl parenthetical to its own sentence.  The
> percentage of readers who will notice or care about Tcl synopses is
> probably close to zero, and they are likely to be familiar enough to not
> need our preface to enlighten them.

Maybe time to drop the Tcl reference altogether?  I like that language,
but I fear it's next door to dead, so it certainly doesn't need to be
mentioned outside the pltcl docs.

			regards, tom lane