X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=man%2Fcurs_trace.3x;h=ca7495272d330d51af7f793f152149a67d0cbe3a;hp=9f5b13a4ec53d0fee8adf6f979fe7a2d310d24aa;hb=ce7b402c144d2b6d3773ef5b42aad9daf1ad76fe;hpb=b1f61d9f3aa244512045a6b02e759825d7049d34 diff --git a/man/curs_trace.3x b/man/curs_trace.3x index 9f5b13a4..ca749527 100644 --- a/man/curs_trace.3x +++ b/man/curs_trace.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright (c) 2000 Free Software Foundation, Inc. * +.\" Copyright (c) 2000-2005,2007 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * .\" copy of this software and associated documentation files (the * @@ -26,8 +26,10 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_trace.3x,v 1.2 2000/07/08 12:42:51 tom Exp $ +.\" $Id: curs_trace.3x,v 1.8 2007/02/24 17:33:49 tom Exp $ .TH curs_trace 3X "" +.na +.hy 0 .SH NAME \fB_tracef\fR, \fB_tracedump\fR, @@ -39,9 +41,11 @@ \fB_tracechtype2\fR, \fB_tracemouse\fR, \fBtrace\fR - \fBcurses\fR debugging routines +.ad +.hy .SH SYNOPSIS \fB#include \fR -.br +.sp \fBvoid _tracef(const char *format, ...);\fR .br \fBvoid _tracedump(const char *label, WINDOW *win);\fR @@ -52,7 +56,7 @@ .br \fBchar *_nc_tracebits(void);\fR .br -\fBchar *_tracechar(const unsigned char ch);\fR +\fBchar *_tracechar(int);\fR .br \fBchar *_tracechtype(chtype ch);\fR .br @@ -67,11 +71,11 @@ as well as applications which use the ncurses libraries. These functions are normally available only with the debugging library \fIlibncurses_g.a\fR, but may be compiled into any model (shared, static, profile) by defining the symbol \fBTRACE\fR. - +.PP The principal parts of this interface are the \fBtrace\fR routine which selectively enables different tracing features, and the \fB_tracef\fR routine which writes formatted data to the \fItrace\fR file. - +.PP Calling \fBtrace\fR with a nonzero parameter opens the file \fBtrace\fR in the current directory for output. The parameter is formed by OR'ing values from the list of \fBTRACE_\fP\fIxxx\fR definitions in \fB\fR. @@ -122,13 +126,15 @@ trace per-character calls. TRACE_DATABASE trace read/write of terminfo/termcap data. .TP 5 +TRACE_ATTRS +trace changes to video attributes and colors. +.TP 5 TRACE_MAXIMUM maximum trace level, enables all of the separate trace features. - +.PP Some tracing features are enabled whenever the \fBtrace\fR parameter is nonzero. Some features overlap. The specific names are used as a guideline. -.. .SH RETURN VALUE Routines which return a value are designed to be used as parameters to the \fB_tracef\fR routine.