NAME

add_error - Adds an additional line to the error messages

SYNOPSIS

#include "l/l_sys_err.h"

Example compile flags (system dependent):
  -DLINUX_X86_64 -DLINUX_X86_64_OPTERON  -DGNU_COMPILER 
   -I/home/kobus/include
   -L/home/kobus/misc/load/linux_x86_64_opteron -L/usr/lib/x86_64-linux-gnu
  -lKJB                               -lfftw3  -lgsl -lgslcblas -ljpeg  -lSVM -lstdc++                    -lpthread -lSLATEC -lg2c    -lacml -lacml_mv -lblas -lg2c      -lncursesw 


void add_error
(
	const char *format_str,
	...
);

DESCRIPTION

This routine is similar to set_error, except that the line is added to the set of message strings, each of which corresponds to a line on output. It is valid to use add_error without a corresponding set_error, but doing so in such a way that makes sense normally requires kjb_clear_error. The argmuents to add_error is a format string followed by zero or more corresponding arguments. See kjb_fprintf for some of the non-standard options useful for error messages like %S, %F, %D. (%S is particularly helpful---it accesses the error messages from the last unsuccessful system call).

DISCLAIMER

This software is not adequatedly tested. It is recomended that results are checked independantly where appropriate.

AUTHOR

Kobus Barnard

DOCUMENTER

Kobus Barnard

SEE ALSO

push_error_action , pop_error_action , set_error_action , get_error_action , set_bug_handler , default_bug_handler , kjb_print_error , kjb_get_error , kjb_get_strlen_error , kjb_clear_error , set_error , cat_error , insert_error , str_set_error , str_add_error , str_cat_error , str_insert_error , set_bug