X-Git-Url: http://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_trace.3x.html;h=d3c9eebd982b07628b139bcb16c46ad66c52fe2c;hp=51d082c52e67d0a31213c35ceab1fba2b0254295;hb=761e4f0825b330e970558e82a4bd638383914429;hpb=c633e5103a29a38532cf1925257b91cea33fd090 diff --git a/doc/html/man/curs_trace.3x.html b/doc/html/man/curs_trace.3x.html index 51d082c5..d3c9eebd 100644 --- a/doc/html/man/curs_trace.3x.html +++ b/doc/html/man/curs_trace.3x.html @@ -1,48 +1,96 @@ + + +
++curs_trace(3x) curs_trace(3x) + + +
- _tracef, _tracedump, _traceattr, _traceattr2, - _nc_tracebits, _tracechar, _tracechtype, _tracechtype2, - _tracemouse, trace - curses debugging routines + _tracef, _tracedump, _traceattr, _traceattr2, + _nc_tracebits, _tracecchar_t, _tracecchar_t2, _tracechar, + _tracechtype, _tracechtype2, _tracemouse, trace - curses + debugging routines
- #include <curses.h> - void _tracef(const char *format, ...); - void _tracedump(const char *label, WINDOW *win); - char *_traceattr(attr_t attr); - char *_traceattr2(int buffer, chtype ch); - char *_nc_tracebits(void); - char *_tracechar(const unsigned char ch); - char *_tracechtype(chtype ch); - char *_tracechtype2(int buffer, chtype ch); - char *_tracemouse(const MEVENT *event); - void trace(const unsigned int param); + #include <curses.h> + + void _tracef(const char *format, ...); + void _tracedump(const char *label, WINDOW *win); + char *_traceattr(attr_t attr); + char *_traceattr2(int buffer, chtype ch); + char *_nc_tracebits(void); + char * _tracecchar_t(const cchar_t *string); + char * _tracecchar_t2(int buffer, const cchar_t *string); + char *_tracechar(int ch); + char *_tracechtype(chtype ch); + char *_tracechtype2(int buffer, chtype ch); + char *_tracemouse(const MEVENT *event); + void trace(const unsigned int param);
- The trace routines are used for debugging the ncurses - libraries, as well as applications which use the ncurses - libraries. These functions are normally available only - with the debugging library libncurses_g.a, but may be com- - piled into any model (shared, static, profile) by defining - the symbol TRACE. - - The principal parts of this interface are the trace rou- + The trace routines are used for debugging the ncurses li- + braries, as well as applications which use the ncurses li- + braries. These functions are normally available only with + the debugging library libncurses_g.a, but may be compiled + into any model (shared, static, profile) by defining the + symbol TRACE. Additionally, some functions are only + available with the wide-character configuration of the li- + braries. + + The principal parts of this interface are the trace rou- tine which selectively enables different tracing features, - and the _tracef routine which writes formatted data to the - trace file. + and the _tracef routine which writes formatted data to the + trace file. - Calling trace with a nonzero parameter opens the file - trace in the current directory for output. The parameter - is formed by OR'ing values from the list of TRACE_xxx def- - initions in <curses.h>. These include: + Calling trace with a nonzero parameter opens the file + trace in the current directory for output. The parameter + is formed by OR'ing values from the list of TRACE_xxx def- + initions in <curses.h>. These include: TRACE_DISABLE turn off tracing. @@ -63,16 +111,16 @@ trace all character outputs. TRACE_ORDINARY - trace all update actions. The old and new screen - contents are written to the trace file for each - refresh. + trace all update actions. The old and new screen + contents are written to the trace file for each re- + fresh. TRACE_CALLS trace all curses calls. The parameters for each call are traced, as well as return values. TRACE_VIRTPUT - trace virtual character puts, i.e., calls to addch. + trace virtual character puts, i.e., calls to addch. TRACE_IEVENT trace low-level input processing, including timeouts. @@ -96,15 +144,21 @@ maximum trace level, enables all of the separate trace features. - Some tracing features are enabled whenever the trace - parameter is nonzero. Some features overlap. The - specific names are used as a guideline. + Some tracing features are enabled whenever the trace pa- + rameter is nonzero. Some features overlap. The specific + names are used as a guideline. + + These functions check the NCURSES_TRACE environment vari- + able, to set the tracing feature as if trace was called: + filter, initscr, new_prescr, newterm, nofilter, + ripoffline, setupterm, slk_init, tgetent +
Routines which return a value are designed to be used as - parameters to the _tracef routine. + parameters to the _tracef routine.@@ -117,11 +171,11 @@
- curses(3x). - + curses(3x). + curs_trace(3x)