From 5acd45f6fd121e6150437f5f05b7949ca2a591dc Mon Sep 17 00:00:00 2001 From: "Thomas G. Lockhart" <lockhart@fourpalms.org> Date: Fri, 26 Sep 1997 15:13:09 +0000 Subject: [PATCH] Initial docs for Vadim's new trigger capabilities. --- src/man/create_trigger.l | 44 ++++++++++++++++++++++++++++++++++++++++ src/man/drop_trigger.l | 23 +++++++++++++++++++++ 2 files changed, 67 insertions(+) create mode 100644 src/man/create_trigger.l create mode 100644 src/man/drop_trigger.l diff --git a/src/man/create_trigger.l b/src/man/create_trigger.l new file mode 100644 index 00000000000..dee152d9b55 --- /dev/null +++ b/src/man/create_trigger.l @@ -0,0 +1,44 @@ +.\" This is -*-nroff-*- +.\" XXX standard disclaimer belongs here.... +.\" $Header: /cvsroot/pgsql/src/man/Attic/create_trigger.l,v 1.1 1997/09/26 15:13:08 thomas Exp $ +.TH "CREATE TRIGGER" SQL 09/25/97 PostgreSQL +.SH NAME +create trigger \(em create a new trigger +.SH SYNOPSIS +.nf +\fBcreate trigger\fR trigname \fB{before|after}\fP \fB{insert|update|delete}\fB + \fBon\fR relname \fBfor each {row|statement}\fR + \fBexecute procedure\fR funcname \fB(\fR arguments \fB)\fR +.fi +.SH DESCRIPTION +.BR "Create Trigger" +will enter a new trigger into the current data base. The trigger will be +associated with the relation +.IR relname +and will execute the specified +.IR funcname . + +.PP +The trigger can be specified to fire either +.BR before +the operation is attempted on a tuple (e.g. before constraints are checked and +the insert/update/delete is attempted) or +.BR after +the operation has been attempted (e.g. after constraints are checked and the +insert/update/delete has completed). +If the trigger fires +.BR before +then the trigger may +skip the operation for the current tuple, +or change the current tuple (for insert/delete operations only). +If the trigger fires +.BR after +then all changes including the last insertion/updation/deletion +are "visible" to trigger. + +.PP +Refer to the SPI and trigger programming guides for more information. +.SH EXAMPLES +Examples are included in the contrib area of the source distribution. +.SH "SEE ALSO" +drop trigger(l). diff --git a/src/man/drop_trigger.l b/src/man/drop_trigger.l new file mode 100644 index 00000000000..933bd8cbbb0 --- /dev/null +++ b/src/man/drop_trigger.l @@ -0,0 +1,23 @@ +.\" This is -*-nroff-*- +.\" XXX standard disclaimer belongs here.... +.\" $Header: /cvsroot/pgsql/src/man/Attic/drop_trigger.l,v 1.1 1997/09/26 15:13:09 thomas Exp $ +.TH "DROP TRIGGER" SQL 09/26/97 PostgreSQL +.SH NAME +drop trigger \(em destroy existing classes +.SH SYNOPSIS +.nf +\fBdrop trigger\fR trigname +.fi +.SH DESCRIPTION +.BR "Drop Trigger" +removes triggers from the data base. Only its owner may destroy a +trigger. +.SH EXAMPLE +.nf +-- +--Destroy the empverify trigger +-- +drop trigger empverify +.fi +.SH "SEE ALSO" +create trigger(l). -- GitLab