summaryrefslogtreecommitdiff
path: root/man/XtAppAddSignal.man
diff options
context:
space:
mode:
Diffstat (limited to 'man/XtAppAddSignal.man')
-rw-r--r--man/XtAppAddSignal.man28
1 files changed, 14 insertions, 14 deletions
diff --git a/man/XtAppAddSignal.man b/man/XtAppAddSignal.man
index 1a5282e..f959839 100644
--- a/man/XtAppAddSignal.man
+++ b/man/XtAppAddSignal.man
@@ -74,51 +74,51 @@ Specifies the argument that is to be passed to the specified procedure
when a signal has been raised.
.IP \fIid\fP 1i
Specifies the ID returned from the corresponding
-.ZN XtAppAddSignal
+.BR XtAppAddSignal
call.
.IP \fIproc\fP 1i
Specifies the procedure that is to be called when the signal has been
raised.
.SH DESCRIPTION
The
-.ZN XtAppAddSignal
+.BR XtAppAddSignal
function initiates a mechanism for handling signals within the context
of the Intrinsics. Prior to establishing an operating system dependent
signal handler the application may call
-.ZN XtAppAddSignal
+.BR XtAppAddSignal
and store the returned \fIid\fP in a place accessible to the signal
handler.
.LP
Upon receipt of a signal from the operating system, the application may
call
-.ZN XtNoticeSignal
+.BR XtNoticeSignal
passing the \fIid\fP returned by the call to
-.ZN XtAppAddSignal .
+.BR XtAppAddSignal .
.LP
-.ZN XtNoticeSignal
+.BR XtNoticeSignal
is the only Intrinsics function that can safely be called from a signal
handler. If
-.ZN XtNoticeSignal
+.BR XtNoticeSignal
is called multiple times before the Intrinsics are able to invoke the
registered callback, the callback is only called once. Logically the
Intrinsics maintain ``pending'' for each registered callback. This
flag is initially
-.ZN False
+.BR False
and is set to
-.ZN True
+.BR True
by
-.ZN XtNoticeSignal ;
+.BR XtNoticeSignal ;
the Intrinsics invoke the callback whenever the flag is
-.ZN True ,
+.BR True ,
and the flag is set to
-.ZN False
+.BR False
just before the callback is invoked.
.LP
The
-.ZN XtRemoveSignal
+.BR XtRemoveSignal
function is called to remove the specified Intrinsics signal handler. The
client should disable the source of the signal before calling
-.ZN XtRemoveSignal .
+.BR XtRemoveSignal .
.SH "SEE ALSO"
XtAppAddTimeOut(__libmansuffix__),XtAppAddInput(__libmansuffix__),XtAppAddWorkProc(__libmansuffix__)
.br