.TH DL 3
.SH NAME
DL - generate logging messages in C and C++ using a debugger
.SH SYNOPSIS
#include
DL(format,...)
DLG(guard,format,...)
DLH(handler,format,...)
DLP(param,format,...)
DLGH(guard,handler,format,...)
DLHP(handler,param,format,...)
DLGHP(guard,handler,param,format,...)
.SH DESCRIPTION
The DL macro is used to print logging or debugging messages using
a debugger. The nana(1) command generates a set of debugger commands
which are then sourced into gdb(1) to implement the logging. If you
don't run the executable under gdb(1) then no tracing will occur.
The arguments are:
format,... - a printf(3) style argument list containing the message
guard - print only if the guard is true.
handler - the code that does the printing. Default: fprintf
param - a parameter to be passed off to the handler. Default: stdout
See nana.info for details on configuring the behaviour.
.SH SEE ALSO
nana-clg(1), nana(1), nana(3), I(3), DI(3), L(3), DL(3), Q(3) and nana.info.
The nana.info file is the primary documentation for this library.
.SH AUTHOR
Phil Maker