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 ) id 1lw51F-0003gZ-65 for pgsql-docs@arkaria.postgresql.org; Wed, 23 Jun 2021 15:42:25 +0000 Received: from localhost ([127.0.0.1] helo=malur.postgresql.org) by malur.postgresql.org with esmtp (Exim 4.92) (envelope-from ) id 1lw51D-000347-Uh for pgsql-docs@arkaria.postgresql.org; Wed, 23 Jun 2021 15:42:23 +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 ) id 1lw51D-0002zs-Lz for pgsql-docs@lists.postgresql.org; Wed, 23 Jun 2021 15:42:23 +0000 Received: from mail-pj1-x1032.google.com ([2607:f8b0:4864:20::1032]) by magus.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.92) (envelope-from ) id 1lw515-0000wQ-TG for pgsql-docs@lists.postgresql.org; Wed, 23 Jun 2021 15:42:23 +0000 Received: by mail-pj1-x1032.google.com with SMTP id g4so1753042pjk.0 for ; Wed, 23 Jun 2021 08:42:15 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc; bh=byMYqkO1JkxhhXk0Uv013aYvXxXOh1uibsVUEYcUq9A=; b=brOaF2uPFIFuq3nptPZwaBo+08wFv0glJNaqsH1YIiF+Me1xAXo8n4ePi2UIQ1Jio+ nW+vn/rRrBYXTMXVwlTgPRTqFL3m3mqAl4Z3l6/qo4r2pTWHdcrWqqATOPUDgrfclWIh XNtUQ54m8Q6TpBHa2vaLyON1vTbSPkV0ATsN+W8h5gkSqvrMeXrkOvteWojcsl/cYSY8 P8UU/pVq3P4GDAtdHlaFSk7+AtJ2+BRsa6SFxYOBsl5u6ZY1ViVE5nniT6Zi3tFDbvSZ 8oPNwCnsZH1WJG5AA1Aki3KpnIoiwt8yMulKBythRYgSjICiINDdICB1Q+nWj24+hV4a 6Yjw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=byMYqkO1JkxhhXk0Uv013aYvXxXOh1uibsVUEYcUq9A=; b=sFSHV5ITjun9r6YeOcAoa2t4DhHLvnF4IAdxTX8QkcgkNCJn/CwWFsIkjjOIXW2PDE aui8XoPhNMu7gTP1eIzqKQFPrLPEeLrSRVXhPI109zXBDQl75MeYzNQ/QhdbHi2IbaqL KK7KTqZGL+1w1d2JgEL4YOhgQta4iL1aqhuXuRcEEBKS9kWzUhmAGq+zTh4dH1UJ1PdF gMvGd+JOJlNXsCxPjSCYseTRyaNL271QEhEVTmDQxdZlhy1K6vNVQuUGGLJRVbv7QN0v oNZsoXbdO4M81lU1T9FDv18XCxmhRl5GOO0pauyPXd8kFihaEAy+m6q7QUlS4z1z1nF1 T/XQ== X-Gm-Message-State: AOAM530LARG4JVazVeXfWCxvTas3EpwPuuCdgtFwhy6Xh1KNmZ3TDHPn OitNW32h3bQaOadQWe3S2T2Y3JHb42cvXN/q/pA= X-Google-Smtp-Source: ABdhPJxrIXsdxQzeMhW0Wu/zS0ekBSWIGCehNZiZdncReYIizno9whQzngHtHNI+7piK64cdtY43rNPJso0Nl0dHvNk= X-Received: by 2002:a17:90b:31cc:: with SMTP id jv12mr386499pjb.180.1624462933685; Wed, 23 Jun 2021 08:42:13 -0700 (PDT) MIME-Version: 1.0 References: <162444349581.694.5818572718530259025@wrigleys.postgresql.org> <2225085.1624462151@sss.pgh.pa.us> In-Reply-To: <2225085.1624462151@sss.pgh.pa.us> From: "David G. Johnston" Date: Wed, 23 Jun 2021 08:41:56 -0700 Message-ID: Subject: Re: Incorrect Syntax in Function Syntax diagram To: Tom Lane Cc: aazamrafeeque0@gmail.com, Pg Docs Content-Type: multipart/alternative; boundary="0000000000001cf83605c570c016" List-Id: List-Help: List-Subscribe: List-Post: List-Owner: List-Archive: Archived-At: Precedence: bulk --0000000000001cf83605c570c016 Content-Type: text/plain; charset="UTF-8" On Wed, Jun 23, 2021 at 8:29 AM Tom Lane wrote: > Yeah. The way it's written fails to show, except via formatting, > that IMMUTABLE/STABLE/VOLATILE are mutually exclusive; > It seems the STRICT -ness line needs brackets too then. Also, back to volatility, volatile is the default option though due to alphabetical order it is shown last with no indication it is the default. Do we have an existing convention in the syntax section to indicate defaults, either with emphasis, placement, or even an annotation like "*"? David J. --0000000000001cf83605c570c016 Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable
On Wed, Jun 23, 2021 at 8:29 AM Tom Lane <tgl@sss.pgh.pa.us> wrote:
Yeah.=C2=A0 The way it's written fails to show, except via format= ting,
that IMMUTABLE/STABLE/VOLATILE are mutually exclusive;

It seems the STRICT -ness line needs brackets too then.
=

Also, back to volatility, volatile is the default option th= ough due to alphabetical order it is shown last with no indication it is th= e default.=C2=A0 Do we have an existing convention in the syntax section to= indicate defaults, either with emphasis, placement, or even an annotation = like "*"?

David J.

<= /div> --0000000000001cf83605c570c016--