[PATCH] Fix documentation about PL/Python exception handling

From: Marti Raudsepp <marti(at)juffo(dot)org>
To: pgsql-docs <pgsql-docs(at)postgresql(dot)org>
Subject: [PATCH] Fix documentation about PL/Python exception handling
Date: 2010-11-09 16:40:43
Message-ID: AANLkTinWJoW2Q1VOtb-EL_XV3iOrKNBedTFfbx_zhED-@mail.gmail.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

Hi lists,

It seems that PL/Python exception functions (plpy.error, plpy.fatal)
and exception types (plpy.Error, plpy.Fatal) have never worked as
documented, and the behavior is quite surprising.

This is an attempt at properly documenting the current semantics. I
tested these behaviors on PostgreSQL 8.1.22 as well as 9.1alpha2.

Patch 1 updates the documentation in doc/src/sgml/plpython.sgml
Patch 2 adds tests to src/pl/plpython/sql/plpython_error.sql

Should I submit separate documentation patches for older maintenance
releases? Versions 8.1 - 8.4 contain the same incorrect text, but in
the "Database Access" section.

Regards,
Marti

Attachment Content-Type Size
0001-Document-current-PL-Python-exception-raising-semanti.patch text/x-patch 2.7 KB
0002-Add-tests-for-current-PL-Python-exception-behavior.patch text/x-patch 5.4 KB

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Euler Taveira de Oliveira 2010-11-10 14:07:54 Re: [PATCH] Fix documentation about PL/Python exception handling
Previous Message Alvaro Herrera 2010-11-09 14:34:15 Re: plpython docs should say 'plpy.Error' instead of ERROR