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 1oYrT5-0003yR-LX for pgsql-hackers@arkaria.postgresql.org; Thu, 15 Sep 2022 16:11:59 +0000 Received: from localhost ([127.0.0.1] helo=malur.postgresql.org) by malur.postgresql.org with esmtp (Exim 4.92) (envelope-from ) id 1oYrT4-0002GB-Hk for pgsql-hackers@arkaria.postgresql.org; Thu, 15 Sep 2022 16:11:58 +0000 Received: from makus.postgresql.org ([2001:4800:3e1:1::229]) by malur.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1oYrT4-0002Fv-7W for pgsql-hackers@lists.postgresql.org; Thu, 15 Sep 2022 16:11:58 +0000 Received: from wout2-smtp.messagingengine.com ([64.147.123.25]) by makus.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1oYrT1-00036Q-Dy for pgsql-hackers@lists.postgresql.org; Thu, 15 Sep 2022 16:11:57 +0000 Received: from compute2.internal (compute2.nyi.internal [10.202.2.46]) by mailout.west.internal (Postfix) with ESMTP id CC7473200B01; Thu, 15 Sep 2022 12:11:53 -0400 (EDT) Received: from mailfrontend2 ([10.202.2.163]) by compute2.internal (MEProxy); Thu, 15 Sep 2022 12:11:54 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:cc:content-transfer-encoding :content-type:date:date:feedback-id:feedback-id:from:from :in-reply-to:in-reply-to:message-id:mime-version:reply-to:sender :subject:subject:to:to:x-me-proxy:x-me-proxy:x-me-sender :x-me-sender:x-sasl-enc; s=fm2; t=1663258313; x=1663344713; bh=Y qig87XuANqU+avji1jYg1nDVTnRDHV7pdJ7z7n/rzc=; b=VVxoycvRB9ysQIIHs iXJ+uH5zP/VDf0STDERowSbwWbKSes++CRXw2qCXMf/81dRmyCOiR6FwLlNnJipw ZaSPUMQIap3ABkaMWqJDPW/QqLfa9Bnntk6g2CXE4QUlaoCrfI6fgEpy8h9c40// t5EzCeI6dNDyNxcidppXYsYKwq4avBsWhJ9ZtVBKl+ATopuuqsievUzzBgIjaHaz yJm10/4gxuMZFC5HnD5GCZ0vSKqc7RvGN9rra6kYCDa81U7obPthgakkItRAdG64 g17VW2kkuJhnZmrCx58HSQ498OIfT0jnJczEr6r5o3zIwccn+POrW8r/FZGxaTdU RbVqA== X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedvfedrfedukedguddttdcutefuodetggdotefrod ftvfcurfhrohhfihhlvgemucfhrghsthforghilhdpqfgfvfdpuffrtefokffrpgfnqfgh necuuegrihhlohhuthemuceftddtnecusecvtfgvtghiphhivghnthhsucdlqddutddtmd enucfjughrpeffhffvvefukfggtggugfgjsehtkeertddttdejnecuhfhrohhmpeetlhhv rghrohcujfgvrhhrvghrrgcuoegrlhhvhhgvrhhrvgesrghlvhhhrdhnohdqihhprdhorh hgqeenucggtffrrghtthgvrhhnpedvkedtffduffdtffffheffhfejjefhgfeiueeukeej keffgfdufffhudffffeuveenucffohhmrghinhepvghnthgvrhhprhhishgvuggsrdgtoh hmnecuvehluhhsthgvrhfuihiivgeptdenucfrrghrrghmpehmrghilhhfrhhomheprghl vhhhvghrrhgvsegrlhhvhhdrnhhoqdhiphdrohhrgh X-ME-Proxy: Feedback-ID: ia2694551:Fastmail Received: by mail.messagingengine.com (Postfix) with ESMTPA; Thu, 15 Sep 2022 12:11:52 -0400 (EDT) Received: by perhan.alvh.no-ip.org (Postfix, from userid 1000) id 956B135F; Thu, 15 Sep 2022 18:11:42 +0200 (CEST) Date: Thu, 15 Sep 2022 18:11:42 +0200 From: Alvaro Herrera To: Peter Smith Cc: Amit Kapila , pgsql-hackers@lists.postgresql.org Subject: Re: pgsql: Doc: Explain about Column List feature. Message-ID: <20220915161142.6gtmmezq47nz37oi@alvherre.pgsql> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: 8bit In-Reply-To: <20220915130821.t3qacw2azuyovjrs@alvherre.pgsql> List-Id: List-Help: List-Subscribe: List-Post: List-Owner: List-Archive: Archived-At: Precedence: bulk On 2022-Sep-15, Alvaro Herrera wrote: > Looking at the rendered docs again, I notice that section "31.4.5. > Combining Multiple Column Lists" is *only* the red-tinted Warning block. > That seems quite odd. I am tempted to remove the sect2 heading for that > one too. Pushed. I didn't modify this part; I spent too much time looking at it trying to figure out how to do it. I think this bit really belongs in the CREATE/ALTER docs rather than this chapter. But in order to support having a separate for the restriction on combination, we need a separate for the column_name parameter. So I'm going to edit that one and I'll throw this change in. Thanks, Peter, for the discussion. -- Álvaro Herrera PostgreSQL Developer — https://www.EnterpriseDB.com/ "Pensar que el espectro que vemos es ilusorio no lo despoja de espanto, sólo le suma el nuevo terror de la locura" (Perelandra, C.S. Lewis)