X-Git-Url: http://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fncurses.3x.html;h=d92016cedbaa32b36e3101732d1a61a877449158;hp=9a946e91e7ade814dfd06d31ee6ec2cd7245efbd;hb=0485620c03e69b1b58a6b12e5e45c98415fc7575;hpb=a20e6eb464be80b9cd8cae7ce925d27fe9c209ed diff --git a/doc/html/man/ncurses.3x.html b/doc/html/man/ncurses.3x.html index 9a946e91..d92016ce 100644 --- a/doc/html/man/ncurses.3x.html +++ b/doc/html/man/ncurses.3x.html @@ -59,7 +59,7 @@ method of updating character screens with reasonable optimization. This implementation is "new curses" (ncurses) and is the approved replacement for 4.4BSD classic curses, which has been discontinued. - This describes ncurses version 6.0 (patch 20170812). + This describes ncurses version 6.0 (patch 20170819). The ncurses library emulates the curses library of System V Release 4 UNIX, and XPG4 (X/Open Portability Guide) curses (also known as XSI @@ -176,7 +176,7 @@ standard place. For example, if TERM is set to att4424, then the com- piled terminal definition is found in - /usr/share/terminfo/a/att4424. + /usr/local/ncurses/lib/terminfo/a/att4424. (The a is copied from the first letter of att4424 to avoid creation of huge directories.) However, if TERMINFO is set to $HOME/myterms, @@ -186,10 +186,10 @@ and if that fails, it then checks - /usr/share/terminfo/a/att4424. + /usr/local/ncurses/lib/terminfo/a/att4424. This is useful for developing experimental definitions or when write - permission in /usr/share/terminfo is not available. + permission in /usr/local/ncurses/lib/terminfo is not available. The integer variables LINES and COLS are defined in <curses.h> and will be filled in by initscr with the size of the screen. The constants @@ -1091,13 +1091,14 @@ o /usr/local/ncurses/share/terminfo:/usr/share/terminfo (corre- sponding to the TERMINFO_DIRS variable) - o /usr/share/terminfo (corresponding to the TERMINFO variable) + o /usr/local/ncurses/lib/terminfo (corresponding to the TER- + MINFO variable)
- Specifies a list of locations to search for terminal descriptions. - Each location in the list is a terminal database as described in the - section on the TERMINFO variable. The list is separated by colons + Specifies a list of locations to search for terminal descriptions. + Each location in the list is a terminal database as described in the + section on the TERMINFO variable. The list is separated by colons (i.e., ":") on Unix, semicolons on OS/2 EMX. There is no corresponding feature in System V terminfo; it is an exten- @@ -1105,11 +1106,11 @@
- If TERMCAP does not hold a file name then ncurses checks the TERMPATH - environment variable. This is a list of filenames separated by spaces + If TERMCAP does not hold a file name then ncurses checks the TERMPATH + environment variable. This is a list of filenames separated by spaces or colons (i.e., ":") on Unix, semicolons on OS/2 EMX. - If the TERMPATH environment variable is not set, ncurses looks in the + If the TERMPATH environment variable is not set, ncurses looks in the files /etc/termcap, /usr/share/misc/termcap and $HOME/.termcap, @@ -1117,7 +1118,7 @@ in that order. The library may be configured to disregard the following variables when - the current user is the superuser (root), or if the application uses + the current user is the superuser (root), or if the application uses setuid or setgid permissions: $TERMINFO, $TERMINFO_DIRS, $TERMPATH, as well as $HOME. @@ -1125,8 +1126,8 @@
Several different configurations are possible, depending on the config- - ure script options used when building ncurses. There are a few main - options whose effects are visible to the applications developer using + ure script options used when building ncurses. There are a few main + options whose effects are visible to the applications developer using ncurses: --disable-overwrite @@ -1134,19 +1135,19 @@ #include <curses.h> - This option is used to avoid filename conflicts when ncurses is + This option is used to avoid filename conflicts when ncurses is not the main implementation of curses of the computer. If ncurses - is installed disabling overwrite, it puts its headers in a subdi- + is installed disabling overwrite, it puts its headers in a subdi- rectory, e.g., #include <ncurses/curses.h> - It also omits a symbolic link which would allow you to use + It also omits a symbolic link which would allow you to use -lcurses to build executables. --enable-widec - The configure script renames the library and (if the --dis- - able-overwrite option is used) puts the header files in a differ- + The configure script renames the library and (if the --dis- + able-overwrite option is used) puts the header files in a differ- ent subdirectory. All of the library names have a "w" appended to them, i.e., instead of @@ -1157,23 +1158,23 @@ -lncursesw You must also define _XOPEN_SOURCE_EXTENDED when compiling for the - wide-character library to use the extended (wide-character) func- - tions. The curses.h file which is installed for the wide-charac- + wide-character library to use the extended (wide-character) func- + tions. The curses.h file which is installed for the wide-charac- ter library is designed to be compatible with the normal library's - header. Only the size of the WINDOW structure differs, and very - few applications require more than a pointer to WINDOWs. If the + header. Only the size of the WINDOW structure differs, and very + few applications require more than a pointer to WINDOWs. If the headers are installed allowing overwrite, the wide-character - library's headers should be installed last, to allow applications + library's headers should be installed last, to allow applications to be built using either library from the same set of headers. --with-pthread - The configure script renames the library. All of the library - names have a "t" appended to them (before any "w" added by + The configure script renames the library. All of the library + names have a "t" appended to them (before any "w" added by --enable-widec). The global variables such as LINES are replaced by macros to allow read-only access. At the same time, setter-functions are provided - to set these values. Some applications (very few) may require + to set these values. Some applications (very few) may require changes to work with this convention. --with-shared @@ -1183,22 +1184,23 @@ --with-debug --with-profile - The shared and normal (static) library names differ by their suf- - fixes, e.g., libncurses.so and libncurses.a. The debug and pro- - filing libraries add a "_g" and a "_p" to the root names respec- + The shared and normal (static) library names differ by their suf- + fixes, e.g., libncurses.so and libncurses.a. The debug and pro- + filing libraries add a "_g" and a "_p" to the root names respec- tively, e.g., libncurses_g.a and libncurses_p.a. --with-trace - The trace function normally resides in the debug library, but it + The trace function normally resides in the debug library, but it is sometimes useful to configure this in the shared library. Con- - figure scripts should check for the function's existence rather + figure scripts should check for the function's existence rather than assuming it is always in the debug library.
/usr/share/tabset - directory containing initialization files for the terminal capa- - bility database /usr/share/terminfo terminal capability database + directory containing initialization files for the terminal capa- + bility database /usr/local/ncurses/lib/terminfo terminal capabil- + ity database