Re: Conventions

From: Bruce Momjian <bruce(at)momjian(dot)us>
To: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
Cc: Alvaro Herrera <alvherre(at)alvh(dot)no-ip(dot)org>, Dave Stewart <davs2rt(at)gmail(dot)com>, "David G(dot) Johnston" <david(dot)g(dot)johnston(at)gmail(dot)com>, Pg Docs <pgsql-docs(at)lists(dot)postgresql(dot)org>
Subject: Re: Conventions
Date: 2022-02-03 02:54:48
Message-ID: YftD+JDh0lvPjPeo@momjian.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

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(at)momjian(dot)us> https://momjian.us
EDB https://enterprisedb.com

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

In response to

Browse pgsql-docs by date

  From Date Subject
Next Message Fujii Masao 2022-02-03 05:33:12 Re: maximum number of backtrace frames logged by backtrace_functions
Previous Message Nasseh Khodaie 2022-02-02 14:56:35 Re: Minor error in calling a python list a tuple