summaryrefslogtreecommitdiff
path: root/src/man/notify.l
diff options
context:
space:
mode:
Diffstat (limited to 'src/man/notify.l')
-rw-r--r--src/man/notify.l54
1 files changed, 0 insertions, 54 deletions
diff --git a/src/man/notify.l b/src/man/notify.l
deleted file mode 100644
index 370677d12f..0000000000
--- a/src/man/notify.l
+++ /dev/null
@@ -1,54 +0,0 @@
-.\" This is -*-nroff-*-
-.\" XXX standard disclaimer belongs here....
-.\" $Header: /cvsroot/pgsql/src/man/Attic/notify.l,v 1.6 1998/10/08 01:16:18 tgl Exp $
-.TH "NOTIFY" SQL 11/05/95 PostgreSQL PostgreSQL
-.SH NAME
-notify - signal all frontends and backends listening on a class
-.SH SYNOPSIS
-.nf
-\fBnotify\fR class_name
-.fi
-.SH DESCRIPTION
-This man page is obsolete. More complete and reliable info is
-available in the User's Guide reference page for NOTIFY.
-.PP
-.BR notify
-is used to awaken all backends and consequently all frontends
-that have executed
-.IR listen(l)
-on
-.IR class_name .
-This can be used either within an instance-level rule as part of the
-action body or from a normal query. When used from within a normal
-query, this can be thought of as interprocess communication (IPC).
-When used from within a rule, this can be thought of as an alerter
-mechanism.
-.PP
-Notice that the mere fact that a
-.BR notify
-has been executed does not imply anything in particular about
-the state of the class (e.g., that it has been updated), nor
-does the notification protocol transmit any useful information
-other than the class name. Therefore, all
-.BR notify
-does is indicate that some backend wishes its peers to examine
-.IR class_name
-in some application-specific way.
-.PP
-In fact,
-.IR class_name
-need not be the name of an SQL class at all. It is best thought of
-as a condition name that the application programmer selects.
-.PP
-This event notification is performed through the Libpq protocol
-and frontend application interface. The application program
-must call the routine
-.IR PQnotifies
-in order to find out the name of the class to which a given
-notification corresponds. If this code is not included in
-the application, the event notification will be queued and
-never be processed.
-.SH "SEE ALSO"
-define rule(l),
-listen(l),
-libpq(3).