- 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:
+ Calling <STRONG>trace</STRONG> with a nonzero parameter creates the file
+ <STRONG>trace</STRONG> in the current directory for output. If the file
+ already exists, no tracing is done.
+
+ The other functions either return a pointer to a string-
+ area (allocated by the corresponding function), or return
+ no value (such as <STRONG>_tracedump</STRONG>, which implements the screen
+ dump for <STRONG>TRACE_UPDATE</STRONG>). The caller should not free these
+ strings, since the allocation is reused on successive
+ calls. To work around the problem of a single string-area
+ per function, some use a buffer-number parameter, telling
+ the library to allocate additional string-areas.
+
+
+</PRE><H3><a name="h3-Trace-Parameter">Trace Parameter</a></H3><PRE>
+ The trace parameter is formed by OR'ing values from the
+ list of <STRONG>TRACE_</STRONG><EM>xxx</EM> definitions in <STRONG><curses.h></STRONG>. These in-
+ clude: