Postgres Pro
Downloads
Home   >   mailing lists

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

From Marti Raudsepp
Subject [PATCH] Fix documentation about PL/Python exception handling
Date
Msg-id AANLkTinWJoW2Q1VOtb-EL_XV3iOrKNBedTFfbx_zhED-@mail.gmail.com
Whole thread Raw
Responses Re: [PATCH] Fix documentation about PL/Python exception handling  (Euler Taveira de Oliveira <euler@timbira.com>)
Re: [PATCH] Fix documentation about PL/Python exception handling  (Bruce Momjian <bruce@momjian.us>)
Re: [PATCH] Fix documentation about PL/Python exception handling  (Peter Eisentraut <peter_e@gmx.net>)
List pgsql-docs
Tree view 
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

pgsql-docs by date:

Previous
From: Alvaro Herrera
Date:
Subject: Re: plpython docs should say 'plpy.Error' instead of ERROR
Next
From: Euler Taveira de Oliveira
Date:
Subject: Re: [PATCH] Fix documentation about PL/Python exception handling