BOOTSTRAP (kutils) functions


LIBRARY ROUTINE

kset_announcehandler - set the announce handling routine used by kannounce()

LIBRARY CALL

knotify kset_announcehandler(
   knotify new_handler)

INPUT

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.