Received: from malur.postgresql.org ([217.196.149.56])
	by arkaria.postgresql.org with esmtps
 (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(Exim 4.92)
	(envelope-from <pgsql-docs-owner+archive@lists.postgresql.org>)
	id 1lw5Pb-0004i0-V8
	for pgsql-docs@arkaria.postgresql.org; Wed, 23 Jun 2021 16:07:35 +0000
Received: from localhost ([127.0.0.1] helo=malur.postgresql.org)
	by malur.postgresql.org with esmtp (Exim 4.92)
	(envelope-from <pgsql-docs-owner+archive@lists.postgresql.org>)
	id 1lw5Pa-0006tI-R9
	for pgsql-docs@arkaria.postgresql.org; Wed, 23 Jun 2021 16:07:34 +0000
Received: from magus.postgresql.org ([2a02:c0:301:0:ffff::29])
	by malur.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(Exim 4.92)
	(envelope-from <tgl@sss.pgh.pa.us>)
	id 1lw5Pa-0006tA-L9
	for pgsql-docs@lists.postgresql.org; Wed, 23 Jun 2021 16:07:34 +0000
Received: from sss.pgh.pa.us ([66.207.139.130])
	by magus.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(Exim 4.92)
	(envelope-from <tgl@sss.pgh.pa.us>)
	id 1lw5PY-00019n-O3
	for pgsql-docs@lists.postgresql.org; Wed, 23 Jun 2021 16:07:34 +0000
Received: from sss1.sss.pgh.pa.us (localhost [127.0.0.1])
	by sss.pgh.pa.us (8.15.2/8.15.2) with ESMTP id 15NG7TsX2249323;
	Wed, 23 Jun 2021 12:07:29 -0400
From: Tom Lane <tgl@sss.pgh.pa.us>
To: "David G. Johnston" <david.g.johnston@gmail.com>
cc: aazamrafeeque0@gmail.com, Pg Docs <pgsql-docs@lists.postgresql.org>
Subject: Re: Incorrect Syntax in Function Syntax diagram
In-reply-to: 
 <CAKFQuwar-RXDzzE53swDA3QbPZVhx=AuG9y=udHX024rvaRA3g@mail.gmail.com>
References: <162444349581.694.5818572718530259025@wrigleys.postgresql.org>
 <CAKFQuwaGV+47J9yqoi16Ke7jkzKALO1V=VXrjMPwhMe9tL580w@mail.gmail.com>
 <2225085.1624462151@sss.pgh.pa.us>
 <CAKFQuwar-RXDzzE53swDA3QbPZVhx=AuG9y=udHX024rvaRA3g@mail.gmail.com>
Comments: In-reply-to "David G. Johnston" <david.g.johnston@gmail.com>
	message dated "Wed, 23 Jun 2021 08:41:56 -0700"
MIME-Version: 1.0
Content-Type: text/plain; charset="us-ascii"
Content-ID: <2249321.1624464449.1@sss.pgh.pa.us>
Date: Wed, 23 Jun 2021 12:07:29 -0400
Message-ID: <2249322.1624464449@sss.pgh.pa.us>
List-Id: <pgsql-docs.lists.postgresql.org>
List-Help: <https://lists.postgresql.org/manage/>
List-Subscribe: <https://lists.postgresql.org/manage/>
List-Post: <mailto:pgsql-docs@lists.postgresql.org>
List-Owner: <mailto:pgsql-docs-owner@lists.postgresql.org>
List-Archive: <https://www.postgresql.org/list/pgsql-docs>
Archived-At: 
 <https://www.postgresql.org/message-id/2249322.1624464449%40sss.pgh.pa.us>
Precedence: bulk

"David G. Johnston" <david.g.johnston@gmail.com> writes:
> Do we have an existing convention in the syntax section to indicate
> defaults, either with emphasis, placement, or even an annotation like "*"?

No.  The syntax diagrams verge on unreadability already, so I'm
unconvinced that trying to overload them with this issue would be
wise.

			regards, tom lane