X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=man%2Fncurses.3x;h=703a239abfdeff19543fceec8485053326dbffa2;hp=7e337f9d21b34b34640b9bd6383b1bc3890bcbd2;hb=ce7b402c144d2b6d3773ef5b42aad9daf1ad76fe;hpb=76af49c338ca828b39306fcf93c6d49dfaf11dfc diff --git a/man/ncurses.3x b/man/ncurses.3x index 7e337f9d..703a239a 100644 --- a/man/ncurses.3x +++ b/man/ncurses.3x @@ -27,7 +27,7 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: ncurses.3x,v 1.90 2008/09/27 19:30:39 tom Exp $ +.\" $Id: ncurses.3x,v 1.92 2008/10/25 23:31:45 tom Exp $ .hy 0 .TH ncurses 3X "" .ds n 5 @@ -74,10 +74,23 @@ terminal and \fBcurses\fR input and output options; environment query routines; color manipulation; use of soft label keys; terminfo capabilities; and access to low-level terminal-manipulation routines. .PP -To initialize the routines, the routine \fBinitscr\fR or \fBnewterm\fR -must be called before any of the other routines that deal with windows +The library uses the locale which the calling program has initialized. +That is normally done with \fBsetlocale\fP: +.sp + \fBsetlocale(LC_ALL, "");\fP +.sp +If the locale is not initialized, +the library assumes that characters are printable as in ISO-8859-1, +to work with certain legacy programs. +You should initialize the locale and not rely on specific details of +the library when the locale has not been setup. +.PP +The function \fBinitscr\fR or \fBnewterm\fR +must be called to initialize the library +before any of the other routines that deal with windows and screens are used. The routine \fBendwin\fR must be called before exiting. +.PP To get character-at-a-time input without echoing (most interactive, screen oriented programs want this), the following sequence should be used: @@ -280,6 +293,8 @@ 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)*