Skip site navigation (1) Skip section navigation (2)

[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 (view raw or flat)
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: 0002-Add-tests-for-current-PL-Python-exception-behavior.patch
Description: text/x-patch (5.4 KB)
Attachment: 0001-Document-current-PL-Python-exception-raising-semanti.patch
Description: text/x-patch (2.7 KB)

Responses

pgsql-docs by date

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

Privacy Policy | About PostgreSQL
Copyright © 1996-2014 The PostgreSQL Global Development Group