Date: Wed, 2 Feb 2022 21:54:48 -0500
From: Bruce Momjian <bruce@momjian.us>
To: Tom Lane <tgl@sss.pgh.pa.us>
Cc: Alvaro Herrera <alvherre@alvh.no-ip.org>,
	Dave Stewart <davs2rt@gmail.com>,
	"David G. Johnston" <david.g.johnston@gmail.com>,
	Pg Docs <pgsql-docs@lists.postgresql.org>
Subject: Re: Conventions
Message-ID: <YftD+JDh0lvPjPeo@momjian.us>
References: <YfFuK5fHSAKUN5yV@momjian.us>
 <202201261701.rzej4dlxqyts@alvherre.pgsql>
 <YfHZ9Ecpiy/v1oPN@momjian.us>
 <2517650.1643250838@sss.pgh.pa.us>
 <YfIIySTYopod5t21@momjian.us>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <YfIIySTYopod5t21@momjian.us>
Archived-At: 
 <https://www.postgresql.org/message-id/YftD%2BJDh0lvPjPeo%40momjian.us>
Precedence: bulk

On Wed, Jan 26, 2022 at 09:51:53PM -0500, Bruce Momjian wrote:
> > I'd suggest a separate para at some point before the first usage,
> > along the lines of
> > 
> >    In this section, we follow the usual Tcl convention of using question
> >    marks, rather than brackets, to indicate an optional element in a
> >    syntax synopsis.
> 
> Oh, then I didn't understand it either.  I know Tcl uses brackets for
> stuff so I thought there was some weird syntax that represented brackets
> as something else.  Anyway, updated patch attached.

Patch applied to all supported versions.  Dave, thanks for pointing out
this problem.

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

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