Re: Conventions

2022-01-25 Thread Dave Stewart
I'm good with it. Thank you! On Tue, Jan 25, 2022 at 6:15 PM David G. Johnston < david.g.johns...@gmail.com> wrote: > On Tuesday, January 25, 2022, Tom Lane wrote: > >> Bruce Momjian writes: >> > How is this patch? >> >> I'd still drop the Tcl bit, or if you must have it, move it to >> pltcl.s

Re: Conventions

2022-01-25 Thread David G. Johnston
On Tuesday, January 25, 2022, Tom Lane wrote: > Bruce Momjian writes: > > How is this patch? > > I'd still drop the Tcl bit, or if you must have it, move it to > pltcl.sgml. Otherwise OK by me. > > > Agreed. David J.

Re: Conventions

2022-01-25 Thread Tom Lane
Bruce Momjian writes: > How is this patch? I'd still drop the Tcl bit, or if you must have it, move it to pltcl.sgml. Otherwise OK by me. regards, tom lane

Re: Conventions

2022-01-25 Thread Bruce Momjian
On Tue, Jan 25, 2022 at 07:15:45PM -0500, Tom Lane wrote: > "David G. Johnston" 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 tha

Re: Conventions

2022-01-25 Thread Tom Lane
"David G. Johnston" 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 explicitl

Re: Conventions

2022-01-25 Thread Dave Stewart
Thanks, all, for considering this update. I like the "anything not noted here..." phrase better than "parentheses should be interpreted literally." That's a little vague to me. And *bold_italic* for variables was somehow obvious to me, but I agree with [1] that it could also be made explicit, to

Re: Conventions

2022-01-25 Thread David G. Johnston
On Tue, Jan 25, 2022 at 1:24 PM Bruce Momjian wrote: > On Tue, Jan 25, 2022 at 03:31:03AM +, PG Doc comments form wrote: > > The following documentation comment has been logged on the website: > > > > Page: https://www.postgresql.org/docs/12/notation.html > > Description: > > > > In section 3

Re: Conventions

2022-01-25 Thread Bruce Momjian
On Tue, Jan 25, 2022 at 03:31:03AM +, PG Doc comments form wrote: > The following documentation comment has been logged on the website: > > Page: https://www.postgresql.org/docs/12/notation.html > Description: > > In section 3, Conventions, it would be helpful to point out that > parentheses,

Conventions

2022-01-25 Thread PG Doc comments form
The following documentation comment has been logged on the website: Page: https://www.postgresql.org/docs/12/notation.html Description: In section 3, Conventions, it would be helpful to point out that parentheses, when used in the command descriptions, are to be interpreted as literal required el