From b7f3981756d314d32cca27b5c3d31bdd58b6ff06 Mon Sep 17 00:00:00 2001 From: Daniel Gustafsson Date: Tue, 15 Nov 2022 14:51:02 +0100 Subject: [PATCH] doc: Use more concise wording for pl/pgSQL TG_ variables MIME-Version: 1.0 Content-Type: text/plain; charset=utf8 Content-Transfer-Encoding: 8bit To improve readability of the TG_ variables definition lists, this moves the datatypes up to the defined term to avoid having each entry start with "Data type". This also removes redundant wording that that didn't carry any information from the descriptions. Author: Christoph Berg Reviewed-by: Dagfinn Ilmari Mannsåker Discussion: https://postgr.es/m/Yw4Noe3A2s87A0qq@msg.df7cb.de --- doc/src/sgml/plpgsql.sgml | 67 ++++++++++++++++----------------------- 1 file changed, 28 insertions(+), 39 deletions(-) diff --git a/doc/src/sgml/plpgsql.sgml b/doc/src/sgml/plpgsql.sgml index d85f89bf303..dda667e68e8 100644 --- a/doc/src/sgml/plpgsql.sgml +++ b/doc/src/sgml/plpgsql.sgml @@ -4032,11 +4032,10 @@ ASSERT condition , - NEW + NEW record - Data type RECORD; variable holding the new - database row for INSERT/UPDATE operations in row-level + new database row for INSERT/UPDATE operations in row-level triggers. This variable is null in statement-level triggers and for DELETE operations. @@ -4044,11 +4043,10 @@ ASSERT condition , - OLD + OLD record - Data type RECORD; variable holding the old - database row for UPDATE/DELETE operations in row-level + old database row for UPDATE/DELETE operations in row-level triggers. This variable is null in statement-level triggers and for INSERT operations. @@ -4056,20 +4054,18 @@ ASSERT condition , - TG_NAME + TG_NAME name - Data type name; variable that contains the name of the trigger actually - fired. + name of the trigger which fired. - TG_WHEN + TG_WHEN text - Data type text; a string of BEFORE, AFTER, or INSTEAD OF, depending on the trigger's definition. @@ -4077,43 +4073,40 @@ ASSERT condition , - TG_LEVEL + TG_LEVEL text - Data type text; a string of either - ROW or STATEMENT + ROW or STATEMENT, depending on the trigger's definition. - TG_OP + TG_OP text - Data type text; a string of + operation for which the trigger was fired: INSERT, UPDATE, - DELETE, or TRUNCATE - telling for which operation the trigger was fired. + DELETE, or TRUNCATE. - TG_RELID + TG_RELID oid (references pg_class.oid) - Data type oid; the object ID of the table that caused the - trigger invocation. + object ID of the table that caused the trigger invocation. - TG_RELNAME + TG_RELNAME name - Data type name; the name of the table that caused the trigger + table that caused the trigger invocation. This is now deprecated, and could disappear in a future release. Use TG_TABLE_NAME instead. @@ -4121,40 +4114,38 @@ ASSERT condition , - TG_TABLE_NAME + TG_TABLE_NAME name - Data type name; the name of the table that - caused the trigger invocation. + table that caused the trigger invocation. - TG_TABLE_SCHEMA + TG_TABLE_SCHEMA name - Data type name; the name of the schema of the - table that caused the trigger invocation. + schema of the table that caused the trigger invocation. - TG_NARGS + TG_NARGS integer - Data type integer; the number of arguments given to the trigger + number of arguments given to the trigger function in the CREATE TRIGGER statement. - TG_ARGV[] + TG_ARGV text[] - Data type array of text; the arguments from + arguments from the CREATE TRIGGER statement. The index counts from 0. Invalid indexes (less than 0 or greater than or equal to tg_nargs) @@ -4656,21 +4647,19 @@ CREATE TRIGGER emp_audit_del - TG_EVENT + TG_EVENT text - Data type text; a string representing the event the - trigger is fired for. + event the trigger is fired for. - TG_TAG + TG_TAG text - Data type text; variable that contains the command tag - for which the trigger is fired. + command tag for which the trigger is fired. -- 2.30.2