X-Git-Url: https://ncurses.scripts.mit.edu/?a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_trace.3x.html;h=c1ea937fd64b6c077e56fab5333385dc21aea9fd;hb=e2153a14ebfb90265151d608778aaf9f403b3d24;hp=295fa5216690aac169ea36310d3413bcb1be24fc;hpb=d90067f9008bb8338a77c1ed519bc108c275ed04;p=ncurses.git diff --git a/doc/html/man/curs_trace.3x.html b/doc/html/man/curs_trace.3x.html index 295fa521..c1ea937f 100644 --- a/doc/html/man/curs_trace.3x.html +++ b/doc/html/man/curs_trace.3x.html @@ -1,6 +1,6 @@ -curs_trace 3x 2023-12-16 ncurses 6.4 Library calls +curs_trace 3x 2024-04-20 ncurses 6.5 Library calls -

curs_trace 3x 2023-12-16 ncurses 6.4 Library calls

+

curs_trace 3x 2024-04-20 ncurses 6.5 Library calls

 curs_trace(3x)                   Library calls                  curs_trace(3x)
 
@@ -55,7 +55,7 @@

SYNOPSIS

        #include <curses.h>
 
-       unsigned curses_trace(const unsigned param);
+       unsigned curses_trace(const unsigned trace-mask);
 
        void _tracef(const char *format, ...);
 
@@ -63,7 +63,7 @@
        char *_traceattr2(int buffer, chtype ch);
        char *_tracecchar_t(const cchar_t *string);
        char *_tracecchar_t2(int buffer, const cchar_t *string);
-       char *_tracechar(int ch);
+       char *_tracechar(int c);
        char *_tracechtype(chtype ch);
        char *_tracechtype2(int buffer, chtype ch);
 
@@ -72,7 +72,7 @@
        char *_tracemouse(const MEVENT *event);
 
        /* deprecated */
-       void trace(const unsigned int param);
+       void trace(const unsigned int trace-mask);

DESCRIPTION

@@ -183,22 +183,13 @@
        guideline.
 
 
-

Initialization

-       These  functions  check  the NCURSES_TRACE environment variable, to set
-       the tracing feature as if curses_trace was called:
-
-           filter,  initscr,  new_prescr,  newterm,   nofilter,   restartterm,
-           ripoffline,      setupterm,     slk_init,     tgetent,     use_env,
-           use_extended_names, use_tioctl
-
-

Command-line Utilities

-       The command-line utilities such as  tic(1)  provide  a  verbose  option
-       which  extends  the  set  of  messages  written  using the curses_trace
-       function.  Both of these (-v and curses_trace) use  the  same  variable
+       The  command-line  utilities  such  as  tic(1) provide a verbose option
+       which extends the  set  of  messages  written  using  the  curses_trace
+       function.   Both  of  these (-v and curses_trace) use the same variable
        (_nc_tracing), which determines the messages which are written.
 
-       Because  the  command-line  utilities may call initialization functions
+       Because the command-line utilities may  call  initialization  functions
        such  as  setupterm,  tgetent  or  use_extended_names,  some  of  their
        debugging output may be directed to the trace file if the NCURSES_TRACE
        environment variable is set:
@@ -207,19 +198,30 @@
 
        o   messages produced by the underlying library are written to trace.
 
-       If ncurses is built without tracing, none of the latter  are  produced,
+       If  ncurses  is built without tracing, none of the latter are produced,
        and fewer diagnostics are provided by the command-line utilities.

RETURN VALUE

-       Routines  which return a value are designed to be used as parameters to
+       Routines which return a value are designed to be used as parameters  to
        the _tracef routine.
 
 
+

ENVIRONMENT

+
+

NCURSES_TRACE

+       A  positive integral value stored in this variable causes the following
+       functions to enable the tracing feature as if curses_trace were called.
+
+           filter, initscr, new_prescr, newterm, nofilter, restartterm,
+           ripoffline, setupterm, slk_init, tgetent, use_env,
+           use_extended_names, use_tioctl
+
+

PORTABILITY

-       These functions are not part of the XSI interface.  Some  other  curses
-       implementations  are  known  to have similar features, but they are not
-       compatible with ncurses:
+       These functions are not part of  the  X/Open  Curses  interface.   Some
+       other  curses  implementations  are known to have similar features, but
+       they are not compatible with ncurses:
 
        o   SVr4 provided traceon and traceoff, to  control  whether  debugging
            information  was  written to the "trace" file.  While the functions
@@ -259,7 +261,7 @@
 
 
 
-ncurses 6.4                       2023-12-16                    curs_trace(3x)
+ncurses 6.5                       2024-04-20                    curs_trace(3x)
  • RETURN VALUE
    • +
  • ENVIRONMENT + +
  • PORTABILITY
  • SEE ALSO