-</PRE>
-<H2>DESCRIPTION</H2><PRE>
- The <B>trace</B> 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 <I>libncurses</I><B>_</B><I>g.a</I>, but may be com-
- piled into any model (shared, static, profile) by defining
- the symbol <B>TRACE</B>.
-
- The principal parts of this interface are the <B>trace</B> rou-
- tine which selectively enables different tracing features,
- and the <B>_tracef</B> routine which writes formatted data to the
- <I>trace</I> file.
-
- Calling <B>trace</B> with a nonzero parameter opens the file
- <B>trace</B> in the current directory for output. The parameter
- is formed by OR'ing values from the list of <B>TRACE_</B><I>xxx</I> def-
- initions in <B><curses.h></B>. These include:
-
- TRACE_DISABLE
+
+</PRE><H2><a name="h2-SYNOPSIS">SYNOPSIS</a></H2><PRE>
+ <STRONG>#include</STRONG> <STRONG><curses.h></STRONG>
+
+ <STRONG>void</STRONG> <STRONG>_tracef(const</STRONG> <STRONG>char</STRONG> <STRONG>*</STRONG><EM>format</EM><STRONG>,</STRONG> <STRONG>...);</STRONG>
+ <STRONG>void</STRONG> <STRONG>_tracedump(const</STRONG> <STRONG>char</STRONG> <STRONG>*</STRONG><EM>label</EM><STRONG>,</STRONG> <STRONG>WINDOW</STRONG> <STRONG>*</STRONG><EM>win</EM><STRONG>);</STRONG>
+ <STRONG>char</STRONG> <STRONG>*_traceattr(attr_t</STRONG> <EM>attr</EM><STRONG>);</STRONG>
+ <STRONG>char</STRONG> <STRONG>*_traceattr2(int</STRONG> <EM>buffer</EM><STRONG>,</STRONG> <STRONG>chtype</STRONG> <EM>ch</EM><STRONG>);</STRONG>
+ <STRONG>char</STRONG> <STRONG>*_nc_tracebits(void);</STRONG>
+ <STRONG>char</STRONG> <STRONG>*</STRONG> <STRONG>_tracecchar_t(const</STRONG> <STRONG>cchar_t</STRONG> <STRONG>*</STRONG><EM>string</EM><STRONG>);</STRONG>
+ <STRONG>char</STRONG> <STRONG>*</STRONG> <STRONG>_tracecchar_t2(int</STRONG> <EM>buffer</EM><STRONG>,</STRONG> <STRONG>const</STRONG> <STRONG>cchar_t</STRONG> <STRONG>*</STRONG><EM>string</EM><STRONG>);</STRONG>
+ <STRONG>char</STRONG> <STRONG>*_tracechar(int</STRONG> <EM>ch</EM><STRONG>);</STRONG>
+ <STRONG>char</STRONG> <STRONG>*_tracechtype(chtype</STRONG> <EM>ch</EM><STRONG>);</STRONG>
+ <STRONG>char</STRONG> <STRONG>*_tracechtype2(int</STRONG> <EM>buffer</EM><STRONG>,</STRONG> <STRONG>chtype</STRONG> <EM>ch</EM><STRONG>);</STRONG>
+ <STRONG>char</STRONG> <STRONG>*_tracemouse(const</STRONG> <STRONG>MEVENT</STRONG> <STRONG>*</STRONG><EM>event</EM><STRONG>);</STRONG>
+ <STRONG>void</STRONG> <STRONG>trace(const</STRONG> <STRONG>unsigned</STRONG> <STRONG>int</STRONG> <EM>param</EM><STRONG>);</STRONG>
+
+
+</PRE><H2><a name="h2-DESCRIPTION">DESCRIPTION</a></H2><PRE>
+ The <STRONG>trace</STRONG> 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 e.g., <EM>libncurses</EM><STRONG>_</STRONG><EM>g.a</EM>, but may be
+ compiled into any model (shared, static, profile) by
+ defining the symbol <STRONG>TRACE</STRONG>. Additionally, some functions
+ are only available with the wide-character configuration
+ of the libraries.
+
+ The principal parts of this interface are
+
+ <STRONG>o</STRONG> <STRONG>trace</STRONG>, which selectively enables different tracing
+ features, and
+
+ <STRONG>o</STRONG> <STRONG>_tracef</STRONG>, which writes formatted data to the <EM>trace</EM>
+ file.
+
+ Calling <STRONG>trace</STRONG> with a nonzero parameter opens the file
+ <STRONG>trace</STRONG> in the current directory for output. The parameter
+ is formed by OR'ing values from the list of <STRONG>TRACE_</STRONG><EM>xxx</EM> def-
+ initions in <STRONG><curses.h></STRONG>. These include:
+
+ <STRONG>TRACE_DISABLE</STRONG>