aboutsummaryrefslogtreecommitdiff
path: root/man/man3/notify.3
diff options
context:
space:
mode:
authorRuss Cox <rsc@swtch.com>2020-08-13 23:41:59 -0400
committerRuss Cox <rsc@swtch.com>2020-08-13 23:43:43 -0400
commit977b25a76ae8263e53fb4eb1abfc395769f23e3d (patch)
treeb04cc1be9205fd85f588e9434642e8aed8a8a4fd /man/man3/notify.3
parenta1c4307800c7f1ef9c5d71ba4c6c3642837e2877 (diff)
downloadplan9port-977b25a76ae8263e53fb4eb1abfc395769f23e3d.tar.gz
plan9port-977b25a76ae8263e53fb4eb1abfc395769f23e3d.tar.bz2
plan9port-977b25a76ae8263e53fb4eb1abfc395769f23e3d.zip
tmac: introduce real manual reference macro instead of overloading IR
The overloading of IR emits magic \X'...' sequences that turn into HTML manual links. But not all such IR invocations should be manual links; those had to be written to avoid the IR macro before. Worse, the \X'...' ending the IR causes troff to emit only a single space after a period. Defining a new IM macro for manual references fixes both problems. Fixes #441.
Diffstat (limited to 'man/man3/notify.3')
-rw-r--r--man/man3/notify.320
1 files changed, 10 insertions, 10 deletions
diff --git a/man/man3/notify.3 b/man/man3/notify.3
index 7dd768e7..269fe4b0 100644
--- a/man/man3/notify.3
+++ b/man/man3/notify.3
@@ -33,12 +33,12 @@ or writing on a closed pipe, a
is posted to communicate the exception.
A note may also be posted by another process
via
-.IR postnote (3).
+.IM postnote (3) .
On Unix, notes are implemented as signals.
.PP
When a note is received, the action taken depends on the note.
See
-.IR signal (7)
+.IM signal (7)
for the full description of the defaults.
.PP
The default actions may be overridden.
@@ -53,10 +53,10 @@ replaces the previous handler, if any.
An argument of zero cancels a previous handler,
restoring the default action.
A
-.IR fork (2)
+.IM fork (2)
system call leaves the handler registered in
both the parent and the child;
-.IR exec (3)
+.IM exec (3)
restores the default behavior.
Handlers may not perform floating point operations.
.PP
@@ -112,17 +112,17 @@ set up with
using the
.I notejmp
function (see
-.IR setjmp (3)).
+.IM setjmp (3) ).
.PP
Unix provides a fixed set of notes (typically there are 32) called
.IR signals .
It also allows a process to block certain notes from being delivered
(see
-.IR sigprocmask (2))
+.IM sigprocmask (2) )
and to ignore certain notes by setting the signal hander to the special value
.B SIG_IGN
(see
-.IR signal (2)).
+.IM signal (2) ).
.I Noteenable
and
.I notedisable
@@ -137,7 +137,7 @@ is called upon receipt of the note; if the handler is not called, the note is di
Regardless of the origin of the note or the presence of a handler,
if the process is being debugged
(see
-.IR ptrace (2))
+.IM ptrace (2) )
the arrival of a note puts the process in the
.B Stopped
state and awakens the debugger.
@@ -252,7 +252,7 @@ are usually generated by the operating system.
.br
.B \*9/src/lib9/atnotify.c
.SH SEE ALSO
-.IR intro (3),
+.IM intro (3) ,
.I notejmp
in
-.IR setjmp (3)
+.IM setjmp (3)