X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_trace.3x.html;h=85ffaad03b7ac8008e0ed04e062f224aa42154f0;hp=e8ae83b90b1cb03943b0cc9cfb223eaa664cb100;hb=f344f8539c1543f8cd65a5bb142dbaf23b9421d2;hpb=1dd25cc0259e0683290fe889707b04979b5fda0a

diff --git a/doc/html/man/curs_trace.3x.html b/doc/html/man/curs_trace.3x.html
index e8ae83b9..85ffaad0 100644
--- a/doc/html/man/curs_trace.3x.html
+++ b/doc/html/man/curs_trace.3x.html
@@ -1,6 +1,6 @@
 <!-- 
   ****************************************************************************
-  * Copyright (c) 2000-2015,2016 Free Software Foundation, Inc.              *
+  * Copyright (c) 2000-2016,2017 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,7 +26,7 @@
   * sale, use or other dealings in this Software without prior written       *
   * authorization.                                                           *
   ****************************************************************************
-  * @Id: curs_trace.3x,v 1.16 2016/12/03 23:53:23 tom Exp @
+  * @Id: curs_trace.3x,v 1.18 2017/01/14 19:46:40 tom Exp @
 -->
 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN">
 <HTML>
@@ -123,7 +123,7 @@
             trace user and system times of updates.
 
        <STRONG>TRACE_TPUTS</STRONG>
-            trace <STRONG>tputs</STRONG> calls.
+            trace <STRONG><A HREF="curs_terminfo.3x.html">tputs(3x)</A></STRONG> calls.
 
        <STRONG>TRACE_UPDATE</STRONG>
             trace update actions, old &amp; new screens.
@@ -182,6 +182,30 @@
            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.
+
+
 </PRE><H2><a name="h2-RETURN-VALUE">RETURN VALUE</a></H2><PRE>
        Routines which return a value are designed to be  used  as
        parameters to the <STRONG>_tracef</STRONG> routine.
@@ -215,6 +239,7 @@
 <li><a href="#h3-Functions">Functions</a></li>
 <li><a href="#h3-Trace-Parameter">Trace Parameter</a></li>
 <li><a href="#h3-Initialization">Initialization</a></li>
+<li><a href="#h3-Command-line-Utilities">Command-line Utilities</a></li>
 </ul>
 </li>
 <li><a href="#h2-RETURN-VALUE">RETURN VALUE</a></li>
