--- ./ATTIC/2023-10-07.man 2023-10-07 20:19:59.302511195 -0500 +++ ./ATTIC/2023-10-07.gbr.man 2023-10-13 18:28:35.939779934 -0500 @@ -100,7 +100,8 @@ This utility is implemented as a link to tic(1M), with the latter’s -I option implied. You can use other tic options such as -1, -f, -v, -w, - and -x. + and -x. The -V option reports the version of ncurses associated with + this program and exits with a successful status. Translations from nonstandard capabilities captoinfo translates some obsolete, nonstandard capabilities into @@ -212,7 +213,7 @@ AUTHOR Eric S. Raymond and - Thomas E. Dickey + Thomas E. Dickey SEE ALSO infocmp(1M), tic(1M), curses(3X), terminfo(5) @@ -725,8 +726,8 @@ loaded using the -x option of tic. FILES - /home/branden/ncurses‐HEAD/share/terminfo - Compiled terminal description database. + /home/branden/ncurses‐HEAD/share/terminfo + compiled terminal description database HISTORY Although System V Release 2 provided a terminfo library, it had no @@ -771,18 +772,18 @@ 4’s. Actual BSD curses versions will have a more restricted set. To see only the 4.4BSD set, use -r -RBSD. -BUGS - The -F option of infocmp(1) should be a toe(1) mode. - AUTHOR Eric S. Raymond and - Thomas E. Dickey + Thomas E. Dickey + +BUGS + The -F option of infocmp(1M) should be a toe(1M) mode. SEE ALSO captoinfo(1M), infotocap(1M), tic(1M), toe(1M), curses(3X), terminfo(5), user_caps(5) - https://invisible‐island.net/ncurses/tctest.html + https://invisible-island.net/ncurses/tctest.html ncurses 6.4 2023‐10‐07 infocmp(1) ─────────────────────────────────────────────────────────────────────────────── @@ -819,7 +820,7 @@ AUTHOR Eric S. Raymond and - Thomas E. Dickey + Thomas E. Dickey SEE ALSO infocmp(1M), tic(1M), curses(3X), terminfo(5) @@ -1036,6 +1037,10 @@ When setting or resetting the left‐margin, tabs may reset the right‐ margin. +FILES + /home/branden/ncurses‐HEAD/share/tabset + tab stop initialization database + PORTABILITY IEEE Std 1003.1/The Open Group Base Specifications Issue 7 (POSIX.1‐2008) describes a tabs utility. However @@ -1515,12 +1520,12 @@ $HOME/.terminfo database unless TERMINFO is explicitly set to it. FILES - /home/branden/ncurses‐HEAD/share/terminfo/?/* - Compiled terminal description database. + /home/branden/ncurses‐HEAD/share/terminfo + compiled terminal description database AUTHOR Eric S. Raymond and - Thomas E. Dickey + Thomas E. Dickey SEE ALSO captoinfo(1M), infocmp(1M), infotocap(1M), toe(1M), curses(3X), @@ -1569,18 +1574,18 @@ -u file lists terminal type dependencies in file, a terminfo entry source or termcap database file. The report summarizes the - “use” (terminfo) and “tc” (termcap) relations: each line + “use” (terminfo) and tc (termcap) relations: each line comprises the primary name of a terminal type employing use/tc capabilities, a colon, a space‐ and tab‐separated list of primary names of terminal types thus named, and a newline. -U file lists terminal type reverse dependencies in file, a terminfo entry source or termcap database file. The report summarizes - the “use” (terminfo) and “tc” (termcap) reverse relations: - each line comprises the primary name of a terminal type - occurring in use/tc capabilities, a colon, a space‐ and tab‐ - separated list of primary names of terminal types naming them - thus, and a newline. + the “use” (terminfo) and tc (termcap) reverse relations: each + line comprises the primary name of a terminal type occurring + in use/tc capabilities, a colon, a space‐ and tab‐separated + list of primary names of terminal types naming them thus, and + a newline. -v [n] reports verbose status information to the standard error stream, showing toe’s progress. @@ -1931,14 +1936,11 @@ terminated by an exclamation mark (!) on a line by itself. FILES - /home/branden/ncurses‐HEAD/share/terminfo - compiled terminal description database + /home/branden/ncurses‐HEAD/share/tabset + tab stop initialization database - /home/branden/ncurses‐HEAD/share/tabset/* - tab settings for some terminals, in a format appropriate to be - output to the terminal (escape sequences that set margins and - tabs); for more information, see the Tabs and Initialization, - section of terminfo(5) + /home/branden/ncurses‐HEAD/share/terminfo + compiled terminal description database EXIT CODES If the -S option is used, tput checks for errors from each line, and if @@ -2361,7 +2363,7 @@ HISTORY A reset command appeared in 1BSD (March 1978), written by Kurt Shoens. - This program set the erase and kill characters to ˆH (backspace) and @ + This program set the erase and kill characters to ^H (backspace) and @ respectively. Mark Horton improved that in 3BSD (October 1979), adding intr, quit, start/stop and eof characters as well as changing the program to avoid modifying any user settings. That version of reset @@ -2476,8 +2478,8 @@ system port name to terminal type mapping database (BSD versions only). - /home/branden/ncurses‐HEAD/share/terminfo - terminal capability database + /home/branden/ncurses‐HEAD/share/terminfo + compiled terminal description database directory SEE ALSO csh(1), sh(1), stty(1), curs_terminfo(3X), tty(4), terminfo(5), @@ -3350,13 +3352,13 @@ into the attribute parameter. These newer routines use similar names, because X/Open simply added an underscore (_) for the newer names. - The int datatype used in the legacy routines is treated as if it is the - same size as chtype (used by addch(3X)). It holds the common video - attributes (such as bold, reverse), as well as a few bits for color. - Those bits correspond to the A_COLOR symbol. The COLOR_PAIR macro - provides a value which can be OR’d into the attribute parameter. For - example, as long as that value fits into the A_COLOR mask, then these - calls produce similar results: + The int data type used in the legacy routines is treated as if it were + the same size as chtype (used by addch(3X)). It holds attributes such + as bold and inverse as well as a few bits for color. Those bits + correspond to the A_COLOR symbol. The COLOR_PAIR macro provides a + value which can be OR’d into the attribute parameter. For example, as + long as that value fits into the A_COLOR mask, then these calls produce + similar results: attrset(A_BOLD | COLOR_PAIR(pair)); attr_set(A_BOLD, pair, NULL); @@ -3657,9 +3659,9 @@ For example, the Solaris xpg4 (X/Open) curses declares attr_t to be an unsigned short integer (16‐bits), while chtype is a unsigned - integer (32‐bits). The WA_ symbols in this case are different from - the A_ symbols because they are used for a smaller datatype which - does not represent A_CHARTEXT or A_COLOR. + integer (32‐bits). The WA_ symbols in this case differ from the A_ + symbols because they are used for a smaller data type that does not + represent A_CHARTEXT or A_COLOR. In this implementation (as in many others), the values happen to be the same because it simplifies copying information between chtype @@ -4336,7 +4338,7 @@ int extended_color_content(int color, int *r, int *g, int *b); int extended_pair_content(int pair, int *f, int *b); - /* extensions */ + /* extension */ void reset_color_pairs(void); int COLOR_PAIR(int n); @@ -6856,8 +6858,8 @@ DESCRIPTION These are building blocks for the form library, defining fields that can be created using the fieldtype(3FORM) functions. Each provides - functions for field‐ and character‐validation, according to the given - datatype. + functions for field and character validation, according to the given + data type. TYPE_ALNUM This holds alphanumeric data. @@ -9288,7 +9290,8 @@ is returned; otherwise, ERR is returned. napms - The napms routine is used to sleep for ms milliseconds. + The napms routine is used to sleep for ms milliseconds. If the value + of ms exceeds 30,000 (thirty seconds), it is capped at that value. RETURN VALUE Except for curs_set, these routines always return OK. @@ -10506,24 +10509,23 @@ matching button‐releases. BUGS - Mouse events under xterm will not in fact be ignored during cooked - mode, if they have been enabled by mousemask. Instead, the xterm mouse - report sequence will appear in the string read. - - Mouse events under xterm will not be detected correctly in a window - with its keypad bit off, since they are interpreted as a variety of - function key. Your terminfo description should have kmous set to - “\E[M” (the beginning of the response from xterm for mouse clicks). - Other values for kmous are permitted, but under the same assumption, - i.e., it is the beginning of the response. - - Because there are no standard terminal responses that would serve to - identify terminals which support the xterm mouse protocol, ncurses - assumes that if kmous is defined in the terminal description, or if the - terminal description’s primary name or aliases contain the string - “xterm”, then the terminal may send mouse events. The kmous capability - is checked first, allowing the use of newer xterm mouse protocols such - as xterm’s private mode 1006. + Mouse events from xterm are not ignored in cooked mode if they have + been enabled by mousemask. Instead, the xterm mouse report sequence + appear in the string read. + + Mouse event reports from xterm are not detected correctly in a window + with keypad application mode disabled, since they are interpreted as a + variety of function key. Set the the terminal’s terminfo capability + kmous to “\E[M” (the beginning of the response from xterm for mouse + clicks). Other values of kmous are permitted under the same + assumption, that is, the report begins with that sequence. + + Because there are no standard response sequences that serve to identify + terminals supporting the xterm mouse protocol, ncurses assumes that if + kmous is defined in the terminal description, or if the terminal type’s + primary name or aliases contain the string “xterm”, then the terminal + may send mouse events. The kmous capability is checked first, allowing + use of newer xterm mouse protocols such as its private mode 1006. SEE ALSO curses(3X), curs_inopts(3X), curs_kernel(3X), curs_slk(3X), @@ -10637,8 +10639,9 @@ Before a curses program is run, the tab stops of the terminal should be set and its initialization strings, if defined, must be output. This can be done by executing the tput init command after the shell - environment variable TERM has been exported. tset(1) is usually - responsible for doing this. [See terminfo(5) for further details.] + environment variable TERM has been exported. (The BSD‐style tset(1) + utility also performs this function.) See subsection “Tabs and + Initialization” of terminfo(5). Datatypes The ncurses library permits manipulation of data structures, called @@ -11748,10 +11751,11 @@ than assuming it is always in the debug library. FILES - /home/branden/ncurses‐HEAD/share/tabset - directory containing initialization files for the terminal - capability database /home/branden/ncurses‐HEAD/share/terminfo - terminal capability database + /home/branden/ncurses‐HEAD/share/tabset + tab stop initialization database + + /home/branden/ncurses‐HEAD/share/terminfo + compiled terminal capability database EXTENSIONS The ncurses library can be compiled with an option (-DUSE_GETCAP) that @@ -11906,9 +11910,9 @@ old versions of AIX curses required including before including . - Because ncurses header files include the headers needed to define - datatypes used in the headers, ncurses header files can be included - in any order. But for portability, you should include + Because ncurses header files include any others needed to define + the data types they use, ncurses header files can be included in + any order. But for portability, you should include before . • X/Open Curses says "may make visible" because including a header @@ -13113,11 +13117,6 @@ • NetBSD 8 (2018) has a panel library begun by Valery Ushakov in 2015. This is based on the AT&T documentation. -FILES - panel.h interface for the panels library - - libpanel.a the panels library itself - AUTHOR Originally written by Warren Tucker , primarily to assist in porting u386mon to systems without a native @@ -13366,7 +13365,7 @@ conditioned using NCURSES_VERSION. BUGS - Padding in the mc5p, mc4 and mc5 capabilities will not be interpreted. + Padding in the mc5p, mc4, and mc5 capabilities is not interpreted. SEE ALSO curses(3X) @@ -14455,7 +14454,7 @@ int tigetnum_sp(SCREEN* sp, const char *capname); char* tigetstr_sp(SCREEN* sp, const char *capname); - /* may instead use 9 long parameters */ + /* tparm_sp may instead use 9 long parameters instead of str */ char* tparm_sp(SCREEN* sp, const char *str, ...); int tputs_sp(SCREEN* sp, const char *str, int affcnt, NCURSES_SP_OUTC putc); @@ -14855,37 +14854,6 @@ • A call to tgoto using a capability with more than two parameters is an error. -BUGS - If you call tgetstr to fetch ca or any other parameterized string, be - aware that it will be returned in terminfo notation, not the older and - not‐quite‐compatible termcap notation. This will not cause problems if - all you do with it is call tgoto or tparm, which both expand terminfo‐ - style strings as terminfo. (The tgoto function, if configured to - support termcap, will check if the string is indeed terminfo‐style by - looking for "%p" parameters or "$<..>" delays, and invoke a termcap‐ - style parser if the string does not appear to be terminfo). - - Because terminfo conventions for representing padding in string - capabilities differ from termcap’s, users can be surprised: - - • tputs("50") in a terminfo system will put out a literal “50” rather - than busy‐waiting for 50 milliseconds. - - • However, if ncurses is configured to support termcap, it may also - have been configured to support the BSD‐style padding. - - In that case, tputs inspects strings passed to it, looking for - digits at the beginning of the string. - - tputs("50") in a termcap system may wait for 50 milliseconds rather - than put out a literal “50” - - Note that termcap has nothing analogous to terminfo’s sgr string. One - consequence of this is that termcap applications assume me (terminfo - sgr0) does not reset the alternate character set. This implementation - checks for, and modifies the data shown to the termcap interface to - accommodate termcap’s limitation in this respect. - PORTABILITY Standards These functions are provided for supporting legacy applications, and @@ -14984,10 +14952,42 @@ which must be taken into account by programs which can work with all termcap library interfaces. +BUGS + If you call tgetstr to fetch ca or any other parameterized string + capability, be aware that it is returned in terminfo notation, not the + older and not‐quite‐compatible termcap notation. This does not cause + problems if all you do with it is call tgoto or tparm, which both + expand terminfo‐style strings as terminfo does. (The tgoto function, + if configured to support termcap, checks if the string is indeed + terminfo‐style by looking for “%p” parameters or “<...>” delays, and + invokes a termcap‐style parser if the string appears not to use + terminfo syntax.) + + Because terminfo’s syntax for padding in string capabilities differs + from termcap’s, users can be surprised. + + • tputs("50") in a terminfo system transmits “50” rather than busy‐ + waiting for 50 milliseconds. + + • However, if ncurses is configured to support termcap, it may also + have been configured to support BSD‐style padding. + + In that case, tputs inspects strings passed to it, looking for + digits at the beginning of the string. + + tputs("50") in a termcap system may busy‐wait for 50 milliseconds + rather than transmitting “50”. + + termcap has nothing analogous to terminfo’s sgr string. One + consequence is that termcap applications assume that me (equivalent to + terminfo’s sgr0 capability) does not reset the alternate character set. + ncurses checks for, and modifies the data shared with, the termcap + interface to accommodate the latter’s limitation in this respect. + SEE ALSO curses(3X), putc(3), term_variables(3X), terminfo(5) - https://invisible‐island.net/ncurses/tctest.html + https://invisible-island.net/ncurses/tctest.html ncurses 6.4 2023‐10‐07 termcap(3NCURSES) ─────────────────────────────────────────────────────────────────────────────── @@ -15218,9 +15218,13 @@ formatting capability to see what the curses library would assume. Output Functions - The tputs routine applies padding information (i.e., by interpreting - marker embedded in the terminfo capability such as “$<5>” as 5 - milliseconds) to the string str and outputs it: + String capabilities can contain padding information, a time delay + (accommodating performance limitations of hardware terminals) expressed + as $<n>, where n is a nonnegative integral count of milliseconds. If n + exceeds 30,000 (thirty seconds), it is capped at that value. + + The tputs routine applies padding information to the string str and + outputs it: • The str parameter must be a terminfo string variable or the return value from tparm, tiparm, tgetstr, or tgoto. @@ -16836,9 +16840,13 @@ delay_output The delay_output routine inserts an ms millisecond pause in output. - This routine should not be used extensively because padding characters - are used rather than a CPU pause. If no padding character is - specified, this uses napms to perform the delay. + Employ this function judiciously when terminal output uses padding, + because ncurses transmits null characters (consuming CPU and I/O + resources) instead of sleeping and requesting resumption from the + operating system. If padding is not in use, or is disabled with the + environment variable NCURSES_NO_PADDING, ncurses uses napms to perform + the delay. If the value of ms exceeds 30,000 (thirty seconds), it is + capped at that value. flushinp The flushinp routine throws away any typeahead that has been typed by @@ -17167,9 +17175,10 @@ Calling subwin creates and returns a pointer to a new window with the given number of lines, nlines, and columns, ncols. The window is at position (begin_y, begin_x) on the screen. The subwindow shares memory - with the window orig, so that changes made to one window will affect - both windows. When using this routine, it is necessary to call - touchwin or touchline on orig before calling wrefresh on the subwindow. + with the window orig, its ancestor, so that changes made to one window + will affect both windows. When using this routine, it is necessary to + call touchwin or touchline on orig before calling wrefresh on the + subwindow. derwin Calling derwin is the same as calling subwin, except that begin_y and @@ -17258,18 +17267,6 @@ Note that syncok may be a macro. -BUGS - The subwindow functions (subwin, derwin, mvderwin, wsyncup, wsyncdown, - wcursyncup, syncok) are flaky, incompletely implemented, and not well - tested. - - The System V curses documentation is very unclear about what wsyncup - and wsyncdown actually do. It seems to imply that they are only - supposed to touch exactly those lines that are affected by ancestor - changes. The language here, and the behavior of the curses - implementation, is patterned on the XPG4 curses standard. The weaker - XPG4 spec may result in slower updates. - PORTABILITY The XSI Curses standard, Issue 4 describes these functions. @@ -17291,6 +17288,17 @@ • NetBSD copied this feature of ncurses in 2003. PDCurses follows the scheme used in Solaris X/Open curses. +BUGS + The subwindow functions subwin, derwin, mvderwin, wsyncup, wsyncdown, + wcursyncup, and syncok are flaky, incompletely implemented, and not + well tested. + + System V’s curses documentation is unclear about what wsyncup and + wsyncdown actually do. It seems to imply that they are supposed to + touch only those lines that are affected by changes to a window’s + ancestors. The language here, and behavior of ncurses, is patterned on + the X/Open Curses standard; this approach may result in slower updates. + SEE ALSO curses(3X), curs_initscr(3X), curs_refresh(3X), curs_touch(3X), curs_variables(3X) @@ -17955,8 +17963,8 @@ 0000 1a 01 10 00 02 00 03 00 82 00 31 00 61 64 6d 33 ........ ..1.adm3 0010 61 7c 6c 73 69 20 61 64 6d 33 61 00 00 01 50 00 a|lsi ad m3a...P. 0020 ff ff 18 00 ff ff 00 00 02 00 ff ff ff ff 04 00 ........ ........ - 0030 ff ff ff ff ff ff ff ff 0a 00 25 00 27 00 ff ff ........ ..%.’... - 0040 29 00 ff ff ff ff 2b 00 ff ff 2d 00 ff ff ff ff ).....+. ..‐..... + 0030 ff ff ff ff ff ff ff ff 0a 00 25 00 27 00 ff ff ........ ..%.'... + 0040 29 00 ff ff ff ff 2b 00 ff ff 2d 00 ff ff ff ff ).....+. ..-..... 0050 ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff ........ ........ 0060 ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff ........ ........ 0070 ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff ........ ........ @@ -17992,8 +18000,8 @@ 4096 bytes. FILES - /home/branden/ncurses‐HEAD/share/terminfo/*/* compiled terminal - capability database + /home/branden/ncurses‐HEAD/share/terminfo + compiled terminal description database AUTHORS Thomas E. Dickey @@ -20550,8 +20558,8 @@ • OSF -- Supports both the SVr4 set and the AIX extensions. FILES - /home/branden/ncurses‐HEAD/share/terminfo/?/* - files containing terminal descriptions + /home/branden/ncurses‐HEAD/share/terminfo + compiled terminal description database directory AUTHORS Zeyd M. Ben‐Halim, Eric S. Raymond, Thomas E. Dickey. Based on pcurses @@ -21061,8 +21069,8 @@ should be unique within the first 14 characters. FILES - /home/branden/ncurses‐HEAD/share/terminfo/?/* - compiled terminal capability database + /home/branden/ncurses‐HEAD/share/terminfo + compiled terminal description database /etc/inittab tty line initialization (AT&T‐like UNIXes)