Initial docs for Vadim's new trigger capabilities.

2 files changed, 67 insertions, 0 deletions

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).