public inbox for [email protected]  
help / color / mirror / Atom feed
From: Bruce Momjian <[email protected]>
To: Dave Stewart <[email protected]>
Cc: David G. Johnston <[email protected]>
Cc: Tom Lane <[email protected]>
Cc: Pg Docs <[email protected]>
Subject: Re: Conventions
Date: Wed, 26 Jan 2022 10:52:11 -0500
Message-ID: <[email protected]> (raw)
In-Reply-To: <CADQBm3S-dyHN-LH7Rs0jB3iV-0ERTqwD=oT2JzfksYnE6h7duQ@mail.gmail.com>
References: <[email protected]>
	<YfBcY1QFX038/[email protected]>
	<CAKFQuwaqq3euLYDdZ+Uy5mdGUX-CjJ_a-8v0_tYwQwTZ60FpXQ@mail.gmail.com>
	<[email protected]>
	<[email protected]>
	<[email protected]>
	<CAKFQuwYU5fYbVG24NvaR3GYt3iLbSRkjP_0YumUS=J_sO6fCxg@mail.gmail.com>
	<CADQBm3S-dyHN-LH7Rs0jB3iV-0ERTqwD=oT2JzfksYnE6h7duQ@mail.gmail.com>

On Tue, Jan 25, 2022 at 06:45:47PM -0800, Dave Stewart wrote:
> I'm good with it.  Thank you!

OK, updated patch attached.  I don't think we even show TCL syntax
anywhere anymore, so I removed that text, rather than moving it.

-- 
  Bruce Momjian  <[email protected]>        https://momjian.us
  EDB                                      https://enterprisedb.com

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



Attachments:

  [text/x-diff] paren.diff (848B, 2-paren.diff)
  download | inline diff:
diff --git a/doc/src/sgml/notation.sgml b/doc/src/sgml/notation.sgml
index bd1e8f629a..c3798d5f1b 100644
--- a/doc/src/sgml/notation.sgml
+++ b/doc/src/sgml/notation.sgml
@@ -6,12 +6,12 @@
  <para>
   The following conventions are used in the synopsis of a command:
   brackets (<literal>[</literal> and <literal>]</literal>) indicate
-  optional parts.  (In the synopsis of a Tcl command, question marks
-  (<literal>?</literal>) are used instead, as is usual in Tcl.)  Braces
+  optional parts.  Braces
   (<literal>{</literal> and <literal>}</literal>) and vertical lines
   (<literal>|</literal>) indicate that you must choose one
   alternative.  Dots (<literal>...</literal>) mean that the preceding element
-  can be repeated.
+  can be repeated.  All other symbols, including parentheses, should be
+  taken literally.
  </para>
 
  <para>


reply

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients using the --to and --cc options:
  reply via email

  To: [email protected]
  Cc: [email protected], [email protected], [email protected], [email protected], [email protected]
  Subject: Re: Conventions
  In-Reply-To: <[email protected]>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox