d51a95053b11b613d9b643366421e986ea943182
[ncurses.git] / man / ncurses.3x
1 '\" t
2 .\"***************************************************************************
3 .\" Copyright 2018-2019,2020 Thomas E. Dickey                                *
4 .\" Copyright 1998-2015,2017 Free Software Foundation, Inc.                  *
5 .\"                                                                          *
6 .\" Permission is hereby granted, free of charge, to any person obtaining a  *
7 .\" copy of this software and associated documentation files (the            *
8 .\" "Software"), to deal in the Software without restriction, including      *
9 .\" without limitation the rights to use, copy, modify, merge, publish,      *
10 .\" distribute, distribute with modifications, sublicense, and/or sell       *
11 .\" copies of the Software, and to permit persons to whom the Software is    *
12 .\" furnished to do so, subject to the following conditions:                 *
13 .\"                                                                          *
14 .\" The above copyright notice and this permission notice shall be included  *
15 .\" in all copies or substantial portions of the Software.                   *
16 .\"                                                                          *
17 .\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS  *
18 .\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF               *
19 .\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.   *
20 .\" IN NO EVENT SHALL THE ABOVE COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,   *
21 .\" DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR    *
22 .\" OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR    *
23 .\" THE USE OR OTHER DEALINGS IN THE SOFTWARE.                               *
24 .\"                                                                          *
25 .\" Except as contained in this notice, the name(s) of the above copyright   *
26 .\" holders shall not be used in advertising or otherwise to promote the     *
27 .\" sale, use or other dealings in this Software without prior written       *
28 .\" authorization.                                                           *
29 .\"***************************************************************************
30 .\"
31 .\" $Id: ncurses.3x,v 1.146 2020/03/14 23:13:18 tom Exp $
32 .hy 0
33 .TH ncurses 3X ""
34 .ie \n(.g .ds `` \(lq
35 .el       .ds `` ``
36 .ie \n(.g .ds '' \(rq
37 .el       .ds '' ''
38 .de bP
39 .ie n  .IP \(bu 4
40 .el    .IP \(bu 2
41 ..
42 .de NS
43 .ie n  .sp
44 .el    .sp .5
45 .ie n  .in +4
46 .el    .in +2
47 .nf
48 .ft C                   \" Courier
49 ..
50 .de NE
51 .fi
52 .ft R
53 .ie n  .in -4
54 .el    .in -2
55 ..
56 .ds n 5
57 .ds d @TERMINFO@
58 .SH NAME
59 \fBncurses\fR \- CRT screen handling and optimization package
60 .SH SYNOPSIS
61 \fB#include <curses.h>\fR
62 .br
63 .SH DESCRIPTION
64 The \fBncurses\fR library routines give the user a terminal-independent method
65 of updating character screens with reasonable optimization.
66 This implementation is \*(``new curses\*('' (ncurses) and
67 is the approved replacement for
68 4.4BSD classic curses, which has been discontinued.
69 This describes \fBncurses\fR
70 version @NCURSES_MAJOR@.@NCURSES_MINOR@ (patch @NCURSES_PATCH@).
71 .PP
72 The \fBncurses\fR library emulates the curses library of
73 System V Release 4 UNIX,
74 and XPG4 (X/Open Portability Guide) curses (also known as XSI curses).
75 XSI stands for X/Open System Interfaces Extension.
76 The \fBncurses\fR library is freely redistributable in source form.
77 Differences from the SVr4
78 curses are summarized under the
79 \fBEXTENSIONS\fP and \fBPORTABILITY\fP sections below and
80 described in detail in the respective
81 \fBEXTENSIONS\fP, \fBPORTABILITY\fP and \fBBUGS\fP sections
82 of individual man pages.
83 .PP
84 The \fBncurses\fR library also provides many useful extensions,
85 i.e., features which cannot be implemented by a simple add-on library
86 but which require access to the internals of the library.
87 .PP
88 A program using these routines must be linked with the \fB\-lncurses\fR option,
89 or (if it has been generated) with the debugging library \fB\-lncurses_g\fR.
90 (Your system integrator may also have installed these libraries under
91 the names \fB\-lcurses\fR and \fB\-lcurses_g\fR.)
92 The ncurses_g library generates trace logs (in a file called 'trace' in the
93 current directory) that describe curses actions.
94 See also the section on \fBALTERNATE CONFIGURATIONS\fP.
95 .PP
96 The \fBncurses\fR package supports: overall screen, window and pad
97 manipulation; output to windows and pads; reading terminal input; control over
98 terminal and \fBcurses\fR input and output options; environment query
99 routines; color manipulation; use of soft label keys; terminfo capabilities;
100 and access to low-level terminal-manipulation routines.
101 .SS Initialization
102 .PP
103 The library uses the locale which the calling program has initialized.
104 That is normally done with \fBsetlocale\fP:
105 .NS
106 \fBsetlocale(LC_ALL, "");\fP
107 .NE
108 .PP
109 If the locale is not initialized,
110 the library assumes that characters are printable as in ISO\-8859\-1,
111 to work with certain legacy programs.
112 You should initialize the locale and not rely on specific details of
113 the library when the locale has not been setup.
114 .PP
115 The function \fBinitscr\fR or \fBnewterm\fR
116 must be called to initialize the library
117 before any of the other routines that deal with windows
118 and screens are used.
119 The routine \fBendwin\fR(3X) must be called before exiting.
120 .PP
121 To get character-at-a-time input without echoing (most
122 interactive, screen oriented programs want this), the following
123 sequence should be used:
124 .NS
125 \fBinitscr(); cbreak(); noecho();\fR
126 .NE
127 .PP
128 Most programs would additionally use the sequence:
129 .NS
130 \fBnonl();\fR
131 \fBintrflush(stdscr, FALSE);\fR
132 \fBkeypad(stdscr, TRUE);\fR
133 .NE
134 .PP
135 Before a \fBcurses\fR program is run, the tab stops of the terminal
136 should be set and its initialization strings, if defined, must be output.
137 This can be done by executing the \fB@TPUT@ init\fR command
138 after the shell environment variable \fBTERM\fR has been exported.
139 \fB@TSET@(1)\fR is usually responsible for doing this.
140 [See \fBterminfo\fR(\*n) for further details.]
141 .SS Datatypes
142 .PP
143 The \fBncurses\fR library permits manipulation of data structures,
144 called \fIwindows\fR, which can be thought of as two-dimensional
145 arrays of characters representing all or part of a CRT screen.
146 A default window called \fBstdscr\fR, which is the size of the terminal
147 screen, is supplied.
148 Others may be created with \fBnewwin\fR.
149 .PP
150 Note that \fBcurses\fR does not handle overlapping windows, that's done by
151 the \fBpanel\fR(3X) library.
152 This means that you can either use
153 \fBstdscr\fR or divide the screen into tiled windows and not using
154 \fBstdscr\fR at all.
155 Mixing the two will result in unpredictable, and undesired, effects.
156 .PP
157 Windows are referred to by variables declared as \fBWINDOW *\fR.
158 These data structures are manipulated with routines described here and
159 elsewhere in the \fBncurses\fR manual pages.
160 Among those, the most basic
161 routines are \fBmove\fR and \fBaddch\fR.
162 More general versions of
163 these routines are included with names beginning with \fBw\fR,
164 allowing the user to specify a window.
165 The routines not beginning
166 with \fBw\fR affect \fBstdscr\fR.
167 .PP
168 After using routines to manipulate a window, \fBrefresh\fR(3X) is called,
169 telling \fBcurses\fR to make the user's CRT screen look like
170 \fBstdscr\fR.
171 The characters in a window are actually of type
172 \fBchtype\fR, (character and attribute data) so that other information
173 about the character may also be stored with each character.
174 .PP
175 Special windows called \fIpads\fR may also be manipulated.
176 These are windows
177 which are not constrained to the size of the screen and whose contents need not
178 be completely displayed.
179 See \fBcurs_pad\fR(3X) for more information.
180 .PP
181 In addition to drawing characters on the screen, video attributes and colors
182 may be supported, causing the characters to show up in such modes as
183 underlined, in reverse video, or in color on terminals that support such
184 display enhancements.
185 Line drawing characters may be specified to be output.
186 On input, \fBcurses\fR is also able to translate arrow and function keys that
187 transmit escape sequences into single values.
188 The video attributes, line
189 drawing characters, and input values use names, defined in \fB<curses.h>\fR,
190 such as \fBA_REVERSE\fR, \fBACS_HLINE\fR, and \fBKEY_LEFT\fR.
191 .SS Environment variables
192 .PP
193 If the environment variables \fBLINES\fR and \fBCOLUMNS\fR are set, or if the
194 program is executing in a window environment, line and column information in
195 the environment will override information read by \fIterminfo\fR.
196 This would affect a program running in an AT&T 630 layer,
197 for example, where the size of a
198 screen is changeable (see \fBENVIRONMENT\fR).
199 .PP
200 If the environment variable \fBTERMINFO\fR is defined, any program using
201 \fBcurses\fR checks for a local terminal definition before checking in the
202 standard place.
203 For example, if \fBTERM\fR is set to \fBatt4424\fR, then the
204 compiled terminal definition is found in
205 .NS
206 \fB\*d/a/att4424\fR.
207 .NE
208 .PP
209 (The \fBa\fR is copied from the first letter of \fBatt4424\fR to avoid
210 creation of huge directories.)  However, if \fBTERMINFO\fR is set to
211 \fB$HOME/myterms\fR, \fBcurses\fR first checks
212 .NS
213 \fB$HOME/myterms/a/att4424\fR,
214 .NE
215 .PP
216 and if that fails, it then checks
217 .NS
218 \fB\*d/a/att4424\fR.
219 .NE
220 .PP
221 This is useful for developing experimental definitions or when write
222 permission in \fB\*d\fR is not available.
223 .PP
224 The integer variables \fBLINES\fR and \fBCOLS\fR are defined in
225 \fB<curses.h>\fR and will be filled in by \fBinitscr\fR with the size of the
226 screen.
227 The constants \fBTRUE\fR and \fBFALSE\fR have the values \fB1\fR and
228 \fB0\fR, respectively.
229 .PP
230 The \fBcurses\fR routines also define the \fBWINDOW *\fR variable \fBcurscr\fR
231 which is used for certain low-level operations like clearing and redrawing a
232 screen containing garbage.
233 The \fBcurscr\fR can be used in only a few routines.
234 .\"
235 .SS Routine and Argument Names
236 Many \fBcurses\fR routines have two or more versions.
237 The routines prefixed with \fBw\fR require a window argument.
238 The routines prefixed with \fBp\fR require a pad argument.
239 Those without a prefix generally use \fBstdscr\fR.
240 .PP
241 The routines prefixed with \fBmv\fR require a \fIy\fR and \fIx\fR
242 coordinate to move to before performing the appropriate action.
243 The \fBmv\fR routines imply a call to \fBmove\fR before the call to the
244 other routine.
245 The coordinate \fIy\fR always refers to the row (of
246 the window), and \fIx\fR always refers to the column.
247 The upper left-hand corner is always (0,0), not (1,1).
248 .PP
249 The routines prefixed with \fBmvw\fR take both a window argument and
250 \fIx\fR and \fIy\fR coordinates.
251 The window argument is always specified before the coordinates.
252 .PP
253 In each case, \fIwin\fR is the window affected, and \fIpad\fR is the
254 pad affected; \fIwin\fR and \fIpad\fR are always pointers to type
255 \fBWINDOW\fR.
256 .PP
257 Option setting routines require a Boolean flag \fIbf\fR with the value
258 \fBTRUE\fR or \fBFALSE\fR; \fIbf\fR is always of type \fBbool\fR.
259 Most of the data types used in the library routines,
260 such as \fBWINDOW\fR, \fBSCREEN\fR, \fBbool\fR, and \fBchtype\fR
261 are defined in \fB<curses.h>\fR.
262 Types used for the terminfo routines such as
263 \fBTERMINAL\fR are defined in \fB<term.h>\fR.
264 .PP
265 This manual page describes functions which may appear in any configuration
266 of the library.
267 There are two common configurations of the library:
268 .RS 3
269 .TP 5
270 .I ncurses
271 the \*(``normal\*('' library, which handles 8-bit characters.
272 The normal (8-bit) library stores characters combined with attributes
273 in \fBchtype\fP data.
274 .IP
275 Attributes alone (no corresponding character) may be stored in \fBchtype\fP
276 or the equivalent \fBattr_t\fP data.
277 In either case, the data is stored in something like an integer.
278 .IP
279 Each cell (row and column) in a \fBWINDOW\fP is stored as a \fBchtype\fP.
280 .TP 5
281 .I ncursesw
282 the so-called \*(``wide\*('' library, which handles multibyte characters
283 (see the section on \fBALTERNATE CONFIGURATIONS\fP).
284 The \*(``wide\*('' library includes all of the calls
285 from the \*(``normal\*('' library.
286 It adds about one third more calls using data types which store
287 multibyte characters:
288 .RS 5
289 .TP 5
290 .B cchar_t
291 corresponds to \fBchtype\fP.
292 However it is a structure, because more data is stored than can fit into
293 an integer.
294 The characters are large enough to require a full integer value \- and there
295 may be more than one character per cell.
296 The video attributes and color are stored in separate fields of the structure.
297 .IP
298 Each cell (row and column) in a \fBWINDOW\fP is stored as a \fBcchar_t\fP.
299 .IP
300 The \fBsetcchar\fP(3X) and \fBgetcchar\fP(3X)
301 functions store and retrieve the data from
302 a \fBcchar_t\fP structure.
303 .TP 5
304 .B wchar_t
305 stores a \*(``wide\*('' character.
306 Like \fBchtype\fP, this may be an integer.
307 .TP 5
308 .B wint_t
309 stores a \fBwchar_t\fP or \fBWEOF\fP \- not the same, though both may have
310 the same size.
311 .RE
312 .IP
313 The \*(``wide\*('' library provides new functions which are analogous to
314 functions in the \*(``normal\*('' library.
315 There is a naming convention which relates many of the normal/wide variants:
316 a \*(``_w\*('' is inserted into the name.
317 For example, \fBwaddch\fP becomes \fBwadd_wch\fP.
318 .RE
319 .PP
320 .\"
321 .SS Routine Name Index
322 The following table lists each \fBcurses\fR routine and the name of
323 the manual page on which it is described.
324 Routines flagged with \*(``*\*(''
325 are ncurses-specific, not described by XPG4 or present in SVr4.
326 .PP
327 .TS
328 center tab(/);
329 l l
330 l l .
331 \fBcurses\fR Routine Name/Manual Page Name
332 =
333 COLOR_PAIR/\fBcurs_color\fR(3X)
334 PAIR_NUMBER/\fBcurs_attr\fR(3X)
335 _nc_free_and_exit/\fBcurs_memleaks\fR(3X)*
336 _nc_freeall/\fBcurs_memleaks\fR(3X)*
337 _nc_tracebits/\fBcurs_trace\fR(3X)*
338 _traceattr/\fBcurs_trace\fR(3X)*
339 _traceattr2/\fBcurs_trace\fR(3X)*
340 _tracechar/\fBcurs_trace\fR(3X)*
341 _tracechtype/\fBcurs_trace\fR(3X)*
342 _tracechtype2/\fBcurs_trace\fR(3X)*
343 _tracedump/\fBcurs_trace\fR(3X)*
344 _tracef/\fBcurs_trace\fR(3X)*
345 _tracemouse/\fBcurs_trace\fR(3X)*
346 add_wch/\fBcurs_add_wch\fR(3X)
347 add_wchnstr/\fBcurs_add_wchstr\fR(3X)
348 add_wchstr/\fBcurs_add_wchstr\fR(3X)
349 addch/\fBcurs_addch\fR(3X)
350 addchnstr/\fBcurs_addchstr\fR(3X)
351 addchstr/\fBcurs_addchstr\fR(3X)
352 addnstr/\fBcurs_addstr\fR(3X)
353 addnwstr/\fBcurs_addwstr\fR(3X)
354 addstr/\fBcurs_addstr\fR(3X)
355 addwstr/\fBcurs_addwstr\fR(3X)
356 alloc_pair/\fBnew_pair\fR(3X)*
357 assume_default_colors/\fBdefault_colors\fR(3X)*
358 attr_get/\fBcurs_attr\fR(3X)
359 attr_off/\fBcurs_attr\fR(3X)
360 attr_on/\fBcurs_attr\fR(3X)
361 attr_set/\fBcurs_attr\fR(3X)
362 attroff/\fBcurs_attr\fR(3X)
363 attron/\fBcurs_attr\fR(3X)
364 attrset/\fBcurs_attr\fR(3X)
365 baudrate/\fBcurs_termattrs\fR(3X)
366 beep/\fBcurs_beep\fR(3X)
367 bkgd/\fBcurs_bkgd\fR(3X)
368 bkgdset/\fBcurs_bkgd\fR(3X)
369 bkgrnd/\fBcurs_bkgrnd\fR(3X)
370 bkgrndset/\fBcurs_bkgrnd\fR(3X)
371 border/\fBcurs_border\fR(3X)
372 border_set/\fBcurs_border_set\fR(3X)
373 box/\fBcurs_border\fR(3X)
374 box_set/\fBcurs_border_set\fR(3X)
375 can_change_color/\fBcurs_color\fR(3X)
376 cbreak/\fBcurs_inopts\fR(3X)
377 chgat/\fBcurs_attr\fR(3X)
378 clear/\fBcurs_clear\fR(3X)
379 clearok/\fBcurs_outopts\fR(3X)
380 clrtobot/\fBcurs_clear\fR(3X)
381 clrtoeol/\fBcurs_clear\fR(3X)
382 color_content/\fBcurs_color\fR(3X)
383 color_set/\fBcurs_attr\fR(3X)
384 copywin/\fBcurs_overlay\fR(3X)
385 curs_set/\fBcurs_kernel\fR(3X)
386 curses_version/\fBcurs_extend\fR(3X)*
387 def_prog_mode/\fBcurs_kernel\fR(3X)
388 def_shell_mode/\fBcurs_kernel\fR(3X)
389 define_key/\fBdefine_key\fR(3X)*
390 del_curterm/\fBcurs_terminfo\fR(3X)
391 delay_output/\fBcurs_util\fR(3X)
392 delch/\fBcurs_delch\fR(3X)
393 deleteln/\fBcurs_deleteln\fR(3X)
394 delscreen/\fBcurs_initscr\fR(3X)
395 delwin/\fBcurs_window\fR(3X)
396 derwin/\fBcurs_window\fR(3X)
397 doupdate/\fBcurs_refresh\fR(3X)
398 dupwin/\fBcurs_window\fR(3X)
399 echo/\fBcurs_inopts\fR(3X)
400 echo_wchar/\fBcurs_add_wch\fR(3X)
401 echochar/\fBcurs_addch\fR(3X)
402 endwin/\fBcurs_initscr\fR(3X)
403 erase/\fBcurs_clear\fR(3X)
404 erasechar/\fBcurs_termattrs\fR(3X)
405 erasewchar/\fBcurs_termattrs\fR(3X)
406 extended_color_content/\fBcurs_color\fR(3X)*
407 extended_pair_content/\fBcurs_color\fR(3X)*
408 extended_slk_color/\fBcurs_slk\fR(3X)*
409 filter/\fBcurs_util\fR(3X)
410 find_pair/\fBnew_pair\fR(3X)*
411 flash/\fBcurs_beep\fR(3X)
412 flushinp/\fBcurs_util\fR(3X)
413 free_pair/\fBnew_pair\fR(3X)*
414 get_wch/\fBcurs_get_wch\fR(3X)
415 get_wstr/\fBcurs_get_wstr\fR(3X)
416 getattrs/\fBcurs_attr\fR(3X)
417 getbegx/\fBcurs_legacy\fR(3X)*
418 getbegy/\fBcurs_legacy\fR(3X)*
419 getbegyx/\fBcurs_getyx\fR(3X)
420 getbkgd/\fBcurs_bkgd\fR(3X)
421 getbkgrnd/\fBcurs_bkgrnd\fR(3X)
422 getcchar/\fBcurs_getcchar\fR(3X)
423 getch/\fBcurs_getch\fR(3X)
424 getcurx/\fBcurs_legacy\fR(3X)*
425 getcury/\fBcurs_legacy\fR(3X)*
426 getmaxx/\fBcurs_legacy\fR(3X)*
427 getmaxy/\fBcurs_legacy\fR(3X)*
428 getmaxyx/\fBcurs_getyx\fR(3X)
429 getmouse/\fBcurs_mouse\fR(3X)*
430 getn_wstr/\fBcurs_get_wstr\fR(3X)
431 getnstr/\fBcurs_getstr\fR(3X)
432 getparx/\fBcurs_legacy\fR(3X)*
433 getpary/\fBcurs_legacy\fR(3X)*
434 getparyx/\fBcurs_getyx\fR(3X)
435 getstr/\fBcurs_getstr\fR(3X)
436 getsyx/\fBcurs_kernel\fR(3X)
437 getwin/\fBcurs_util\fR(3X)
438 getyx/\fBcurs_getyx\fR(3X)
439 halfdelay/\fBcurs_inopts\fR(3X)
440 has_colors/\fBcurs_color\fR(3X)
441 has_ic/\fBcurs_termattrs\fR(3X)
442 has_il/\fBcurs_termattrs\fR(3X)
443 has_key/\fBcurs_getch\fR(3X)*
444 hline/\fBcurs_border\fR(3X)
445 hline_set/\fBcurs_border_set\fR(3X)
446 idcok/\fBcurs_outopts\fR(3X)
447 idlok/\fBcurs_outopts\fR(3X)
448 immedok/\fBcurs_outopts\fR(3X)
449 in_wch/\fBcurs_in_wch\fR(3X)
450 in_wchnstr/\fBcurs_in_wchstr\fR(3X)
451 in_wchstr/\fBcurs_in_wchstr\fR(3X)
452 inch/\fBcurs_inch\fR(3X)
453 inchnstr/\fBcurs_inchstr\fR(3X)
454 inchstr/\fBcurs_inchstr\fR(3X)
455 init_color/\fBcurs_color\fR(3X)
456 init_extended_color/\fBcurs_color\fR(3X)*
457 init_extended_pair/\fBcurs_color\fR(3X)*
458 init_pair/\fBcurs_color\fR(3X)
459 initscr/\fBcurs_initscr\fR(3X)
460 innstr/\fBcurs_instr\fR(3X)
461 innwstr/\fBcurs_inwstr\fR(3X)
462 ins_nwstr/\fBcurs_ins_wstr\fR(3X)
463 ins_wch/\fBcurs_ins_wch\fR(3X)
464 ins_wstr/\fBcurs_ins_wstr\fR(3X)
465 insch/\fBcurs_insch\fR(3X)
466 insdelln/\fBcurs_deleteln\fR(3X)
467 insertln/\fBcurs_deleteln\fR(3X)
468 insnstr/\fBcurs_insstr\fR(3X)
469 insstr/\fBcurs_insstr\fR(3X)
470 instr/\fBcurs_instr\fR(3X)
471 intrflush/\fBcurs_inopts\fR(3X)
472 inwstr/\fBcurs_inwstr\fR(3X)
473 is_cleared/\fBcurs_opaque\fR(3X)*
474 is_idcok/\fBcurs_opaque\fR(3X)*
475 is_idlok/\fBcurs_opaque\fR(3X)*
476 is_immedok/\fBcurs_opaque\fR(3X)*
477 is_keypad/\fBcurs_opaque\fR(3X)*
478 is_leaveok/\fBcurs_opaque\fR(3X)*
479 is_linetouched/\fBcurs_touch\fR(3X)
480 is_nodelay/\fBcurs_opaque\fR(3X)*
481 is_notimeout/\fBcurs_opaque\fR(3X)*
482 is_pad/\fBcurs_opaque\fR(3X)*
483 is_scrollok/\fBcurs_opaque\fR(3X)*
484 is_subwin/\fBcurs_opaque\fR(3X)*
485 is_syncok/\fBcurs_opaque\fR(3X)*
486 is_term_resized/\fBresizeterm\fR(3X)*
487 is_wintouched/\fBcurs_touch\fR(3X)
488 isendwin/\fBcurs_initscr\fR(3X)
489 key_defined/\fBkey_defined\fR(3X)*
490 key_name/\fBcurs_util\fR(3X)
491 keybound/\fBkeybound\fR(3X)*
492 keyname/\fBcurs_util\fR(3X)
493 keyok/\fBkeyok\fR(3X)*
494 keypad/\fBcurs_inopts\fR(3X)
495 killchar/\fBcurs_termattrs\fR(3X)
496 killwchar/\fBcurs_termattrs\fR(3X)
497 leaveok/\fBcurs_outopts\fR(3X)
498 longname/\fBcurs_termattrs\fR(3X)
499 mcprint/\fBcurs_print\fR(3X)*
500 meta/\fBcurs_inopts\fR(3X)
501 mouse_trafo/\fBcurs_mouse\fR(3X)*
502 mouseinterval/\fBcurs_mouse\fR(3X)*
503 mousemask/\fBcurs_mouse\fR(3X)*
504 move/\fBcurs_move\fR(3X)
505 mvadd_wch/\fBcurs_add_wch\fR(3X)
506 mvadd_wchnstr/\fBcurs_add_wchstr\fR(3X)
507 mvadd_wchstr/\fBcurs_add_wchstr\fR(3X)
508 mvaddch/\fBcurs_addch\fR(3X)
509 mvaddchnstr/\fBcurs_addchstr\fR(3X)
510 mvaddchstr/\fBcurs_addchstr\fR(3X)
511 mvaddnstr/\fBcurs_addstr\fR(3X)
512 mvaddnwstr/\fBcurs_addwstr\fR(3X)
513 mvaddstr/\fBcurs_addstr\fR(3X)
514 mvaddwstr/\fBcurs_addwstr\fR(3X)
515 mvchgat/\fBcurs_attr\fR(3X)
516 mvcur/\fBcurs_terminfo\fR(3X)
517 mvdelch/\fBcurs_delch\fR(3X)
518 mvderwin/\fBcurs_window\fR(3X)
519 mvget_wch/\fBcurs_get_wch\fR(3X)
520 mvget_wstr/\fBcurs_get_wstr\fR(3X)
521 mvgetch/\fBcurs_getch\fR(3X)
522 mvgetn_wstr/\fBcurs_get_wstr\fR(3X)
523 mvgetnstr/\fBcurs_getstr\fR(3X)
524 mvgetstr/\fBcurs_getstr\fR(3X)
525 mvhline/\fBcurs_border\fR(3X)
526 mvhline_set/\fBcurs_border_set\fR(3X)
527 mvin_wch/\fBcurs_in_wch\fR(3X)
528 mvin_wchnstr/\fBcurs_in_wchstr\fR(3X)
529 mvin_wchstr/\fBcurs_in_wchstr\fR(3X)
530 mvinch/\fBcurs_inch\fR(3X)
531 mvinchnstr/\fBcurs_inchstr\fR(3X)
532 mvinchstr/\fBcurs_inchstr\fR(3X)
533 mvinnstr/\fBcurs_instr\fR(3X)
534 mvinnwstr/\fBcurs_inwstr\fR(3X)
535 mvins_nwstr/\fBcurs_ins_wstr\fR(3X)
536 mvins_wch/\fBcurs_ins_wch\fR(3X)
537 mvins_wstr/\fBcurs_ins_wstr\fR(3X)
538 mvinsch/\fBcurs_insch\fR(3X)
539 mvinsnstr/\fBcurs_insstr\fR(3X)
540 mvinsstr/\fBcurs_insstr\fR(3X)
541 mvinstr/\fBcurs_instr\fR(3X)
542 mvinwstr/\fBcurs_inwstr\fR(3X)
543 mvprintw/\fBcurs_printw\fR(3X)
544 mvscanw/\fBcurs_scanw\fR(3X)
545 mvvline/\fBcurs_border\fR(3X)
546 mvvline_set/\fBcurs_border_set\fR(3X)
547 mvwadd_wch/\fBcurs_add_wch\fR(3X)
548 mvwadd_wchnstr/\fBcurs_add_wchstr\fR(3X)
549 mvwadd_wchstr/\fBcurs_add_wchstr\fR(3X)
550 mvwaddch/\fBcurs_addch\fR(3X)
551 mvwaddchnstr/\fBcurs_addchstr\fR(3X)
552 mvwaddchstr/\fBcurs_addchstr\fR(3X)
553 mvwaddnstr/\fBcurs_addstr\fR(3X)
554 mvwaddnwstr/\fBcurs_addwstr\fR(3X)
555 mvwaddstr/\fBcurs_addstr\fR(3X)
556 mvwaddwstr/\fBcurs_addwstr\fR(3X)
557 mvwchgat/\fBcurs_attr\fR(3X)
558 mvwdelch/\fBcurs_delch\fR(3X)
559 mvwget_wch/\fBcurs_get_wch\fR(3X)
560 mvwget_wstr/\fBcurs_get_wstr\fR(3X)
561 mvwgetch/\fBcurs_getch\fR(3X)
562 mvwgetn_wstr/\fBcurs_get_wstr\fR(3X)
563 mvwgetnstr/\fBcurs_getstr\fR(3X)
564 mvwgetstr/\fBcurs_getstr\fR(3X)
565 mvwhline/\fBcurs_border\fR(3X)
566 mvwhline_set/\fBcurs_border_set\fR(3X)
567 mvwin/\fBcurs_window\fR(3X)
568 mvwin_wch/\fBcurs_in_wch\fR(3X)
569 mvwin_wchnstr/\fBcurs_in_wchstr\fR(3X)
570 mvwin_wchstr/\fBcurs_in_wchstr\fR(3X)
571 mvwinch/\fBcurs_inch\fR(3X)
572 mvwinchnstr/\fBcurs_inchstr\fR(3X)
573 mvwinchstr/\fBcurs_inchstr\fR(3X)
574 mvwinnstr/\fBcurs_instr\fR(3X)
575 mvwinnwstr/\fBcurs_inwstr\fR(3X)
576 mvwins_nwstr/\fBcurs_ins_wstr\fR(3X)
577 mvwins_wch/\fBcurs_ins_wch\fR(3X)
578 mvwins_wstr/\fBcurs_ins_wstr\fR(3X)
579 mvwinsch/\fBcurs_insch\fR(3X)
580 mvwinsnstr/\fBcurs_insstr\fR(3X)
581 mvwinsstr/\fBcurs_insstr\fR(3X)
582 mvwinstr/\fBcurs_instr\fR(3X)
583 mvwinwstr/\fBcurs_inwstr\fR(3X)
584 mvwprintw/\fBcurs_printw\fR(3X)
585 mvwscanw/\fBcurs_scanw\fR(3X)
586 mvwvline/\fBcurs_border\fR(3X)
587 mvwvline_set/\fBcurs_border_set\fR(3X)
588 napms/\fBcurs_kernel\fR(3X)
589 newpad/\fBcurs_pad\fR(3X)
590 newterm/\fBcurs_initscr\fR(3X)
591 newwin/\fBcurs_window\fR(3X)
592 nl/\fBcurs_outopts\fR(3X)
593 nocbreak/\fBcurs_inopts\fR(3X)
594 nodelay/\fBcurs_inopts\fR(3X)
595 noecho/\fBcurs_inopts\fR(3X)
596 nofilter/\fBcurs_util\fR(3X)*
597 nonl/\fBcurs_outopts\fR(3X)
598 noqiflush/\fBcurs_inopts\fR(3X)
599 noraw/\fBcurs_inopts\fR(3X)
600 notimeout/\fBcurs_inopts\fR(3X)
601 overlay/\fBcurs_overlay\fR(3X)
602 overwrite/\fBcurs_overlay\fR(3X)
603 pair_content/\fBcurs_color\fR(3X)
604 pechochar/\fBcurs_pad\fR(3X)
605 pnoutrefresh/\fBcurs_pad\fR(3X)
606 prefresh/\fBcurs_pad\fR(3X)
607 printw/\fBcurs_printw\fR(3X)
608 putp/\fBcurs_terminfo\fR(3X)
609 putwin/\fBcurs_util\fR(3X)
610 qiflush/\fBcurs_inopts\fR(3X)
611 raw/\fBcurs_inopts\fR(3X)
612 redrawwin/\fBcurs_refresh\fR(3X)
613 refresh/\fBcurs_refresh\fR(3X)
614 reset_prog_mode/\fBcurs_kernel\fR(3X)
615 reset_shell_mode/\fBcurs_kernel\fR(3X)
616 resetty/\fBcurs_kernel\fR(3X)
617 resize_term/\fBresizeterm\fR(3X)*
618 resizeterm/\fBresizeterm\fR(3X)*
619 restartterm/\fBcurs_terminfo\fR(3X)
620 ripoffline/\fBcurs_kernel\fR(3X)
621 savetty/\fBcurs_kernel\fR(3X)
622 scanw/\fBcurs_scanw\fR(3X)
623 scr_dump/\fBcurs_scr_dump\fR(3X)
624 scr_init/\fBcurs_scr_dump\fR(3X)
625 scr_restore/\fBcurs_scr_dump\fR(3X)
626 scr_set/\fBcurs_scr_dump\fR(3X)
627 scrl/\fBcurs_scroll\fR(3X)
628 scroll/\fBcurs_scroll\fR(3X)
629 scrollok/\fBcurs_outopts\fR(3X)
630 set_curterm/\fBcurs_terminfo\fR(3X)
631 set_term/\fBcurs_initscr\fR(3X)
632 setcchar/\fBcurs_getcchar\fR(3X)
633 setscrreg/\fBcurs_outopts\fR(3X)
634 setsyx/\fBcurs_kernel\fR(3X)
635 setterm/\fBcurs_terminfo\fR(3X)
636 setupterm/\fBcurs_terminfo\fR(3X)
637 slk_attr/\fBcurs_slk\fR(3X)*
638 slk_attr_off/\fBcurs_slk\fR(3X)
639 slk_attr_on/\fBcurs_slk\fR(3X)
640 slk_attr_set/\fBcurs_slk\fR(3X)
641 slk_attroff/\fBcurs_slk\fR(3X)
642 slk_attron/\fBcurs_slk\fR(3X)
643 slk_attrset/\fBcurs_slk\fR(3X)
644 slk_clear/\fBcurs_slk\fR(3X)
645 slk_color/\fBcurs_slk\fR(3X)
646 slk_init/\fBcurs_slk\fR(3X)
647 slk_label/\fBcurs_slk\fR(3X)
648 slk_noutrefresh/\fBcurs_slk\fR(3X)
649 slk_refresh/\fBcurs_slk\fR(3X)
650 slk_restore/\fBcurs_slk\fR(3X)
651 slk_set/\fBcurs_slk\fR(3X)
652 slk_touch/\fBcurs_slk\fR(3X)
653 standend/\fBcurs_attr\fR(3X)
654 standout/\fBcurs_attr\fR(3X)
655 start_color/\fBcurs_color\fR(3X)
656 subpad/\fBcurs_pad\fR(3X)
657 subwin/\fBcurs_window\fR(3X)
658 syncok/\fBcurs_window\fR(3X)
659 term_attrs/\fBcurs_termattrs\fR(3X)
660 termattrs/\fBcurs_termattrs\fR(3X)
661 termname/\fBcurs_termattrs\fR(3X)
662 tgetent/\fBcurs_termcap\fR(3X)
663 tgetflag/\fBcurs_termcap\fR(3X)
664 tgetnum/\fBcurs_termcap\fR(3X)
665 tgetstr/\fBcurs_termcap\fR(3X)
666 tgoto/\fBcurs_termcap\fR(3X)
667 tigetflag/\fBcurs_terminfo\fR(3X)
668 tigetnum/\fBcurs_terminfo\fR(3X)
669 tigetstr/\fBcurs_terminfo\fR(3X)
670 timeout/\fBcurs_inopts\fR(3X)
671 tiparm/\fBcurs_terminfo\fR(3X)*
672 touchline/\fBcurs_touch\fR(3X)
673 touchwin/\fBcurs_touch\fR(3X)
674 tparm/\fBcurs_terminfo\fR(3X)
675 tputs/\fBcurs_termcap\fR(3X)
676 tputs/\fBcurs_terminfo\fR(3X)
677 trace/\fBcurs_trace\fR(3X)*
678 typeahead/\fBcurs_inopts\fR(3X)
679 unctrl/\fBcurs_util\fR(3X)
680 unget_wch/\fBcurs_get_wch\fR(3X)
681 ungetch/\fBcurs_getch\fR(3X)
682 ungetmouse/\fBcurs_mouse\fR(3X)*
683 untouchwin/\fBcurs_touch\fR(3X)
684 use_default_colors/\fBdefault_colors\fR(3X)*
685 use_env/\fBcurs_util\fR(3X)
686 use_extended_names/\fBcurs_extend\fR(3X)*
687 use_legacy_coding/\fBlegacy_coding\fR(3X)*
688 use_tioctl/\fBcurs_util\fR(3X)*
689 vid_attr/\fBcurs_terminfo\fR(3X)
690 vid_puts/\fBcurs_terminfo\fR(3X)
691 vidattr/\fBcurs_terminfo\fR(3X)
692 vidputs/\fBcurs_terminfo\fR(3X)
693 vline/\fBcurs_border\fR(3X)
694 vline_set/\fBcurs_border_set\fR(3X)
695 vw_printw/\fBcurs_printw\fR(3X)
696 vw_scanw/\fBcurs_scanw\fR(3X)
697 vwprintw/\fBcurs_printw\fR(3X)
698 vwscanw/\fBcurs_scanw\fR(3X)
699 wadd_wch/\fBcurs_add_wch\fR(3X)
700 wadd_wchnstr/\fBcurs_add_wchstr\fR(3X)
701 wadd_wchstr/\fBcurs_add_wchstr\fR(3X)
702 waddch/\fBcurs_addch\fR(3X)
703 waddchnstr/\fBcurs_addchstr\fR(3X)
704 waddchstr/\fBcurs_addchstr\fR(3X)
705 waddnstr/\fBcurs_addstr\fR(3X)
706 waddnwstr/\fBcurs_addwstr\fR(3X)
707 waddstr/\fBcurs_addstr\fR(3X)
708 waddwstr/\fBcurs_addwstr\fR(3X)
709 wattr_get/\fBcurs_attr\fR(3X)
710 wattr_off/\fBcurs_attr\fR(3X)
711 wattr_on/\fBcurs_attr\fR(3X)
712 wattr_set/\fBcurs_attr\fR(3X)
713 wattroff/\fBcurs_attr\fR(3X)
714 wattron/\fBcurs_attr\fR(3X)
715 wattrset/\fBcurs_attr\fR(3X)
716 wbkgd/\fBcurs_bkgd\fR(3X)
717 wbkgdset/\fBcurs_bkgd\fR(3X)
718 wbkgrnd/\fBcurs_bkgrnd\fR(3X)
719 wbkgrndset/\fBcurs_bkgrnd\fR(3X)
720 wborder/\fBcurs_border\fR(3X)
721 wborder_set/\fBcurs_border_set\fR(3X)
722 wchgat/\fBcurs_attr\fR(3X)
723 wclear/\fBcurs_clear\fR(3X)
724 wclrtobot/\fBcurs_clear\fR(3X)
725 wclrtoeol/\fBcurs_clear\fR(3X)
726 wcolor_set/\fBcurs_attr\fR(3X)
727 wcursyncup/\fBcurs_window\fR(3X)
728 wdelch/\fBcurs_delch\fR(3X)
729 wdeleteln/\fBcurs_deleteln\fR(3X)
730 wecho_wchar/\fBcurs_add_wch\fR(3X)
731 wechochar/\fBcurs_addch\fR(3X)
732 wenclose/\fBcurs_mouse\fR(3X)*
733 werase/\fBcurs_clear\fR(3X)
734 wget_wch/\fBcurs_get_wch\fR(3X)
735 wget_wstr/\fBcurs_get_wstr\fR(3X)
736 wgetbkgrnd/\fBcurs_bkgrnd\fR(3X)
737 wgetch/\fBcurs_getch\fR(3X)
738 wgetdelay/\fBcurs_opaque\fR(3X)*
739 wgetn_wstr/\fBcurs_get_wstr\fR(3X)
740 wgetnstr/\fBcurs_getstr\fR(3X)
741 wgetparent/\fBcurs_opaque\fR(3X)*
742 wgetscrreg/\fBcurs_opaque\fR(3X)*
743 wgetstr/\fBcurs_getstr\fR(3X)
744 whline/\fBcurs_border\fR(3X)
745 whline_set/\fBcurs_border_set\fR(3X)
746 win_wch/\fBcurs_in_wch\fR(3X)
747 win_wchnstr/\fBcurs_in_wchstr\fR(3X)
748 win_wchstr/\fBcurs_in_wchstr\fR(3X)
749 winch/\fBcurs_inch\fR(3X)
750 winchnstr/\fBcurs_inchstr\fR(3X)
751 winchstr/\fBcurs_inchstr\fR(3X)
752 winnstr/\fBcurs_instr\fR(3X)
753 winnwstr/\fBcurs_inwstr\fR(3X)
754 wins_nwstr/\fBcurs_ins_wstr\fR(3X)
755 wins_wch/\fBcurs_ins_wch\fR(3X)
756 wins_wstr/\fBcurs_ins_wstr\fR(3X)
757 winsch/\fBcurs_insch\fR(3X)
758 winsdelln/\fBcurs_deleteln\fR(3X)
759 winsertln/\fBcurs_deleteln\fR(3X)
760 winsnstr/\fBcurs_insstr\fR(3X)
761 winsstr/\fBcurs_insstr\fR(3X)
762 winstr/\fBcurs_instr\fR(3X)
763 winwstr/\fBcurs_inwstr\fR(3X)
764 wmouse_trafo/\fBcurs_mouse\fR(3X)*
765 wmove/\fBcurs_move\fR(3X)
766 wnoutrefresh/\fBcurs_refresh\fR(3X)
767 wprintw/\fBcurs_printw\fR(3X)
768 wredrawln/\fBcurs_refresh\fR(3X)
769 wrefresh/\fBcurs_refresh\fR(3X)
770 wresize/\fBwresize\fR(3X)*
771 wscanw/\fBcurs_scanw\fR(3X)
772 wscrl/\fBcurs_scroll\fR(3X)
773 wsetscrreg/\fBcurs_outopts\fR(3X)
774 wstandend/\fBcurs_attr\fR(3X)
775 wstandout/\fBcurs_attr\fR(3X)
776 wsyncdown/\fBcurs_window\fR(3X)
777 wsyncup/\fBcurs_window\fR(3X)
778 wtimeout/\fBcurs_inopts\fR(3X)
779 wtouchln/\fBcurs_touch\fR(3X)
780 wunctrl/\fBcurs_util\fR(3X)
781 wvline/\fBcurs_border\fR(3X)
782 wvline_set/\fBcurs_border_set\fR(3X)
783 .TE
784 .SH RETURN VALUE
785 Routines that return an integer return \fBERR\fR upon failure and an
786 integer value other than \fBERR\fR upon successful completion, unless
787 otherwise noted in the routine descriptions.
788 .PP
789 As a general rule, routines check for null pointers passed as parameters,
790 and handle this as an error.
791 .PP
792 All macros return the value of the \fBw\fR version, except \fBsetscrreg\fR,
793 \fBwsetscrreg\fR, \fBgetyx\fR, \fBgetbegyx\fR, and \fBgetmaxyx\fR.
794 The return values of
795 \fBsetscrreg\fR,
796 \fBwsetscrreg\fR,
797 \fBgetyx\fR,
798 \fBgetbegyx\fR, and
799 \fBgetmaxyx\fR are undefined (i.e., these should not be used as the
800 right-hand side of assignment statements).
801 .PP
802 Routines that return pointers return \fBNULL\fR on error.
803 .SH ENVIRONMENT
804 .PP
805 The following environment symbols are useful for customizing the
806 runtime behavior of the \fBncurses\fR library.
807 The most important ones have been already discussed in detail.
808 .SS CC command-character
809 .PP
810 When set, change occurrences of the command_character
811 (i.e., the \fBcmdch\fP capability)
812 of the loaded terminfo entries to the value of this variable.
813 Very few terminfo entries provide this feature.
814 .PP
815 Because this name is also used in development environments to represent
816 the C compiler's name, \fBncurses\fR ignores it if it does not happen to
817 be a single character.
818 .SS BAUDRATE
819 .PP
820 The debugging library checks this environment variable when the application
821 has redirected output to a file.
822 The variable's numeric value is used for the baudrate.
823 If no value is found, \fBncurses\fR uses 9600.
824 This allows testers to construct repeatable test-cases
825 that take into account costs that depend on baudrate.
826 .SS COLUMNS
827 .PP
828 Specify the width of the screen in characters.
829 Applications running in a windowing environment usually are able to
830 obtain the width of the window in which they are executing.
831 If neither the \fBCOLUMNS\fP value nor the terminal's screen size is available,
832 \fBncurses\fR uses the size which may be specified in the terminfo database
833 (i.e., the \fBcols\fR capability).
834 .PP
835 It is important that your application use a correct size for the screen.
836 This is not always possible because your application may be
837 running on a host which does not honor NAWS (Negotiations About Window
838 Size), or because you are temporarily running as another user.
839 However, setting \fBCOLUMNS\fP and/or \fBLINES\fP overrides the library's
840 use of the screen size obtained from the operating system.
841 .PP
842 Either \fBCOLUMNS\fP or \fBLINES\fP symbols may be specified independently.
843 This is mainly useful to circumvent legacy misfeatures of terminal descriptions,
844 e.g., xterm which commonly specifies a 65 line screen.
845 For best results, \fBlines\fR and \fBcols\fR should not be specified in
846 a terminal description for terminals which are run as emulations.
847 .PP
848 Use the \fBuse_env\fR function to disable all use of external environment
849 (but not including system calls) to determine the screen size.
850 Use the \fBuse_tioctl\fR function to update \fBCOLUMNS\fP or \fBLINES\fP
851 to match the screen size obtained from system calls or the terminal database.
852 .SS ESCDELAY
853 .PP
854 Specifies the total time, in milliseconds, for which ncurses will
855 await a character sequence, e.g., a function key.
856 The default value, 1000 milliseconds, is enough for most uses.
857 However, it is made a variable to accommodate unusual applications.
858 .PP
859 The most common instance where you may wish to change this value
860 is to work with slow hosts, e.g., running on a network.
861 If the host cannot read characters rapidly enough, it will have the same
862 effect as if the terminal did not send characters rapidly enough.
863 The library will still see a timeout.
864 .PP
865 Note that xterm mouse events are built up from character sequences
866 received from the xterm.
867 If your application makes heavy use of multiple-clicking, you may
868 wish to lengthen this default value because the timeout applies
869 to the composed multi-click event as well as the individual clicks.
870 .PP
871 In addition to the environment variable,
872 this implementation provides a global variable with the same name.
873 Portable applications should not rely upon the presence of ESCDELAY
874 in either form,
875 but setting the environment variable rather than the global variable
876 does not create problems when compiling an application.
877 .SS HOME
878 Tells \fBncurses\fR where your home directory is.
879 That is where it may read and write auxiliary terminal descriptions:
880 .NS
881 $HOME/.termcap
882 $HOME/.terminfo
883 .NE
884 .SS LINES
885 .PP
886 Like COLUMNS, specify the height of the screen in characters.
887 See COLUMNS for a detailed description.
888 .SS MOUSE_BUTTONS_123
889 .PP
890 This applies only to the OS/2 EMX port.
891 It specifies the order of buttons on the mouse.
892 OS/2 numbers a 3-button mouse inconsistently from other
893 platforms:
894 .NS
895 1 = left
896 .br
897 2 = right
898 .br
899 3 = middle.
900 .NE
901 .PP
902 This variable lets you customize the mouse.
903 The variable must be three numeric digits 1\-3 in any order, e.g., 123 or 321.
904 If it is not specified, \fBncurses\fR uses 132.
905 .SS NCURSES_ASSUMED_COLORS
906 .PP
907 Override the compiled-in assumption that the
908 terminal's default colors are white-on-black
909 (see \fBdefault_colors\fR(3X)).
910 You may set the foreground and background color values with this environment
911 variable by proving a 2-element list: foreground,background.
912 For example, to tell ncurses to not assume anything
913 about the colors, set this to "\-1,\-1".
914 To make it green-on-black, set it to "2,0".
915 Any positive value from zero to the terminfo \fBmax_colors\fR value is allowed.
916 .SS NCURSES_CONSOLE2
917 This applies only to the MinGW port of ncurses.
918 .PP
919 The \fBConsole2\fP program's handling of the Microsoft Console API call
920 \fBCreateConsoleScreenBuffer\fP is defective.
921 Applications which use this will hang.
922 However, it is possible to simulate the action of this call by
923 mapping coordinates,
924 explicitly saving and restoring the original screen contents.
925 Setting the environment variable \fBNCGDB\fP has the same effect.
926 .SS NCURSES_GPM_TERMS
927 .PP
928 This applies only to ncurses configured to use the GPM interface.
929 .PP
930 If present,
931 the environment variable is a list of one or more terminal names
932 against which the \fBTERM\fP environment variable is matched.
933 Setting it to an empty value disables the GPM interface;
934 using the built-in support for xterm, etc.
935 .PP
936 If the environment variable is absent,
937 ncurses will attempt to open GPM if \fBTERM\fP contains \*(``linux\*(''.
938 .SS NCURSES_NO_HARD_TABS
939 .PP
940 \fBNcurses\fP may use tabs as part of the cursor movement optimization.
941 In some cases,
942 your terminal driver may not handle these properly.
943 Set this environment variable to disable the feature.
944 You can also adjust your \fBstty\fP settings to avoid the problem.
945 .SS NCURSES_NO_MAGIC_COOKIE
946 .PP
947 Some terminals use a magic-cookie feature which requires special handling
948 to make highlighting and other video attributes display properly.
949 You can suppress the highlighting entirely for these terminals by
950 setting this environment variable.
951 .SS NCURSES_NO_PADDING
952 .PP
953 Most of the terminal descriptions in the terminfo database are written
954 for real \*(``hardware\*('' terminals.
955 Many people use terminal emulators
956 which run in a windowing environment and use curses-based applications.
957 Terminal emulators can duplicate
958 all of the important aspects of a hardware terminal, but they do not
959 have the same limitations.
960 The chief limitation of a hardware terminal from the standpoint
961 of your application is the management of dataflow, i.e., timing.
962 Unless a hardware terminal is interfaced into a terminal concentrator
963 (which does flow control),
964 it (or your application) must manage dataflow, preventing overruns.
965 The cheapest solution (no hardware cost)
966 is for your program to do this by pausing after
967 operations that the terminal does slowly, such as clearing the display.
968 .PP
969 As a result, many terminal descriptions (including the vt100)
970 have delay times embedded.
971 You may wish to use these descriptions,
972 but not want to pay the performance penalty.
973 .PP
974 Set the NCURSES_NO_PADDING environment variable to disable all but mandatory
975 padding.
976 Mandatory padding is used as a part of special control
977 sequences such as \fIflash\fR.
978 .SS NCURSES_NO_SETBUF
979 This setting is obsolete.
980 Before changes
981 .RS 3
982 .bP
983 started with 5.9 patch 20120825
984 and
985 .bP
986 continued
987 though 5.9 patch 20130126
988 .RE
989 .PP
990 \fBncurses\fR enabled buffered output during terminal initialization.
991 This was done (as in SVr4 curses) for performance reasons.
992 For testing purposes, both of \fBncurses\fR and certain applications,
993 this feature was made optional.
994 Setting the NCURSES_NO_SETBUF variable
995 disabled output buffering, leaving the output in the original (usually
996 line buffered) mode.
997 .PP
998 In the current implementation,
999 ncurses performs its own buffering and does not require this workaround.
1000 It does not modify the buffering of the standard output.
1001 .PP
1002 The reason for the change was to make the behavior for interrupts and
1003 other signals more robust.
1004 One drawback is that certain nonconventional programs would mix
1005 ordinary stdio calls with ncurses calls and (usually) work.
1006 This is no longer possible since ncurses is not using
1007 the buffered standard output but its own output (to the same file descriptor).
1008 As a special case, the low-level calls such as \fBputp\fP still use the
1009 standard output.
1010 But high-level curses calls do not.
1011 .SS NCURSES_NO_UTF8_ACS
1012 .PP
1013 During initialization, the \fBncurses\fR library
1014 checks for special cases where VT100 line-drawing (and the corresponding
1015 alternate character set capabilities) described in the terminfo are known
1016 to be missing.
1017 Specifically, when running in a UTF\-8 locale,
1018 the Linux console emulator and the GNU screen program ignore these.
1019 Ncurses checks the \fBTERM\fP environment variable for these.
1020 For other special cases, you should set this environment variable.
1021 Doing this tells ncurses to use Unicode values which correspond to
1022 the VT100 line-drawing glyphs.
1023 That works for the special cases cited,
1024 and is likely to work for terminal emulators.
1025 .PP
1026 When setting this variable, you should set it to a nonzero value.
1027 Setting it to zero (or to a nonnumber)
1028 disables the special check for \*(``linux\*('' and \*(``screen\*(''.
1029 .PP
1030 As an alternative to the environment variable,
1031 ncurses checks for an extended terminfo capability \fBU8\fP.
1032 This is a numeric capability which can be compiled using \fB@TIC@\ \-x\fP.
1033 For example
1034 .RS 3
1035 .ft CW
1036 .sp
1037 .nf
1038 # linux console, if patched to provide working
1039 # VT100 shift-in/shift-out, with corresponding font.
1040 linux-vt100|linux console with VT100 line-graphics,
1041         U8#0, use=linux,
1042 .sp
1043 # uxterm with vt100Graphics resource set to false
1044 xterm-utf8|xterm relying on UTF-8 line-graphics,
1045         U8#1, use=xterm,
1046 .fi
1047 .ft
1048 .RE
1049 .PP
1050 The name \*(``U8\*('' is chosen to be two characters,
1051 to permit it to be used by applications that use ncurses'
1052 termcap interface.
1053 .SS NCURSES_TRACE
1054 .PP
1055 During initialization, the \fBncurses\fR debugging library
1056 checks the NCURSES_TRACE environment variable.
1057 If it is defined, to a numeric value, \fBncurses\fR calls the \fBtrace\fR
1058 function, using that value as the argument.
1059 .PP
1060 The argument values, which are defined in \fBcurses.h\fR, provide several
1061 types of information.
1062 When running with traces enabled, your application will write the
1063 file \fBtrace\fR to the current directory.
1064 .PP
1065 See \fBcurs_trace\fP(3X) for more information.
1066 .SS TERM
1067 .PP
1068 Denotes your terminal type.
1069 Each terminal type is distinct, though many are similar.
1070 .PP
1071 \fBTERM\fP is commonly set by terminal emulators to help
1072 applications find a workable terminal description.
1073 Some of those choose a popular approximation, e.g.,
1074 \*(``ansi\*('', \*(``vt100\*('', \*(``xterm\*('' rather than an exact fit.
1075 Not infrequently, your application will have problems with that approach,
1076 e.g., incorrect function-key definitions.
1077 .PP
1078 If you set \fBTERM\fP in your environment,
1079 it has no effect on the operation of the terminal emulator.
1080 It only affects the way applications work within the terminal.
1081 Likewise, as a general rule (\fBxterm\fP being a rare exception),
1082 terminal emulators which allow you to
1083 specify \fBTERM\fP as a parameter or configuration value do
1084 not change their behavior to match that setting.
1085 .SS TERMCAP
1086 If the \fBncurses\fR library has been configured with \fItermcap\fR
1087 support, \fBncurses\fR will check for a terminal's description in
1088 termcap form if it is not available in the terminfo database.
1089 .PP
1090 The \fBTERMCAP\fP environment variable contains
1091 either a terminal description (with newlines stripped out),
1092 or a file name telling where the information denoted by
1093 the \fBTERM\fP environment variable exists.
1094 In either case, setting it directs \fBncurses\fR to ignore
1095 the usual place for this information, e.g., /etc/termcap.
1096 .SS TERMINFO
1097 .PP
1098 \fBncurses\fP can be configured to read from multiple terminal databases.
1099 The \fBTERMINFO\fP variable overrides the location for
1100 the default terminal database.
1101 Terminal descriptions (in terminal format) are stored in terminal databases:
1102 .bP
1103 Normally these are stored in a directory tree,
1104 using subdirectories named by the first letter of the terminal names therein.
1105 .IP
1106 This is the scheme used in System V, which legacy Unix systems use,
1107 and the \fBTERMINFO\fP variable is used by \fIcurses\fP applications on those
1108 systems to override the default location of the terminal database.
1109 .bP
1110 If \fBncurses\fP is built to use hashed databases,
1111 then each entry in this list may be the path of a hashed database file, e.g.,
1112 .NS
1113 /usr/share/terminfo.db
1114 .NE
1115 .IP
1116 rather than
1117 .NS
1118 /usr/share/terminfo/
1119 .NE
1120 .IP
1121 The hashed database uses less disk-space and is a little faster than the
1122 directory tree.
1123 However,
1124 some applications assume the existence of the directory tree,
1125 reading it directly
1126 rather than using the terminfo library calls.
1127 .bP
1128 If \fBncurses\fP is built with a support for reading termcap files
1129 directly, then an entry in this list may be the path of a termcap file.
1130 .bP
1131 If the \fBTERMINFO\fP variable begins with
1132 \*(``hex:\*('' or \*(``b64:\*('',
1133 \fBncurses\fP uses the remainder of that variable as a compiled terminal
1134 description.
1135 You might produce the base64 format using \fBinfocmp\fP(1M):
1136 .NS
1137 TERMINFO="$(infocmp -0 -Q2 -q)"
1138 export TERMINFO
1139 .NE
1140 .IP
1141 The compiled description is used if it corresponds to the terminal identified
1142 by the \fBTERM\fP variable.
1143 .PP
1144 Setting \fBTERMINFO\fP is the simplest,
1145 but not the only way to set location of the default terminal database.
1146 The complete list of database locations in order follows:
1147 .RS 3
1148 .bP
1149 the last terminal database to which \fBncurses\fR wrote,
1150 if any, is searched first
1151 .bP
1152 the location specified by the TERMINFO environment variable
1153 .bP
1154 $HOME/.terminfo
1155 .bP
1156 locations listed in the TERMINFO_DIRS environment variable
1157 .bP
1158 one or more locations whose names are configured and compiled into the
1159 ncurses library, i.e.,
1160 .RS 3
1161 .bP
1162 @TERMINFO_DIRS@ (corresponding to the TERMINFO_DIRS variable)
1163 .bP
1164 @TERMINFO@ (corresponding to the TERMINFO variable)
1165 .RE
1166 .RE
1167 .PP
1168 .SS TERMINFO_DIRS
1169 .PP
1170 Specifies a list of locations to search for terminal descriptions.
1171 Each location in the list is a terminal database as described in
1172 the section on the \fBTERMINFO\fP variable.
1173 The list is separated by colons (i.e., ":") on Unix, semicolons on OS/2 EMX.
1174 .PP
1175 There is no corresponding feature in System V terminfo;
1176 it is an extension developed for \fBncurses\fP.
1177 .SS TERMPATH
1178 .PP
1179 If \fBTERMCAP\fP does not hold a file name then \fBncurses\fR checks
1180 the \fBTERMPATH\fP environment variable.
1181 This is a list of filenames separated by spaces or colons (i.e., ":") on Unix,
1182 semicolons on OS/2 EMX.
1183 .PP
1184 If the \fBTERMPATH\fP environment variable is not set,
1185 \fBncurses\fR looks in the files
1186 .NS
1187 /etc/termcap, /usr/share/misc/termcap and $HOME/.termcap,
1188 .NE
1189 .PP
1190 in that order.
1191 .PP
1192 The library may be configured to disregard the following variables when the
1193 current user is the superuser (root), or if the application uses setuid or
1194 setgid permissions:
1195 .NS
1196 $TERMINFO, $TERMINFO_DIRS, $TERMPATH, as well as $HOME.
1197 .NE
1198 .SH ALTERNATE CONFIGURATIONS
1199 .PP
1200 Several different configurations are possible,
1201 depending on the configure script options used when building \fBncurses\fP.
1202 There are a few main options whose effects are visible to the applications
1203 developer using \fBncurses\fP:
1204 .TP 5
1205 \-\-disable\-overwrite
1206 The standard include for \fBncurses\fP is as noted in \fBSYNOPSIS\fP:
1207 .NS
1208 \fB#include <curses.h>\fR
1209 .NE
1210 .IP
1211 This option is used to avoid filename conflicts when \fBncurses\fP
1212 is not the main implementation of curses of the computer.
1213 If \fBncurses\fP is installed disabling overwrite, it puts its headers in
1214 a subdirectory, e.g.,
1215 .NS
1216 \fB#include <ncurses/curses.h>\fR
1217 .NE
1218 .IP
1219 It also omits a symbolic link which would allow you to use \fB\-lcurses\fP
1220 to build executables.
1221 .TP 5
1222 \-\-enable\-widec
1223 The configure script renames the library and
1224 (if the \fB\-\-disable\-overwrite\fP option is used)
1225 puts the header files in a different subdirectory.
1226 All of the library names have a \*(``w\*('' appended to them,
1227 i.e., instead of
1228 .NS
1229 \fB\-lncurses\fR
1230 .NE
1231 .IP
1232 you link with
1233 .NS
1234 \fB\-lncursesw\fR
1235 .NE
1236 .IP
1237 You must also enable the wide-character features in the header file
1238 when compiling for the wide-character library
1239 to use the extended (wide-character) functions.
1240 The symbol which enables these features has changed since XSI Curses, Issue 4:
1241 .RS
1242 .bP
1243 Originally, the wide-character feature required the symbol
1244 \fB_XOPEN_SOURCE_EXTENDED\fP
1245 but that was only valid for XPG4 (1996).
1246 .bP
1247 Later, that was deemed conflicting with \fB_XOPEN_SOURCE\fP defined to 500.
1248 .bP
1249 As of mid-2018,
1250 none of the features in this implementation require a \fB_XOPEN_SOURCE\fP
1251 feature greater than 600.
1252 However, X/Open Curses, Issue 7 (2009) recommends defining it to 700.
1253 .bP
1254 Alternatively, you can enable the feature by defining \fBNCURSES_WIDECHAR\fP
1255 with the caveat that some other header file than \fBcurses.h\fP
1256 may require a specific value for \fB_XOPEN_SOURCE\fP
1257 (or a system-specific symbol).
1258 .RE
1259 .IP
1260 The \fBcurses.h\fP file which is installed for the wide-character
1261 library is designed to be compatible with the normal library's header.
1262 Only the size of the \fBWINDOW\fP structure differs, and very few
1263 applications require more than a pointer to \fBWINDOW\fPs.
1264 .IP
1265 If the headers are installed allowing overwrite,
1266 the wide-character library's headers should be installed last,
1267 to allow applications to be built using either library
1268 from the same set of headers.
1269 .TP 5
1270 \-\-with\-pthread
1271 The configure script renames the library.
1272 All of the library names have a \*(``t\*('' appended to them
1273 (before any \*(``w\*('' added by \fB\-\-enable\-widec\fP).
1274 .IP
1275 The global variables such as \fBLINES\fP are replaced by macros to
1276 allow read-only access.
1277 At the same time, setter-functions are provided to set these values.
1278 Some applications (very few) may require changes to work with this convention.
1279 .TP 5
1280 \-\-with\-shared
1281 .TP
1282 \-\-with\-normal
1283 .TP
1284 \-\-with\-debug
1285 .TP
1286 \-\-with\-profile
1287 The shared and normal (static) library names differ by their suffixes,
1288 e.g., \fBlibncurses.so\fP and \fBlibncurses.a\fP.
1289 The debug and profiling libraries add a \*(``_g\*(''
1290 and a \*(``_p\*('' to the root names respectively,
1291 e.g., \fBlibncurses_g.a\fP and \fBlibncurses_p.a\fP.
1292 .TP 5
1293 \-\-with\-trace
1294 The \fBtrace\fP function normally resides in the debug library,
1295 but it is sometimes useful to configure this in the shared library.
1296 Configure scripts should check for the function's existence rather
1297 than assuming it is always in the debug library.
1298 .SH FILES
1299 .TP 5
1300 @DATADIR@/tabset
1301 directory containing initialization files for the terminal capability database
1302 @TERMINFO@
1303 terminal capability database
1304 .SH SEE ALSO
1305 \fBterminfo\fR(\*n) and related pages whose names begin
1306 \*(``curs_\*('' for detailed routine descriptions.
1307 .br
1308 \fBcurs_variables\fR(3X)
1309 .br
1310 \fBuser_caps\fP(5) for user-defined capabilities
1311 .SH EXTENSIONS
1312 The \fBncurses\fR library can be compiled with an option (\fB\-DUSE_GETCAP\fR)
1313 that falls back to the old-style /etc/termcap file if the terminal setup code
1314 cannot find a terminfo entry corresponding to \fBTERM\fR.
1315 Use of this feature
1316 is not recommended, as it essentially includes an entire termcap compiler in
1317 the \fBncurses\fR startup code, at significant cost in core and startup cycles.
1318 .PP
1319 The \fBncurses\fR library includes facilities for capturing mouse events on
1320 certain terminals (including xterm).
1321 See the \fBcurs_mouse\fR(3X)
1322 manual page for details.
1323 .PP
1324 The \fBncurses\fR library includes facilities for responding to window
1325 resizing events, e.g., when running in an xterm.
1326 See the \fBresizeterm\fR(3X)
1327 and \fBwresize\fR(3X) manual pages for details.
1328 In addition, the library may be configured with a \fBSIGWINCH\fP handler.
1329 .PP
1330 The \fBncurses\fR library extends the fixed set of function key capabilities
1331 of terminals by allowing the application designer to define additional
1332 key sequences at runtime.
1333 See the \fBdefine_key\fR(3X)
1334 \fBkey_defined\fR(3X),
1335 and \fBkeyok\fR(3X) manual pages for details.
1336 .PP
1337 The \fBncurses\fR library can exploit the capabilities of terminals which
1338 implement the ISO\-6429 SGR 39 and SGR 49 controls, which allow an application
1339 to reset the terminal to its original foreground and background colors.
1340 From the users' perspective, the application is able to draw colored
1341 text on a background whose color is set independently, providing better
1342 control over color contrasts.
1343 See the \fBdefault_colors\fR(3X) manual page for details.
1344 .PP
1345 The \fBncurses\fR library includes a function for directing application output
1346 to a printer attached to the terminal device.
1347 See the \fBcurs_print\fR(3X) manual page for details.
1348 .SH PORTABILITY
1349 The \fBncurses\fR library is intended to be BASE-level conformant with XSI
1350 Curses.
1351 The EXTENDED XSI Curses functionality
1352 (including color support) is supported.
1353 .PP
1354 A small number of local differences (that is, individual differences between
1355 the XSI Curses and \fBncurses\fR calls) are described in \fBPORTABILITY\fR
1356 sections of the library man pages.
1357 .SS Error checking
1358 .PP
1359 In many cases, X/Open Curses is vague about error conditions,
1360 omitting some of the SVr4 documentation.
1361 .PP
1362 Unlike other implementations, this one checks parameters such as pointers
1363 to WINDOW structures to ensure they are not null.
1364 The main reason for providing this behavior is to guard against programmer
1365 error.
1366 The standard interface does not provide a way for the library
1367 to tell an application which of several possible errors were detected.
1368 Relying on this (or some other) extension will adversely affect the
1369 portability of curses applications.
1370 .SS Extensions versus portability
1371 .PP
1372 Most of the extensions provided by ncurses have not been standardized.
1373 Some have been incorporated into other implementations, such as
1374 PDCurses or NetBSD curses.
1375 Here are a few to consider:
1376 .bP
1377 The routine \fBhas_key\fR is not part of XPG4, nor is it present in SVr4.
1378 See the \fBcurs_getch\fR(3X) manual page for details.
1379 .bP
1380 The routine \fBslk_attr\fR is not part of XPG4, nor is it present in SVr4.
1381 See the \fBcurs_slk\fR(3X) manual page for details.
1382 .bP
1383 The routines \fBgetmouse\fR, \fBmousemask\fR, \fBungetmouse\fR,
1384 \fBmouseinterval\fR, and \fBwenclose\fR relating to mouse interfacing are not
1385 part of XPG4, nor are they present in SVr4.
1386 See the \fBcurs_mouse\fR(3X) manual page for details.
1387 .bP
1388 The routine \fBmcprint\fR was not present in any previous curses implementation.
1389 See the \fBcurs_print\fR(3X) manual page for details.
1390 .bP
1391 The routine \fBwresize\fR is not part of XPG4, nor is it present in SVr4.
1392 See the \fBwresize\fR(3X) manual page for details.
1393 .bP
1394 The WINDOW structure's internal details can be hidden from application
1395 programs.
1396 See \fBcurs_opaque\fR(3X) for the discussion of \fBis_scrollok\fR, etc.
1397 .bP
1398 This implementation can be configured to provide rudimentary support
1399 for multi-threaded applications.
1400 See \fBcurs_threads\fR(3X) for details.
1401 .bP
1402 This implementation can also be configured to provide a set of functions which
1403 improve the ability to manage multiple screens.
1404 See \fBcurs_sp_funcs\fR(3X) for details.
1405 .SS Padding differences
1406 .PP
1407 In historic curses versions, delays embedded in the capabilities \fBcr\fR,
1408 \fBind\fR, \fBcub1\fR, \fBff\fR and \fBtab\fR activated corresponding delay
1409 bits in the UNIX tty driver.
1410 In this implementation, all padding is done by sending NUL bytes.
1411 This method is slightly more expensive, but narrows the interface
1412 to the UNIX kernel significantly and increases the package's portability
1413 correspondingly.
1414 .SS Header files
1415 The header file \fB<curses.h>\fR automatically includes the header files
1416 \fB<stdio.h>\fR and \fB<unctrl.h>\fR.
1417 .PP
1418 X/Open Curses has more to say,
1419 but does not finish the story:
1420 .RS 4
1421 .PP
1422 The inclusion of <curses.h> may make visible all symbols
1423 from the headers <stdio.h>, <term.h>, <termios.h>, and <wchar.h>.
1424 .RE
1425 .PP
1426 Here is a more complete story:
1427 .bP
1428 Starting with BSD curses, all implementations have included <stdio.h>.
1429 .IP
1430 BSD curses included <curses.h> and <unctrl.h> from an internal header
1431 "curses.ext" ("ext" was a short name for \fIexterns\fP).
1432 .IP
1433 BSD curses used <stdio.h> internally (for \fBprintw\fP and \fBscanw\fP),
1434 but nothing in <curses.h> itself relied upon <stdio.h>.
1435 .bP
1436 SVr2 curses added \fBnewterm\fP(3X), which relies upon <stdio.h>.
1437 That is, the function prototype uses \fBFILE\fP.
1438 .IP
1439 SVr4 curses added \fBputwin\fP and \fBgetwin\fP, which also use <stdio.h>.
1440 .IP
1441 X/Open Curses documents all three of these functions.
1442 .IP
1443 SVr4 curses and X/Open Curses do not require the developer to
1444 include <stdio.h> before including <curses.h>.
1445 Both document curses showing <curses.h> as the only required header.
1446 .IP
1447 As a result, standard <curses.h> will always include <stdio.h>.
1448 .bP
1449 X/Open Curses is inconsistent with respect to SVr4 regarding <unctrl.h>.
1450 .IP
1451 As noted in \fBcurs_util\fP(3X), ncurses includes <unctrl.h> from
1452 <curses.h> (like SVr4).
1453 .bP
1454 X/Open's comments about <term.h> and <termios.h> may refer to HP-UX and AIX:
1455 .IP
1456 HP-UX curses includes <term.h> from <curses.h>
1457 to declare \fBsetupterm\fP in curses.h,
1458 but ncurses (and Solaris curses) do not.
1459 .IP
1460 AIX curses includes <term.h> and <termios.h>.
1461 Again, ncurses (and Solaris curses) do not.
1462 .bP
1463 X/Open says that <curses.h> \fImay\fP include <term.h>,
1464 but there is no requirement that it do that.
1465 .IP
1466 Some programs use functions declared in both <curses.h> and <term.h>,
1467 and must include both headers in the same module.
1468 Very old versions of AIX curses required including <curses.h>
1469 before including <term.h>.
1470 .IP
1471 Because ncurses header files include the headers needed to
1472 define datatypes used in the headers,
1473 ncurses header files can be included in any order.
1474 But for portability, you should include <curses.h> before <term.h>.
1475 .bP
1476 X/Open Curses says \fI"may make visible"\fP
1477 because including a header file does not necessarily make all symbols
1478 in it visible (there are ifdef's to consider).
1479 .IP
1480 For instance, in ncurses <wchar.h> \fImay\fP be included if
1481 the proper symbol is defined, and if ncurses is configured for
1482 wide-character support.
1483 If the header is included, its symbols may be made visible.
1484 That depends on the value used for \fB_XOPEN_SOURCE\fP
1485 feature test macro.
1486 .bP
1487 X/Open Curses documents one required header,
1488 in a special case: <stdarg.h> before <curses.h> to prototype
1489 the \fBvw_printw\fP and \fBvw_scanw\fP functions
1490 (as well as the obsolete
1491 the \fBvwprintw\fP and \fBvwscanw\fP functions).
1492 Each of those uses a \fBva_list\fP parameter.
1493 .IP
1494 The two obsolete functions were introduced in SVr3.
1495 The other functions were introduced in X/Open Curses.
1496 In between, SVr4 curses provided for the possibility that
1497 an application might include either <varargs.h> or <stdarg.h>.
1498 Initially, that was done by using \fBvoid*\fP for the \fBva_list\fP
1499 parameter.
1500 Later, a special type (defined in <stdio.h>) was introduced,
1501 to allow for compiler type-checking.
1502 That special type is always available,
1503 because <stdio.h> is always included by <curses.h>.
1504 .IP
1505 None of the X/Open Curses implementations require an application
1506 to include <stdarg.h> before <curses.h> because they either
1507 have allowed for a special type, or (like ncurses) include <stdarg.h>
1508 directly to provide a portable interface.
1509 .SH NOTES
1510 .PP
1511 If standard output from a \fBncurses\fR program is re-directed to something
1512 which is not a tty, screen updates will be directed to standard error.
1513 This was an undocumented feature of AT&T System V Release 3 curses.
1514 .SH AUTHORS
1515 Zeyd M. Ben-Halim, Eric S. Raymond, Thomas E. Dickey.
1516 Based on pcurses by Pavel Curtis.