Re: [PATCH] Fix documentation about PL/Python exception handling - Mailing list pgsql-docs

From Tom Lane
Subject Re: [PATCH] Fix documentation about PL/Python exception handling
Date
Msg-id 6240.1289852723@sss.pgh.pa.us
Whole thread Raw
In response to Re: [PATCH] Fix documentation about PL/Python exception handling  (Marti Raudsepp <marti@juffo.org>)
Responses Re: [PATCH] Fix documentation about PL/Python exception handling
Re: [PATCH] Fix documentation about PL/Python exception handling
List pgsql-docs
Marti Raudsepp <marti@juffo.org> writes:
> On Wed, Nov 10, 2010 at 16:07, Euler Taveira de Oliveira
> <euler@timbira.com> 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

pgsql-docs by date:

Previous
From: Tom Lane
Date:
Subject: Re: Large SGML Cleanup
Next
From: Marti Raudsepp
Date:
Subject: Re: [PATCH] Fix documentation about PL/Python exception handling