Received: from maia.hub.org (maia-2.hub.org [200.46.204.251]) by mail.postgresql.org (Postfix) with ESMTP id 1899A1337B92 for ; Mon, 15 Nov 2010 16:25:34 -0400 (AST) Received: from mail.postgresql.org ([200.46.204.86]) by maia.hub.org (mx1.hub.org [200.46.204.251]) (amavisd-maia, port 10024) with ESMTP id 53676-02-2 for ; Mon, 15 Nov 2010 20:25:26 +0000 (UTC) X-Greylist: from auto-whitelisted by SQLgrey-1.7.6 Received: from sss.pgh.pa.us (sss.pgh.pa.us [66.207.139.130]) by mail.postgresql.org (Postfix) with ESMTP id 8DF851337B4E for ; Mon, 15 Nov 2010 16:25:25 -0400 (AST) Received: from sss2.sss.pgh.pa.us (tgl@localhost [127.0.0.1]) by sss.pgh.pa.us (8.14.2/8.14.2) with ESMTP id oAFKPOwT006241; Mon, 15 Nov 2010 15:25:24 -0500 (EST) To: Marti Raudsepp cc: Euler Taveira de Oliveira , pgsql-docs Subject: Re: [PATCH] Fix documentation about PL/Python exception handling In-reply-to: References: <4CDAA73A.6090409@timbira.com> Comments: In-reply-to Marti Raudsepp message dated "Sun, 14 Nov 2010 12:23:59 +0200" Date: Mon, 15 Nov 2010 15:25:23 -0500 Message-ID: <6240.1289852723@sss.pgh.pa.us> From: Tom Lane X-Virus-Scanned: Maia Mailguard 1.0.1 X-Spam-Status: No, hits=-1.91 tagged_above=-5 required=5 tests=BAYES_00=-1.9, T_RP_MATCHES_RCVD=-0.01 X-Spam-Level: X-Archive-Number: 201011/28 X-Sequence-Number: 6226 Marti Raudsepp writes: > On Wed, Nov 10, 2010 at 16:07, Euler Taveira de Oliveira > wrote: >> Sure. But bear in mind that we don't usually backpatch documentation unless >> there is incorrect information; improvement belongs to HEAD. > Yeah, it is quite incorrect (as you can see by comparing test results > from 1st post with the documentation). > Attached is a documentation patch that will apply to PostgreSQL 8.1 - 8.4 Hmmm ... I'm less than excited about documenting agreed-to-be-broken behavior in exquisite detail. Doing so will just encourage people to rely on it. It's particularly unfriendly to document it in detail without pointing out that it's likely to change. My inclination is to forget about these doc changes and spend our time on fixing the behavior instead. regards, tom lane