aboutsummaryrefslogtreecommitdiff
path: root/src/man/listen.l
diff options
context:
space:
mode:
Diffstat (limited to 'src/man/listen.l')
-rw-r--r--src/man/listen.l48
1 files changed, 0 insertions, 48 deletions
diff --git a/src/man/listen.l b/src/man/listen.l
deleted file mode 100644
index e3247a5f84b..00000000000
--- a/src/man/listen.l
+++ /dev/null
@@ -1,48 +0,0 @@
-.\" This is -*-nroff-*-
-.\" XXX standard disclaimer belongs here....
-.\" $Header: /cvsroot/pgsql/src/man/Attic/listen.l,v 1.9 1998/10/08 01:16:17 tgl Exp $
-.TH "LISTEN" SQL 03/12/94 PostgreSQL PostgreSQL
-.SH NAME
-listen - listen for notification on a relation
-.SH SYNOPSIS
-.nf
-\fBlisten\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 LISTEN.
-.PP
-.BR listen
-is used to register the current backend as a listener on the relation
-.IR class_name .
-When the command
-.BI notify " class_name"
-is called either from within a rule or at the query level, the
-frontend applications corresponding to the listening backends
-are notified. When the backend process exits, this registration
-is cleared.
-.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.
-.PP
-Note that
-.IR class_name
-needs not to be a valid class name but can be any ascii string up to 32
-characters long. It must however be eclosed in double-quotes if it is
-not valid as class name.
-.SH "SEE ALSO"
-create_rule(l),
-notify(l),
-select(l),
-unlisten(l),
-libpq.
-.SH BUGS
-The
-.IR psql(1)
-command does not poll for asynchronous events.