Re: Conventions - Mailing list pgsql-docs

From Bruce Momjian
Subject Re: Conventions
Date
Msg-id YfClUrN2gTEtvrHP@momjian.us
Whole thread Raw
In response to Re: Conventions  (Tom Lane <tgl@sss.pgh.pa.us>)
Responses Re: Conventions
List pgsql-docs
On Tue, Jan 25, 2022 at 07:15:45PM -0500, Tom Lane wrote:
> "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.

How is this patch?

-- 
  Bruce Momjian  <bruce@momjian.us>        https://momjian.us
  EDB                                      https://enterprisedb.com

  If only the physical world exists, free will is an illusion.


Attachment

pgsql-docs by date:

Previous
From: Tom Lane
Date:
Subject: Re: Conventions
Next
From: Tom Lane
Date:
Subject: Re: Conventions