Here's some matching documentation, including some other

undocumented items in TD.

Should doc patches alse be sent to pgsql-patches, or do I
have to subscribe to pgsql-docs?

The archive link for pgsql-patches is broken, and I don't
see any patches in spot checking the archive for pgsql-docs.

-Brad McLean.

diff --git a/doc/src/sgml/plpython.sgml b/doc/src/sgml/plpython.sgml
index c8725e550fb08f15de08b908a062b572ec92ff29..69894bf5aadf4c6d98c231cdb8b66eb5d2bb62eb 100644 (file)
--- a/doc/src/sgml/plpython.sgml
+++ b/doc/src/sgml/plpython.sgml
@@ -1,4 +1,4 @@
-
+
 
 
  PL/Python - Python Procedural Language
@@ -58,13 +58,7 @@ def __plpython_procedure_myfunc_23456():
    The global dictionary SD is available to store data between
    function calls.  This variable is private static data.  The global
    dictionary GD is public data, available to all python functions
-   within a backend.  Use with care.  When the function is used in a
-   trigger, the triggers tuples are in TD["new"] and/or TD["old"]
-   depending on the trigger event.  Return 'None' or "OK" from the
-   python function to indicate the tuple is unmodified, "SKIP" to
-   abort the event, or "MODIFIED" to indicate you've modified the
-   tuple.  If the trigger was called with arguments they are available
-   in TD["args"][0] to TD["args"][(n -1)].
+   within a backend.  Use with care.
   
 
   
@@ -75,6 +69,26 @@ def __plpython_procedure_myfunc_23456():
    dictionary, as mentioned above.
   
 
+  
+   When a function is used in a trigger, the dictionary TD contains
+   transaction related values.  The trigger tuples are in TD["new"]
+   and/or TD["old"] depending on the trigger event.  TD["event"]
+   contains the event as a string ("INSERT", "UPDATE", "DELETE", or
+   "UNKNOWN").  TD["when"] contains one of ("BEFORE", "AFTER", or
+   "UNKNOWN").  TD["level"] contains one of ("ROW", "STATEMENT", or
+   "UNKNOWN").  TD["name"] contains the trigger name, and TD["relid"]
+   contains the relation id of the table on which the trigger occurred.
+   If the trigger was called with arguments they are available
+   in TD["args"][0] to TD["args"][(n -1)]
+  
+
+  
+   If the trigger 'when' is "BEFORE", you may Return 'None' or "OK"
+   from the python function to indicate the tuple is unmodified,
+   "SKIP" to abort the event, or "MODIFIED" to indicate you've
+   modified the tuple.
+  
+
   
    The PL/Python language module automatically imports a Python module
    called plpy.  The functions and constants in