\section NAME
liberror - error reporting library
\break

\section DESCRIPTION
liberror is the resident library under C-Ware for reporting error
\break
messages in a structured, computer-readable format. As described in
\break
\bold-on
cware
\bold-off
(cware), liberror produces error messages in the format:
\break
\break
\bold-on
\set-indent 4
{TYPE}\\t{FUNCTION}\\t{ERROR-MESSSAGE}\\t{FILE}\\t{LINE}
\set-indent 0
\bold-off
\break
\break
Liberror is intended to be used to allow togglable safety mechanisms
\break
in C-Ware code, like checking for NULL pointers. By design, the various
\break
components of the library are designed to be composed together into
\break
larger error checking operations to validate entire structures, for
\break
example. Also provided is a basic API for adding additional runtime
\break
error checks such as whether or not a structure has been passed through
\break
an operation that releases it from memory. All of this can be enabled
\break
through the definition of the
\space
\bold-on
CWARE_SAFETY_CHECKS
\bold-off
\space
macro. The manuals for the
\break
operations can be found below:
\break
\break
MANUAL
\set-indent 20
SYNOPSIS
\set-indent 0
\break
-----------------------------------------------------------------------
\break
LIBERROR_ASSERT(cware)
\set-indent 4
assert a condition with debugging information
\break
\set-indent 0
LIBERROR_TEST(cware)
\set-indent 6
wrapper over LIBERROR_ASSERT for testcases
\break
\set-indent 0


\section SEE ALSO
\bold-on
cware
\bold-off
(cware)