chiark / gitweb /
Update manual style.
[mLib] / man / sig.3
index ddfbdb40397bf832018da3ef3948c46b55dcda1b..241c6246d6ce77f960bdc332089b0f6c436c6185 100644 (file)
--- a/man/sig.3
+++ b/man/sig.3
@@ -1,5 +1,5 @@
 .\" -*-nroff-*-
-.TH sel 3 "23 July 1999" mLib
+.TH sel 3 "23 July 1999" "Straylight/Edgeware" "mLib utilities library"
 .SH NAME
 sig \- more controlled signal handling
 .\" @sig_init
@@ -20,9 +20,9 @@ The
 subsystem uses the I/O multiplexing capabilities of
 .B mLib
 (see
-.BR sel (3) for details)
-to provide a more convenient interface for handling signals which don't
-need to be dealt with `right away'.  Like the I/O system,
+.BR sel (3)
+for details) to provide a more convenient interface for handling signals
+which don't need to be dealt with `right away'.  Like the I/O system,
 .B sig
 doesn't allocate any memory for itself: you have to give it space to
 work in.
@@ -39,25 +39,25 @@ To register interest in a signal, call
 .BR sig_add ,
 passing it the following arguments:
 .TP
-.I s
+.BI "sig *" s
 A pointer to an (uninitialized) object of type
 .BR sig .
 This will be used by the system to retain information about this signal
 claim.  You use the address of this object to remove the handler again
 when you've finished.
 .TP
-.I n
+.BI "int " n
 The number of the signal you want to handle.
 .PP
 .TP
-.I proc
+.BI "void (*" proc ")(int " n ", void *" p )
 A function to call when the signal is detected.  The function is passed
 the signal number and the pointer
 .I p
 passed to
 .BR sig_add .
 .TP
-.I p
+.BI "void *" p
 A pointer argument to be passed to
 .I func
 when the signal is detected.
@@ -89,9 +89,5 @@ The
 .B SA_NOCLDSTOP
 flag is also set, so that stopped child processes aren't reported by a
 signal.  This is normally right, but ought to be configurable.
-.PP
-The system uses writes to a nonblocking pipe to integrate with the I/O
-multiplexing system.  It's possible (though very unlikely) that signals
-get lost because the pipe is full.
 .SH "AUTHOR"
 Mark Wooding, <mdw@nsict.org>