- filter, initscr, new_prescr, newterm, nofilter,
- restartterm, ripoffline, setupterm, slk_init, tge-
- tent, use_env, use_extended_names, use_tioctl
+ filter, initscr, new_prescr, newterm, nofilter,
+ restartterm, ripoffline, setupterm, slk_init, tgetent,
+ use_env, use_extended_names, use_tioctl
+
+
+</PRE><H3><a name="h3-Command-line-Utilities">Command-line Utilities</a></H3><PRE>
+ The command-line utilities such as <STRONG><A HREF="tic.1m.html">tic(1)</A></STRONG> provide a ver-
+ bose option which extends the set of messages written us-
+ ing the <STRONG>trace</STRONG> function. Both of these (<STRONG>-v</STRONG> and <STRONG>trace</STRONG>) use
+ the same variable (<STRONG>_nc_tracing</STRONG>), which determines the mes-
+ sages which are written.
+
+ Because the command-line utilities may call initialization
+ functions such as <STRONG>setupterm</STRONG>, <STRONG>tgetent</STRONG> or <STRONG>use_extend-</STRONG>
+ <STRONG>ed_names</STRONG>, some of their debugging output may be directed
+ to the <EM>trace</EM> file if the <STRONG>NCURSES_TRACE</STRONG> environment vari-
+ able is set:
+
+ <STRONG>o</STRONG> messages produced in the utility are written to the
+ standard error.
+
+ <STRONG>o</STRONG> messages produced by the underlying library are writ-
+ ten to <EM>trace</EM>.
+
+ If ncurses is built without tracing, none of the latter
+ are produced, and fewer diagnostics are provided by the
+ command-line utilities.