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 1jTU7T-000538-L8 for pgsql-hackers@arkaria.postgresql.org; Tue, 28 Apr 2020 17:34:07 +0000 Received: from localhost ([127.0.0.1] helo=malur.postgresql.org) by malur.postgresql.org with esmtp (Exim 4.92) (envelope-from ) id 1jTU6v-0002jp-22 for pgsql-hackers@arkaria.postgresql.org; Tue, 28 Apr 2020 17:33:33 +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 1jTU6u-0002ji-RF for pgsql-hackers@lists.postgresql.org; Tue, 28 Apr 2020 17:33:32 +0000 Received: from sss.pgh.pa.us ([66.207.139.130]) by makus.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1jTU6o-0003lE-IQ for pgsql-hackers@lists.postgresql.org; Tue, 28 Apr 2020 17:33:31 +0000 Received: from sss1.sss.pgh.pa.us (localhost [127.0.0.1]) by sss.pgh.pa.us (8.14.4/8.14.4) with ESMTP id 03SHXOvp012252; Tue, 28 Apr 2020 13:33:24 -0400 From: Tom Lane To: emre@hasegeli.com cc: PostgreSQL Hackers Subject: Re: Bogus documentation for bogus geometric operators In-reply-to: References: <24348.1587444160@sss.pgh.pa.us> Comments: In-reply-to Emre Hasegeli message dated "Tue, 28 Apr 2020 17:33:53 +0100" MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-ID: <12250.1588095204.1@sss.pgh.pa.us> Date: Tue, 28 Apr 2020 13:33:24 -0400 Message-ID: <12251.1588095204@sss.pgh.pa.us> List-Id: List-Help: List-Subscribe: List-Post: List-Owner: List-Archive: Precedence: bulk Emre Hasegeli writes: >> Perhaps it's too late in the v13 cycle to actually do anything >> about this code-wise, but what should I do documentation-wise? >> I'm certainly not eager to document that these operators behave >> inconsistently depending on which type you're talking about. > I don't think we need to worry too much about doing something in the > v13 cycle. The geometric operators had and evidently still have so > many bugs. Nobody complains about them other than the developers who > read the code. Yeah, I ended up just documenting the current state of affairs. > I am happy to prepare a patch for the next release to fix the current > operators and add the missing ones. Sounds great! regards, tom lane