BOOTSTRAP (kutils) functions
LIBRARY ROUTINE
kset_announcehandler - set the announce handling routine used by kannounce()
LIBRARY CALL
knotify kset_announcehandler(
knotify new_handler)
INPUT
- new_handler - the announce handler to be called.
OUTPUT
none
RETURN VALUE
the previously installed announce handler, or NULL
if the default announce handler was installed.
DESCRIPTION
Sets the announce handler routine to be used by the kannounce()
reporting facility. When set to NULL (the default), the
Khoros announce handler will be used, which simply prints the
announcement to stderr.
If a different announce handler is set, the announce handler
must be declared as follows, and should return TRUE.
int announce_handler(
char *toolbox,
char *program,
char *library,
char *routine,
char *message)
toolbox - name of toolbox
program - name of program
library - name of library
routine - name of routine
message - grammatically correct, clear announcement message
ADDITIONAL INFORMATION
none
EXAMPLES
none
SIDE EFFECTS
none
RESTRICTIONS
none
MODIFICATION
none
FILES
$BOOTSTRAP/objects/library/kutils/src/notify.c
SEE ALSO
kutils(3)
COPYRIGHT
Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.