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 1kYACx-0001xT-W3 for pgsql-bugs@arkaria.postgresql.org; Thu, 29 Oct 2020 15:51:23 +0000 Received: from localhost ([127.0.0.1] helo=malur.postgresql.org) by malur.postgresql.org with esmtp (Exim 4.92) (envelope-from ) id 1kYACw-0003hW-0L for pgsql-bugs@arkaria.postgresql.org; Thu, 29 Oct 2020 15:51:22 +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 1kYACv-0003gr-Qg for pgsql-bugs@lists.postgresql.org; Thu, 29 Oct 2020 15:51:21 +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 ) id 1kYACo-0006It-Tj for pgsql-bugs@lists.postgresql.org; Thu, 29 Oct 2020 15:51:20 +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 09TFpCja1549606; Thu, 29 Oct 2020 11:51:12 -0400 From: Tom Lane To: "David G. Johnston" cc: Wolfgang Walther , PostgreSQL mailing lists Subject: Re: Calling variadic function with default value in named notation In-reply-to: References: <5a80bcdb-e92a-5c21-d923-f3813543771b@technowledgy.de> <1449498.1603919899@sss.pgh.pa.us> Comments: In-reply-to "David G. Johnston" message dated "Thu, 29 Oct 2020 08:11:43 -0700" MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-ID: <1549604.1603986672.1@sss.pgh.pa.us> Date: Thu, 29 Oct 2020 11:51:12 -0400 Message-ID: <1549605.1603986672@sss.pgh.pa.us> List-Id: List-Help: List-Subscribe: List-Post: List-Owner: List-Archive: Precedence: bulk "David G. Johnston" writes: > As I look at this more I'm definitely agreeing that the documentation here > is problematic. Specifically, the fact that the only place about this > syntax is in a chapter under Extending SQ - SQL Functions, is not good. It > really needs to be in the Syntax chapter. The documentation situation was complained of in the 2009 thread I just cited :-(. Doesn't look like anybody did anything about it. I am not, however, persuaded that you can just move a bunch of that material to the syntax chapter. I don't think it's very practical to describe variadic functions when the user doesn't know how to create one. And we definitely should not push all the docs about creating functions into the syntax chapter. regards, tom lane