X-Git-Url: http://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=man%2Fncurses.3x;h=5b8e708d099a3ab48a88a295d8aec4afb942b7f3;hp=74f390cbc5b63e873c6f8a53b78f74c2578914a8;hb=d1cc319afccb0d472465718a748664e7cef00840;hpb=a90dd7b66fa711acd24d8181ea20e4f57d4b36cd diff --git a/man/ncurses.3x b/man/ncurses.3x index 74f390cb..5b8e708d 100644 --- a/man/ncurses.3x +++ b/man/ncurses.3x @@ -28,7 +28,7 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: ncurses.3x,v 1.145 2020/02/23 01:05:45 tom Exp $ +.\" $Id: ncurses.3x,v 1.149 2020/10/03 20:15:52 tom Exp $ .hy 0 .TH ncurses 3X "" .ie \n(.g .ds `` \(lq @@ -127,7 +127,6 @@ sequence should be used: .PP Most programs would additionally use the sequence: .NS -\fBnonl();\fR \fBintrflush(stdscr, FALSE);\fR \fBkeypad(stdscr, TRUE);\fR .NE @@ -319,8 +318,9 @@ For example, \fBwaddch\fP becomes \fBwadd_wch\fP. .PP .\" .SS Routine Name Index -The following table lists each \fBcurses\fR routine and the name of -the manual page on which it is described. +The following table lists the \fBcurses\fR routines provided in +the \*(``normal\*('' and \*(``wide\*('' libraries and the names of +the manual pages on which they are described. Routines flagged with \*(``*\*('' are ncurses-specific, not described by XPG4 or present in SVr4. .PP @@ -332,17 +332,6 @@ l l . = COLOR_PAIR/\fBcurs_color\fR(3X) PAIR_NUMBER/\fBcurs_attr\fR(3X) -_nc_free_and_exit/\fBcurs_memleaks\fR(3X)* -_nc_freeall/\fBcurs_memleaks\fR(3X)* -_nc_tracebits/\fBcurs_trace\fR(3X)* -_traceattr/\fBcurs_trace\fR(3X)* -_traceattr2/\fBcurs_trace\fR(3X)* -_tracechar/\fBcurs_trace\fR(3X)* -_tracechtype/\fBcurs_trace\fR(3X)* -_tracechtype2/\fBcurs_trace\fR(3X)* -_tracedump/\fBcurs_trace\fR(3X)* -_tracef/\fBcurs_trace\fR(3X)* -_tracemouse/\fBcurs_trace\fR(3X)* add_wch/\fBcurs_add_wch\fR(3X) add_wchnstr/\fBcurs_add_wchstr\fR(3X) add_wchstr/\fBcurs_add_wchstr\fR(3X) @@ -383,6 +372,7 @@ color_content/\fBcurs_color\fR(3X) color_set/\fBcurs_attr\fR(3X) copywin/\fBcurs_overlay\fR(3X) curs_set/\fBcurs_kernel\fR(3X) +curses_trace/\fBcurs_trace\fR(3X)* curses_version/\fBcurs_extend\fR(3X)* def_prog_mode/\fBcurs_kernel\fR(3X) def_shell_mode/\fBcurs_kernel\fR(3X) @@ -403,6 +393,8 @@ endwin/\fBcurs_initscr\fR(3X) erase/\fBcurs_clear\fR(3X) erasechar/\fBcurs_termattrs\fR(3X) erasewchar/\fBcurs_termattrs\fR(3X) +exit_curses/\fBcurs_memleaks\fR(3X)* +exit_terminfo/\fBcurs_memleaks\fR(3X)* extended_color_content/\fBcurs_color\fR(3X)* extended_pair_content/\fBcurs_color\fR(3X)* extended_slk_color/\fBcurs_slk\fR(3X)* @@ -441,6 +433,7 @@ has_colors/\fBcurs_color\fR(3X) has_ic/\fBcurs_termattrs\fR(3X) has_il/\fBcurs_termattrs\fR(3X) has_key/\fBcurs_getch\fR(3X)* +has_mouse/\fBcurs_mouse\fR(3X)* hline/\fBcurs_border\fR(3X) hline_set/\fBcurs_border_set\fR(3X) idcok/\fBcurs_outopts\fR(3X) @@ -594,13 +587,14 @@ nocbreak/\fBcurs_inopts\fR(3X) nodelay/\fBcurs_inopts\fR(3X) noecho/\fBcurs_inopts\fR(3X) nofilter/\fBcurs_util\fR(3X)* -nonl/\fBcurs_outopts\fR(3X) +nonl/\fBcurs_inopts\fR(3X) noqiflush/\fBcurs_inopts\fR(3X) noraw/\fBcurs_inopts\fR(3X) notimeout/\fBcurs_inopts\fR(3X) overlay/\fBcurs_overlay\fR(3X) overwrite/\fBcurs_overlay\fR(3X) pair_content/\fBcurs_color\fR(3X) +pecho_wchar/\fBcurs_pad\fR(3X)* pechochar/\fBcurs_pad\fR(3X) pnoutrefresh/\fBcurs_pad\fR(3X) prefresh/\fBcurs_pad\fR(3X) @@ -611,6 +605,7 @@ qiflush/\fBcurs_inopts\fR(3X) raw/\fBcurs_inopts\fR(3X) redrawwin/\fBcurs_refresh\fR(3X) refresh/\fBcurs_refresh\fR(3X) +reset_color_pairs/\fBcurs_color\fR(3X)* reset_prog_mode/\fBcurs_kernel\fR(3X) reset_shell_mode/\fBcurs_kernel\fR(3X) resetty/\fBcurs_kernel\fR(3X) @@ -650,6 +645,7 @@ slk_refresh/\fBcurs_slk\fR(3X) slk_restore/\fBcurs_slk\fR(3X) slk_set/\fBcurs_slk\fR(3X) slk_touch/\fBcurs_slk\fR(3X) +slk_wset/\fBcurs_slk\fR(3X)* standend/\fBcurs_attr\fR(3X) standout/\fBcurs_attr\fR(3X) start_color/\fBcurs_color\fR(3X) @@ -781,6 +777,19 @@ wunctrl/\fBcurs_util\fR(3X) wvline/\fBcurs_border\fR(3X) wvline_set/\fBcurs_border_set\fR(3X) .TE +.PP +Depending on the configuration, +additional sets of functions may be available: +.RS 3 +.TP 5 +\fBcurs_memleaks\fP(3X) - curses memory-leak checking +.TP 5 +\fBcurs_sp_funcs\fP(3X) - curses screen-pointer extension +.TP 5 +\fBcurs_threads\fP(3X) - curses thread support +.TP 5 +\fBcurs_trace\fP(3X) - curses debugging routines +.RE .SH RETURN VALUE Routines that return an integer return \fBERR\fR upon failure and an integer value other than \fBERR\fR upon successful completion, unless @@ -799,6 +808,13 @@ The return values of \fBgetmaxyx\fR are undefined (i.e., these should not be used as the right-hand side of assignment statements). .PP +Functions with a \*(``mv\*('' prefix first perform a cursor movement using +\fBwmove\fP, and return an error if the position is outside the window, +or if the window pointer is null. +Most \*(``mv\*(''-prefixed functions +(except variadic functions such as \fBmvprintw\fP) +are provided both as macros and functions. +.PP Routines that return pointers return \fBNULL\fR on error. .SH ENVIRONMENT .PP @@ -1483,6 +1499,29 @@ wide-character support. If the header is included, its symbols may be made visible. That depends on the value used for \fB_XOPEN_SOURCE\fP feature test macro. +.bP +X/Open Curses documents one required header, +in a special case: before to prototype +the \fBvw_printw\fP and \fBvw_scanw\fP functions +(as well as the obsolete +the \fBvwprintw\fP and \fBvwscanw\fP functions). +Each of those uses a \fBva_list\fP parameter. +.IP +The two obsolete functions were introduced in SVr3. +The other functions were introduced in X/Open Curses. +In between, SVr4 curses provided for the possibility that +an application might include either or . +Initially, that was done by using \fBvoid*\fP for the \fBva_list\fP +parameter. +Later, a special type (defined in ) was introduced, +to allow for compiler type-checking. +That special type is always available, +because is always included by . +.IP +None of the X/Open Curses implementations require an application +to include before because they either +have allowed for a special type, or (like ncurses) include +directly to provide a portable interface. .SH NOTES .PP If standard output from a \fBncurses\fR program is re-directed to something