From: Thomas E. Dickey Date: Sun, 28 Jan 2018 01:02:35 +0000 (+0000) Subject: ncurses 6.1 - patch 20180127 X-Git-Tag: v6.1~1 X-Git-Url: http://ncurses.scripts.mit.edu/?p=ncurses.git;a=commitdiff_plain;h=d66080c21038ad4feb2e41a0c4e517d5b4a03ab2 ncurses 6.1 - patch 20180127 + updated release notes + amend a warning message from tic which should have flagged misuse of "XT" capability in "screen" terminal description. > terminfo changes: + trim "XT" from screen entry, add comments to explain why it was not suitable -TD + modify iterm to use xterm+sl-twm building block -TD + mark konsole-420pc, konsole-vt100, konsole-xf3x obsolete reflecting konsole's removal in 2008 -TD + expanded the history section of konsole to explain its flawed imitation of xterm's keyboard -TD + use xterm+x11mouse in screen.* entries because screen does not yet support xterm's 1006 mode -TD + add nsterm-build400 for macOS 10.13 -TD + add ansi+idc1, use that in ansi+idc adding dch for consistency -TD + update vte to vte-2017 -TD + add ecma+strikeout to vte-2017 -TD + add iterm2-direct -TD + updated teraterm, added teraterm-256color -TD + add mlterm-direct -TD + add descriptions for ANSI building-blocks -TD --- diff --git a/ANNOUNCE b/ANNOUNCE index 858c7f2f..8bda60e2 100644 --- a/ANNOUNCE +++ b/ANNOUNCE @@ -1,4 +1,4 @@ - Announcing ncurses 6.0 + Announcing ncurses 6.1 Overview @@ -6,8 +6,8 @@ Overview curses in System V Release 4.0 (SVr4), and more. It uses terminfo format, supports pads and color and multiple highlights and forms characters and function-key mapping, and has all the other SVr4-curses - enhancements over BSD curses. SVr4 curses is better known today as - X/Open Curses. + enhancements over BSD curses. SVr4 curses became the basis of X/Open + Curses. In mid-June 1995, the maintainer of 4.4BSD curses declared that he considered 4.4BSD curses obsolete, and encouraged the keepers of unix @@ -38,428 +38,599 @@ Overview Full manual pages are provided for the library and tools. - The ncurses distribution is available via anonymous FTP at the GNU - distribution site + The ncurses distribution is available at ncurses' [9]homepage: - [9]ftp://ftp.gnu.org/gnu/ncurses/ . + [10]ftp://ftp.invisible-island.net/ncurses/ or + [11]https://invisible-mirror.net/archives/ncurses/ . - It is also available at + It is also available via anonymous FTP at the GNU distribution site - [10]ftp://invisible-island.net/ncurses/ . + [12]ftp://ftp.gnu.org/gnu/ncurses/ . Release Notes - These notes are for ncurses 6.0, released August 8, 2015. + These notes are for ncurses 6.1, released January 27, 2018. This release is designed to be source-compatible with ncurses 5.0 - through 5.9; providing a new application binary interface (ABI). - Although the source can still be configured to support the ncurses 5 - ABI, the intent of the release is to provide extensions which are - generally useful, but binary-incompatible with ncurses 5: - * Extend the cchar_t structure to allow more than 16 colors to be - encoded. - * Modify the encoding of mouse state to make room for a 5th mouse - button. That allows one to use ncurses with a wheel mouse with - xterm or similar X terminal emulators. - - There are, of course, numerous other improvements, including - * fixes made based on the Clang and Coverity static analyzers. - * memory leak fixes using Valgrind - - The release notes mention some bug-fixes, but are focused on new - features and improvements to existing features log since ncurses 5.9 + through 6.0; providing extensions to the application binary interface + (ABI). Although the source can still be configured to support the + ncurses 5 ABI, the intent of the release is to provide extensions to + the ncurses 6 ABI: + * improve integration of tput and tset + * provide support for extended numeric capabilities. + + There are, of course, numerous other improvements, listed in this + announcement. + + The release notes also mention some bug-fixes, but are focused on new + features and improvements to existing features since ncurses 6.0 release. - While the intent of the release is to provide a new stable ABI, there - are other development activities which are summarized below. - * The original release plan, e.g., for "5.10" was to improve the - MinGW port. Ultimately that was completed (wide-character support, - mouse, etc), but was deferred to focus on termcap support and - performance issues. Also, pinpointing the problems with Console2 - took a while. - * A review of termcap compatibility in 2011 led to several minor - fixes in the library and improvements to utilities. To do this - properly, a review of the various extent termcap implementations - was needed. - The [11]termcap library checker (tctest) (not part of ncurses) was - one result. A followup review of performance using - [12]ncurses-examples in 2014 led to additional improvements. - * Output buffering provided a further, but worthwhile distraction. A - bug report in 2012 regarding the use of signal handlers in - ncurses) pointed out [13]a problem with the use of unsafe - functions for handling SIGTSTP. Other signals could be addressed - with workarounds; repairing SIGTSTP required a different approach. - The solution required changing internal behavior of the library: - how it handles output buffering. - Now ncurses buffers its own output, independently of the standard - output. A few applications relied upon the library's direct reuse - of the standard output buffering; however that is unspecified - behavior and has never been a recommended practice. Identifying - these applications as well as refining the change to permit - low-level applications to work consistently took time. - * Since the introduction of the experimental support for 256 colors - early in [14]2005 (released in [15]ncurses 5.5), there has been - increased user interest. Almost all packagers continue providing - the ncurses ABI 5 which cannot support 256 colors. - * Symbol versioning, or the lack of it in ncurses, is the main - reason why packagers would be reluctant to add a new ncurses ABI. - This release provides the new ABI along with script-generated - lists of versioned symbols which can be used for both ABI 5 and 6 - (with distinct names to keep the two separate). This took time to - development, as reported in [16]Symbol versioning in ncurses. - Library improvements - Output buffering - - X/Open curses provides more than one initialization function: - * [17]initscr (the simplest) accepts no parameters. - * [18]newterm accepts parameters for the stream input and output - * [19]setupterm (the low-level function) accepts a parameter for the - file descriptor of the output. - - They are documented in X/Open as if initscr calls newterm using stdout - for output stream, and in turn newterm calls setupterm using - fileno(stdout) for the file descriptor. As long as an implementation - acts as if it does this, it conforms. In practice, implementations do - what is implied. This creates a problem: the low-level setupterm - function's file descriptor is unbuffered, while newterm implies - buffered output. X/Open Curses says that all output is done through - the file descriptor, and does not say how the output stream is - actually used. - - Initially, ncurses used the file descriptor (obtained from the output - stream passed to newterm) for changing the terminal modes, and relied - upon the output parameter of newterm for buffered output. Later (to - avoid using unsafe buffered I/O in signal handlers), ncurses was - modified to use the file descriptor (unbuffered output) when cleaning - up on receipt of a signal. Otherwise (when not handling a signal), it - continued to use the buffered output. - - That approach worked reasonably well and as a side effect, using the - same buffered output as an application might use for printf meant that - no flushing was needed when switching between normal- and - screen-modes. - - There were a couple of problems: - * to get good performance, curses (not only ncurses, but SVr4 curses - in general) set an output buffer using setbuf or similar function. - There is no standard (or portable) way to turn that output buffer - off, and revert to line-buffering. The [20]NCURSES_NO_SETBUF - environment variable did make it optional. - * to handle SIGTSTP (the "stop" signal), ncurses relied upon unsafe - functions. That is, due to the complexity of the feature, it - relied upon reusing existing functions which should not have been - called via the signal handler. - - Conveniently, solving the second problem (by making ncurses do its own - output buffering) also fixed the first one. But there were special - cases to resolve: [21]low-level functions such as mvcur, putp, vidattr - explicitly use the standard output. Those functions were reused - internally, and required modification to distinguish whether they were - used by the high-level or low-level interfaces. - - Finally, there may still be a few programs which should be modified to - improve their portability, e.g., adding an - -fflush(stdout); - - when switching from "[22]shell" mode to "[23]program" (curses) mode. - Those are fairly rare because most programmers have learned not to mix - printf and [24]printw. - - Symbol versioning - - This release introduces symbol-versioning to ncurses because without - it, the change of ABI would be less successful. A lengthy discussion - will be presented in [25]Symbol versioning in ncurses. These notes - summarize what has changed, and what can be done with the new release. - - Symbol-versioning allows the developers of a library to mark each - public symbol (both data and functions) with an identifier denoting - the library name and the version for which it was built. By doing - this, users of the library have a way to help ensure that applications - do not accidentally load an incompatible library. In addition, private - symbols can be hidden entirely. - - This release provides sample files for the four principal - configurations of ncurses libraries: ncurses, ncursesw, ncursest and - ncursestw. Each sample is given in two forms: - - ".map" - These list all public symbols, together with version names. - - ".sym" - These list all public symbols, without version names. - - The sample files are generated by scripts which take into account a - few special cases such as [26]tack to omit many of the ncurses private - symbols (beginning with "_nc_"). Here are counts of globals versus - locals: - - Config Symbols Globals Locals "_nc_" - ncurses 976 796 180 332 - ncursesw 1089 905 184 343 - ncursest 979 804 175 358 - ncursestw 1098 914 184 372 - - Although only four sample configurations are presented, each is formed - by merging symbols from several combinations of configure-script - options, taking into account advice from downstream packagers. Because - they are formed by merging, the sample files may list a symbol which - is not in a given package. That is expected. The samples have been - tested and are working with systems (such as Fedora, FreeBSD and - Debian) which fully support this feature. There are other systems - which do not support the feature, and a few (such as Solaris) which - provide incomplete support. - - The version-naming convention used allows these sample files to build - distinct libraries for ABI 5 and 6. Version names consist of - * configuration name, e.g., "NCURSESW" for the wide-character - libraries - * ABI version (if not 5) - * library name for two special cases which have the same interface - across configurations: "TINFO" and "TIC" - * release version - * patch date (for the release version) - - For example, running nm -D on the libraries in the ncurses6 test - package shows these symbol-versions: - -0000000000000000 A NCURSES6_TIC_5.0.19991023 -0000000000000000 A NCURSES6_TIC_5.1.20000708 -0000000000000000 A NCURSES6_TIC_5.5.20051010 -0000000000000000 A NCURSES6_TIC_5.7.20081102 -0000000000000000 A NCURSES6_TIC_5.9.20150530 -0000000000000000 A NCURSES6_TINFO_5.0.19991023 -0000000000000000 A NCURSES6_TINFO_5.1.20000708 -0000000000000000 A NCURSES6_TINFO_5.2.20001021 -0000000000000000 A NCURSES6_TINFO_5.3.20021019 -0000000000000000 A NCURSES6_TINFO_5.4.20040208 -0000000000000000 A NCURSES6_TINFO_5.5.20051010 -0000000000000000 A NCURSES6_TINFO_5.6.20061217 -0000000000000000 A NCURSES6_TINFO_5.7.20081102 -0000000000000000 A NCURSES6_TINFO_5.8.20110226 -0000000000000000 A NCURSES6_TINFO_5.9.20150530 -0000000000000000 A NCURSESW6_5.1.20000708 -0000000000000000 A NCURSESW6_5.3.20021019 -0000000000000000 A NCURSESW6_5.4.20040208 -0000000000000000 A NCURSESW6_5.5.20051010 -0000000000000000 A NCURSESW6_5.6.20061217 -0000000000000000 A NCURSESW6_5.7.20081102 -0000000000000000 A NCURSESW6_5.8.20110226 -0000000000000000 A NCURSESW6_5.9.20150530 - - As a special case, this release (which makes the final change for ABI - 5) is marked with release version 5.9 and patch date 20150530. - - Miscellaneous - - The new release has several improvements for performance and building. - For instance: - * several files in ncurses- and progs-directories were modified to - allow const data used in internal tables to be put by the linker - into the readonly text segment. - * various improvements were made to building the Ada95 binding, both - in simplifying the generated files as well as improving the way it - uses gnatmake - - There are also new features in the libraries: - * added [27]use_tioctl function - * added [28]wgetdelay to retrieve _delay member of WINDOW if it - happens to be opaque, e.g., in the pthread configuration. - * added [29]A_ITALIC extension. - * added form library extension [30]O_DYNAMIC_JUSTIFY option which - can be used to override the different treatment of justification - for static versus dynamic fields . - * rewrote [31]putwin and [32]getwin, making an extended version - which is capable of reading screen-dumps between the wide/normal - ncurses configurations. These are text files, except for a magic - code at the beginning: - -0 string \210\210 Screen-dump (ncurses) - - * several changes to mouse support include: - + added decoder for xterm SGR 1006 mouse mode. - + added experimental support for "%u" format to terminfo. - + improved behavior of wheel-mice for xterm protocol: noting - that there are only button-presses for buttons "4" and "5", - so there is no need to wait to combine events into - double-clicks . - - There are a few new configure options dealing with library - customization: - * add "--enable-ext-putwin" configure option to turn on the extended - putwin/getwin. By default, this is enabled for ABI 6 and disabled - with ABI 5. - * add "--enable-string-hacks" option to control whether strlcat and - strlcpy may be used. Because ncurses already does the requisite - buffer-limit checks, this feature is mainly of interest to quiet - compiler-warnings on a few systems. - * add configure option "--with-tparm-arg" to allow [33]tparm's - parameters to be something more likely to be the same size as a - pointer, e.g., intptr_t (again, the default is set for ABI 6). + New features + + The improved integration of tput and tset made only small changes to + the libraries. However, supporting extended numeric capabilities + required a few changes: + * The TERMINAL structure in is now opaque. Doing that + allowed making the structure larger, to hold the extended numeric + data. + A few applications required changes during development of + ncurses 6.1 because those applications misused the members of that + structure, e.g., directly modifying it rather than using + [13]def_prog_mode. + * Having made TERMINAL opaque (and because none of the library + functions use anything except a pointer to TERMINAL), it was + possible to increase the size of the structure, adding to the end. + Existing applications which were linked to the ncurses 6.0 + high-level (ncurses, ncursesw) and low-level (tinfo, tinfo) + libraries should not require re-linking since the binary interface + did not change, nor did the structure offsets with TERMINAL + change. + A few applications use the inner TERMTYPE structure's offsets to + refer to terminfo capabilities within that structure. Again, those + do not require modification because their offsets within TERMINAL + did not change. + * When configured for wide-characters, i.e., "ncursesw" the TERMINAL + structure is extended. + The new data in TERMINAL holds the same information as TERMTYPE, + but with larger numbers ("int" versus "short"). It is named + TERMTYPE2. + The library uses this structure internally in preference to + TERMTYPE, referring to TERMTYPE only to initialize it for + applications that use the capabilities defined in + * When configured for 8-bit (narrow) characters, the TERMTYPE2 + structure is not used. + * The updated application binary interface is 6.1.20171230 (used for + new [14]versioned symbols), although the interface changes were + developed several months previously. + + The motivation for making this extension came from noticing that + [15]termcap applications could (though not [16]realistically) use + larger numbers than would fit in 16-bits, and the fact that the number + of color pairs for a 256-color xterm could not be expressed in + terminfo (i.e., 32767 versus 65536). Also, a few terminals support + direct-colors, which could use the extension. + + Generally speaking, applications that use internal details of a + library are unsupported. There was exactly one exception for ncurses: + the tack program used the internal details of TERMINAL, because it + provides an ncurses-specific feature for interactively modifying a + terminfo description and writing the updated description to a + text-file. It was possible to not only separate tack from these + [17]internal details of ncurses, but to generalize it so that the + program works with Unix curses (omitting the ncurses-specific + feature). That was released as [18]tack 1.08 in July 2017. + + While making changes to tack to eliminate its dependency upon ncurses + internals, the publicly-visible details of those internals were + reviewed, and some symbols were moved to private header files, while + others were marked explicitly as ncurses internals. Future releases of + ncurses may eliminate some of those symbols (such as those used by + tack 1.07) because they are neither part of the API or the ABI. + + Using the TERMTYPE2 extended numeric capabilities, it is possible to + support both color pair values and color values past 32767. Taking + compatibility into account, developers readily understand that neither + function signatures nor structure offsets change. Also, existing + functions have to operate with the extended numbers. Most of that work + is internal to the library. For the external interfaces, a hybrid + approach was used: + * X/Open Curses defined function prototypes such as wattr_set with + an unused parameter, for "future" use. After 25 years, the future + is here: ncurses uses the parameter to augment color pair values + as described in the [19]manual page. + * Other functions such as those defining color pairs did not have a + corresponding reserved parameter. For those, ncurses defines + extended versions such as init_extended_pair (versus init_pair), + init_extended_color (versus init_color). + + Additionally, to improve performance other changes (and extensions) + are provided in this release: + * Several new functions simplify management of large sets of color + pairs: reset_color_pairs, alloc_pair, find_pair and free_pair. + * New "RGB" extension capability for direct-color support is used to + improve performance of color_content. + * The internal colorpair_t is now a struct, eliminating an internal + 8-bit limit on colors + * Allocation for SCREEN's color-pair table starts small, grows on + demand up to the limit given in the terminal description. + * setcchar and getcchar now treat a negative color-pair as an error. + + Other improvements + + These are new or revised features: + * modify c++/etip.h.in to accommodate deprecation of throw and + throws in c++17 + * add new function unfocus_current_field + * add option to preserve leading whitespace in form fields + * add a macro for is_linetouched and adjust the function's return + value to make it possible for most applications to check for an + error-return. + * add build-time utility report_offsets to help show when the + various configurations of tinfo library are compatible or not. + + These were done to limit or ultimately deprecate features: + * drop two symbols obsoleted in 2004: _nc_check_termtype, and + _nc_resolve_uses + * move _nc_tracebits, _tracedump and _tracemouse to curses.priv.h, + since they are not part of the suggested ABI6. + * mark some structs in form/menu/panel libraries as potentially + opaque without modifying API/ABI. + * ifdef'd header-file definition of mouse_trafo with + NCURSES_NOMACROS + * remove initialization-check for calling napms in the term-driver + configuration; none is needed. + * modify trace to avoid overwriting existing file + + These are improvements to existing features: + * modify make_hash to allow building with address-sanitizer, + assuming that --disable-leaks is configured. + * move SCREEN field for use_tioctl data before the ncursesw fields, + and limit that to the sp-funcs configuration to improve termlib + compatibility + * modify db-iterator: + + ignore zero-length files in db-iterator; these are useful for + instance to suppress $HOME/.terminfo when not wanted. + + modify update_getenv to ensure that environment variables + which are not initially set will be checked later if an + application happens to set them + * modify _nc_outc_wrapper to use the standard output if the screen + was not initialized, rather than returning an error. + * improve checks for low-level terminfo functions when the terminal + has not been initialized. + * modify set_curterm to update ttytype[] data used by longname/p> + * modify _nc_get_screensize to allow for use_env and use_tioctl + state to be per-screen when sp-funcs are configured, better + matching the behavior when using the term-driver configuration. + * remove an early-return from _nc_do_color, which can interfere with + data needed by bkgd when ncurses is configured with extended + colors + * incorporate A_COLOR mask into COLOR_PAIR, in case user application + provides an out-of-range pair number + * modify logic for endwin-state to be able to detect the case where + the screen was never initialized, using that to trigger a flush of + ncurses' buffer for mvcur, e.g., in the sample program dots_mvcur + for the term-driver configuration. + + These are corrections to existing features: + * fixes for writing extended color pairs in putwin. + * modify no-leaks code for lib_cur_term.c to account for the tgetent + cache. + * amend handling of the repeat_char capability in EmitRange to avoid + scope creep: translate the character to the alternate character + set when the alternate character set is enabled, and do not use + repeat_char for characters past 255. + * improve wide-character implementation of myADDNSTR in + frm_driver.c, which was inconsistent with the normal + implementation. + * modify winnstr and winchnstr to return error if the output pointer + is null, as well as adding a null pointer check of the window + pointer for better compatibility with other implementations. + * modify setupterm to save original tty-modes so that erasechar + works as expected. Also modify _nc_setupscreen to avoid redundant + calls to get original tty-modes. + * modify wattr_set and wattr_get to return ERR if win-parameter is + null, as documented. + * correct order of initialization for traces in use_env and + use_tioctl versus first _tracef calls. + * correct parameters for copywin call in _nc_Synchronize_Attributes + * flush the standard output in _nc_flush for the case where SP is + zero, e.g., when called via putp. This fixes a scenario where + "tput flash" did not work after changes in 20130112. + * amend internal use of tputs to consistently use the number of + lines affected, e.g., for insert/delete character operations. + While merging terminfo source early in 1995, several descriptions + used the "*" proportional delay for these operations, prompting a + change in doupdate. + * correct return-value of extended putwin. + * double-width multibyte characters were not counted properly in + winsnstr and wins_nwstr. + * amend fix for _nc_ripoffline from 20091031 to make test/ditto.c + work in threaded configuration. + * modify _nc_viscbuf2 and _tracecchar_t2 to trace wide-characters as + a whole rather than their multibyte equivalents. + * minor fix in wadd_wchnstr to ensure that each cell has nonzero + width. + * move PUTC_INIT calls next to wcrtomb calls, to avoid carry-over of + error status when processing Unicode values which are not mapped. + * add missing assignment in lib_getch.c to make notimeout work Program improvements - Utilities - - Most of the termcap-related changes based on development of [34]tctest - (termcap library checker) are implemented in the tic and infocmp - programs rather than affecting the library. As noted in the - [35]discussion of tctest, ncurses's ability to translate between - terminfo and termcap formats has been improved at different times, but - subject to feedback from "real" termcap users. There are very few of - those. Nowadays, virtually all termcap users are using ncurses (or - NetBSD, with its own terminfo library) and their programs are actually - using terminfo rather than termcap data. - - Still, there are a few. A comment about the translation of the ASCII - NUL character prompted a review: - * Both terminfo and termcap store string capabilities as - NUL-terminated strings. - * In terminfo, a \0 in a terminal description is stored as \200. - * There are no (known) terminals which would behave differently when - sent \0 or \200. - * When translating to terminfo format (or displaying a printable - version of an entry using infocmp), ncurses shows \200 as \0. - * It has done this since 1998 (quoting from the NEWS file): - -[36]980103 -... - + modify _nc_tic_expand() to generate \0 rather than \200. -... - + correct translation of terminfo "^@", to \200, like \0. - - * However, the _nc_tic_expand function (which optionally produces - terminfo or termcap format) did not address this special case for - termcap. Even the later 4.4BSD [37]cgetstr interprets a \0 - literally, ending that string (rather than using the terminfo - improvement). - - As a result of the review, several improvements were made to ncurses - translation to/from termcap format -- and improving the checks made in - tic for consistency of entries. Most of these are not of general - interest, except for two new command-line options for tic and infocmp: - * the "-0" option generates termcap/terminfo source on a single - line. - * the "-K" option provides stricter BSD-compatibility for termcap - output. + While reviewing user feedback, it became apparent that the differences + between [20]reset (an alias for tset) and "tput reset" were confusing: + * one ([21]tset) updated the terminal modes, but used only part of + the terminfo capabilities for initialization, while + * the other ([22]tput) used all of the terminal capabilities while + neglecting the terminal modes. + + On further investigation, it turned out that the differences were + largely an accident due to the way those programs had evolved. + + This release eliminates the unnecessary differences, using the same + approach for tput's init (initialization), reset and clear operations + as the separate [23]reset and [24]clear programs. Doing this does not + change the command-line options; existing scripts are unaffected. + + These are the user-visible changes for the three programs (tput, tset + and clear): + * add the terminal-mode parts of "reset" (aka tset) to the "tput + reset" command, making the two almost the same except for + window-size. + * improve tput's check for being called as "init" or "reset" to + allow for transformed names. + * add "clear" as a possible link/alias to tput. + * amend changes for tput to reset tty modes to "sane" if the program + is run as "reset", like tset. Likewise, ensure that tset sends + either reset- or init-strings. + * add -x option to clear/tput to make the E3 extension optional + * add functionality of "tset -w" to tput, like the "-c" feature this + is not optional in tput. + * add options -T and -V to clear command for compatibility with + tput. + * drop long-obsolete "-n" option from tset. + * modify tset's assignment to TERM in its output to reflect the name + by which the terminal description is found, rather than the + primary name. That was an unnecessary part from the initial + conversion of tset from termcap to terminfo. The termcap library + in 4.3BSD did this to avoid using the short 2-character name + * remove a restriction in tput's support for termcap names which + omitted capabilities normally not shown in termcap translations + * add usage message to clear command + * improve usage messages for tset and tput. Other user-visible improvements and new features include: - * added "-D" option to tic and infocmp, to show the database - locations that it could use. - * added "-s" option to toe, to sort its output. - * extended "-c" and "-n" options of infocmp to allow comparing more - than two entries. - * modified toe's report when "-a" and "-s" options are combined, to - add a column showing which entries belong to a given database. - * modified the clear program to take into account the "E3" extended - capability to clear the terminal's scrollback buffer. + * modify tic/infocmp display of numeric values to use hexadecimal + when they are "close" to a power of two, making the result more + readable. + * add "-W" option to tic/infocmp to force long strings to wrap. + + This is in addition to the "-w" option which attempts to fit + capabilities into a given line-length. + + If "-f" option splits line, do not further split it with + "-W". + + Begin a new line when adding "use=" after a wrapped line. + * add "-q" option to infocmp to suppress the "Reconstructed from" + comment from the header, and a corresponding option to tic to + suppress all comments from the "tic -I" output. + * Sorted options in usage message for infocmp, to make it simpler to + see unused letters. + * Updated usage message for tic, adding "-0" option. + * add infocmp/tic "-Q" option, which allows one to dump the compiled + form of the terminal entry, in hexadecimal or base64: + + A "b64:" prefix in the TERMINFO variable tells the terminfo + reader to use base64 according to RFC-3548 as well as + RFC-4648 url/filename-safe format. + + A "hex:" prefix tells the terminfo reader to accept + hexadecimal data as generated by "infocmp -0qQ1". + + Other less-visible improvements and new features include: + * modify utility headers such as tic.h to make it clearer which are + externals that are used by tack. + * add "reset" to list of programs whose names might change in + manpages due to program-transformation configure options. + * modify "-T" option of clear and tput to call use_tioctl to obtain + the operating system's notion of the screensize if possible. + * add check in tput for init/reset operands to ensure those use a + terminal. + * modify programs clear, tabs, tput and tset to pass the actual tty + file descriptor to setupterm rather than the standard output or + error, making padding work. + * change tset's initialization to allow it to get settings from the + standard input as well as /dev/tty, to be more effective when + output or error are redirected. + * amend check in tput, tabs and clear to allow those to use the + database-only features in cron if a "-T" option gives a suitable + terminal name. + * improve error message from tset/reset when both stderr/stdout are + redirected to a file or pipe. + + Several of the less apparent features deal with translation of + terminfo to termcap (and the reverse), with corresponding checks by + tic: + * modify check in fmt_entry to handle a cancelled reset string. Make + similar fixes in other parts of dump_entry.c and tput.c + * correct read of terminfo entry in which all strings are absent or + explicitly cancelled. Before this fix, the result was that all + were treated as only absent. + * modify infocmp to suppress mixture of absent/cancelled + capabilities that would only show as "NULL, NULL", unless the "-q" + option is used, e.g., to show "-, @" or "@, -". + * correct a warning from tic about keys which are the same, to skip + over missing/cancelled values. + * add check in tic for use of bold, etc., video attributes in the + color capabilities, accounting whether the feature is listed in + ncv. + * add check in tic for unnecessary use of "2" to denote a shifted + special key. + * improve check in tic for delays by also warning about beep/flash + when a delay is not embedded, or if those use the VT100 reverse + video escape without using a delay. + * improve checks in trim_sgr0, comp_parse.c and parse_entry.c, for + cancelled string capabilities. + * add check in tic for some syntax errors of delays, as well as use + of proportional delays for non-line capabilities. + * add check in tic for conflict between ritm, rmso, rmul versus + sgr0. + * add check in _nc_parse_entry for invalid entry name, setting the + name to "invalid" to avoid problems storing entries. + * improve _nc_tparm_analyze, using that to extend the checks made by + tic for reporting inconsistencies between the expected number of + parameters for a capability and the actual. + * remove tic warning about "^?" in string capabilities, which was + marked as an extension; however all Unix implementations support + this and X/Open Curses does not address it. On the other hand, + [25]BSD termcap did not support this feature (until the + [26]mid-1990s). + in _nc_infotocap, added a check to ensure that terminfo "^?" is + not written to termcap. + * modify sscanf calls in _nc_infotocap for patterns "%{number}%+%c" + and "%'char'%+%c" to check that the final character is really "c", + avoiding a case in icl6404 which cannot be converted to termcap. + * in _nc_tic_expand and _nc_infotocap, improved string-length check + when deciding whether to use "^X" or "\xxx" format for control + characters, to make the output of tic/infocmp more predictable. + * limited termcap "%d" width to 2 digits on input, and use "%2" in + preference to "%02" on output. + * correct terminfo/termcap conversion of "%02" and "%03" into "%2" + and "%3"; the result repeated the last character. Examples Along with the library and utilities, many improvements were made to - the [38]ncurses-examples. Some were made to allow building (and - comparison-testing) against NetBSD curses and PDCurses. Both lack some - of the X/Open Curses features, necessitating customization. But this - activity was useful because it showed some remaining performance - issues (which have been resolved in this release). - - These changes were made to verify compatibility or compare performance - of ncurses: - * made workarounds for compiling test-programs with NetBSD curses, - though it lacks some common functions such as [39]use_env. - * added dots_termcap test-program - * added dots_curses test-program, for comparison with the low-level - examples. - * added test_setupterm test-proram to demonstrate normal/error - returns from the setupterm and restartterm functions. - * added "-d", "-e" and "-q" options to the demo_terminfo and - demo_termcap test-programs. - * added "-y" option to demo_termcap and test/demo_terminfo - test-programs to demonstrate behavior with/without extended - capabilities. - * modified demo_termcap and demo_terminfo test-programs to make - their options more directly comparable, and add "-i" option to - specify a terminal description filename to parse for names to - lookup. - * rewrote the tests for [40]mvderwin and test for recursive - [41]mvwin in the movewindow test-program. - - These changes were made to help with the MinGW port: - * added test-screens to the ncurses test-program to show - 256-characters at a time, to help with MinGW port. - * modified the view test-program to load UTF-8 when built with MinGW - by using regular win32 API because the MinGW functions mblen and - mbtowc do not work. - * added "-s" option to the view test-program to allow it to start in - single-step mode, reducing size of trace files when it is used for - debugging MinGW changes. - - These changes were made to verify new extensions in ncurses: - * added [42]form_driver_w entrypoint to wide-character forms - library, as well as form_driver_w test-program. - * modified ncurses test-program's b/B tests to display lines only - for the attributes which a given terminal supports, to make room - for an italics test. - * modified ncurses test-program, adding "-E" and "-T" options to - demonstrate use_env versus use_tioctl. - * modified ncurses test-program's c/C tests to cycle through subsets - of the total number of colors, to better illustrate - 8/16/88/256-colors by providing directly comparable screens. - * modified the ncurses test-program to also show position reports in - 'a' test. - - These changes were made to make the examples more useful: - * added scripts for building dpkg and rpm test-packages - * modified the hanoi test-program to show the minimum number of - moves possible for the given number of tiles. - * modified the knight test-program to show the number of choices - possible for each position in automove option, e.g., to allow user - to follow Warnsdorff's rule to solve the puzzle. + the [27]ncurses-examples. + + These changes were made to demonstrate new extensions in ncurses: + * add demo_new_pair program, to demonstrate [28]alloc_pair, + [29]find_pair and [30]free_pair functions. + This program iterates over the possible color combinations, + allocating or initializing color pairs. For best results, choose + screen-width dividing evenly into the number of colors. e.g., + + 32x64,32x128 256 colors + 24x44,24x88 88 colors + 32x64,24x128 16 colors + + * add extended_color program, like the older color_set program, but + using the extended color functions, with and without the + SP-functions interface. + * add picsmap program to fill in some testing issues not met by + dots, using this as the third example in a comparison of the + [31]ncurses versus slang libraries. + The program can directly read X bitmap and pixmap files, + displaying a picture. It can read other image files using + ImageMagick's convert program to translate the image into text. + For 16-, 88- and 256-color terminal descriptions, picsmap can load + a palette file which tells it which color palette entries to use. + For direct-colors, the terminal descriptions use the RGB extension + capability. - Terminal database + There are other new example programs and a few scripts: + * add dots_xcurses program to illustrate a different approach used + for extended colors which can be contrasted with dots_curses. + * add list_keys program show function keys for one or more terminal + descriptions. It uses ncurses's convention of modifiers for + special keys, based on xterm. + * add padview program, to compare pads with direct updates in the + view program. + * add sp_tinfo program to exercise the SP-functions extension of the + low-level terminfo library. + * add test-programs for termattrs and term_attrs functions. + * add test_sgr program to exercise all combinations of the sgr + capability. + * add tput-colorcube demo script, imitating xterm's 88- and + 256-color scripts using tput. + * add tput-initc script to demonstrate how tput may be used to + initialize a color palette from a data file. + + A variety of improvements were made to existing programs, both new + features as well as options added to make the set of programs more + consistent. + + The ncurses program is the largest; a proportionately large number of + changes were made to it: + * modify a/A screens to make exiting on an escape character depend + on the start of keypad and timeout modes, to allow better testing + of function-keys. + add "t" toggle for notimeout function. + * modify layout of b/B screens to allow for additional annotation on + the right margin; some terminals with partial support did not + display well. + * modify c/C screens to allow for extended color pairs. + add z/Z zoom feature to make extended color pairs easier to test. + modify test-screens to take advantage of wide screens, reducing + the number of lines used for 88- and 256-colors. + * modify "d" edit-color screen to optionally read xterm color + palette directly from terminal, as well as handling KEY_RESIZE and + screen-repainting with control/L and control/R. + * add examples to "F" screen for WACS_D_PLUS and WACS_T_PLUS. + * improve "g" screen, correcting ifdef which made the legend not + reflect changes to keypad- and scroll-modes. Added check for + return-value of putwin. + * make "s" test easier to understand which subtests are available + add a corresponding "S" wide-character overlap test-screen. + * add "v" screen to show baudrate and other values. + + These changes were made to the other examples: + * modify blue program to use Unicode values for card-glyphs when + available, as well as improving the check for CP437 and CP850. + * improve demo_menus program, allowing mouse-click on the + menu-headers to switch the active menu. This requires a new + extension option O_MOUSE_MENU to tell the menu driver to put mouse + events which do not apply to the active menu back into the queue + so that the application can handle the event. + * correct logic in demo_terminfo program for "-f" option + * modify ditto program to allow $XTERM_PROG environment variable to + override "xterm" as the name of the program to run in the threaded + configuration. + * add several options to the "dots" test-programs. + * modify filter program: + + illustrate an alternative to getnstr, that polls for input + while updating a clock on the right margin as well as + responding to window size-changes. + + adapt logic used in [32]dialog [33]"--keep-tite" option for + filter program as the "-a" option. When set, filter attempts + to suppress the alternate screen. + * modify knight program to provide the "slow" solution for small + screens using "R", noting that Warnsdorf's method is easily done + with "a". + * modify the savescreen program to add test patterns that exercise + 88-, 256-, etc., colors. + * add options to test_arrays, for selecting termcap vs terminfo, + etc. + * modify the view program: + + expand tabs using the ncurses library rather than in the + test-program. + + eliminate the "-n" option by simply reading the whole file. + + implement page up/down commands. + + remove the very old SIGWINCH example; just use KEY_RESIZE. + * improve animation in xmas program by adding a time-delay in + blinkit. + * modify several test-programs which call use_default_colors to + consistently do this only if the "-d" option is given. + * modify the install-rule for ncurses-examples to put the data files + in the data directory, e.g., /usr/share/ncurses-examples. + * modify several test programs to use new popup_msgs function, + adapted from the help-screen used in the edit_field program. + * modify test data for xterm palettes to use the newer + color4/color12 values. + * improve the tracemunch script: + + show screenXX pointers and thread identifiers as names. + + chang address-parameters of add_wch, color_content and + pair_content to dummy parameters. - This release provides improvements to tic's "-c" checking option, - which was used for example to - * make sgr in several entries agree with other caps. - * correct padding in some entries where earlier versions had - miscounted the number of octal digits. + Terminal database There are several new terminal descriptions: - * [43]mlterm is now aliased to mlterm3 - * [44]nsterm is now derived from nsterm-256color - * [45]putty-sco - * [46]teken is FreeBSD's "xterm" console. - * [47]terminator - * [48]terminology - * [49]tmux is derived from screen. - * several screen.XXX entries support the respective variations for - 256 colors. - * [50]simpleterm is now 0.5 - * [51]vte is aliased to vte-2012 - * [52]vt520ansi + + dumb-emacs-ansi, dvtm, dvtm-256color, fbterm, iterm2, linux-m1 + minitel entries, putty-noapp, viewdata, and vt100+4bsd + building-block. + + xterm+noalt, xterm+titlestack, xterm+alt1049, xterm+alt+title + building blocks and xterm+direct, xterm+indirect, xterm-direct. + from [34]xterm patch #331. + + several other "-direct" descriptions to address the differences of + other terminal emulators versus xterm-direct. + + There are many changes to existing terminal descriptions. Some were + updates to several descriptions: + * use xterm+sm+1006 in several terminal descriptions which were + validated as supporting the extended mouse feature for their + respective terminal emulators. + * corrected sgr/sgr0 strings in a few cases reported by tic, making + those correspond to the non-sgr settings where they differ, but + otherwise use ECMA-48 consistently. + * add 0.1sec mandatory delay to flash capabilities using the VT100 + reverse-video control + + while others affected specific descriptions. These were retested, to + take into account new/undocumented changes by their developers: + + iterm, minitel, st, viewdata, nsterm + + while these are specific fixes based on user reports, or warnings from + tic: + + [35]ansi building blocks + + + restored rmir/smir in ansi+idc to better match original + ansiterm+idc, add alias ansiterm + + [36]icl6402 + + + corrected missing comma-separator between string capabilities + in icl6402 and m2-nam + + [37]interix + + + updated using tack and SFU with Windows 7 Ultimate. + + used ^? for kdch1 + + [38]linux + + + made linux3.0 entry the default linux entry + + modify linux2.6 entry to improve line-drawing so that the + linux3.0 entry can be used in non-UTF-8 mode + + omitted selection of ISO-8859-1 for G0 in enacs capability + from linux2.6 entry, to avoid conflict with the user-defined + mapping. The reset feature uses ISO-8859-1 in any case. + + modify flash capability for linux and wyse entries to put the + delay between the reverse/normal escapes rather than after + + modify linux-16color to not mask dim, standout or reverse + with the ncv capability + + [39]pccon entries + + + fixed some inconsistencies in the pccon* entries + + add bold to pccon+sgr+acs and pccon-base + + add keys f12-f124 to pccon+keys + + [40]tmux + + + corrected sgr string, which used screen's "standout" code + rather than the standard code. + + add settings corresponding to xterm-keys option to reflect + upcoming change to make that option "on" by default + + uncanceled Ms + + [41]vt100 + + + modify vt100 rs2 string to reset vt52 mode and scrolling + regions + + corrected rs2 string for vt100-nam + + made minor fixes for vt100+4bsd, e.g., delay in sgr for + consistency + + [42]vte + + + moved SGR 24 and 27 from vte-2014 to vte-2012 + + add a few capabilities fixed in recent VTE development + + [43]xterm + + + add rep to xterm-new, available since [44]late 1996. + + modify xterm+256color and xterm+256setaf to use correct + number of color pairs. + + modify rs1 for xterm-16color, xterm-88color and + xterm-256color to reset palette using oc string as in linux + entry. + + add rs1 capability to xterm-256color + + add oc capability to xterm+256color, allowing palette reset + for xterm + + add op to xterm+256setaf + + modify xterm-r5, xterm-r6 and xterm-xf86-v32 to use xterm+kbs + to match [45]xterm #272, reflecting packager's changes + + used ANSI reply for u8 in xterm-new, to reflect vt220-style + responses that could be returned. + + made xterm-pcolor sgr consistent with other capabilities A few entries use extensions (user-defined terminal capabilities): - * E3, used in linux, putty and xterm-basic is tested in the - [53]clear program to erase a terminal's scrollback. - * TS is used in the [54]xterm+sl building block to help deprecate - the misuse of tsl for xterm's title-string. - * XT is used in some terminfo entries to improve usefulness for - other applications than screen, which would like to pretend that - xterm's title is a status-line. - * xm is used in examples [55]xterm-1005 and [56]xterm-1006 to - illustrate a way to make mouse handling more general - - A few terminals support italics and/or dim capabilities. In - particular, screen does not. Documented that, and accommodated the - terminals where this feature works with the A_ITALIC extension. - * konsole, mlterm3 (italics) - * nsterm (dim) - * screen (dim) - * vte (dim, italics) - * xterm (dim, italics) + * add rmxx/smxx ECMA-48 strikeout extension to tmux and xterm-basic + * used RGB capability in new *-direct entries to denote direct-color + feature. Documentation @@ -468,325 +639,273 @@ fflush(stdout); * attempts to improve the description of features which users have found confusing * fills in overlooked descriptions of features which were described - in the [57]NEWS file but treated sketchily in manual pages. - - In addition, the mechanism for producing HTML versions of the - documentation has been improved: - * use an improved version of [58]man2html to generate html manpages. - * regenerated [59]NCURSES-Programming-HOWTO.html to fix some of the - broken html emitted by docbook. + in the [46]NEWS file but treated sketchily in manual pages. + + In particular, + * Since the underlying features for [47]tset, [48]tput, and + [49]clear have been better integrated, the documentation now + includes information on how those tools evolved. + In addition to explaining the improved integration of the tools, + the manual pages made it easier to see how the tools are similar + and how they are different. + * The addch manual page has additional information on + [50]portability and differences from other implementations. + * The discussion of color-pairs in the attributes manual page is + improved in its [51]history section. + * The documentation of the chtype, cchar_t types and the attribute + values which can be stored in those types, in particular the + [52]history and [53]portability sections of the attributes manual + page, has been improved. + * improve discussion of [54]portability in the mouse manual. + * The pad manual page has a section on the [55]origin and + portability of pads. + * Differences between SVr4 and X/Open Curses soft-keys are discussed + in a new section on [56]portability. + * There are updated/improved notes on portability in the + [57]resizeterm and [58]wresize manual pages. + + In addition to providing background information to explain these + features and show how they evolved, there are corrections, + clarifications, etc.: + * add note in the [59]addch manual about line-drawing when it + depends upon UTF-8. + * improve discussion of line-drawing characters in the [60]add_wch + manual. + * explain in [61]clear's manual page that it writes to the standard + output. + * improve description of [62]endwin. + * improve discussion of field validation in the [63]form driver + manual page. + * clarify the use of wint_t vs wchar_t in [64]get_wstr manual page. + * clarify in the [65]getch manual that the keypad mode affects an + application's ability to read KEY_MOUSE codes, but does not affect + KEY_RESIZE. + trim some obsolete/incorrect wording about EINTR from the getch + manual page + improve manual pages for [66]getch and [67]get_wch to point out + that they might return user-defined values which have no + predefined names in + * improve description of the -R option in the [68]infocmp manual + page + * clarify in the [69]resizeterm manual page how KEY_RESIZE is pushed + onto the input stream. + * document return value of [70]use_extended_names + * document differences in [71]ESCDELAY versus AIX's implementation + in the variables manual page. + * The _nc_free_tinfo function is now documented in the + [72]memory-leaks manual page, because it could be used in tack for + memory-leak checking. + * add a note to the [73]tic manual page about -W versus -f options. + * improve terminfo manual description of [74]terminfo syntax. + improve terminfo manual page discussion of [75]control- and + graphics- characters. + improve [76]color-handling section in terminfo manual page + * clarify description in [77]tput manual page regarding support for + termcap names + update [78]tput manual page to reflect changes to manipulate + terminal modes by sharing functions with tset. + * clarify in manual pages that the optional verbose option level of + [79]tic and [80]infocmp is available only when ncurses is + configured for tracing. + * improve manual page description of [81]tset/reset versus + window-size. + * improve description of [82]tgoto parameters + + There are new manual pages: + * [83]user_caps documents the terminfo extensions used by ncurses. + * [84]scr_dump documents the screen-dump format. + + Some of the improvements are more subtle, relating to the way the + information is presented: + * Made minor fixes to manpage NAME/SYNOPSIS sections to consistently + use rule that either all functions which are prototyped in + SYNOPSIS are listed in the NAME section, or the manual-page name + is the sole item listed in the NAME section. The latter is used to + reduce clutter, e.g., for the top-level library manual pages as + well as for certain feature-pages such as [85]SP-funcs and + [86]threading. + * improve manual pages for utilities with respect to POSIX versus + X/Open Curses. + * improve organization of the [87]attributes and [88]color manual + pages. Interesting bug-fixes - * Ada95 binding: - + modify makefile rules to ensure that the PIC option is not - used when building a static library - + make Ada95 build-fix for big-endian architectures such as - sparc. This undoes one of the fixes from [60]20110319, which - added an "Unused" member to representation clauses, replacing - that with pragmas to suppress warnings about unused bits. - * Color and attributes: - + parenthesize parameter of COLOR_PAIR and PAIR_NUMBER in - curses.h in case it happens to be a comma-expression. - + improve [61]20021221 workaround for broken acs, handling a - case where that ACS_xxx character is not in the acsc string - but there is a known wide-character which can be used. - + modify [62]init_pair to accept -1's for color value after - [63]assume_default_colors has been called. - + add a check in [64]start_color to limit color-pairs to 256 - when extended colors are not supported. - * Resizing the screen: - + propagate error-returns from wresize, i.e., the internal - increase_size and decrease_size functions through - [65]resize_term. - + add check for zero/negative dimensions for resizeterm and - resize_term. - + modify resizeterm to always push a KEY_RESIZE onto the fifo, - even if screensize is unchanged. Modify library to push a - KEY_RESIZE if there was a SIGWINCH, even if it does not call - resizeterm). These changes eliminate the case where a - SIGWINCH is received, but ERR is returned from wgetch or - wgetnstr because the screen dimensions did not change. - * Low-level interfaces - + fix an old bug in the termcap emulation; "%i" was ignored in - tparm because the parameters to be incremented were already - on the internal stack. - + change "%l" behavior in tparm to push the string length onto - the stack rather than saving the formatted length into the - output buffer. - + modify name-comparison for tgetstr, etc., to accommodate - legacy applications as well as to improve compatbility with - BSD 4.2 termcap implementations (see note for [66]980725). - * High-level interfaces - + modify internal recursion in wgetch which handles cooked mode - to check if the call to wgetnstr returned an error. This can - happen when both nocbreak and nodelay are set, for instance - (see note for [67]960418). - + add a check in internal function waddch_nosync to ensure that - tab characters are treated as control characters; some broken - locales claim they are printable. - + modify menu library to ensure that a menu's top-row is - adjusted as needed to ensure that the current item is on the - screen - + fix special case where double-width character overwrites a - single- width character in the first column. + * modify toe to not exit if unable to read a terminal description, + e.g., if there is a permission problem. + * correct 20100515 change for weak signals versus sigprocmask + * work around Ada tool-breakage in Debian 9 and later by invoking + gprconfig to specify the C compiler to be used by gnatmake, and + conditionally suppressing Library_Options line for static + libraries. + * There were, as well, several bug-fixes to handle illegal input for + tic. Because those did not correspond to useful terminal + descriptions, most users are unaffected. Configuration changes Major changes - The ncurses 6.0 configure script makes changes to the default value of - several configure options, depending on the --with-abi-version option - (i.e., whether its value is "5" or "6"): - - --enable-const - Feature introduced in [68]970405 supports the use of const - where X/Open Curses should have, but did not. NetBSD curses - does something similar with const. - - --enable-ext-colors - Extends the cchar_t structure to allow more than 16 colors to - be encoded. This applies only to the wide-character - (--enable-widec) configuration. - - --enable-ext-mouse - Modifies the encoding of mouse state to make room for a 5th - mouse button. That allows one to use ncurses with a wheel mouse - with xterm or similar X terminal emulators. - - --enable-ext-putwin - Modifies the file-format written by putwin to use printable - text rather than binary files, allowing getwin to read screen - dumps written by differently-configured ncurses libraries. The - extended getwin can still read binary screen dumps from the - same configuration of ncurses. This does not change the ABI - (the binary interface seen by calling applications). - - --enable-interop - Modifies the FIELDTYPE structure used for the form library to - make it more generic. - - --enable-lp64 - Allows an application to define _LP64 to declare chtype and - mmask_t as simply "unsigned" rather than the configured types - using the --with-chtype and --with-mmask_t options. - - --enable-sp-funcs - Compile-in support for extended functions which accept a SCREEN - pointer, reducing the need for juggling the global SP value - with [69]set_term and [70]delscreen. - - --with-chtype=uint32_t - Makes chtype explicitly a 32-bit unsigned value. - - --with-mmask_t=uint32_t - Makes mmask_t explicitly a 32-bit unsigned value. - - --with-tparm-arg=intptr_t - X/Open Curses declares [71]tparm using long for each of the - parameters aside from the formatting string, presuming that - long and char* are the same size. This configure option uses - intptr_t which provides a better guarantee of the sizes. - - The configure script no longer checks for antique compilers; c89 is - assumed as a minimum. There are a few features from later revisions - which are used when available. The configure script makes checks to - turn on useful warnings from clang, gcc and icc. You should be able to - build ncurses 6.0 with any of the current (or not so current) C - compilers available in 2015. - - The configure script, by the way, makes changes which do not work with - systems whose /bin/sh is non-POSIX. This mainly affects Solaris (the - other vendor unix systems have followed the POSIX guidelines for the - past twenty years). If you must build on Solaris, its [72]xpg4 - binaries suffice, e.g., - - #!/bin/sh - WHAT=`hostname|sed -e 's/\..*//'` - OUT=configure.out - cat >>$OUT <&1 | tee -a $OUT - - Other major changes to the configure script include: - * ABI 6 is now the default, intending that the existing ABI 5 should - build as before using the "--with-abi-version=5" option. - * added --with-extra-suffix option to help with installing - nonconflicting ncurses6 packages, e.g., avoiding header- and - library-conflicts. - NOTE: as a side-effect, this renames - - adacurses-config to adacurses5-config and - adacursesw-config to adacursesw5-config - * the configure script looks for gnatgcc if the Ada95 binding is - built, in preference to the default gcc/cc. The script also - ensures that the Ada95 binding is built with the level of - optimization as the C libraries. - * the configure script captures define's related to -D_XOPEN_SOURCE - from the configure check and adds those to the *-config and *.pc - files, to simplify use for the wide-character libraries. + This release provides a new binary format for terminal descriptions + that use extended numeric capabilities. Applications built with the + wide-character ncursesw library can use these extended numbers. + * This includes utilities such as tic and infocmp, because (as noted + in [89]New features), the feature relies upon an extension to the + low-level tinfo library. + * A few software packagers use a configuration option of ncurses + which allows the low-level tinfo library to be shared between the + high-level ncurses and ncursesw libraries. This new feature was + designed to work in that configuration as well. + + Other applications (i.e., using the 8-bit ncurses library) which read + the extended terminal descriptions see those numeric capabilities set + to the maximum value for a signed 16-bit number. + + Older versions of ncurses' tic accept out-of-range numeric + capabilities, storing those as the maximum value for a signed 16-bit + number. Other implementations of curses (mentioned in the discussion + of [90]picsmap) give zero for these out-of-range capabilities. Configuration options - There are several new (or extended) configure options: - - --disable-db-install - Do not install the terminal database. This is used to omit - features for packages, as done with --without-progs. The option - simplifies building cross-compile support packages. - - --disable-gnat-projects - This option is used for regression testing - - --disable-lib-suffixes - Suppress the "w", "t" or "tw" suffixes which normally would be - added to the library names for the --enable-widec and - --with-pthread options. - - --with-cxx-shared - When --with-shared is set, build libncurses++ as a shared - library. This implicitly relies upon building with gcc/g++, - since other compiler suites may have differences in the way - shared libraries are built. libtool by the way has similar - limitations. - - --with-hashed-db - Extended this configure option to simplify building with - different versions of Berkeley database using FreeBSD ports. - - --with-pc-suffix - If ".pc" files are installed, optionally add a suffix to the - files and corresponding package names to separate unusual - configurations. If no option value is given (or if it is - "none"), no suffix is added. This option is used in the test - package for ncurses6. - - --with-xterm-kbs - Configure xterm's terminfo entries to use either BS (^H, i.e., - ASCII backspace) or DEL (^?, or 127). + These changes provide support for tack 1.08, released in [91]July + 2017: + * add --without-tack configure option to refine --with-progs + configure option. Normally tack is built outside the ncurses tree, + but a few packagers combine it during the build. If term_entry.h + is installed, there is no advantage to in-tree builds. + * adjust configure-script to define HAVE_CURSES_DATA_BOOLNAMES + symbol needed for tack 1.08 when built in-tree. Rather than + relying upon internal "_nc_" functions, tack now uses the boolean, + number and string capability name-arrays provided by ncurses and + SVr4 Unix curses. It still uses term_entry.h for the definitions + of the extended capability arrays. + * add dependency upon ncurses_cfg.h to tic's header-files; any + program using tic-library will have to supply this file. Legacy + tack versions supply this file; ongoing tack development has + dropped the dependency upon tic-library and new releases will not + be affected. + + Other changes to the configure-script and generated files include + * add configure options to disable checks for form, menu and panel + libraries so that ncurses-examples can be built with non-SVr4 + curses implementations. + * add configure option --enable-opaque-curses for ncurses library + and similar options for the other libraries. + * add configure option --disable-wattr-macros for use in cases where + one wants to use the same headers for ncurses5/ncurses6 + development, by suppressing the wattr* macros which differ due to + the introduction of extended colors + * modify configure macro for shared-library rules to use -Wl,-rpath + rather than -rpath to work around a bug in scons + * improve ncurses-examples' configure script to define as needed + NCURSES_WIDECHAR for platforms where _XOPEN_SOURCE_EXTENDED does + not work. Also modified the test program to ensure that if + building with ncurses, that the cchar_t type is checked, since + that is normally (since [92]20111030) ifdef'd depending on this + test. + * modify configure script to handle the case where tic-library is + renamed, but the --with-debug option is used by itself without + normal or shared libraries + * modify editing script which generates resulting.map to work with + the clang configuration on recent FreeBSD, which gives an error on + an empty "local" section. + * improve configure check for setting the WILDCARD_SYMS variable; on + ppc64 the variable is in the Data section rather than Text. + * correct result of configure option --without-fallbacks, which + caused FALLBACK_LIST to be set to "no" + * modify --with-pkg-config-libdir option to make it possible to + install ".pc" files even if pkg-config is not found. Limit this + change, to suppress the actual install if it is not overridden to + a valid directory at install time. + * disallow "no" as a possible value for --with-shlib-version option, + overlooked in cleanup-changes for [93]20000708. Portability - MinGW - - Most of the portability-related work since [73]ncurses 5.9 extended - and improved the MinGW port introduced in [74]ncurses 5.8. - - The MinGW port can be readily cross-compiled: - * modified configure script to allow creating dll's for MinGW when - cross-compiling. - * enforced Windows-style path-separator if cross-compiling, - * added scripts for test-builds of cross-compiled packages for - ncurses6 to MinGW. - * added pc-files to the MinGW cross-compiling test-packages. - * added script for building test-packages of binaries cross-compiled - to MinGW using NSIS. - * added nc_mingw.h to installed headers for MinGW port; this is - needed for cross-compiling [75]ncurses-examples. - * added test-packages for cross-compiling ncurses-examples using the - MinGW test-packages. - - The MinGW-specific Windows driver accounts for several changes: - * wide-character display is made usable by replacing MinGW's - non-working wcrtomb and wctomb functions. - * implemented some display features: [76]beep, [77]flash, - [78]curs_set. - * the driver handles repainting on endwin/refresh combination. - * modified treatment of TERM variable for MinGW port to allow - explicit use of the Windows console driver by checking if $TERM is - set to "#win32console" or an abbreviation of that. - * the Windows driver also matches the special TERM value "unknown" - * the driver now returns characters for special keys, (like ansi.sys - does), when keypad mode is off, rather than returning nothing at - all. - * the driver checks a new environment variable [79]NCURSES_CONSOLE2 - to optionally work around a deficiency in Console2 (and its - descendent ConsoleZ) which hang when an application creates a - console buffer. - - Finally, there are other improvements: - * MinGW is one of the configurations where ncurses installs by - default into /usr - * configuration for cross-compiling uses AC_CHECK_TOOLS in - preference to AC_PATH_PROGS when searching for ncurses*-config, - e.g., in Ada95/configure and test/configure. - * extend Windows support to work with MSYS2; - + this works with a scenario where there is an ANSI-escape - handler such as ansicon running in the console window. - + wrap isatty calls with a macro, provide a corresponding set - of support routines to address differences between MinGW and - MSYS2. - * ensure WINVER is defined in makefiles rather than using headers. - * add check for the gnatprep "-T" option. - * work around a bug introduced by [80]gcc 4.8.1 in MinGW which - breaks "trace" feature. - * add a driver-name method to each of the drivers. - - Other ports - - These changes affect certain platforms (ports): - * the configure script knows how to build shared libraries with - DragonFlyBSD and Interix. - * support for AIX shared libraries is improved, tested with AIX 5.3, - 6.1 and 7.1 with both gcc 4.2.4 and cc: - + the shared-library suffix for AIX 5 and 6 is now ".so" - + the -brtl option is used with AIX 5-7; it is needed to link - with the shared libraries. - * the configure --enable-pc-files option takes into account the - [81]PKG_CONFIG_PATH variable. - * the configure option --with-pkg-config-libdir provides control - over the actual directory into which pc-files are installed. - * the build scripts add explicit -ltinfo, etc., to the generated - ".pc" file when ld option "--as-needed" is used, or when ncurses - and tinfo are installed without using rpath. - * the configure script disallows conflicting options - "--with-termlib" and "--enable-term-driver". - * the check for missing c++ compiler to work when no error is - reported, and no variables set is improved (see note for - [82]20021206). - * the misc/gen_edit.sh script selects a "linux" entry which works - with the current kernel rather than assuming it is always - "linux3.0" - * the test/configure script makes it simpler to override names of - curses-related libraries, to help with linking with pdcurses in - MinGW environment. - * the configure-script/ifdef's allow the BSD OLD_TTY feature to be - suppressed if the type of ospeed is configured using the option - --with-ospeed to not be a short. By default, it is a short for - termcap-compatibility. - * the MKlib_gen.sh script works around a recent change in gcc 5 - (released [83]mid-2015) which essentially emits multiple #line - statements for the same position in a file. - * the configure script works with Minix3.2 (see [84]note on - portability) - * OS/2 redux: - + the configure script supports OS/2 kLIBC. - + the --with-lib-prefix option allows configuring for old/new - flavors of OS/2 EMX. - * improved configure-script checks for _XOPEN_SOURCE: - + the definition works starting with Solaris 10. - + the definition is suppressed for IRIX64, since its header - files have a conflict versus _SGI_SOURCE. + Many of the portability changes are implemented via the configure + script: + * improve configure script's CF_CC_ENV_FLAGS macro to allow for + compiler wrappers such as ccache. This change moves only the + preprocessor, optimization and warning flags to CPPFLAGS and + CFLAGS, leaving the residue in CC. That happens to work for gcc's + various "model" options, but may require tuning for other + compilers. + * modify ncurses-examples' configure script to use pkg-config for + the extra form/menu/panel libraries, to be more consistent with + the handling of the curses/ncurses library. + * add configuration checks to build with [94]NetBSD curses, which + for example lacks [95]use_env. + * change ncurses-examples to use attr_t vs chtype to follow X/Open + documentation more closely since Solaris xpg4-curses uses + different values for WA_xxx vs A_xxx that rely on attr_t being an + unsigned short. Tru64 aka OSF1, HPUX, AIX did as ncurses does, + equating the two sets. + * modify several test programs to reflect that ncurses honors + existing signal handlers in initscr, while other implementations + do not. + * add configure check for openpty to ncurses-examples' configure + script, for ditto. + * improve check for working poll function by using posix_openpt as a + fallback in case there is no valid terminal on the standard input + * modify ncurses-examples' configure script to check for pthread + dependency of ncursest or ncursestw library when building the + ncurses examples, e.g., in case weak symbols are used. + * add checks in ncurses-examples' configure script for some + functions neither in 4.3BSD curses, nor based on X/Open Curses: + + modify a loop limit in firework.c to work around absense of + limit checks in some libraries. + + fill the last row of a window with "?" in firstlast if waddch + does not return ERR on the lower-right corner. + * build-fixes for the Portland Group (PGI) compilers + + accept whitespace in sed expression for generating expanded.c + + modify configure check that g++ compiler warnings are not + used. + + add configure check for -fPIC option needed for shared + libraries. + * modify configure script for clang as used on FreeBSD, to work + around clang's differences in exit codes vs gcc. + * fixes for configure/build using clang on OSX + + do not redefine "inline" in ncurses_cfg.h; this was + originally to solve a problem with gcc/g++, but is aggravated + by clang's misuse of symbols to pretend it is gcc. + + add braces to configure script to prevent unwanted addition + of "-lstdc++" option to the CXXLIBS symbol. + + improve/update test-program used for checking existence of + stdc++ library. + + if $CXXLIBS is set, the linkage test uses that in addition to + $LIBS. + * fixes for OS/2: + + use button instead of kbuf[0] in EMX-specific part of + lib_mouse.c + + support building with libtool on OS/2 + + use stdc++ library with OS/2 kLIBC + + clear configure script's cf_XOPEN_SOURCE for OS/2, to work + with its header files + * add "newer" baudrate symbols to the [96]baudrate function in the + ncurses library as well as to a corresponding table in tset. + * modify ncurses-examples savescreen to work with AIX and HPUX. + * define WIN32_LEAN_AND_MEAN for MinGW port, making builds faster. + * add a configure check for wcwidth versus the ncurses line-drawing + characters, to use in special-casing systems such as Solaris. + Solaris, however, requires a special case that maps Unicode + line-drawing characters into the acsc string for non-Unicode + locales. Solaris also has a misconfigured wcwidth which marks all + of the line drawing characters as double-width. + * string-hacks (non-standard): + + fix configure script to record when strlcat is found on + OpenBSD. + + add --enable-string-hacks option to ncurses-examples' + configure script. + + completed string-hacks for sprintf, etc., including the + ncurses-examples programs. + + make --enable-string-hacks option work with Debian by + checking for the "bsd" library and its associated + "" header. + * workaround for Debian's antique/unmaintained version of mawk: + + see Debian #65617, which was fixed in mawk's upstream + releases in [97]2009. + + related fixes when building link_test. _________________________________________________________________ Features of ncurses @@ -863,10 +982,10 @@ Features of ncurses types even when no terminfo tree or termcap file is accessible (this may be useful for support of screen-oriented programs that must run in single-user mode). - * The [85]tic/[86]captoinfo utility provided with ncurses has the + * The [98]tic/[99]captoinfo utility provided with ncurses has the ability to translate many termcaps from the XENIX, IBM and AT&T extension sets. - * A BSD-like [87]tset utility is provided. + * A BSD-like [100]tset utility is provided. * The ncurses library and utilities will automatically read terminfo entries from $HOME/.terminfo if it exists, and compile to that directory if it exists and the user has no write access to the @@ -881,132 +1000,148 @@ Features of ncurses other entries in the same source file (as in System V) but also to compiled entries in either the system terminfo directory or the user's $HOME/.terminfo directory. - * The table-of-entries utility [88]toe makes it easy for users to + * The table-of-entries utility [101]toe makes it easy for users to see exactly what terminal types are available on the system. * The library meets the XSI requirement that every macro entry point have a corresponding function which may be linked (and will be prototype-checked) if the macro definition is disabled with #undef. - * Extensive documentation is provided (see the [89]Additional - Reading section of the [90]ncurses FAQ for online documentation). + * Extensive documentation is provided (see the [102]Additional + Reading section of the [103]ncurses FAQ for online documentation). Applications using ncurses The ncurses distribution includes a selection of test programs (including a few games). These are available separately as - [91]ncurses-examples + [104]ncurses-examples The ncurses library has been tested with a wide variety of applications including: + aptitude + FrontEnd to Apt, the debian package manager + + [105]https://wiki.debian.org/Aptitude + cdk Curses Development Kit - [92]http://invisible-island.net/cdk/ + [106]https://invisible-island.net/cdk/ ded directory-editor - [93]http://invisible-island.net/ded/ + [107]https://invisible-island.net/ded/ dialog the underlying application used in Slackware's setup, and the basis for similar install/configure applications on many systems. - [94]http://invisible-island.net/dialog/ + [108]https://invisible-island.net/dialog/ lynx the text WWW browser - [95]http://lynx.isc.org/ - - Midnight Commander - file manager - - [96]http://www.midnight-commander.org/ + [109]https://lynx.invisible-island.net/ mutt mail utility - [97]http://www.mutt.org/ + [110]http://www.mutt.org/ ncftp file-transfer utility - [98]http://www.ncftp.com/ + [111]https://www.ncftp.com/ nvi New vi uses ncurses. - [99]https://sites.google.com/a/bostic.com/keithbostic/nvi + [112]https://sites.google.com/a/bostic.com/keithbostic/vi + + ranger + A console file manager with VI key bindings in Python. + + [113]https://ranger.github.io/ tin newsreader, supporting color, MIME - [100]http://www.tin.org/ + [114]http://www.tin.org/ + + vifm + File manager with vi like keybindings + + [115]https://vifm.info/ as well as some that use ncurses for the terminfo support alone: minicom terminal emulator for serial modem connections - [101]http://alioth.debian.org/projects/minicom/ + [116]https://alioth.debian.org/projects/minicom/ mosh a replacement for ssh. - [102]https://mosh.mit.edu/ + [117]https://mosh.mit.edu/ tack terminfo action checker - [103]http://invisible-island.net/ncurses/tack.html + [118]https://invisible-island.net/ncurses/tack.html tmux terminal multiplexor - [104]http://tmux.github.io/ + [119]https://github.com/tmux/tmux/wiki vile vi-like-emacs may be built to use the terminfo, termcap or curses interfaces. - [105]http://invisible-island.net/vile/ + [120]https://invisible-island.net/vile/ and finally, those which use only the termcap interface: emacs text editor - [106]http://www.gnu.org/software/emacs/ + [121]https://www.gnu.org/software/emacs/ + + less + The most commonly used pager (a program that displays text + files). + + [122]http://www.greenwoodsoftware.com/less/ screen terminal multiplexor - [107]http://www.gnu.org/software/screen/ + [123]https://www.gnu.org/software/screen/ vim text editor - [108]http://www.vim.org/ + [124]https://www.vim.org/ Development activities Zeyd Ben-Halim started ncurses from a previous package pcurses, written by Pavel Curtis. Eric S. Raymond continued development. Juergen Pfeifer wrote most of the form and menu libraries. Ongoing - development work is done by [109]Thomas Dickey. Thomas Dickey also + development work is done by [125]Thomas Dickey. Thomas Dickey also acts as the maintainer for the Free Software Foundation, which holds - the [110]copyright on ncurses. + the [126]copyright on ncurses. Contact the current maintainers at - [111]bug-ncurses@gnu.org + [127]bug-ncurses@gnu.org To join the ncurses mailing list, please write email to - [112]bug-ncurses-request@gnu.org + [128]bug-ncurses-request@gnu.org containing the line: @@ -1018,208 +1153,216 @@ Development activities Beta versions of ncurses and patches to the current release are made available at - [113]ftp://invisible-island.net/ncurses/ . + [129]ftp://ftp.invisible-island.net/ncurses/ and + [130]https://invisible-mirror.net/archives/ncurses/ . There is an archive of the mailing list here: - [114]http://lists.gnu.org/archive/html/bug-ncurses (also - [115]https) + [131]http://lists.gnu.org/archive/html/bug-ncurses (also + [132]https) Related resources The release notes make scattered references to these pages, which may be interesting by themselves: - * [116]man2html - * [117]ncurses licensing - * [118]Symbol versioning in ncurses - * [119]The MinGW port of ncurses - * [120]tack - terminfo action checker - * [121]tar versus portability - * [122]tctest - termcap library checker - * [123]Terminal Database + * [133]ncurses licensing + * [134]Symbol versioning in ncurses + * [135]Comments on ncurses versus slang (S-Lang) + * [136]tack - terminfo action checker + * [137]tctest - termcap library checker + * [138]Terminal Database Other resources The distribution provides a newer version of the terminfo-format - terminal description file once maintained by [124]Eric Raymond . + terminal description file once maintained by [139]Eric Raymond . Unlike the older version, the termcap and terminfo data are provided - in the same file, and provides several user-definable extensions - beyond the X/Open specification. + in the same file, which also provides several user-definable + extensions beyond the X/Open specification. You can find lots of information on terminal-related topics not - covered in the terminfo file at [125]Richard Shuford's archive . - - * [126]Overview - * [127]Release Notes - + [128]Library improvements - o [129]Output buffering - o [130]Symbol versioning - o [131]Miscellaneous - + [132]Program improvements - o [133]Utilities - o [134]Examples - + [135]Terminal database - + [136]Documentation - + [137]Interesting bug-fixes - + [138]Configuration changes - o [139]Major changes - o [140]Configuration options - + [141]Portability - o [142]MinGW - o [143]Other ports - * [144]Features of ncurses - * [145]Applications using ncurses - * [146]Development activities - * [147]Related resources - * [148]Other resources + covered in the terminfo file at [140]Richard Shuford's archive . + + * [141]Overview + * [142]Release Notes + + [143]Library improvements + o [144]New features + o [145]Other improvements + + [146]Program improvements + o [147]Utilities + o [148]Examples + + [149]Terminal database + + [150]Documentation + + [151]Interesting bug-fixes + + [152]Configuration changes + o [153]Major changes + o [154]Configuration options + + [155]Portability + * [156]Features of ncurses + * [157]Applications using ncurses + * [158]Development activities + * [159]Related resources + * [160]Other resources References - 1. http://invisible-island.net/ncurses/man/captoinfo.1m.html - 2. http://invisible-island.net/ncurses/man/clear.1.html - 3. http://invisible-island.net/ncurses/man/infocmp.1m.html - 4. http://invisible-island.net/ncurses/man/tabs.1.html - 5. http://invisible-island.net/ncurses/man/tic.1m.html - 6. http://invisible-island.net/ncurses/man/toe.1m.html - 7. http://invisible-island.net/ncurses/man/tput.1.html - 8. http://invisible-island.net/ncurses/man/tset.1.html - 9. ftp://ftp.gnu.org/gnu/ncurses/ - 10. ftp://invisible-island.net/ncurses/ - 11. http://invisible-island.net/ncurses/tctest.html - 12. http://invisible-island.net/ncurses/ncurses-examples.html - 13. http://lists.gnu.org/archive/html/bug-ncurses/2012-07/msg00029.html - 14. http://invisible-island.net/ncurses/NEWS.html#t20050101 - 15. http://invisible-island.net/ncurses/announce-5.5.html - 16. http://invisible-island.net/ncurses/ncurses-mapsyms.html - 17. http://invisible-island.net/ncurses/man/curs_initscr.3x.html#h3-initscr - 18. http://invisible-island.net/ncurses/man/curs_initscr.3x.html#h3-newterm - 19. http://invisible-island.net/ncurses/man/curs_terminfo.3x.html#h3-Initialization - 20. http://invisible-island.net/ncurses/man/ncurses.3x.html#h3-NCURSES_NO_SETBUF - 21. http://invisible-island.net/ncurses/man/curs_terminfo.3x.html - 22. http://invisible-island.net/ncurses/man/curs_kernel.3x.html#h3-reset_prog_mode_-reset_shell_mode - 23. http://invisible-island.net/ncurses/man/curs_kernel.3x.html#h3-reset_prog_mode_-reset_shell_mode - 24. http://invisible-island.net/ncurses/man/curs_printw.3x.html - 25. http://invisible-island.net/ncurses/ncurses-mapsyms.html - 26. http://invisible-island.net/ncurses/tack.html - 27. http://invisible-island.net/ncurses/man/curs_util.3x.html#h3-use_tioctl - 28. http://invisible-island.net/ncurses/man/curs_opaque.3x.html - 29. http://invisible-island.net/ncurses/man/curs_attr.3x.html#h2-PORTABILITY - 30. http://invisible-island.net/ncurses/man/form_field_opts.3x.html - 31. http://invisible-island.net/ncurses/man/curs_util.3x.html#h3-putwin_getwin - 32. http://invisible-island.net/ncurses/man/curs_util.3x.html#h3-putwin_getwin - 33. http://invisible-island.net/ncurses/man/curs_terminfo.3x.html#h3-Formatting-Output - 34. http://invisible-island.net/ncurses/tctest.html - 35. http://invisible-island.net/ncurses/tctest.html#my-better-translation - 36. http://invisible-island.net/ncurses/NEWS.html#t980103 - 37. https://svnweb.freebsd.org/base/head/lib/libc/gen/getcap.c?revision=244092&view=markup#l784 - 38. http://invisible-island.net/ncurses/ncurses-examples.html - 39. http://invisible-island.net/ncurses/man/curs_util.3x.html#h3-use_env - 40. http://invisible-island.net/ncurses/man/curs_window.3x.html#h3-derwin - 41. http://invisible-island.net/ncurses/man/curs_window.3x.html#h3-mvwin - 42. http://invisible-island.net/ncurses/man/form_driver.3x.html#h3-form_driver_w - 43. http://invisible-island.net/ncurses/terminfo.src.html#toc-_M_L_T_E_R_M - 44. http://invisible-island.net/ncurses/terminfo.src.html#tic-nsterm - 45. http://invisible-island.net/ncurses/terminfo.src.html#tic-putty-sco - 46. http://invisible-island.net/ncurses/terminfo.src.html#tic-teken - 47. http://invisible-island.net/ncurses/terminfo.src.html#toc-_T_E_R_M_I_N_A_T_O_R - 48. http://invisible-island.net/ncurses/terminfo.src.html#toc-_T_E_R_M_I_N_O_L_O_G_Y - 49. http://invisible-island.net/ncurses/terminfo.src.html#tic-tmux - 50. http://invisible-island.net/ncurses/terminfo.src.html#toc-_S_I_M_P_L_E_T_E_R_M - 51. http://invisible-island.net/ncurses/terminfo.src.html#tic-vte - 52. http://invisible-island.net/ncurses/terminfo.src.html#tic-vt520ansi - 53. http://aerie.jexium-island.net/ncurses/man/clear.1.html - 54. http://invisible-island.net/ncurses/terminfo.src.html#tic-xterm_sl - 55. http://invisible-island.net/ncurses/terminfo.src.html#tic-xterm-1005 - 56. http://invisible-island.net/ncurses/terminfo.src.html#tic-xterm-1006 - 57. http://invisible-island.net/ncurses/NEWS.html - 58. http://invisible-island.net/scripts/man2html.html - 59. http://invisible-island.net/ncurses/NCURSES-Programming-HOWTO.html - 60. http://invisible-island.net/ncurses/NEWS.html#t20110319 - 61. http://invisible-island.net/ncurses/NEWS.html#t20021221 - 62. http://invisible-island.net/ncurses/man/curs_color.3x.html#h3-Routine-Descriptions - 63. http://invisible-island.net/ncurses/man/default_colors.3x.html - 64. http://invisible-island.net/ncurses/man/curs_color.3x.html#h3-Routine-Descriptions - 65. http://invisible-island.net/ncurses/man/resizeterm.3x.html - 66. http://invisible-island.net/ncurses/NEWS.html#t980725 - 67. http://invisible-island.net/ncurses/NEWS.html#t960418 - 68. http://invisible-island.net/ncurses/NEWS.html#t970405 - 69. http://invisible-island.net/ncurses/man/curs_initscr.3x.html#h3-set_term - 70. http://invisible-island.net/ncurses/man/curs_initscr.3x.html#h3-delscreen - 71. http://invisible-island.net/ncurses/man/curs_terminfo.3x.html#h3-Formatting-Output - 72. http://docs.oracle.com/cd/E19253-01/html/817-0552/fhkpy.html - 73. http://invisible-island.net/ncurses/announce-5.9.html - 74. http://invisible-island.net/ncurses/announce-5.8.html - 75. http://invisible-island.net/ncurses/ncurses-examples.html - 76. http://invisible-island.net/ncurses/man/curs_beep.3x.html - 77. http://invisible-island.net/ncurses/man/curs_beep.3x.html - 78. http://invisible-island.net/ncurses/man/curs_kernel.3x.html#h3-curs_set - 79. http://invisible-island.net/ncurses/man/ncurses.3x.html#h3-NCURSES_CONSOLE2 - 80. http://stackoverflow.com/questions/20877689/gcc-4-8-1-minggw-d-option-does-not-work-as-usual - 81. http://linux.die.net/man/1/pkg-config - 82. http://invisible-island.net/ncurses/NEWS.html#t20021206 - 83. https://gcc.gnu.org/gcc-5/ - 84. http://invisible-island.net/autoconf/portability-test.html - 85. http://invisible-island.net/ncurses/man/tic.1m.html - 86. http://invisible-island.net/ncurses/man/captoinfo.1m.html - 87. http://invisible-island.net/ncurses/man/tset.1.html - 88. http://invisible-island.net/ncurses/man/toe.1m.html - 89. http://invisible-island.net/ncurses/ncurses.faq.html#additional_reading - 90. http://invisible-island.net/ncurses/ncurses.faq.html - 91. http://invisible-island.net/ncurses/ncurses-examples.html - 92. http://invisible-island.net/cdk/ - 93. http://invisible-island.net/ded/ - 94. http://invisible-island.net/dialog/ - 95. http://lynx.isc.org/ - 96. http://www.midnight-commander.org/ - 97. http://www.mutt.org/ - 98. http://www.ncftp.com/ - 99. https://sites.google.com/a/bostic.com/keithbostic/nvi - 100. http://www.tin.org/ - 101. http://alioth.debian.org/projects/minicom/ - 102. https://mosh.mit.edu/ - 103. http://invisible-island.net/ncurses/tack.html - 104. http://tmux.github.io/ - 105. http://invisible-island.net/vile/ - 106. http://www.gnu.org/software/emacs/ - 107. http://www.gnu.org/software/screen/ - 108. http://www.vim.org/ - 109. mailto:dickey@invisible-island.net - 110. http://invisible-island.net/ncurses/ncurses-license.html - 111. mailto:bug-ncurses@gnu.org - 112. mailto:bug-ncurses-request@gnu.org - 113. ftp://invisible-island.net/ncurses/ - 114. http://lists.gnu.org/archive/html/bug-ncurses - 115. https://lists.gnu.org/archive/html/bug-ncurses - 116. http://invisible-island.net/scripts/man2html.html - 117. http://invisible-island.nethttp://invisible-island.net/ncurses/ncurses-license.html - 118. http://invisible-island.net/ncurses/ncurses-mapsyms.html - 119. http://invisible-island.net/ncurses/ncurses-mingw.html - 120. http://invisible-island.net/ncurses/tack.html - 121. http://invisible-island.net/autoconf/portability-tar.html - 122. http://invisible-island.net/ncurses/tctest.html - 123. http://invisible-island.net/ncurses/ncurses.html#download_database - 124. http://www.catb.org/~esr/terminfo/ - 125. http://web.archive.org/web/*/http://www.cs.utk.edu/~shuford/terminal - 126. file:///usr/build/ncurses/ncurses-6.0-20150808/doc/html/announce.html#h2-overview - 127. file:///usr/build/ncurses/ncurses-6.0-20150808/doc/html/announce.html#h2-release-notes - 128. file:///usr/build/ncurses/ncurses-6.0-20150808/doc/html/announce.html#h3-library - 129. file:///usr/build/ncurses/ncurses-6.0-20150808/doc/html/announce.html#h3-lib-setbuf - 130. file:///usr/build/ncurses/ncurses-6.0-20150808/doc/html/announce.html#h3-lib-versioning - 131. file:///usr/build/ncurses/ncurses-6.0-20150808/doc/html/announce.html#h3-lib-other - 132. file:///usr/build/ncurses/ncurses-6.0-20150808/doc/html/announce.html#h3-programs - 133. file:///usr/build/ncurses/ncurses-6.0-20150808/doc/html/announce.html#h4-utilities - 134. file:///usr/build/ncurses/ncurses-6.0-20150808/doc/html/announce.html#h4-examples - 135. file:///usr/build/ncurses/ncurses-6.0-20150808/doc/html/announce.html#h3-database - 136. file:///usr/build/ncurses/ncurses-6.0-20150808/doc/html/announce.html#h3-documentation - 137. file:///usr/build/ncurses/ncurses-6.0-20150808/doc/html/announce.html#h3-bug-fixes - 138. file:///usr/build/ncurses/ncurses-6.0-20150808/doc/html/announce.html#h3-config-config - 139. file:///usr/build/ncurses/ncurses-6.0-20150808/doc/html/announce.html#h4-config-major - 140. file:///usr/build/ncurses/ncurses-6.0-20150808/doc/html/announce.html#h4-config-options - 141. file:///usr/build/ncurses/ncurses-6.0-20150808/doc/html/announce.html#h3-portability - 142. file:///usr/build/ncurses/ncurses-6.0-20150808/doc/html/announce.html#h4-port-mingw - 143. file:///usr/build/ncurses/ncurses-6.0-20150808/doc/html/announce.html#h4-port-systems - 144. file:///usr/build/ncurses/ncurses-6.0-20150808/doc/html/announce.html#h2-features - 145. file:///usr/build/ncurses/ncurses-6.0-20150808/doc/html/announce.html#h2-who-uses - 146. file:///usr/build/ncurses/ncurses-6.0-20150808/doc/html/announce.html#h2-development - 147. file:///usr/build/ncurses/ncurses-6.0-20150808/doc/html/announce.html#h2-this-stuff - 148. file:///usr/build/ncurses/ncurses-6.0-20150808/doc/html/announce.html#h2-other-stuff + 1. https://invisible-island.net/ncurses/man/captoinfo.1m.html + 2. https://invisible-island.net/ncurses/man/clear.1.html + 3. https://invisible-island.net/ncurses/man/infocmp.1m.html + 4. https://invisible-island.net/ncurses/man/tabs.1.html + 5. https://invisible-island.net/ncurses/man/tic.1m.html + 6. https://invisible-island.net/ncurses/man/toe.1m.html + 7. https://invisible-island.net/ncurses/man/tput.1.html + 8. https://invisible-island.net/ncurses/man/tset.1.html + 9. https://invisible-island.net/ncurses/ + 10. ftp://ftp.invisible-island.net/ncurses/ + 11. https://invisible-mirror.net/archives/ncurses/ + 12. ftp://ftp.gnu.org/gnu/ncurses/ + 13. https://invisible-island.net/ncurses/man/curs_kernel.3x.html#h3-def_prog_mode_-def_shell_mode + 14. https://invisible-island.net/ncurses/ncurses-mapsyms.html + 15. https://invisible-island.net/ncurses/tctest.html#bsd42-numeric-caps + 16. https://invisible-island.net/ncurses/ncurses-slang.html#cause_numbers + 17. https://invisible-island.net/ncurses/tack.html#portable + 18. https://invisible-island.net/ncurses/tack/CHANGES.html#index-t20170726 + 19. https://invisible-island.net/ncurses/man/curs_attr.3x.html#h2-EXTENSIONS + 20. https://invisible-island.net/ncurses/man/tset.1.html#h3-reset---reinitialization + 21. https://invisible-island.net/ncurses/man/tset.1.html + 22. https://invisible-island.net/ncurses/man/tput.1.html + 23. https://invisible-island.net/ncurses/man/tset.1.html#h3-reset---reinitialization + 24. https://invisible-island.net/ncurses/man/clear.1.html + 25. https://invisible-island.net/ncurses/tctest.html#bsd42-ctl-question + 26. https://invisible-island.net/ncurses/tctest.html#freebsd-ctl-question + 27. https://invisible-island.net/ncurses/ncurses-examples.html + 28. https://invisible-island.net/ncurses/man/new_pair.3x.html#h3-alloc_pair + 29. https://invisible-island.net/ncurses/man/new_pair.3x.html#h3-find_pair + 30. https://invisible-island.net/ncurses/man/new_pair.3x.html#h3-free_pair + 31. https://invisible-island.net/ncurses/ncurses-slang.html#compare_picsmap + 32. https://invisible-island.net/dialog/ + 33. https://invisible-island.net/dialog/manpage/dialog.html#h3-Common-Options + 34. https://invisible-island.net/xterm/xterm.log.html#xterm_331 + 35. https://invisible-island.net/ncurses/terminfo.src.html#toc-_A_N_S_I__S_Y_S__I_S_O_6429__E_C_M_A-48__Capabilities + 36. https://invisible-island.net/ncurses/terminfo.src.html#tic-icl6404 + 37. https://invisible-island.net/ncurses/terminfo.src.html#tic-interix + 38. https://invisible-island.net/ncurses/terminfo.src.html#toc-_Linux_consoles + 39. https://invisible-island.net/ncurses/terminfo.src.html#toc-_Open_B_S_D_consoles + 40. https://invisible-island.net/ncurses/terminfo.src.html#toc-_Tmux + 41. https://invisible-island.net/ncurses/terminfo.src.html#toc-_D_E_C__V_T100_and_compatibles + 42. https://invisible-island.net/ncurses/terminfo.src.html#toc-_G_N_O_M_E__V_T_E_ + 43. https://invisible-island.net/ncurses/terminfo.src.html#toc-_X_T_E_R_M + 44. https://invisible-island.net/xterm/xterm.log.html#xterm_32 + 45. https://invisible-island.net/xterm/xterm.log.html#xterm_272 + 46. https://invisible-island.net/ncurses/NEWS.html + 47. https://invisible-island.net/ncurses/man/clear.1.html#h2-HISTORY + 48. https://invisible-island.net/ncurses/man/clear.1.html#h2-HISTORY + 49. https://invisible-island.net/ncurses/man/clear.1.html#h2-HISTORY + 50. https://invisible-island.net/ncurses/man/curs_addch.3x.html#h2-PORTABILITY + 51. https://invisible-island.net/ncurses/man/curs_attr.3x.html#h2-HISTORY + 52. https://invisible-island.net/ncurses/man/curs_attr.3x.html#h2-HISTORY + 53. https://invisible-island.net/ncurses/man/curs_attr.3x.html#h2-PORTABILITY + 54. https://invisible-island.net/ncurses/man/curs_mouse.3x.html#h2-PORTABILITY + 55. https://invisible-island.net/ncurses/man/curs_pad.3x.html#h2-PORTABILITY + 56. https://invisible-island.net/ncurses/man/curs_slk.3x.html#h2-PORTABILITY + 57. https://invisible-island.net/ncurses/man/resizeterm.3x.html#h2-PORTABILITY + 58. https://invisible-island.net/ncurses/man/wresize.3x.html#h2-PORTABILITY + 59. https://invisible-island.net/ncurses/man/curs_addch.3x.html#h3-ACS-Symbols + 60. https://invisible-island.net/ncurses/man/curs_add_wch.3x.html + 61. https://invisible-island.net/ncurses/man/clear.1.html#h2-DESCRIPTION + 62. https://invisible-island.net/ncurses/man/curs_initscr.3x.html#h3-endwin + 63. https://invisible-island.net/ncurses/man/form_driver.3x.html + 64. https://invisible-island.net/ncurses/man/curs_get_wstr.3x.html#h2-RETURN-VALUE + 65. https://invisible-island.net/ncurses/man/curs_getch.3x.html#h3-Predefined-key-codes + 66. https://invisible-island.net/ncurses/man/curs_getch.3x.html#h3-Keypad-Mode + 67. https://invisible-island.net/ncurses/man/curs_get_wch.3x.html#h2-DESCRIPTION + 68. https://invisible-island.net/ncurses/man/infocmp.1m.html + 69. https://invisible-island.net/ncurses/man/resizeterm.3x.html#h2-NOTES + 70. https://invisible-island.net/ncurses/man/curs_extend.3x#h2-RETURN-VALUE + 71. https://invisible-island.net/ncurses/man/curs_variables.3x.html#h2-PORTABILITY + 72. https://invisible-island.net/ncurses/man/curs_memleaks.3x.html + 73. https://invisible-island.net/ncurses/man/tic.1m.html + 74. https://invisible-island.net/ncurses/man/terminfo.5.html#h3-Terminfo-Capabilities-Syntax + 75. https://invisible-island.net/ncurses/man/terminfo.5.html#h3-Line-Graphics + 76. https://invisible-island.net/ncurses/man/terminfo.5.html#h3-Color-Handling + 77. https://invisible-island.net/ncurses/man/tput.1.html#h2-PORTABILITY + 78. https://invisible-island.net/ncurses/man/tput.1.html#h3-Aliases + 79. https://invisible-island.net/ncurses/man/tic.1m.html#h2-OPTIONS + 80. https://invisible-island.net/ncurses/man/infocmp.1m.html#h3-Other-Options + 81. https://invisible-island.net/ncurses/man/tset.1.html + 82. https://invisible-island.net/ncurses/man/curs_termcap.3x.html#h3-FORMATTING-CAPABILITIES + 83. https://invisible-island.net/ncurses/man/user_caps.5.html + 84. https://invisible-island.net/ncurses/man/scr_dump.5.html + 85. https://invisible-island.net/ncurses/man/curs_sp_funcs.3x.html + 86. https://invisible-island.net/ncurses/man/curs_threads.3x.html + 87. https://invisible-island.net/ncurses/man/curs_attr.3x.html + 88. file:///ncurses/man/curs_color.3x.html + 89. file:///usr/build/ncurses/ncurses-6.1-20180127/doc/html/announce.html#h4-new-library + 90. https://invisible-island.net/ncurses/ncurses-slang.html#compare_picsmap + 91. https://invisible-island.net/ncurses/tack/CHANGES.html#index-t20170726 + 92. https://invisible-island.net/ncurses/NEWS.html#t20111030 + 93. https://invisible-island.net/ncurses/NEWS.html#t20000708 + 94. https://invisible-island.net/ncurses/ncurses-netbsd.html + 95. https://invisible-island.net/ncurses/man/curs_util.3x.html#h3-use_env + 96. https://invisible-island.net/ncurses/man/curs_termattrs.3x.html#h3-baudrate + 97. https://invisible-island.net/mawk/CHANGES.html#t20090727 + 98. https://invisible-island.net/ncurses/man/tic.1m.html + 99. https://invisible-island.net/ncurses/man/captoinfo.1m.html + 100. https://invisible-island.net/ncurses/man/tset.1.html + 101. https://invisible-island.net/ncurses/man/toe.1m.html + 102. https://invisible-island.net/ncurses/ncurses.faq.html#additional_reading + 103. https://invisible-island.net/ncurses/ncurses.faq.html + 104. https://invisible-island.net/ncurses/ncurses-examples.html + 105. https://wiki.debian.org/Aptitude + 106. https://invisible-island.net/cdk/ + 107. https://invisible-island.net/ded/ + 108. https://invisible-island.net/dialog/ + 109. https://lynx.invisible-island.net/ + 110. http://www.mutt.org/ + 111. https://www.ncftp.com/ + 112. https://sites.google.com/a/bostic.com/keithbostic/vi + 113. https://ranger.github.io/ + 114. http://www.tin.org/ + 115. https://vifm.info/ + 116. https://alioth.debian.org/projects/minicom/ + 117. https://mosh.mit.edu/ + 118. https://invisible-island.net/ncurses/tack.html + 119. https://github.com/tmux/tmux/wiki + 120. https://invisible-island.net/vile/ + 121. https://www.gnu.org/software/emacs/ + 122. http://www.greenwoodsoftware.com/less/ + 123. https://www.gnu.org/software/screen/ + 124. https://www.vim.org/ + 125. mailto:dickey@invisible-island.net + 126. https://invisible-island.net/ncurses/ncurses-license.html + 127. mailto:bug-ncurses@gnu.org + 128. mailto:bug-ncurses-request@gnu.org + 129. ftp://ftp.invisible-island.net/ncurses/ + 130. https://invisible-mirror.net/archives/ncurses/ + 131. http://lists.gnu.org/archive/html/bug-ncurses + 132. https://lists.gnu.org/archive/html/bug-ncurses + 133. https://invisible-island.net/ncurses/ncurses-license.html + 134. https://invisible-island.net/ncurses/ncurses-mapsyms.html + 135. https://invisible-island.net/ncurses/ncurses-slang.html + 136. https://invisible-island.net/ncurses/tack.html + 137. https://invisible-island.net/ncurses/tctest.html + 138. https://invisible-island.net/ncurses/ncurses.html#download_database + 139. http://www.catb.org/~esr/terminfo/ + 140. http://web.archive.org/web/*/http://www.cs.utk.edu/~shuford/terminal + 141. file:///usr/build/ncurses/ncurses-6.1-20180127/doc/html/announce.html#h2-overview + 142. file:///usr/build/ncurses/ncurses-6.1-20180127/doc/html/announce.html#h2-release-notes + 143. file:///usr/build/ncurses/ncurses-6.1-20180127/doc/html/announce.html#h3-library + 144. file:///usr/build/ncurses/ncurses-6.1-20180127/doc/html/announce.html#h4-new-library + 145. file:///usr/build/ncurses/ncurses-6.1-20180127/doc/html/announce.html#h4-fixes-library + 146. file:///usr/build/ncurses/ncurses-6.1-20180127/doc/html/announce.html#h3-programs + 147. file:///usr/build/ncurses/ncurses-6.1-20180127/doc/html/announce.html#h4-utilities + 148. file:///usr/build/ncurses/ncurses-6.1-20180127/doc/html/announce.html#h4-examples + 149. file:///usr/build/ncurses/ncurses-6.1-20180127/doc/html/announce.html#h3-database + 150. file:///usr/build/ncurses/ncurses-6.1-20180127/doc/html/announce.html#h3-documentation + 151. file:///usr/build/ncurses/ncurses-6.1-20180127/doc/html/announce.html#h3-bug-fixes + 152. file:///usr/build/ncurses/ncurses-6.1-20180127/doc/html/announce.html#h3-config-config + 153. file:///usr/build/ncurses/ncurses-6.1-20180127/doc/html/announce.html#h4-config-major + 154. file:///usr/build/ncurses/ncurses-6.1-20180127/doc/html/announce.html#h4-config-options + 155. file:///usr/build/ncurses/ncurses-6.1-20180127/doc/html/announce.html#h3-portability + 156. file:///usr/build/ncurses/ncurses-6.1-20180127/doc/html/announce.html#h2-features + 157. file:///usr/build/ncurses/ncurses-6.1-20180127/doc/html/announce.html#h2-who-uses + 158. file:///usr/build/ncurses/ncurses-6.1-20180127/doc/html/announce.html#h2-development + 159. file:///usr/build/ncurses/ncurses-6.1-20180127/doc/html/announce.html#h2-this-stuff + 160. file:///usr/build/ncurses/ncurses-6.1-20180127/doc/html/announce.html#h2-other-stuff diff --git a/INSTALL b/INSTALL index 467add47..7d4b143e 100644 --- a/INSTALL +++ b/INSTALL @@ -25,7 +25,7 @@ -- sale, use or other dealings in this Software without prior written -- -- authorization. -- ------------------------------------------------------------------------------- --- $Id: INSTALL,v 1.202 2018/01/15 19:22:55 tom Exp $ +-- $Id: INSTALL,v 1.203 2018/01/23 00:59:19 tom Exp $ --------------------------------------------------------------------- How to install Ncurses/Terminfo on your system --------------------------------------------------------------------- @@ -317,11 +317,20 @@ SUMMARY OF CONFIGURE OPTIONS: Do not install the terminal database. This is used to omit features for packages, as done with --without-progs. + --disable-echo + Use the option --disable-echo to make the build-log less verbose by + suppressing the display of the compile and link commands. This makes + it easier to see the compiler warnings. (You can always use "make -n" + to see the options that are used). + --disable-ext-funcs Disable function-extensions. Configure ncurses without the functions that are not specified by XSI. See ncurses/modules for the exact list of library modules that would be suppressed. + --disable-gnat-projects + Disable GNAT projects even if usable, for testing old makefile rules. + --disable-hashmap Compile without hashmap scrolling-optimization code. This algorithm is the default. @@ -335,25 +344,6 @@ SUMMARY OF CONFIGURE OPTIONS: --disable-largefile Disable compiler flags needed to use large-file interfaces. - --disable-lib-suffixes - Suppress the "w", "t" or "tw" suffixes which normally would be added - to the library names for the --enable-widec and --with-pthread options. - - --disable-libtool-version - when using --with-libtool, control how the major/minor version numbers - are used for constructing the library name. - - The default uses the -version-number feature of libtool, which makes - the library names compatible (though not identical) with the standard - build using --with-shared. - - Use --disable-libtool-version to use the libtool -version-info feature. - This corresponds to the setting used before patch 20100515. - - Starting with patch 20141115, using this option causes the configure - script to apply the top-level VERSION file to the ABI version used - for libtool. - --disable-leaks For testing, compile-in code that frees memory that normally would not be freed, to simplify analysis of memory-leaks. @@ -374,6 +364,25 @@ SUMMARY OF CONFIGURE OPTIONS: library resume and reallocate memory, then that would not use a "_nc_" prefix. + --disable-lib-suffixes + Suppress the "w", "t" or "tw" suffixes which normally would be added + to the library names for the --enable-widec and --with-pthread options. + + --disable-libtool-version + when using --with-libtool, control how the major/minor version numbers + are used for constructing the library name. + + The default uses the -version-number feature of libtool, which makes + the library names compatible (though not identical) with the standard + build using --with-shared. + + Use --disable-libtool-version to use the libtool -version-info feature. + This corresponds to the setting used before patch 20100515. + + Starting with patch 20141115, using this option causes the configure + script to apply the top-level VERSION file to the ABI version used + for libtool. + --disable-lp64 The header files will ignore use of the _LP64 symbol to make chtype and mmask_t types 32 bits (they may be long on 64-bit hosts, for @@ -539,12 +548,6 @@ SUMMARY OF CONFIGURE OPTIONS: issues arise when porting to SVr4 curses, which uses const in even fewer places. - --enable-echo - Use the option --disable-echo to make the build-log less verbose by - suppressing the display of the compile and link commands. This makes - it easier to see the compiler warnings. (You can always use "make -n" - to see the options that are used). - --enable-expanded For testing, generate functions for certain macros to make them visible as such to the debugger. See also the --disable-macros option. @@ -844,6 +847,10 @@ SUMMARY OF CONFIGURE OPTIONS: executables, e.g., by setting "--with-chtype=long" (the configure script supplies "unsigned"). + --with-config-suffix=XXX + Specify a suffix for the ncursesw6-config file, etc., used to work + around conflicts with packages. + --with-cxx-shared When --with-shared is set, build libncurses++ as a shared library. This implicitly relies upon building with gcc/g++, since other @@ -981,6 +988,13 @@ SUMMARY OF CONFIGURE OPTIONS: --with-libtool-opts=XXX Specify additional libtool options. + --with-libtool-opts + Allow user to pass additional libtool options into the library creation + and link steps. The main use for this is to do something like + ./configure --with-libtool-opts=-static + to get the same behavior as automake-flavored + ./configure --enable-static + --with-manpage-aliases Tell the configure script you wish to create entries in the man-directory for aliases to manpages which list them, e.g., the @@ -1226,6 +1240,11 @@ SUMMARY OF CONFIGURE OPTIONS: which applications should not call even via a macro. This configure option lets you choose the prefix for these wrapped variables. + --with-x11-rgb=FILE + Provide a pathname for the X11 rgb file, used by the picsmap program. + This overrides a configure check which usually works, but is needed + due to the lack of standardization for X11's files. + --without-ada Suppress the configure script's check for Ada95, do not build the Ada95 binding and related demo. @@ -1265,6 +1284,11 @@ SUMMARY OF CONFIGURE OPTIONS: programs (e.g., tic). The test applications will still be built if you type "make", though not if you simply do "make install". + --without-tack + Suppress build/install with tack program, if it happens to be + in the same build-tree (tack was moved out of the ncurses source-tree + in 20070203). + --without-tests Tell the configure script to suppress the build of ncurses' test programs. @@ -1278,10 +1302,10 @@ SUMMARY OF CONFIGURE OPTIONS: COMPATIBILITY WITH OLDER VERSIONS OF NCURSES: -------------------------------------------- - Because ncurses implements X/Open Curses, its interface is fairly stable. + Because ncurses implements X/Open Curses, its interface is fairly stable. That does not mean the interface does not change. Changes are made to the documented interfaces when we find differences between ncurses and X/Open - or implementations which largely correspond to X/Open (such as Solaris). + or implementations which largely correspond to X/Open (such as Solaris). We add extensions to those interfaces to solve problems not addressed by the original curses design, but those must not conflict with the X/Open documentation. @@ -1290,6 +1314,91 @@ COMPATIBILITY WITH OLDER VERSIONS OF NCURSES: you may encounter when building a system with different versions of ncurses: + 6.1 (Jan 27, 2018) + Interface changes: + + + X/Open Curses specifies a "reserved" void* parameter in several + functions, saying that it must be NULL. In this release, if the + parameter is non-NULL, it is interpreted as a point to an integer + containing a color pair. In previous releases, a non-NULL parameter + caused an error return. Portable applications are unaffected. Here + are the functions which have been extended: + attr_get + attr_off + attr_on + attr_set + chgat + color_set + mvchgat + mvwchgat + slk_attr_off + slk_attr_on + slk_attr_set + wattr_get + wattr_on + wattr_off + wattr_set + wchgat + wcolor_set + + + the TERMINAL structure declared in has been made opaque, + and its size increased to handle the increased size of color pair + and color value, as well as other numeric capabilities. + + A few applications required change, e.g., to use def_prog_mode; + only one application (tack) is known to have a valid reason for + accessing these internal details, and that was addressed by the + release of tack 1.08 in 2017. Internal functions marked as used + by tack will be deprecated in future releases. + + Added extensions: + + + Several new functions were added to manipulate extended color pairs + and color values. These include: + alloc_pair + extended_color_content + extended_pair_content + extended_slk_color + find_pair + free_pair + init_extended_color + init_extended_pair + reset_color_pairs + + as well as corresponding sp-functions. + + + A new terminfo capability "RGB" tells the ncurses library that the + color values are red/green/blue, to eliminate the need for palettes + in that special case for the color_content function. + + Added internal functions (other than "_sp" variants): + _nc_copy_termtype2 + _nc_export_termtype2 + _nc_fallback2 + _nc_find_prescr + _nc_forget_prescr + _nc_free_termtype2 + _nc_read_entry2 + _nc_write_object + + Removed internal functions: + _nc_check_termtype + _nc_resolve_uses + + Modified internal functions: + + + symbols are used by tic/infocmp/toe: + _nc_align_termtype - change parameters to TERMTYPE2* + _nc_check_termtype2 - change parameter to TERMTYPE2* + _nc_read_file_entry - change parameter to TERMTYPE2* + _nc_read_termtype - change parameter to TERMTYPE2* + _nc_trim_sgr0 - change parameter to TERMTYPE2* + _nc_write_entry - change parameter to TERMTYPE2* + + + symbols used only within the library: + _nc_fallback - change return type to TERMTYPE2* + _nc_init_termtype - change parameter to TERMTYPE2* + 6.0 (Aug 08, 2015) Interface changes: diff --git a/NEWS b/NEWS index cc844f86..2e4ab8e2 100644 --- a/NEWS +++ b/NEWS @@ -25,7 +25,7 @@ -- sale, use or other dealings in this Software without prior written -- -- authorization. -- ------------------------------------------------------------------------------- --- $Id: NEWS,v 1.3065 2018/01/22 01:18:36 tom Exp $ +-- $Id: NEWS,v 1.3069 2018/01/27 15:28:53 tom Exp $ ------------------------------------------------------------------------------- This is a log of changes that ncurses has gone through since Zeyd started @@ -45,6 +45,29 @@ See the AUTHORS file for the corresponding full names. Changes through 1.9.9e did not credit all contributions; it is not possible to add this information. +20180127 + + updated release notes + + amend a warning message from tic which should have flagged misuse + of "XT" capability in "screen" terminal description. + > terminfo changes: + + trim "XT" from screen entry, add comments to explain why it was + not suitable -TD + + modify iterm to use xterm+sl-twm building block -TD + + mark konsole-420pc, konsole-vt100, konsole-xf3x obsolete reflecting + konsole's removal in 2008 -TD + + expanded the history section of konsole to explain its flawed + imitation of xterm's keyboard -TD + + use xterm+x11mouse in screen.* entries because screen does not yet + support xterm's 1006 mode -TD + + add nsterm-build400 for macOS 10.13 -TD + + add ansi+idc1, use that in ansi+idc adding dch for consistency -TD + + update vte to vte-2017 -TD + + add ecma+strikeout to vte-2017 -TD + + add iterm2-direct -TD + + updated teraterm, added teraterm-256color -TD + + add mlterm-direct -TD + + add descriptions for ANSI building-blocks -TD + 20180121 pre-release > terminfo changes: + add xterm+noalt, xterm+titlestack, xterm+alt1049, xterm+alt+title diff --git a/VERSION b/VERSION index d1297e7d..8d1f0758 100644 --- a/VERSION +++ b/VERSION @@ -1 +1 @@ -5:0:9 6.0 20180121 +5:0:9 6.0 20180127 diff --git a/announce.html.in b/announce.html.in index 89fb3ebe..378f6f80 100644 --- a/announce.html.in +++ b/announce.html.in @@ -1,7 +1,7 @@ - + @@ -42,6 +42,15 @@ @@ -50,21 +59,21 @@ p,li { max-width:700px; }

Overview

-

The ncurses (new curses) library - is a free software emulation of curses in System V Release 4.0 - (SVr4), and more. It uses terminfo format, supports pads and - color and multiple highlights and forms characters and +

The ncurses (new curses) + library is a free software emulation of curses in System V + Release 4.0 (SVr4), and more. It uses terminfo format, supports + pads and color and multiple highlights and forms characters and function-key mapping, and has all the other SVr4-curses - enhancements over BSD curses. SVr4 curses is better known today - as X/Open Curses.

+ enhancements over BSD curses. SVr4 curses became the basis of + X/Open Curses.

In mid-June 1995, the maintainer of 4.4BSD curses declared that he considered 4.4BSD curses obsolete, and encouraged the - keepers of unix releases such as - BSD/OS, FreeBSD and NetBSD to switch over to ncurses.

+ keepers of unix releases such as + BSD/OS, FreeBSD and NetBSD to switch over to ncurses.

-

Since 1995, ncurses has been +

Since 1995, ncurses has been ported to many systems:

    @@ -78,11 +87,12 @@ p,li { max-width:700px; } first of these was EMX on OS/2 Warp.
  • It is used (though usually not as the system - curses) on all of the vendor unix - systems, e.g., AIX, HP-UX, IRIX64, SCO, Solaris, Tru64.
  • + curses) on all of the vendor unix systems, e.g., AIX, HP-UX, IRIX64, SCO, + Solaris, Tru64.
  • It should work readily on any ANSI/POSIX-conforming - unix.
  • + unix.

The distribution includes the library and support utilities, @@ -90,1743 +100,2252 @@ p,li { max-width:700px; }

  • captoinfo, - a termcap conversion tool
  • + "https://invisible-island.net/ncurses/man/captoinfo.1m.html"> + captoinfo, a termcap conversion tool
  • clear, - utility for clearing the screen
  • + "https://invisible-island.net/ncurses/man/clear.1.html"> + clear, utility for clearing the screen
  • infocmp, - the terminfo decompiler
  • + "https://invisible-island.net/ncurses/man/infocmp.1m.html"> + infocmp, the terminfo decompiler
  • tabs, - set tabs on a terminal
  • + "https://invisible-island.net/ncurses/man/tabs.1.html"> + tabs, set tabs on a terminal
  • tic, - the terminfo compiler
  • + "https://invisible-island.net/ncurses/man/tic.1m.html"> + tic, the terminfo compiler
  • toe, - list (table of) terminfo entries
  • + "https://invisible-island.net/ncurses/man/toe.1m.html"> + toe, list (table of) terminfo entries
  • tput, - utility for retrieving terminal capabilities in shell - scripts
  • + "https://invisible-island.net/ncurses/man/tput.1.html"> + tput, utility for retrieving terminal capabilities + in shell scripts
  • tset, - to initialize the terminal
  • + "https://invisible-island.net/ncurses/man/tset.1.html"> + tset, to initialize the terminal

Full manual pages are provided for the library and tools.

-

The ncurses distribution is - available via anonymous FTP at the GNU distribution site

+

The ncurses distribution is + available at ncurses' homepage:

ftp://ftp.gnu.org/gnu/ncurses/ .

-
It is also available at + "ftp://ftp.invisible-island.net/ncurses/">ftp://ftp.invisible-island.net/ncurses/ + or
+ https://invisible-mirror.net/archives/ncurses/ .

+ + +

It is also available via anonymous FTP at the GNU distribution + site

ftp://invisible-island.net/ncurses/ .

+ "ftp://ftp.gnu.org/gnu/ncurses/">ftp://ftp.gnu.org/gnu/ncurses/ .

Release Notes

-

These notes are for ncurses - @VERSION@, released August 8, 2015.

+

These notes are for ncurses + @VERSION@, released January 27, 2018.

This release is designed to be source-compatible with - ncurses 5.0 through 5.9; providing a - new application binary interface (ABI). Although the source can - still be configured to support the ncurses 5 ABI, the intent of the release is to - provide extensions which are generally useful, but - binary-incompatible with ncurses - 5:

+ ncurses 5.0 through 6.0; providing + extensions to the application binary interface (ABI). Although + the source can still be configured to support the ncurses 5 ABI, the intent of the release is to + provide extensions to the ncurses + 6 ABI:

  • -

    Extend the cchar_t structure to allow more - than 16 colors to be encoded.

    +

    improve integration of tput + and tset

  • -

    Modify the encoding of mouse state to make room for a 5th - mouse button. That allows one to use ncurses with a wheel mouse with xterm or - similar X terminal emulators.

    +

    provide support for extended numeric capabilities.

-

There are, of course, numerous other improvements, - including

+

There are, of course, numerous other improvements, listed in + this announcement.

+ +

The release notes also mention some bug-fixes, but are focused + on new features and improvements to existing features since + ncurses 6.0 release.

+ +

Library + improvements

+ +

New + features

+ +

The improved integration of tput and tset + made only small changes to the libraries. However, supporting + extended numeric capabilities required a few changes:

  • -

    fixes made based on the Clang and Coverity static - analyzers.

    +

    The TERMINAL structure in + <term.h> is now opaque. Doing that allowed + making the structure larger, to hold the extended numeric + data.

    + +

    A few applications required changes during development of + ncurses 6.1 because those + applications misused the members of that structure, e.g., + directly modifying it rather than using + def_prog_mode.

  • -

    memory leak fixes using Valgrind

    -
  • -
+

Having made TERMINAL opaque (and because none + of the library functions use anything except a pointer to + TERMINAL), it was possible to increase the size + of the structure, adding to the end.

-

The release notes mention some bug-fixes, but are focused on - new features and improvements to existing features log since - ncurses 5.9 release.

+

Existing applications which were linked to the + ncurses 6.0 high-level + (ncurses, ncursesw) and low-level + (tinfo, tinfo) libraries should not require + re-linking since the binary interface did not change, nor did + the structure offsets with TERMINAL change.

-

While the intent of the release is to provide a new stable - ABI, there are other development activities which are summarized - below.

+

A few applications use the inner TERMTYPE + structure's offsets to refer to terminfo capabilities within + that structure. Again, those do not require modification + because their offsets within TERMINAL did not + change.

+ -
  • -

    The original release plan, e.g., for "5.10" was to improve - the MinGW port. Ultimately that was completed (wide-character - support, mouse, etc), but was deferred to focus on termcap - support and performance issues. Also, pinpointing the - problems with Console2 took a while.

    +

    When configured for wide-characters, i.e., + “ncursesw” the TERMINAL structure is + extended.

    + +

    The new data in TERMINAL holds the same + information as TERMTYPE, but with larger numbers + (“int” versus “short”). It is named + TERMTYPE2.

    + +

    The library uses this structure internally in preference + to TERMTYPE, referring to TERMTYPE + only to initialize it for applications that use the + capabilities defined in <term.h>

  • -

    A review of termcap compatibility in 2011 led to several - minor fixes in the library and improvements to utilities. To - do this properly, a review of the various extent termcap - implementations was needed.

    +

    When configured for 8-bit (narrow) characters, the + TERMTYPE2 structure is not used.

    +
  • -

    The termcap - library checker (tctest) (not part of ncurses) was one result. A followup review - of performance using ncurses-examples - in 2014 led to additional improvements.

    +
  • The updated application binary interface is 6.1.20171230 + (used for new versioned + symbols), although the interface changes were developed + several months previously.
  • +
+ +

The motivation for making this extension came from noticing + that + termcap applications could (though not + realistically) use larger numbers than would fit in 16-bits, + and the fact that the number of color pairs for a 256-color xterm + could not be expressed in terminfo (i.e., 32767 versus 65536). + Also, a few terminals support direct-colors, which could use the + extension.

+ +

Generally speaking, applications that use internal details of + a library are unsupported. There was exactly one exception for + ncurses: the tack program used the internal + details of TERMINAL, because it provides an + ncurses-specific feature for interactively modifying a terminfo + description and writing the updated description to a text-file. + It was possible to not only separate tack from these internal + details of ncurses, but to + generalize it so that the program works with Unix curses + (omitting the ncurses-specific feature). That was released as + + tack 1.08 in July + 2017.

+ +

While making changes to tack to + eliminate its dependency upon ncurses internals, the publicly-visible + details of those internals were reviewed, and some symbols were + moved to private header files, while others were marked + explicitly as ncurses internals. + Future releases of ncurses may + eliminate some of those symbols (such as those used by + tack 1.07) because they are + neither part of the API or the ABI.

+ +

Using the TERMTYPE2 extended numeric + capabilities, it is possible to support both color pair values + and color values past 32767. Taking compatibility into account, + developers readily understand that neither function signatures + nor structure offsets change. Also, existing functions have to + operate with the extended numbers. Most of that work is internal + to the library. For the external interfaces, a hybrid approach + was used:

+ +
    +
  • +

    X/Open Curses defined function prototypes such as + wattr_set with an unused parameter, for + “future” use. After 25 years, the future is here: + ncurses uses the parameter to + augment color pair values as described in the + manual page.

  • -

    Output buffering provided a further, but worthwhile - distraction. A bug report in 2012 regarding the use of signal - handlers in ncurses) pointed out - - a problem with the use of unsafe functions for handling - SIGTSTP. Other signals could be addressed with - workarounds; repairing SIGTSTP required a - different approach. The solution required changing internal - behavior of the library: how it handles output buffering.

    - -

    Now ncurses buffers its own - output, independently of the standard output. A few - applications relied upon the library's direct reuse of the - standard output buffering; however that is - unspecified behavior and has never been a - recommended practice. Identifying these applications as well - as refining the change to permit low-level applications to - work consistently took time.

    -
  • - -
  • -

    Since the introduction of the experimental support for 256 - colors early in 2005 - (released in ncurses - 5.5), there has been increased user interest. Almost all - packagers continue providing the ncurses ABI 5 which cannot - support 256 colors.

    -
  • - -
  • -

    Symbol versioning, or the lack of it in ncurses, is the - main reason why packagers would be reluctant to add a new - ncurses ABI.

    - -

    This release provides the new ABI along with - script-generated lists of versioned symbols which can be used - for both ABI 5 and 6 (with distinct names to keep the two - separate). This took time to development, as reported in - Symbol - versioning in ncurses.

    +

    Other functions such as those defining color pairs did not + have a corresponding reserved parameter. For those, + ncurses defines extended + versions such as init_extended_pair (versus + init_pair), init_extended_color + (versus init_color).

-

Library - improvements

+

Additionally, to improve performance other changes (and + extensions) are provided in this release:

-

Output - buffering

+
    +
  • +

    Several new functions simplify management of large sets of + color pairs: reset_color_pairs, + alloc_pair, find_pair and + free_pair.

    +
  • -

    X/Open curses provides more than one initialization - function:

    +
  • +

    New "RGB" extension capability for direct-color support is + used to improve performance of + color_content.

    +
  • -
      -
    • - initscr (the simplest) accepts no parameters.
    • +
    • +

      The internal colorpair_t is now a struct, + eliminating an internal 8-bit limit on colors

      +
    • -
    • - newterm accepts parameters for the stream input and - output
    • +
    • +

      Allocation for SCREEN's color-pair table + starts small, grows on demand up to the limit given in the + terminal description.

      +
    • -
    • - setupterm (the low-level function) accepts a parameter for - the file descriptor of the output.
    • +
    • +

      setcchar and getcchar now treat + a negative color-pair as an error.

      +
    -

    They are documented in X/Open as if - initscr calls newterm using - stdout for output stream, and in turn - newterm calls setupterm using - fileno(stdout) for the file descriptor. As long as - an implementation acts as if it does this, it conforms. - In practice, implementations do what is implied. This creates a - problem: the low-level setupterm function's file - descriptor is unbuffered, while newterm implies - buffered output. X/Open Curses says that all output is done - through the file descriptor, and does not say how the output - stream is actually used.

    - -

    Initially, ncurses used the file - descriptor (obtained from the output stream passed to - newterm) for changing the terminal modes, and relied - upon the output parameter of newterm for buffered - output. Later (to avoid using unsafe buffered I/O in signal - handlers), ncurses was modified to - use the file descriptor (unbuffered output) when cleaning up on - receipt of a signal. Otherwise (when not handling a signal), it - continued to use the buffered output.

    - -

    That approach worked reasonably well and as a side effect, - using the same buffered output as an application might use for - printf meant that no flushing was needed when - switching between normal- and screen-modes.

    - -

    There were a couple of problems:

    +

    Other + improvements

    + +

    These are new or revised features:

    • -

      to get good performance, curses (not only ncurses, but SVr4 curses in general) set an - output buffer using setbuf or similar function. - There is no standard (or portable) way to turn that output - buffer off, and revert to line-buffering. The - NCURSES_NO_SETBUF environment variable did make it - optional.

      +

      modify c++/etip.h.in to accommodate + deprecation of throw and throws in c++17

    • -

      to handle SIGTSTP (the “stop” - signal), ncurses relied upon - unsafe functions. That is, due to the complexity of the - feature, it relied upon reusing existing functions which - should not have been called via the signal handler.

      +

      add new function unfocus_current_field

    • -
    -

    Conveniently, solving the second problem (by making ncurses do its own output buffering) - also fixed the first one. But there were special cases to - resolve: - low-level functions such as mvcur, putp, vidattr - explicitly use the standard output. Those functions were reused - internally, and required modification to distinguish whether they - were used by the high-level or low-level interfaces.

    +
  • +

    add option to preserve leading whitespace in form + fields

    +
  • -

    Finally, there may still be a few programs which should be - modified to improve their portability, e.g., adding an

    +
  • +

    add a macro for is_linetouched and adjust the + function's return value to make it possible for most + applications to check for an error-return.

    +
  • -
    -
    -fflush(stdout);
    -
    -
    +
  • +

    add build-time utility report_offsets to help + show when the various configurations of tinfo library are + compatible or not.

    +
  • +
-

when switching from “shell” - mode to “program” - (curses) mode. Those are fairly rare because most programmers - have learned not to mix printf and printw.

- -

Symbol - versioning

- -

This release introduces symbol-versioning to ncurses because without it, the change of ABI - would be less successful. A lengthy discussion will be presented - in Symbol - versioning in ncurses. These - notes summarize what has changed, and what can be done with the - new release.

- -

Symbol-versioning allows the developers of a library to mark - each public symbol (both data and functions) with an identifier - denoting the library name and the version for which it was built. - By doing this, users of the library have a way to help ensure - that applications do not accidentally load an incompatible - library. In addition, private symbols can be hidden entirely.

- -

This release provides sample files for the four principal - configurations of ncurses libraries: - ncurses, ncursesw, - ncursest and ncursestw. Each sample is - given in two forms:

+

These were done to limit or ultimately deprecate features:

-
-
-
.map
+
    +
  • +

    drop two symbols obsoleted in 2004: + _nc_check_termtype, and + _nc_resolve_uses

    +
  • -
    These list all public symbols, together with version - names.
    +
  • +

    move _nc_tracebits, _tracedump + and _tracemouse to curses.priv.h, + since they are not part of the suggested ABI6.

    +
  • -
    .sym
    +
  • +

    mark some structs in form/menu/panel libraries as + potentially opaque without modifying API/ABI.

    +
  • -
    These list all public symbols, without version - names.
    -
-
+
  • +

    ifdef'd header-file definition of mouse_trafo + with NCURSES_NOMACROS

    +
  • -

    The sample files are generated by scripts which take - into account a few special cases such as tack to omit - many of the ncurses private symbols - (beginning with “_nc_”). Here are - counts of globals versus locals:

    +
  • +

    remove initialization-check for calling napms + in the term-driver configuration; none is needed.

    +
  • -
    - - - +
  • +

    modify trace to avoid overwriting existing + file

    +
  • + - +

    These are improvements to existing features:

    - +
      +
    • +

      modify make_hash to allow building with + address-sanitizer, assuming that --disable-leaks + is configured.

      +
    • -
    +
  • +

    move SCREEN field for use_tioctl + data before the ncursesw fields, and limit that to the + sp-funcs configuration to improve termlib compatibility

    +
  • - - +
  • +

    modify db-iterator:

    -
  • - +
      +
    • +

      ignore zero-length files in db-iterator; these are + useful for instance to suppress + $HOME/.terminfo when not wanted.

      +
    • -
    +
  • +

    modify update_getenv to ensure that + environment variables which are not initially set will be + checked later if an application happens to set them

    +
  • + + - +
  • +

    modify _nc_outc_wrapper to use the standard + output if the screen was not initialized, rather than + returning an error.

    +
  • - +
  • +

    improve checks for low-level terminfo functions when the + terminal has not been initialized.

    +
  • - - +
  • +

    modify set_curterm to update + ttytype[] data used by longname/p>

    +
  • - - +
  • +

    modify _nc_get_screensize to allow for + use_env and use_tioctl state to be + per-screen when sp-funcs are configured, better matching the + behavior when using the term-driver configuration.

    +
  • - +
  • +

    remove an early-return from _nc_do_color, + which can interfere with data needed by bkgd + when ncurses is configured + with extended colors

    +
  • - +
  • +

    incorporate A_COLOR mask into + COLOR_PAIR, in case user application provides an + out-of-range pair number

    +
  • - +
  • +

    modify logic for endwin-state to be able to + detect the case where the screen was never initialized, using + that to trigger a flush of ncurses' buffer for mvcur, + e.g., in the sample program dots_mvcur for the term-driver + configuration.

    +
  • + - - +

    These are corrections to existing features:

    - - +
      +
    • +

      fixes for writing extended color pairs in + putwin.

      +
    • -
    +
  • +

    modify no-leaks code for lib_cur_term.c to + account for the tgetent cache.

    +
  • - +
  • +

    amend handling of the repeat_char capability + in EmitRange to avoid scope creep: translate the + character to the alternate character set when the alternate + character set is enabled, and do not use + repeat_char for characters past 255.

    +
  • - +
  • +

    improve wide-character implementation of + myADDNSTR in frm_driver.c, which + was inconsistent with the normal implementation.

    +
  • - - +
  • +

    modify winnstr and winchnstr to + return error if the output pointer is null, as well as adding + a null pointer check of the window pointer for better + compatibility with other implementations.

    +
  • - - +
  • +

    modify setupterm to save original tty-modes + so that erasechar works as expected. Also modify + _nc_setupscreen to avoid redundant calls to get + original tty-modes.

    +
  • - +
  • +

    modify wattr_set and wattr_get + to return ERR if win-parameter is null, + as documented.

    +
  • - +
  • +

    correct order of initialization for traces in + use_env and use_tioctl versus first + _tracef calls.

    +
  • - +
  • +

    correct parameters for copywin call in + _nc_Synchronize_Attributes

    +
  • - - -
    ConfigSymbolsGlobalsLocals"_nc_"
    ncurses976796180332
    ncursesw1089905184343
    ncursest979804175358
    ncursestw1098914184372
    -
    +
  • +

    flush the standard output in _nc_flush for + the case where SP is zero, e.g., when called via + putp. This fixes a scenario where + “tput flash” did not work after changes in + 20130112.

    +
  • -

    Although only four sample configurations are presented, each - is formed by merging symbols from several combinations of - configure-script options, taking into account advice from - downstream packagers. Because they are formed by merging, the - sample files may list a symbol which is not in a given package. - That is expected. The samples have been tested and are working - with systems (such as Fedora, FreeBSD and Debian) which fully - support this feature. There are other systems which do - not support the feature, and a few (such as Solaris) - which provide incomplete support.

    - -

    The version-naming convention used allows these sample files - to build distinct libraries for ABI 5 and 6. Version names - consist of

    +
  • +

    amend internal use of tputs to consistently + use the number of lines affected, e.g., for insert/delete + character operations. While merging terminfo source early in + 1995, several descriptions used the + “*” proportional delay for these + operations, prompting a change in doupdate.

    +
  • -
    • -

      configuration name, e.g., - “NCURSESW” for the wide-character - libraries

      +

      correct return-value of extended putwin.

    • -

      ABI version (if not 5)

      +

      double-width multibyte characters were not counted + properly in winsnstr and + wins_nwstr.

    • -

      library name for two special cases which have the same - interface across configurations: - “TINFO” and - “TIC

      +

      amend fix for _nc_ripoffline from 20091031 to + make test/ditto.c work in threaded + configuration.

    • -

      release version

      +

      modify _nc_viscbuf2 and + _tracecchar_t2 to trace wide-characters as a + whole rather than their multibyte equivalents.

    • -

      patch date (for the release version)

      +

      minor fix in wadd_wchnstr to ensure that each + cell has nonzero width.

    • -
    -

    For example, running nm -D on the libraries in - the ncurses6 test package shows these symbol-versions:

    +
  • +

    move PUTC_INIT calls next to + wcrtomb calls, to avoid carry-over of error + status when processing Unicode values which are not + mapped.

    +
  • -
    -
    -0000000000000000 A NCURSES6_TIC_5.0.19991023
    -0000000000000000 A NCURSES6_TIC_5.1.20000708
    -0000000000000000 A NCURSES6_TIC_5.5.20051010
    -0000000000000000 A NCURSES6_TIC_5.7.20081102
    -0000000000000000 A NCURSES6_TIC_5.9.20150530
    -0000000000000000 A NCURSES6_TINFO_5.0.19991023
    -0000000000000000 A NCURSES6_TINFO_5.1.20000708
    -0000000000000000 A NCURSES6_TINFO_5.2.20001021
    -0000000000000000 A NCURSES6_TINFO_5.3.20021019
    -0000000000000000 A NCURSES6_TINFO_5.4.20040208
    -0000000000000000 A NCURSES6_TINFO_5.5.20051010
    -0000000000000000 A NCURSES6_TINFO_5.6.20061217
    -0000000000000000 A NCURSES6_TINFO_5.7.20081102
    -0000000000000000 A NCURSES6_TINFO_5.8.20110226
    -0000000000000000 A NCURSES6_TINFO_5.9.20150530
    -0000000000000000 A NCURSESW6_5.1.20000708
    -0000000000000000 A NCURSESW6_5.3.20021019
    -0000000000000000 A NCURSESW6_5.4.20040208
    -0000000000000000 A NCURSESW6_5.5.20051010
    -0000000000000000 A NCURSESW6_5.6.20061217
    -0000000000000000 A NCURSESW6_5.7.20081102
    -0000000000000000 A NCURSESW6_5.8.20110226
    -0000000000000000 A NCURSESW6_5.9.20150530
    -
    -
    +
  • +

    add missing assignment in lib_getch.c to make + notimeout work

    +
  • + + +

    Program + improvements

    -

    As a special case, this release (which makes the final change - for ABI 5) is marked with release version 5.9 and patch date - 20150530.

    +

    While reviewing user feedback, it became apparent that the + differences between + reset (an alias for + tset) and “tput reset” were confusing:

    -

    Miscellaneous

    +
      +
    • one (tset) + updated the terminal modes, but used only part of the terminfo + capabilities for initialization, while
    • + +
    • the other (tput) + used all of the terminal capabilities while neglecting the + terminal modes.
    • +
    -

    The new release has several improvements for performance and - building. For instance:

    +

    On further investigation, it turned out that the differences + were largely an accident due to the way those programs had + evolved.

    + +

    This release eliminates the unnecessary differences, using the + same approach for tput's + init (initialization), reset and clear + operations as the separate + reset and + clear programs. Doing this does not change the + command-line options; existing scripts are unaffected.

    + +

    These are the user-visible changes for the three programs + (tput, tset and clear):

    • -

      several files in ncurses- and progs-directories were - modified to allow const data used in internal - tables to be put by the linker into the readonly text - segment.

      +

      add the terminal-mode parts of “reset” (aka tset) to the “tput + reset” command, making the two almost the same + except for window-size.

    • -

      various improvements were made to building the Ada95 - binding, both in simplifying the generated files as well as - improving the way it uses gnatmake

      +

      improve tput's check for + being called as “init” or “reset” to + allow for transformed names.

    • -
    -

    There are also new features in the libraries:

    +
  • +

    add “clear” as a possible link/alias to + tput.

    +
  • -
      -
    • added - use_tioctl function
    • +
    • +

      amend changes for tput to + reset tty modes to “sane” if the program is run + as “reset”, like tset. Likewise, ensure that tset sends either reset- or + init-strings.

      +
    • -

      added - wgetdelay to retrieve _delay member of WINDOW if it - happens to be opaque, e.g., in the pthread configuration.

      +

      add -x option to clear/tput + to make the E3 extension optional

    • -

      added - A_ITALIC extension.

      +

      add functionality of + “tset -w” to tput, like the + “-c” feature this is not optional in + tput.

    • -

      added form library extension - O_DYNAMIC_JUSTIFY option which can be used to override - the different treatment of justification for static versus - dynamic fields .

      +

      add options -T and -V to + clear command for + compatibility with tput.

    • -

      rewrote - putwin and - getwin, making an extended version which is capable of - reading screen-dumps between the wide/normal ncurses configurations. These are text - files, except for a magic code at the beginning:

      +

      drop long-obsolete “-n” option + from tset.

      +
    • -
      -
      -0       string          \210\210        Screen-dump (ncurses)
      -
      -
      +
    • +

      modify tset's assignment to + TERM in its output to reflect the name by which + the terminal description is found, rather than the primary + name. That was an unnecessary part from the initial + conversion of tset from + termcap to terminfo. The termcap library in 4.3BSD did this + to avoid using the short 2-character name

    • -

      several changes to mouse support include:

      +

      remove a restriction in tput's support for termcap names which + omitted capabilities normally not shown in termcap + translations

      +
    • + +
    • +

      add usage message to clear + command

      +
    • + +
    • +

      improve usage messages for tset and tput.

      +
    • +
    + +

    Other user-visible improvements and new features include:

    + +
      +
    • +

      modify tic/infocmp display of numeric values to use + hexadecimal when they are "close" to a power of two, making + the result more readable.

      +
    • + +
    • +

      add “-W” option to tic/infocmp + to force long strings to wrap.

        -
      • added decoder for xterm SGR 1006 mouse mode.
      • +
      • +

        This is in addition to the + “-w” option which attempts to + fit capabilities into a given line-length.

        +
      • -
      • added experimental support for - “%u” format to terminfo.
      • +
      • +

        If “-f” option splits line, + do not further split it with + “-W”.

        +
      • -
      • improved behavior of wheel-mice for xterm protocol: - noting that there are only button-presses for buttons - “4” and “5”, so there is no need to - wait to combine events into double-clicks .
      • +
      • +

        Begin a new line when adding + “use=” after a wrapped line.

        +
    • -
    -

    There are a few new configure options dealing with library - customization:

    +
  • +

    add “-q” option to infocmp to suppress the + “Reconstructed from” comment from + the header, and a corresponding option to tic to suppress all comments from the + “tic -I” output.

    +
  • -
    • -

      add “--enable-ext-putwin” - configure option to turn on the extended putwin/getwin. By - default, this is enabled for ABI 6 and disabled with ABI - 5.

      +

      Sorted options in usage message for infocmp, to make it simpler to see unused + letters.

    • -

      add “--enable-string-hacks” - option to control whether strlcat and strlcpy may be used. - Because ncurses already does the - requisite buffer-limit checks, this feature is mainly of - interest to quiet compiler-warnings on a few systems.

      +

      Updated usage message for tic, adding “-0” + option.

    • -

      add configure option - “--with-tparm-arg” to allow - tparm's parameters to be something more likely to be the - same size as a pointer, e.g., intptr_t (again, - the default is set for ABI 6).

      +

      add infocmp/tic-Q” option, + which allows one to dump the compiled form of the terminal + entry, in hexadecimal or base64:

      + +
        +
      • A “b64:” prefix in the + TERMINFO variable tells the terminfo reader to + use base64 according to RFC-3548 as well as RFC-4648 + url/filename-safe format.
      • + +
      • A “hex:” prefix tells the + terminfo reader to accept hexadecimal data as generated by + “infocmp -0qQ1”.
      • +
    -

    Program - improvements

    - -

    Utilities

    - -

    Most of the termcap-related changes based on development of - tctest - (termcap library checker) are implemented in the tic and - infocmp programs rather than affecting the library. As noted in - the - discussion of tctest, ncurses's ability to translate between terminfo - and termcap formats has been improved at different times, but - subject to feedback from "real" termcap users. There are very few - of those. Nowadays, virtually all termcap users are - using ncurses (or NetBSD, with its - own terminfo library) and their programs are actually using - terminfo rather than termcap data.

    - -

    Still, there are a few. A comment about the translation of the - ASCII NUL character prompted a review:

    +

    Other less-visible improvements and new features include:

    • -

      Both terminfo and termcap store string capabilities as - NUL-terminated strings.

      +

      modify utility headers such as tic.h to make + it clearer which are externals that are used by tack.

    • -

      In terminfo, a \0 in a terminal description - is stored as \200.

      +

      add “reset” to list of programs + whose names might change in manpages due to + program-transformation configure options.

    • -

      There are no (known) terminals which would behave - differently when sent \0 or - \200.

      +

      modify “-T” option of + clear and tput to call use_tioctl to + obtain the operating system's notion of the screensize if + possible.

    • -

      When translating to terminfo format (or displaying a - printable version of an entry using infocmp), ncurses shows \200 as - \0.

      +

      add check in tput for + init/reset operands to ensure those use a terminal.

    • -

      It has done this since 1998 (quoting from the NEWS - file):

      - -
      -
      -980103
      -...
      -        + modify _nc_tic_expand() to generate \0 rather than \200.
      -...
      -        + correct translation of terminfo "^@", to \200, like \0.
      -
      -
      +

      modify programs clear, + tabs, tput and tset to pass the actual tty file + descriptor to setupterm rather than the standard output or + error, making padding work.

    • -

      However, the _nc_tic_expand function (which - optionally produces terminfo or termcap format) did not - address this special case for termcap. Even the later 4.4BSD - - cgetstr interprets a \0 literally, ending - that string (rather than using the terminfo - improvement).

      +

      change tset's + initialization to allow it to get settings from the standard + input as well as /dev/tty, to be more effective + when output or error are redirected.

    • -
    -

    As a result of the review, several improvements were made to - ncurses translation to/from termcap - format — and improving the checks made in tic for - consistency of entries. Most of these are not of general - interest, except for two new command-line options for tic and - infocmp:

    - -
    • -

      the “-0” option generates - termcap/terminfo source on a single line.

      +

      amend check in tput, + tabs and clear to allow those to use the + database-only features in cron + if a “-T” option gives a suitable + terminal name.

    • -

      the “-K” option provides stricter - BSD-compatibility for termcap output.

      +

      improve error message from tset/reset + when both stderr/stdout are redirected to a file or pipe.

    -

    Other user-visible improvements and new features include:

    +

    Several of the less apparent features deal with translation of + terminfo to termcap (and the reverse), with corresponding checks + by tic:

    • -

      added “-D” option to tic and - infocmp, to show the database locations that it could - use.

      +

      modify check in fmt_entry to handle a + cancelled reset string. Make similar fixes in other parts of + dump_entry.c and tput.c

    • -

      added “-s” option to toe, to sort - its output.

      +

      correct read of terminfo entry in which all strings are + absent or explicitly cancelled. Before this fix, the result + was that all were treated as only absent.

    • -

      extended “-c” and - “-n” options of infocmp to allow - comparing more than two entries.

      +

      modify infocmp to suppress + mixture of absent/cancelled capabilities that would only show + as “NULL, NULL”, unless the + “-q” option is used, e.g., to show + “-, @” or “@, + -”.

    • -

      modified toe's report when “-a” - and “-s” options are combined, to - add a column showing which entries belong to a given - database.

      +

      correct a warning from tic + about keys which are the same, to skip over missing/cancelled + values.

    • -

      modified the clear program to take into account the - “E3” extended capability to clear - the terminal's scrollback buffer.

      +

      add check in tic for use of + bold, etc., video attributes in the color capabilities, + accounting whether the feature is listed in + ncv.

    • -
    -

    Examples

    +
  • +

    add check in tic for + unnecessary use of “2” to denote a + shifted special key.

    +
  • -

    Along with the library and utilities, many improvements were - made to the ncurses-examples. - Some were made to allow building (and comparison-testing) against - NetBSD curses and PDCurses. Both lack some of the X/Open Curses - features, necessitating customization. But this activity was - useful because it showed some remaining performance issues (which - have been resolved in this release).

    +
  • +

    improve check in tic for + delays by also warning about beep/flash when a delay is not + embedded, or if those use the VT100 reverse video escape + without using a delay.

    +
  • -

    These changes were made to verify compatibility or compare - performance of ncurses:

    +
  • +

    improve checks in trim_sgr0, comp_parse.c and + parse_entry.c, for cancelled string capabilities.

    +
  • -
    • -

      made workarounds for compiling test-programs with NetBSD - curses, though it lacks some common functions such as - - use_env.

      +

      add check in tic for some + syntax errors of delays, as well as use of proportional + delays for non-line capabilities.

    • -

      added dots_termcap test-program

      +

      add check in tic for + conflict between ritm, rmso, + rmul versus sgr0.

    • -

      added dots_curses test-program, for comparison with the - low-level examples.

      +

      add check in _nc_parse_entry for invalid + entry name, setting the name to + “invalid” to avoid problems storing + entries.

    • -

      added test_setupterm test-proram to demonstrate - normal/error returns from the setupterm and restartterm - functions.

      +

      improve _nc_tparm_analyze, using that to + extend the checks made by tic + for reporting inconsistencies between the expected number of + parameters for a capability and the actual.

    • -

      added “-d”, - “-e” and - “-q” options to the demo_terminfo - and demo_termcap test-programs.

      +

      remove tic warning about + “^?” in string capabilities, which + was marked as an extension; however all Unix implementations + support this and X/Open Curses does not address it. On the + other hand, + BSD termcap did not support this feature (until the + + mid-1990s).

      + +

      in _nc_infotocap, added a check to ensure + that terminfo “^?” is not written to + termcap.

    • -

      added “-y” option to demo_termcap - and test/demo_terminfo test-programs to demonstrate behavior - with/without extended capabilities.

      +

      modify sscanf calls in + _nc_infotocap for patterns + “%{number}%+%c” and + “%'char'%+%c” to check that the + final character is really “c”, + avoiding a case in icl6404 which cannot be converted to + termcap.

    • -

      modified demo_termcap and demo_terminfo test-programs to - make their options more directly comparable, and add - “-i” option to specify a terminal - description filename to parse for names to lookup.

      +

      in _nc_tic_expand and + _nc_infotocap, improved string-length check when + deciding whether to use “^X” or + “\xxx” format for control + characters, to make the output of tic/infocmp + more predictable.

    • -

      rewrote the tests for - mvderwin and test for recursive - mvwin in the movewindow test-program.

      +

      limited termcap “%d” width to 2 + digits on input, and use “%2” in + preference to “%02” on output.

      +
    • + +
    • +

      correct terminfo/termcap conversion of + “%02” and + “%03” into + “%2” and + “%3”; the result repeated the last + character.

    -

    These changes were made to help with the MinGW port:

    +

    Examples

    + +

    Along with the library and utilities, many improvements were + made to the ncurses-examples.

    + +

    These changes were made to demonstrate new extensions in + ncurses:

    • -

      added test-screens to the ncurses test-program to show - 256-characters at a time, to help with MinGW port.

      +

      add demo_new_pair program, + to demonstrate + alloc_pair, + find_pair and + free_pair functions.

      + +

      This program iterates over the possible color + combinations, allocating or initializing color pairs. For + best results, choose screen-width dividing evenly into the + number of colors. e.g.,

      + +
      + + + + + + + + + + + + + + + + + + +
      32x64,32x128  256 colors
      24x44,24x8888 colors
      32x64,24x12816 colors
      +
    • -

      modified the view test-program to load UTF-8 when built - with MinGW by using regular win32 API because the MinGW - functions mblen and mbtowc do not work.

      +

      add extended_color program, + like the older color_set + program, but using the extended color functions, with and + without the SP-functions interface.

    • -

      added “-s” option to the view - test-program to allow it to start in single-step mode, - reducing size of trace files when it is used for debugging - MinGW changes.

      +

      add picsmap program to fill + in some testing issues not met by dots, using this as the third example in a + comparison of the + ncurses versus slang libraries.

      + +

      The program can directly read X bitmap and pixmap files, + displaying a picture. It can read other image files using + ImageMagick's convert program to translate the image + into text.

      + +

      For 16-, 88- and 256-color terminal descriptions, + picsmap can load a palette + file which tells it which color palette entries to use. For + direct-colors, the terminal descriptions use the + RGB extension capability.

    -

    These changes were made to verify new extensions in ncurses:

    +

    There are other new example programs and a few scripts:

    • -

      added - form_driver_w entrypoint to wide-character forms library, - as well as form_driver_w test-program.

      +

      add dots_xcurses program to + illustrate a different approach used for extended colors + which can be contrasted with dots_curses.

    • -

      modified ncurses test-program's b/B tests to display lines - only for the attributes which a given terminal supports, to - make room for an italics test.

      +

      add list_keys program show + function keys for one or more terminal descriptions. It uses + ncurses's convention of + modifiers for special keys, based on xterm.

    • -

      modified ncurses test-program, adding - “-E” and - “-T” options to demonstrate use_env - versus use_tioctl.

      +

      add padview program, to + compare pads with direct updates in the view program.

    • -

      modified ncurses test-program's c/C tests to cycle through - subsets of the total number of colors, to better illustrate - 8/16/88/256-colors by providing directly comparable - screens.

      +

      add sp_tinfo program to + exercise the SP-functions extension of the low-level terminfo + library.

    • -

      modified the ncurses test-program to also show position - reports in 'a' test.

      +

      add test-programs for termattrs and + term_attrs functions.

    • -
    - -

    These changes were made to make the examples more useful:

    -
    • -

      added scripts for building dpkg and rpm test-packages

      +

      add test_sgr program to + exercise all combinations of the sgr capability.

    • -

      modified the hanoi test-program to show the minimum number - of moves possible for the given number of tiles.

      +

      add tput-colorcube demo + script, imitating xterm's 88- and 256-color scripts using + tput.

    • -

      modified the knight test-program to show the number of - choices possible for each position in automove option, e.g., - to allow user to follow Warnsdorff's rule to solve the - puzzle.

      +

      add tput-initc script to + demonstrate how tput may be + used to initialize a color palette from a data file.

    -

    Terminal - database

    +

    A variety of improvements were made to existing programs, both + new features as well as options added to make the set of programs + more consistent.

    -

    This release provides improvements to tic's - “-c” checking option, which was used for - example to

    +

    The ncurses program is the + largest; a proportionately large number of changes were made to + it:

    • -

      make sgr in several entries agree with other - caps.

      +

      modify a/A screens to make exiting on an escape character + depend on the start of keypad and timeout modes, to allow + better testing of function-keys.

      + +

      add “t” toggle for + notimeout function.

    • -

      correct padding in some entries where earlier versions had - miscounted the number of octal digits.

      +

      modify layout of b/B screens to allow for additional + annotation on the right margin; some terminals with partial + support did not display well.

    • -
    -

    There are several new terminal descriptions:

    - -
      -
    • - mlterm is now aliased to mlterm3
    • - -
    • - nsterm is now derived from nsterm-256color
    • - -
    • - putty-sco
    • +
    • +

      modify c/C screens to allow for extended color pairs.

      -
    • - teken is FreeBSD's "xterm" console.
    • +

      add z/Z zoom feature to make extended color pairs + easier to test.

      -
    • - terminator
    • +

      modify test-screens to take advantage of wide screens, + reducing the number of lines used for 88- and 256-colors.

      + -
    • - terminology
    • +
    • +

      modify “d” edit-color screen to + optionally read xterm color palette directly from terminal, + as well as handling KEY_RESIZE and + screen-repainting with control/L and control/R.

      +
    • -
    • - tmux is derived from screen.
    • +
    • +

      add examples to “F” screen for + WACS_D_PLUS and WACS_T_PLUS.

      +
    • -
    • several screen.XXX entries support the respective - variations for 256 colors.
    • +
    • +

      improve “g” screen, correcting + ifdef which made the legend not reflect changes to keypad- + and scroll-modes. Added check for return-value of + putwin.

      +
    • -
    • - simpleterm is now 0.5
    • +
    • +

      make “s” test easier to + understand which subtests are available

      -
    • - vte is aliased to vte-2012
    • +

      add a corresponding “S” + wide-character overlap test-screen.

      + -
    • - vt520ansi
    • +
    • +

      add “v” screen to show + baudrate and other values.

      +
    -

    A few entries use extensions (user-defined terminal - capabilities):

    +

    These changes were made to the other examples:

    • -

      E3, used in linux, putty and xterm-basic is - tested in the clear - program to erase a terminal's scrollback.

      +

      modify blue program to use + Unicode values for card-glyphs when available, as well as + improving the check for CP437 and CP850.

    • -

      TS is used in the - xterm+sl building block to help deprecate the misuse of - tsl for xterm's title-string.

      +

      improve demo_menus program, + allowing mouse-click on the menu-headers to switch the active + menu. This requires a new extension option + O_MOUSE_MENU to tell the menu driver to put + mouse events which do not apply to the active menu back into + the queue so that the application can handle the event.

    • -

      XT is used in some terminfo entries to - improve usefulness for other applications than screen, which - would like to pretend that xterm's title is a - status-line.

      +

      correct logic in demo_terminfo program for + “-f” option

    • -

      xm is used in examples - xterm-1005 and - xterm-1006 to illustrate a way to make mouse handling - more general

      +

      modify ditto program to + allow $XTERM_PROG environment variable to + override "xterm" as the name of the program to run in the + threaded configuration.

    • -
    -

    A few terminals support italics and/or dim capabilities. In - particular, screen does not. Documented that, and accommodated - the terminals where this feature works with the - A_ITALIC extension.

    +
  • +

    add several options to the “dots” + test-programs.

    +
  • -
      -
    • konsole, mlterm3 (italics)
    • +
    • +

      modify filter program:

      + +
        +
      • illustrate an alternative to getnstr, that + polls for input while updating a clock on the right margin + as well as responding to window size-changes.
      • + +
      • adapt logic used in dialog + “--keep-tite” option for + filter program as the "-a" + option. When set, filter + attempts to suppress the alternate screen.
      • +
      +
    • -
    • nsterm (dim)
    • +
    • +

      modify knight program to + provide the "slow" solution for small screens using + “R”, noting that Warnsdorf's method + is easily done with “a”.

      +
    • -
    • screen (dim)
    • +
    • +

      modify the savescreen + program to add test patterns that exercise 88-, 256-, etc., + colors.

      +
    • -
    • vte (dim, italics)
    • +
    • +

      add options to test_arrays, + for selecting termcap vs terminfo, etc.

      +
    • -
    • xterm (dim, italics)
    • -
    +
  • +

    modify the view + program:

    -

    Documentation

    +
      +
    • expand tabs using the ncurses library rather than in + the test-program.
    • -

      As usual, this release

      +
    • eliminate the “-n” option by + simply reading the whole file.
    • + +
    • implement page up/down commands.
    • + +
    • remove the very old SIGWINCH example; just + use KEY_RESIZE.
    • +
    +
  • -
    • -

      improves documentation by describing new features,

      +

      improve animation in xmas + program by adding a time-delay in blinkit.

    • -

      attempts to improve the description of features which - users have found confusing

      +

      modify several test-programs which call + use_default_colors to consistently do this only + if the “-d” option is given.

    • -

      fills in overlooked descriptions of features which were - described in the NEWS file - but treated sketchily in manual pages.

      +

      modify the install-rule for ncurses-examples to put the + data files in the data directory, e.g., + /usr/share/ncurses-examples.

    • -
    -

    In addition, the mechanism for producing HTML versions of the - documentation has been improved:

    +
  • +

    modify several test programs to use new + popup_msgs function, adapted from the + help-screen used in the edit_field program.

    +
  • -
    • -

      use an improved version of man2html - to generate html manpages.

      +

      modify test data for xterm palettes to use the newer + color4/color12 values.

    • -

      regenerated - NCURSES-Programming-HOWTO.html to fix some of the broken - html emitted by docbook.

      +

      improve the tracemunch + script:

      + +
        +
      • show screenXX pointers and thread identifiers as + names.
      • + +
      • chang address-parameters of add_wch, + color_content and pair_content to + dummy parameters.
      • +
    -

    Interesting - bug-fixes

    +

    Terminal + database

    + +

    There are several new terminal descriptions:

    + +
    +

    dumb-emacs-ansi, dvtm, + dvtm-256color, fbterm, + iterm2, linux-m1 minitel + entries, putty-noapp, viewdata, + and vt100+4bsd building-block.

    + +

    xterm+noalt, xterm+titlestack, + xterm+alt1049, xterm+alt+title + building blocks and xterm+direct, + xterm+indirect, xterm-direct. from + xterm + patch #331.

    + +

    several other “-direct” + descriptions to address the differences of other terminal + emulators versus xterm-direct.

    +
    + +

    There are many changes to existing terminal descriptions. Some + were updates to several descriptions:

      -
    • -

      Ada95 binding:

      +
    • use xterm+sm+1006 in several terminal + descriptions which were validated as supporting the extended + mouse feature for their respective terminal emulators.
    • + +
    • corrected sgr/sgr0 strings in a few cases + reported by tic, making those + correspond to the non-sgr settings where they differ, + but otherwise use ECMA-48 consistently.
    • + +
    • add 0.1sec mandatory delay to flash capabilities + using the VT100 reverse-video control
    • +
    +

    while others affected specific descriptions. These were + retested, to take into account new/undocumented changes by their + developers:

    + +
    +

    iterm, minitel, st, + viewdata, nsterm

    +
    + +

    while these are specific fixes based on user reports, or + warnings from tic:

    + +
    +
    + ansi building blocks
    + +
      -
    • -

      modify makefile rules to ensure that the PIC option is - not used when building a static library

      -
    • +
    • restored rmir/smir in + ansi+idc to better match original + ansiterm+idc, add alias + ansiterm
    • +
    +
    -
  • -

    make Ada95 build-fix for big-endian architectures such - as sparc. This undoes one of the fixes from - 20110319, which added an - “Unused” member to - representation clauses, replacing that with pragmas to - suppress warnings about unused bits.

    -
  • +
    + icl6402
    + +
    +
      +
    • corrected missing comma-separator between string + capabilities in icl6402 and + m2-nam
    - +
    -
  • -

    Color and attributes:

    +
    + interix
    +
      -
    • -

      parenthesize parameter of COLOR_PAIR and - PAIR_NUMBER in curses.h in case it happens - to be a comma-expression.

      -
    • +
    • updated using tack and + SFU with Windows 7 Ultimate.
    • -
    • -

      improve - 20021221 workaround for broken acs, handling a case - where that ACS_xxx character is not in the - acsc string but there is a known - wide-character which can be used.

      -
    • +
    • used ^? for kdch1
    • +
    +
    -
  • -

    modify - init_pair to accept -1's for color value after - - assume_default_colors has been called.

    -
  • +
    + linux
    -
  • -

    add a check in - start_color to limit color-pairs to 256 when extended - colors are not supported.

    -
  • +
    +
      +
    • made linux3.0 entry the default + linux entry
    • + +
    • modify linux2.6 entry to improve + line-drawing so that the linux3.0 entry can be + used in non-UTF-8 mode
    • + +
    • omitted selection of ISO-8859-1 for G0 in enacs + capability from linux2.6 entry, to avoid conflict with the + user-defined mapping. The reset feature uses ISO-8859-1 in + any case.
    • + +
    • modify flash capability for linux + and wyse entries to put the delay between the + reverse/normal escapes rather than after
    • + +
    • modify linux-16color to not mask dim, + standout or reverse with the ncv capability
    - +
    -
  • -

    Resizing the screen:

    +
    + pccon entries
    +
      -
    • -

      propagate error-returns from wresize, i.e., the - internal increase_size and decrease_size functions - through - resize_term.

      -
    • +
    • fixed some inconsistencies in the + pccon* entries
    • -
    • -

      add check for zero/negative dimensions for - resizeterm and resize_term.

      -
    • +
    • add bold to pccon+sgr+acs and + pccon-base
    • -
    • -

      modify resizeterm to always push a - KEY_RESIZE onto the fifo, even if screensize - is unchanged. Modify library to push a - KEY_RESIZE if there was a SIGWINCH, even if - it does not call resizeterm). These changes - eliminate the case where a SIGWINCH is received, but ERR - is returned from wgetch or - wgetnstr because the screen dimensions did - not change.

      -
    • +
    • add keys f12-f124 to pccon+keys
    -
  • + -
  • -

    Low-level interfaces

    +
    + tmux
    +
      -
    • -

      fix an old bug in the termcap emulation; - “%i” was ignored in - tparm because the parameters to be - incremented were already on the internal stack.

      -
    • +
    • corrected sgr string, which used + screen's "standout" code rather than the + standard code.
    • -
    • -

      change “%l” behavior in tparm - to push the string length onto the stack rather than - saving the formatted length into the output buffer.

      -
    • +
    • add settings corresponding to xterm-keys + option to reflect upcoming change to make that option + "on" by default
    • -
    • -

      modify name-comparison for tgetstr, etc., to - accommodate legacy applications as well as to improve - compatbility with BSD 4.2 termcap implementations (see - note for 980725).

      -
    • +
    • uncanceled Ms
    -
  • + -
  • High-level interfaces +
    + vt100
    +
      -
    • -

      modify internal recursion in wgetch which - handles cooked mode to check if the call to - wgetnstr returned an error. This can happen - when both nocbreak and nodelay - are set, for instance (see note for 960418).

      -
    • +
    • modify vt100 rs2 string to reset + vt52 mode and scrolling regions
    • -
    • -

      add a check in internal function - waddch_nosync to ensure that tab characters - are treated as control characters; some broken locales - claim they are printable.

      -
    • +
    • corrected rs2 string for + vt100-nam
    • -
    • -

      modify menu library to ensure that a menu's top-row is - adjusted as needed to ensure that the current item is on - the screen

      -
    • +
    • made minor fixes for vt100+4bsd, e.g., + delay in sgr for consistency
    • +
    +
    -
  • -

    fix special case where double-width character - overwrites a single- width character in the first - column.

    -
  • +
    + vte
    + +
    +
      +
    • moved SGR 24 and 27 from vte-2014 to + vte-2012
    • + +
    • add a few capabilities fixed in recent VTE + development
    +
    + +
    + xterm
    + +
    +
      +
    • add rep to xterm-new, available + since + late 1996.
    • + +
    • modify xterm+256color and + xterm+256setaf to use correct number of color + pairs.
    • + +
    • modify rs1 for xterm-16color, + xterm-88color and xterm-256color + to reset palette using oc string as in + linux entry.
    • + +
    • add rs1 capability to + xterm-256color
    • + +
    • add oc capability to + xterm+256color, allowing palette reset for + xterm
    • + +
    • add op to xterm+256setaf
    • + +
    • modify xterm-r5, xterm-r6 and + xterm-xf86-v32 to use xterm+kbs + to match + xterm #272, reflecting packager's changes
    • + +
    • used ANSI reply for u8 in + xterm-new, to reflect vt220-style responses + that could be returned.
    • + +
    • made xterm-pcolor sgr consistent + with other capabilities
    • +
    +
    +
    + +

    A few entries use extensions (user-defined terminal + capabilities):

    + +
      +
    • add rmxx/smxx ECMA-48 strikeout extension + to tmux and xterm-basic
    • + +
    • used RGB capability in new *-direct + entries to denote direct-color feature.
    • +
    + +

    Documentation

    + +

    As usual, this release

    + +
      +
    • +

      improves documentation by describing new features,

      +
    • + +
    • +

      attempts to improve the description of features which + users have found confusing

      +
    • + +
    • +

      fills in overlooked descriptions of features which were + described in the NEWS + file but treated sketchily in manual pages.

    -

    Configuration changes

    +

    In particular,

    -

    Major - changes

    +
      +
    • +

      Since the underlying features for + tset, + tput, and + clear have been better + integrated, the documentation now includes information on how + those tools evolved.

      -

      The ncurses 6.0 configure script - makes changes to the default value of several configure - options, depending on the --with-abi-version option - (i.e., whether its value is “5” or - “6”):

      +

      In addition to explaining the improved integration of the + tools, the manual pages made it easier to see how the tools + are similar and how they are different.

      +
    • -
      -
      --enable-const
      +
    • +

      The addch manual page has additional + information on + portability and differences from other + implementations.

      +
    • -
      -

      Feature introduced in 970405 - supports the use of const where X/Open Curses - should have, but did not. NetBSD curses does something - similar with const.

      -
      +
    • +

      The discussion of color-pairs in the attributes + manual page is improved in its + history section.

      +
    • -
      --enable-ext-colors
      +
    • +

      The documentation of the chtype, + cchar_t types and the attribute values which can + be stored in those types, in particular the + history and + portability sections of the attributes manual + page, has been improved.

      +
    • -
      -

      Extends the cchar_t structure to allow more - than 16 colors to be encoded. This applies only to the - wide-character (--enable-widec) - configuration.

      -
      +
    • +

      improve discussion of + portability in the mouse manual.

      +
    • -
      --enable-ext-mouse
      +
    • +

      The pad manual page has a section on the + origin and portability of pads.

      +
    • -
      -

      Modifies the encoding of mouse state to make room for a - 5th mouse button. That allows one to use ncurses with a wheel - mouse with xterm or similar X terminal emulators.

      -
      +
    • +

      Differences between SVr4 and X/Open Curses soft-keys are + discussed in a new section on + portability.

      +
    • -
      --enable-ext-putwin
      +
    • +

      There are updated/improved notes on portability in the + + resizeterm and + wresize manual pages.

      +
    • +
    -
    -

    Modifies the file-format written by putwin to - use printable text rather than binary files, allowing - getwin to read screen dumps written by - differently-configured ncurses libraries. The extended - getwin can still read binary screen dumps from - the same configuration of ncurses. This does not - change the ABI (the binary interface seen by calling - applications).

    -
    +

    In addition to providing background information to explain + these features and show how they evolved, there are corrections, + clarifications, etc.:

    -
    --enable-interop
    +
      +
    • +

      add note in the + addch manual about line-drawing when it depends + upon UTF-8.

      +
    • -
      -

      Modifies the FIELDTYPE structure used for the - form library to make it more generic.

      -
      +
    • +

      improve discussion of line-drawing characters in the + + add_wch manual.

      +
    • -
      --enable-lp64
      +
    • +

      explain in + clear's manual page that + it writes to the standard output.

      +
    • -
      -

      Allows an application to define _LP64 to - declare chtype and mmask_t as - simply “unsigned” rather than the - configured types using the --with-chtype and - --with-mmask_t options.

      -
      +
    • +

      improve description of + endwin.

      +
    • -
      --enable-sp-funcs
      +
    • +

      improve discussion of field validation in the + form driver manual page.

      +
    • -
      -

      Compile-in support for extended functions which accept a - SCREEN pointer, reducing the need for juggling the global SP - value with - set_term and - delscreen.

      -
      +
    • +

      clarify the use of wint_t vs + wchar_t in + get_wstr manual page.

      +
    • -
      --with-chtype=uint32_t
      +
    • +

      clarify in the + getch manual that the keypad mode affects an + application's ability to read KEY_MOUSE codes, + but does not affect KEY_RESIZE.

      -
      -

      Makes chtype explicitly a 32-bit unsigned - value.

      -
      +

      trim some obsolete/incorrect wording about + EINTR from the getch manual page

      -
      --with-mmask_t=uint32_t
      +

      improve manual pages for + getch and + get_wch to point out that they might return + user-defined values which have no predefined names in + <curses.h>

      +
    • -
      -

      Makes mmask_t explicitly a 32-bit unsigned - value.

      -
      +
    • +

      improve description of the -R option in the + + infocmp manual page

      +
    • -
      --with-tparm-arg=intptr_t
      +
    • +

      clarify in the + resizeterm manual page how + KEY_RESIZE is pushed onto the input stream.

      +
    • -
      -

      X/Open Curses declares - tparm using long for each of the parameters - aside from the formatting string, presuming that - long and char* are the same size. - This configure option uses intptr_t which - provides a better guarantee of the sizes.

      -
      - +
    • +

      document return value of + use_extended_names

      +
    • -

      The configure script no longer checks for antique compilers; - c89 is assumed as a minimum. There are a few - features from later revisions which are used when available. The - configure script makes checks to turn on useful warnings from - clang, gcc and icc. You should be able to build ncurses 6.0 with any of the current (or not so - current) C compilers available in 2015.

      - -

      The configure script, by the way, makes changes which do not - work with systems whose /bin/sh is non-POSIX. This - mainly affects Solaris (the other vendor unix systems have followed the POSIX guidelines - for the past twenty years). If you must build on Solaris, its - xpg4 - binaries suffice, e.g.,

      - -
      - - -

      - #!/bin/sh
      - WHAT=`hostname|sed -e 's/\..*//'`
      - - OUT=configure.out
      - cat >>$OUT <<EOF/
      - ** 
      `date`
      - ** node: 
      $WHAT
      - ** user: 
      `id`
      - ** conf: $*
      - EOF/

      -  
      - SHELL=/bin/sh
      - if test -f /usr/xpg4/bin/sh
      - - then
      -         CONFIG_SHELL=/usr/xpg4/bin/sh
      -         export CONFIG_SHELL
      - -         SHELL=$CONFIG_SHELL
      - fi
      -  
      - rm -f config.status config.cache
      - TOP=$HOME/$WHAT
      - $SHELL ./configure --verbose \
      - -         --disable-echo \
      - -         --disable-overwrite \
      - -         --enable-warnings \
      - -         --with-warnings \
      - -         --prefix=$TOP $* 2>&1 | tee -a $OUT
      - -

      -
      +
    • +

      document differences in + ESCDELAY versus AIX's implementation in the + variables manual page.

      +
    • -

      Other major changes to the configure script include:

      +
    • +

      The _nc_free_tinfo function is now documented + in the + memory-leaks manual page, because it could be + used in tack for memory-leak + checking.

      +
    • -
      • -

        ABI 6 is now the default, intending that the existing ABI - 5 should build as before using the - “--with-abi-version=5” option.

        +

        add a note to the + tic manual page about -W versus -f options.

      • -

        added --with-extra-suffix option to help with - installing nonconflicting ncurses6 packages, e.g., avoiding - header- and library-conflicts.

        +

        improve terminfo manual description of + terminfo syntax.

        -

        NOTE: as a side-effect, this renames

        +

        improve terminfo manual page discussion of + control- and graphics- characters.

        -
        -

        adacurses-config to - adacurses5-config and
        - adacursesw-config to - adacursesw5-config

        -
        +

        improve + color-handling section in terminfo manual page

        +
      • + +
      • +

        clarify description in + tput manual page regarding + support for termcap names

        + +

        update + tput manual page to + reflect changes to manipulate terminal modes by sharing + functions with tset.

        +
      • + +
      • +

        clarify in manual pages that the optional verbose option + level of + tic and + infocmp is available only + when ncurses is configured for + tracing.

      • -

        the configure script looks for gnatgcc if the Ada95 - binding is built, in preference to the default gcc/cc. The - script also ensures that the Ada95 binding is built with the - level of optimization as the C libraries.

        +

        improve manual page description of tset/reset + versus window-size.

      • -

        the configure script captures define's related to - -D_XOPEN_SOURCE from the configure check and adds those to - the *-config and *.pc files, to simplify use for the - wide-character libraries.

        +

        improve description of + tgoto parameters

      -

      Configuration options

      +

      There are new manual pages:

      -

      There are several new (or extended) configure options:

      +
        +
      • + user_caps documents the terminfo extensions used by + ncurses.
      • -
        -
        --disable-db-install
        +
      • +

        + scr_dump documents the screen-dump format.

        +
      • +
      -
      -

      Do not install the terminal database. This is used to omit - features for packages, as done with - --without-progs. The option simplifies building - cross-compile support packages.

      -
      +

      Some of the improvements are more subtle, relating to the way + the information is presented:

      -
      --disable-gnat-projects
      +
        +
      • +

        Made minor fixes to manpage NAME/SYNOPSIS + sections to consistently use rule that either all functions + which are prototyped in SYNOPSIS are listed in the + NAME section, or the manual-page name is the sole + item listed in the NAME section. The latter is used + to reduce clutter, e.g., for the top-level library manual + pages as well as for certain feature-pages such as + SP-funcs and + threading.

        +
      • -
        -

        This option is used for regression testing

        -
        +
      • +

        improve manual pages for utilities with respect to POSIX + versus X/Open Curses.

        +
      • -
        --disable-lib-suffixes
        +
      • +

        improve organization of the + attributes and color manual + pages.

        +
      • +
      -
      -

      Suppress the “w”, “t” or - “tw” suffixes which normally would be added to - the library names for the --enable-widec and - --with-pthread options.

      -
      +

      Interesting + bug-fixes

      -
      --with-cxx-shared
      +
        +
      • +

        modify toe to not exit if + unable to read a terminal description, e.g., if there is a + permission problem.

        +
      • -
        -

        When --with-shared is set, build libncurses++ - as a shared library. This implicitly relies upon building - with gcc/g++, since other compiler suites may have - differences in the way shared libraries are built. libtool by - the way has similar limitations.

        -
        +
      • +

        correct 20100515 change for weak signals versus + sigprocmask

        +
      • -
        --with-hashed-db
        +
      • work around Ada tool-breakage in Debian 9 and later by + invoking gprconfig to specify the C compiler to be + used by gnatmake, and conditionally suppressing + Library_Options line for static libraries.
      • -
        -

        Extended this configure option to simplify building with - different versions of Berkeley database using FreeBSD - ports.

        -
        +
      • +

        There were, as well, several bug-fixes to handle illegal + input for tic. Because those + did not correspond to useful terminal descriptions, most + users are unaffected.

        +
      • +
      -
      --with-pc-suffix
      +

      Configuration changes

      -
      -

      If ".pc" files are installed, optionally add a suffix to - the files and corresponding package names to separate unusual - configurations. If no option value is given (or if it is - "none"), no suffix is added. This option is used in the test - package for ncurses6.

      -
      +

      Major + changes

      -
      --with-xterm-kbs
      +

      This release provides a new binary format for terminal + descriptions that use extended numeric capabilities. Applications + built with the wide-character ncursesw library can use + these extended numbers.

      -
      -

      Configure xterm's terminfo entries to use either BS - (^H, i.e., ASCII backspace) or DEL - (^?, or 127).

      -
      - +
        +
      • +

        This includes utilities such as tic and infocmp, because (as noted in New features), the feature + relies upon an extension to the low-level tinfo + library.

        +
      • -

        Portability

        +
      • +

        A few software packagers use a configuration option of + ncurses which allows the + low-level tinfo library to be shared between the + high-level ncurses and ncursesw libraries. + This new feature was designed to work in that configuration + as well.

        +
      • +
      + +

      Other applications (i.e., using the 8-bit ncurses + library) which read the extended terminal descriptions see those + numeric capabilities set to the maximum value for a signed 16-bit + number.

      -

      MinGW

      +

      Older versions of ncurses' + tic accept out-of-range numeric + capabilities, storing those as the maximum value for a signed + 16-bit number. Other implementations of curses (mentioned in the + discussion of + picsmap) give zero for these + out-of-range capabilities.

      -

      Most of the portability-related work since - ncurses 5.9 extended and improved the MinGW port - introduced in - ncurses 5.8.

      +

      Configuration options

      -

      The MinGW port can be readily cross-compiled:

      +

      These changes provide support for tack 1.08, released in + July 2017:

      • -

        modified configure script to allow creating dll's for - MinGW when cross-compiling.

        +

        add --without-tack configure option to refine + --with-progs configure option. Normally + tack is built outside the + ncurses tree, but a few + packagers combine it during the build. If + term_entry.h is installed, there is no advantage + to in-tree builds.

      • -

        enforced Windows-style path-separator if - cross-compiling,

        +

        adjust configure-script to define + HAVE_CURSES_DATA_BOOLNAMES symbol needed for + tack 1.08 when built in-tree. + Rather than relying upon internal "_nc_" functions, + tack now uses the boolean, + number and string capability name-arrays provided by + ncurses and SVr4 Unix curses. + It still uses term_entry.h for the definitions + of the extended capability arrays.

      • -

        added scripts for test-builds of cross-compiled packages - for ncurses6 to MinGW.

        +

        add dependency upon ncurses_cfg.h to tic's header-files; any program using + tic-library will have to + supply this file. Legacy tack + versions supply this file; ongoing tack development has dropped the + dependency upon tic-library + and new releases will not be affected.

      • +
      + +

      Other changes to the configure-script and generated files + include

      +
      • -

        added pc-files to the MinGW cross-compiling - test-packages.

        +

        add configure options to disable checks for form, menu and + panel libraries so that ncurses-examples can be built with + non-SVr4 curses implementations.

      • -

        added script for building test-packages of binaries - cross-compiled to MinGW using NSIS.

        +

        add configure option --enable-opaque-curses + for ncurses library and similar options for the + other libraries.

      • -

        added nc_mingw.h to installed headers for - MinGW port; this is needed for cross-compiling ncurses-examples.

        +

        add configure option --disable-wattr-macros + for use in cases where one wants to use the same headers for + ncurses5/ncurses6 development, by suppressing the + wattr* macros which differ due to the introduction + of extended colors

      • -

        added test-packages for cross-compiling ncurses-examples - using the MinGW test-packages.

        +

        modify configure macro for shared-library rules to use + -Wl,-rpath rather than -rpath to + work around a bug in scons

      • -
      -

      The MinGW-specific Windows driver accounts for several - changes:

      - -
      • -

        wide-character display is made usable by replacing MinGW's - non-working wcrtomb and wctomb - functions.

        +

        improve ncurses-examples' configure script to define as + needed NCURSES_WIDECHAR for platforms where + _XOPEN_SOURCE_EXTENDED does not work. Also + modified the test program to ensure that if building with + ncurses, that the + cchar_t type is checked, since that is normally + (since 20111030) + ifdef'd depending on this test.

      • -

        implemented some display features: beep, - flash, - - curs_set.

        +

        modify configure script to handle the case where + tic-library is renamed, but + the --with-debug option is used by itself + without normal or shared libraries

      • -

        the driver handles repainting on endwin/refresh - combination.

        +

        modify editing script which generates resulting.map to + work with the clang configuration on recent FreeBSD, which + gives an error on an empty "local" section.

      • -

        modified treatment of TERM variable for MinGW - port to allow explicit use of the Windows console driver by - checking if $TERM is set to - “#win32console” or an abbreviation - of that.

        +

        improve configure check for setting the + WILDCARD_SYMS variable; on ppc64 the variable is + in the Data section rather than + Text.

      • -

        the Windows driver also matches the special - TERM value “unknown”

        +

        correct result of configure option + --without-fallbacks, which caused FALLBACK_LIST + to be set to "no"

      • -

        the driver now returns characters for special keys, (like - ansi.sys does), when keypad mode is off, rather - than returning nothing at all.

        +

        modify --with-pkg-config-libdir option to + make it possible to install “.pc” files even if + pkg-config is not found. Limit + this change, to suppress the actual install if it is not + overridden to a valid directory at install time.

      • -

        the driver checks a new environment variable - NCURSES_CONSOLE2 to optionally work around a deficiency - in Console2 (and its descendent - ConsoleZ) which hang when an application creates - a console buffer.

        +

        disallow “no” as a possible value for + --with-shlib-version option, overlooked in + cleanup-changes for 20000708.

      -

      Finally, there are other improvements:

      +

      Portability

      + +

      Many of the portability changes are implemented via the + configure script:

      • -

        MinGW is one of the configurations where ncurses installs by default into /usr

        +

        improve configure script's CF_CC_ENV_FLAGS + macro to allow for compiler wrappers such as ccache. This change moves only the + preprocessor, optimization and warning flags to + CPPFLAGS and CFLAGS, leaving the + residue in CC. That happens to work for + gcc's various + “model” options, but may require tuning for other + compilers.

      • -
      • configuration for cross-compiling uses AC_CHECK_TOOLS in - preference to AC_PATH_PROGS when searching for ncurses*-config, - e.g., in Ada95/configure and test/configure.
      • -
      • -

        extend Windows support to work with MSYS2;

        - -
          -
        • -

          this works with a scenario where there is an - ANSI-escape handler such as ansicon running - in the console window.

          -
        • - -
        • wrap isatty calls with a macro, provide a - corresponding set of support routines to address - differences between MinGW and MSYS2.
        • -
        +

        modify ncurses-examples' configure script to use + pkg-config for the extra + form/menu/panel libraries, to be more consistent with the + handling of the curses/ncurses library.

      • -

        ensure WINVER is defined in makefiles rather - than using headers.

        +

        add configuration checks to build with NetBSD + curses, which for example lacks + use_env.

      • -

        add check for the gnatprep - “-T” option.

        +

        change ncurses-examples to use attr_t vs + chtype to follow X/Open documentation more + closely since Solaris xpg4-curses uses different values for + WA_xxx vs A_xxx + that rely on attr_t being an unsigned short. Tru64 aka OSF1, + HPUX, AIX did as ncurses does, + equating the two sets.

      • -

        work around a bug introduced by - gcc 4.8.1 in MinGW which breaks "trace" feature.

        +

        modify several test programs to reflect that ncurses honors existing signal handlers in + initscr, while other implementations do not.

      • -

        add a driver-name method to each of the drivers.

        +

        add configure check for openpty to + ncurses-examples' configure script, for ditto.

      • -
      - -

      Other - ports

      -

      These changes affect certain platforms (ports):

      +
    • +

      improve check for working poll function by + using posix_openpt as a fallback in case there + is no valid terminal on the standard input

      +
    • -
      • -

        the configure script knows how to build shared libraries - with DragonFlyBSD and Interix.

        +

        modify ncurses-examples' configure script to check for + pthread dependency of + ncursest or ncursestw library when building + the ncurses examples, e.g., in + case weak symbols are used.

      • -

        support for AIX shared libraries is improved, tested with - AIX 5.3, 6.1 and 7.1 with both gcc 4.2.4 and cc:

        +

        add checks in ncurses-examples' configure script for some + functions neither in 4.3BSD curses, nor based on X/Open + Curses:

        • -

          the shared-library suffix for AIX 5 and 6 is now - ".so"

          +

          modify a loop limit in firework.c to work around + absense of limit checks in some libraries.

        • -

          the -brtl option is used with AIX 5-7; it - is needed to link with the shared libraries.

          +

          fill the last row of a window with + “?” in firstlast if waddch does + not return ERR on the lower-right + corner.

      • -

        the configure --enable-pc-files option takes - into account the PKG_CONFIG_PATH - variable.

        -
      • +

        build-fixes for the Portland Group (PGI) compilers

        -
      • -

        the configure option --with-pkg-config-libdir - provides control over the actual directory into which - pc-files are installed.

        -
      • +
          +
        • +

          accept whitespace in sed expression for generating + expanded.c

          +
        • -
        • -

          the build scripts add explicit -ltinfo, etc., to the - generated ".pc" file when ld option - “--as-needed” is used, or when - ncurses and tinfo are installed without using rpath.

          +
        • +

          modify configure check that g++ compiler warnings are + not used.

          +
        • + +
        • +

          add configure check for -fPIC option needed for shared + libraries.

          +
        • +
      • -

        the configure script disallows conflicting options - “--with-termlib” and - “--enable-term-driver”.

        +

        modify configure script for clang as used on FreeBSD, to + work around clang's differences in exit codes vs gcc.

      • -

        the check for missing c++ compiler to work when no error - is reported, and no variables set is improved (see note for - 20021206).

        +

        fixes for configure/build using clang on OSX

        + +
          +
        • +

          do not redefine “inline” in + ncurses_cfg.h; this was originally to solve + a problem with gcc/g++, but is aggravated by clang's + misuse of symbols to pretend it is gcc.

          +
        • + +
        • +

          add braces to configure script to prevent unwanted + addition of “-lstdc++” option to + the CXXLIBS symbol.

          +
        • + +
        • +

          improve/update test-program used for checking + existence of stdc++ library.

          +
        • + +
        • +

          if $CXXLIBS is set, the linkage test uses + that in addition to $LIBS.

          +
        • +
      • -

        the misc/gen_edit.sh script selects a "linux" entry which - works with the current kernel rather than assuming it is - always "linux3.0"

        +

        fixes for OS/2:

        + +
          +
        • +

          use button instead of kbuf[0] in + EMX-specific part of lib_mouse.c

          +
        • + +
        • +

          support building with libtool on OS/2

          +
        • + +
        • +

          use stdc++ library with OS/2 kLIBC

          +
        • + +
        • +

          clear configure script's cf_XOPEN_SOURCE + for OS/2, to work with its header files

          +
        • +
      • -

        the test/configure script makes it simpler to override - names of curses-related libraries, to help with linking with - pdcurses in MinGW environment.

        +

        add “newer” baudrate symbols to the + baudrate function in the ncurses library as + well as to a corresponding table in tset.

      • -

        the configure-script/ifdef's allow the BSD OLD_TTY feature - to be suppressed if the type of ospeed is - configured using the option --with-ospeed to not - be a short. By default, it is a - short for termcap-compatibility.

        +

        modify ncurses-examples savescreen to work with AIX and HPUX.

      • -

        the MKlib_gen.sh script works around a recent change in - gcc 5 (released mid-2015) which essentially - emits multiple #line statements for the same - position in a file.

        +

        define WIN32_LEAN_AND_MEAN for MinGW port, + making builds faster.

      • -

        the configure script works with Minix3.2 (see note - on portability)

        +

        add a configure check for wcwidth versus the + ncurses line-drawing + characters, to use in special-casing systems such as Solaris. + Solaris, however, requires a special case that maps Unicode + line-drawing characters into the acsc string for non-Unicode + locales. Solaris also has a misconfigured wcwidth which marks + all of the line drawing characters as double-width.

      • -

        OS/2 redux:

        +

        string-hacks (non-standard):

        • -

          the configure script supports OS/2 kLIBC.

          +

          fix configure script to record when + strlcat is found on OpenBSD.

          +
        • + +
        • +

          add --enable-string-hacks option to + ncurses-examples' configure script.

        • -

          the --with-lib-prefix option allows - configuring for old/new flavors of OS/2 EMX.

          +

          completed string-hacks for sprintf, etc., + including the ncurses-examples programs.

          +
        • + +
        • +

          make --enable-string-hacks option work + with Debian by checking for the "bsd" library and its + associated "<bsd/string.h>" header.

      • -

        improved configure-script checks for - _XOPEN_SOURCE:

        +

        workaround for Debian's antique/unmaintained version of + mawk:

        • -

          the definition works starting with Solaris 10.

          +

          see Debian #65617, which was fixed in mawk's upstream releases in + 2009.

        • -

          the definition is suppressed for IRIX64, since its - header files have a conflict versus - _SGI_SOURCE.

          +

          related fixes when building link_test.


      -

      Features of ncurses

      +

      Features of + ncurses

      -

      The ncurses package is fully +

      The ncurses package is fully upward-compatible with SVr4 (System V Release 4) curses:

        @@ -1836,14 +2355,14 @@ fflush(stdout);
      • -

        ncurses supports all of the +

        ncurses supports all of the for SVr4 curses features including keyboard mapping, color, forms-drawing with ACS characters, and automatic recognition of keypad and function keys.

      • -

        ncurses provides these SVr4 +

        ncurses provides these SVr4 add-on libraries (not part of X/Open Curses):

          @@ -1865,14 +2384,16 @@ fflush(stdout);
        • -

          ncurses's terminal database is - fully compatible with that used by SVr4 curses.

          +

          ncurses's terminal database + is fully compatible with that used by SVr4 curses.

            -
          • ncurses supports - user-defined capabilities which it can see, but which are - hidden from SVr4 curses applications using the - same terminal database.
          • +
          • +

            ncurses supports + user-defined capabilities which it can see, but which are + hidden from SVr4 curses applications using the + same terminal database.

            +
          • It can be optionally configured to match the format @@ -1880,23 +2401,23 @@ fflush(stdout);

          • -

            Alternatively, ncurses can - be configured to use hashed databases rather than the +

            Alternatively, ncurses + can be configured to use hashed databases rather than the directory of files used by SVr4 curses.

        • -

          The ncurses utilities have +

          The ncurses utilities have options to allow you to filter terminfo entries for use with less capable curses/terminfo versions such as the HP/UX and AIX ports.

        -

        The ncurses package also has many - useful extensions over SVr4:

        +

        The ncurses package also has + many useful extensions over SVr4:

        • @@ -1909,7 +2430,7 @@ fflush(stdout);
        • -

          Unlike SVr3 curses, ncurses +

          Unlike SVr3 curses, ncurses can write to the rightmost-bottommost corner of the screen if your terminal has an insert-character capability.

        • @@ -1942,9 +2463,9 @@ fflush(stdout);
        • The functions keyok and define_key allow you to better control the use - of function keys, e.g., disabling the ncurses KEY_MOUSE, or by defining more than - one control sequence to map to a given key code.

          + of function keys, e.g., disabling the ncurses KEY_MOUSE, or by defining more + than one control sequence to map to a given key code.

        • @@ -1992,20 +2513,22 @@ fflush(stdout);
        • The tic/captoinfo - utility provided with ncurses has - the ability to translate many termcaps from the XENIX, IBM - and AT&T extension sets.

          + "https://invisible-island.net/ncurses/man/tic.1m.html"> + tic/captoinfo + utility provided with ncurses + has the ability to translate many termcaps from the XENIX, + IBM and AT&T extension sets.

        • A BSD-like tset - utility is provided.

          + "https://invisible-island.net/ncurses/man/tset.1.html"> + tset utility is provided.

        • -

          The ncurses library and +

          The ncurses library and utilities will automatically read terminfo entries from $HOME/.terminfo if it exists, and compile to that directory if it exists and the user has no write access to the system @@ -2030,9 +2553,9 @@ fflush(stdout);

        • The table-of-entries utility toe - makes it easy for users to see exactly what terminal types - are available on the system.

          + "https://invisible-island.net/ncurses/man/toe.1m.html"> + toe makes it easy for users to see exactly what + terminal types are available on the system.

        • @@ -2044,46 +2567,55 @@ fflush(stdout);
        • Extensive documentation is provided (see the + "https://invisible-island.net/ncurses/ncurses.faq.html#additional_reading"> Additional Reading section of the - ncurses FAQ for online documentation).

          + "https://invisible-island.net/ncurses/ncurses.faq.html"> + ncurses FAQ for online documentation).

        Applications using - ncurses

        + ncurses -

        The ncurses distribution includes - a selection of test programs (including a few games). These are - available separately as ncurses-examples

        +

        The ncurses distribution + includes a selection of test programs (including a few games). + These are available separately as ncurses-examples

        The ncurses library has been tested with a wide variety of applications including:

        -
        cdk
        +
        aptitude
        + +
        +

        FrontEnd to Apt, the debian package manager

        + +

        https://wiki.debian.org/Aptitude

        +
        + +
        cdk

        Curses Development Kit

        http://invisible-island.net/cdk/
        + "https://invisible-island.net/cdk/">https://invisible-island.net/cdk/

        -
        ded
        +
        ded

        directory-editor

        http://invisible-island.net/ded/

        + "https://invisible-island.net/ded/">https://invisible-island.net/ded/

        -
        dialog
        +
        dialog

        the underlying application used in Slackware's setup, @@ -2091,56 +2623,57 @@ fflush(stdout); many systems.

        http://invisible-island.net/dialog/

        + "https://invisible-island.net/dialog/">https://invisible-island.net/dialog/

        -
        lynx
        +
        lynx

        the text WWW browser

        http://lynx.isc.org/

        + "https://lynx.invisible-island.net/">https://lynx.invisible-island.net/

        -
        Midnight Commander
        +
        mutt
        -

        file manager

        +

        mail utility

        http://www.midnight-commander.org/

        + "http://www.mutt.org/">http://www.mutt.org/

        -
        mutt
        +
        ncftp
        -

        mail utility

        +

        file-transfer utility

        http://www.mutt.org/

        + "https://www.ncftp.com/">https://www.ncftp.com/

        -
        ncftp
        +
        nvi
        -

        file-transfer utility

        +

        New vi uses ncurses.

        http://www.ncftp.com/

        + "https://sites.google.com/a/bostic.com/keithbostic/vi">https://sites.google.com/a/bostic.com/keithbostic/vi
        +

        -
        nvi
        +
        ranger
        -

        New vi uses ncurses.

        +

        A console file manager with VI key bindings in + Python.

        https://sites.google.com/a/bostic.com/keithbostic/nvi
        -

        + "https://ranger.github.io/">https://ranger.github.io/

        -
        tin
        +
        tin

        newsreader, supporting color, MIME

        @@ -2148,24 +2681,32 @@ fflush(stdout);

        http://www.tin.org/

        + +
        vifm
        + +
        +

        File manager with vi like keybindings

        + +

        https://vifm.info/

        +
        -

        as well as some that use ncurses - for the terminfo support alone:

        +

        as well as some that use ncurses for the terminfo support alone:

        -
        minicom
        +
        minicom

        terminal emulator for serial modem connections

        http://alioth.debian.org/projects/minicom/

        + "https://alioth.debian.org/projects/minicom/">https://alioth.debian.org/projects/minicom/

        -
        mosh
        +
        mosh

        a replacement for ssh.

        @@ -2174,32 +2715,32 @@ fflush(stdout); "https://mosh.mit.edu/">https://mosh.mit.edu/

        -
        tack
        +
        tack

        terminfo action checker

        http://invisible-island.net/ncurses/tack.html

        + "https://invisible-island.net/ncurses/tack.html">https://invisible-island.net/ncurses/tack.html

        -
        tmux
        +
        tmux

        terminal multiplexor

        http://tmux.github.io/

        + "https://github.com/tmux/tmux/wiki">https://github.com/tmux/tmux/wiki

        -
        vile
        +
        vile

        vi-like-emacs may be built to use the terminfo, termcap or curses interfaces.

        http://invisible-island.net/vile/

        + "https://invisible-island.net/vile/">https://invisible-island.net/vile/

        @@ -2208,31 +2749,41 @@ fflush(stdout);
        -
        emacs
        +
        emacs

        text editor

        http://www.gnu.org/software/emacs/

        + "https://www.gnu.org/software/emacs/">https://www.gnu.org/software/emacs/

        +
        + +
        less
        + +
        +

        The most commonly used pager (a program that + displays text files).

        + +

        http://www.greenwoodsoftware.com/less/

        -
        screen
        +
        screen

        terminal multiplexor

        http://www.gnu.org/software/screen/

        + "https://www.gnu.org/software/screen/">https://www.gnu.org/software/screen/

        -
        vim
        +
        vim

        text editor

        http://www.vim.org/

        + "https://www.vim.org/">https://www.vim.org/

        @@ -2240,14 +2791,14 @@ fflush(stdout);

        Development activities

        -

        Zeyd Ben-Halim started ncurses +

        Zeyd Ben-Halim started ncurses from a previous package pcurses, written by Pavel Curtis. Eric S. Raymond continued development. Jürgen Pfeifer wrote most of the form and menu libraries. Ongoing development work is done by Thomas Dickey. Thomas Dickey also acts as the maintainer for the Free Software Foundation, which holds the copyright + "https://invisible-island.net/ncurses/ncurses-license.html">copyright on ncurses.

        Contact the current maintainers at

        @@ -2271,12 +2822,15 @@ fflush(stdout);

        This list is open to anyone interested in helping with the development and testing of this package.

        -

        Beta versions of ncurses and +

        Beta versions of ncurses and patches to the current release are made available at

        ftp://invisible-island.net/ncurses/ .

        + "ftp://ftp.invisible-island.net/ncurses/">ftp://ftp.invisible-island.net/ncurses/ + and
        + https://invisible-mirror.net/archives/ncurses/ .

        There is an archive of the mailing list here:

        @@ -2296,34 +2850,28 @@ fflush(stdout); @@ -2334,8 +2882,9 @@ fflush(stdout); terminfo-format terminal description file once maintained by Eric Raymond . Unlike the older version, the termcap and - terminfo data are provided in the same file, and provides several - user-definable extensions beyond the X/Open specification.

        + terminfo data are provided in the same file, which also provides + several user-definable extensions beyond the X/Open + specification.

        You can find lots of information on terminal-related topics not covered in the terminfo file at Library improvements

      • @@ -2392,23 +2938,15 @@ fflush(stdout);
      -
    • - Portability - - -
    • +
    • Portability
    -
  • Features of ncurses
  • +
  • Features of ncurses
  • -
  • Applications using ncurses
  • +
  • Applications using ncurses
  • Development activities
  • diff --git a/dist.mk b/dist.mk index 35191a66..aa799ca9 100644 --- a/dist.mk +++ b/dist.mk @@ -25,7 +25,7 @@ # use or other dealings in this Software without prior written # # authorization. # ############################################################################## -# $Id: dist.mk,v 1.1205 2018/01/21 00:48:08 tom Exp $ +# $Id: dist.mk,v 1.1207 2018/01/22 11:42:46 tom Exp $ # Makefile for creating ncurses distributions. # # This only needs to be used directly as a makefile by developers, but @@ -36,8 +36,8 @@ SHELL = /bin/sh # These define the major/minor/patch versions of ncurses. NCURSES_MAJOR = 6 -NCURSES_MINOR = 0 -NCURSES_PATCH = 20180121 +NCURSES_MINOR = 1 +NCURSES_PATCH = 20180127 # We don't append the patch to the version, since this only applies to releases VERSION = $(NCURSES_MAJOR).$(NCURSES_MINOR) diff --git a/doc/html/ada/terminal_interface-curses_constants__ads.htm b/doc/html/ada/terminal_interface-curses_constants__ads.htm index c541c9b8..e57ea4a0 100644 --- a/doc/html/ada/terminal_interface-curses_constants__ads.htm +++ b/doc/html/ada/terminal_interface-curses_constants__ads.htm @@ -36,8 +36,8 @@ -- Version of the ncurses library from extensions(3NCURSES) NCURSES_VERSION_MAJOR : constant := 6; - NCURSES_VERSION_MINOR : constant := 0; - Version : constant String := "6.0"; + NCURSES_VERSION_MINOR : constant := 1; + Version : constant String := "6.1"; -- Character non-color attributes from attr(3NCURSES) diff --git a/doc/html/announce.html b/doc/html/announce.html index 694848a1..45c0c125 100644 --- a/doc/html/announce.html +++ b/doc/html/announce.html @@ -1,7 +1,7 @@ - + - Announcing ncurses 6.0 + Announcing ncurses 6.1 -

    Announcing ncurses 6.0

    +

    Announcing ncurses 6.1

    Overview

    -

    The ncurses (new curses) library - is a free software emulation of curses in System V Release 4.0 - (SVr4), and more. It uses terminfo format, supports pads and - color and multiple highlights and forms characters and +

    The ncurses (new curses) + library is a free software emulation of curses in System V + Release 4.0 (SVr4), and more. It uses terminfo format, supports + pads and color and multiple highlights and forms characters and function-key mapping, and has all the other SVr4-curses - enhancements over BSD curses. SVr4 curses is better known today - as X/Open Curses.

    + enhancements over BSD curses. SVr4 curses became the basis of + X/Open Curses.

    In mid-June 1995, the maintainer of 4.4BSD curses declared that he considered 4.4BSD curses obsolete, and encouraged the - keepers of unix releases such as - BSD/OS, FreeBSD and NetBSD to switch over to ncurses.

    + keepers of unix releases such as + BSD/OS, FreeBSD and NetBSD to switch over to ncurses.

    -

    Since 1995, ncurses has been +

    Since 1995, ncurses has been ported to many systems:

      @@ -78,11 +87,12 @@ p,li { max-width:700px; } first of these was EMX on OS/2 Warp.
    • It is used (though usually not as the system - curses) on all of the vendor unix - systems, e.g., AIX, HP-UX, IRIX64, SCO, Solaris, Tru64.
    • + curses) on all of the vendor unix systems, e.g., AIX, HP-UX, IRIX64, SCO, + Solaris, Tru64.
    • It should work readily on any ANSI/POSIX-conforming - unix.
    • + unix.

    The distribution includes the library and support utilities, @@ -90,1743 +100,2252 @@ p,li { max-width:700px; }

    • captoinfo, - a termcap conversion tool
    • + "https://invisible-island.net/ncurses/man/captoinfo.1m.html"> + captoinfo, a termcap conversion tool
    • clear, - utility for clearing the screen
    • + "https://invisible-island.net/ncurses/man/clear.1.html"> + clear, utility for clearing the screen
    • infocmp, - the terminfo decompiler
    • + "https://invisible-island.net/ncurses/man/infocmp.1m.html"> + infocmp, the terminfo decompiler
    • tabs, - set tabs on a terminal
    • + "https://invisible-island.net/ncurses/man/tabs.1.html"> + tabs, set tabs on a terminal
    • tic, - the terminfo compiler
    • + "https://invisible-island.net/ncurses/man/tic.1m.html"> + tic, the terminfo compiler
    • toe, - list (table of) terminfo entries
    • + "https://invisible-island.net/ncurses/man/toe.1m.html"> + toe, list (table of) terminfo entries
    • tput, - utility for retrieving terminal capabilities in shell - scripts
    • + "https://invisible-island.net/ncurses/man/tput.1.html"> + tput, utility for retrieving terminal capabilities + in shell scripts
    • tset, - to initialize the terminal
    • + "https://invisible-island.net/ncurses/man/tset.1.html"> + tset, to initialize the terminal

    Full manual pages are provided for the library and tools.

    -

    The ncurses distribution is - available via anonymous FTP at the GNU distribution site

    +

    The ncurses distribution is + available at ncurses' homepage:

    ftp://ftp.gnu.org/gnu/ncurses/ .

    -
    It is also available at + "ftp://ftp.invisible-island.net/ncurses/">ftp://ftp.invisible-island.net/ncurses/ + or
    + https://invisible-mirror.net/archives/ncurses/ .

    + + +

    It is also available via anonymous FTP at the GNU distribution + site

    ftp://invisible-island.net/ncurses/ .

    + "ftp://ftp.gnu.org/gnu/ncurses/">ftp://ftp.gnu.org/gnu/ncurses/ .

    Release Notes

    -

    These notes are for ncurses - 6.0, released August 8, 2015.

    +

    These notes are for ncurses + 6.1, released January 27, 2018.

    This release is designed to be source-compatible with - ncurses 5.0 through 5.9; providing a - new application binary interface (ABI). Although the source can - still be configured to support the ncurses 5 ABI, the intent of the release is to - provide extensions which are generally useful, but - binary-incompatible with ncurses - 5:

    + ncurses 5.0 through 6.0; providing + extensions to the application binary interface (ABI). Although + the source can still be configured to support the ncurses 5 ABI, the intent of the release is to + provide extensions to the ncurses + 6 ABI:

    • -

      Extend the cchar_t structure to allow more - than 16 colors to be encoded.

      +

      improve integration of tput + and tset

    • -

      Modify the encoding of mouse state to make room for a 5th - mouse button. That allows one to use ncurses with a wheel mouse with xterm or - similar X terminal emulators.

      +

      provide support for extended numeric capabilities.

    -

    There are, of course, numerous other improvements, - including

    +

    There are, of course, numerous other improvements, listed in + this announcement.

    + +

    The release notes also mention some bug-fixes, but are focused + on new features and improvements to existing features since + ncurses 6.0 release.

    + +

    Library + improvements

    + +

    New + features

    + +

    The improved integration of tput and tset + made only small changes to the libraries. However, supporting + extended numeric capabilities required a few changes:

    • -

      fixes made based on the Clang and Coverity static - analyzers.

      +

      The TERMINAL structure in + <term.h> is now opaque. Doing that allowed + making the structure larger, to hold the extended numeric + data.

      + +

      A few applications required changes during development of + ncurses 6.1 because those + applications misused the members of that structure, e.g., + directly modifying it rather than using + def_prog_mode.

    • -

      memory leak fixes using Valgrind

      -
    • -
    +

    Having made TERMINAL opaque (and because none + of the library functions use anything except a pointer to + TERMINAL), it was possible to increase the size + of the structure, adding to the end.

    -

    The release notes mention some bug-fixes, but are focused on - new features and improvements to existing features log since - ncurses 5.9 release.

    +

    Existing applications which were linked to the + ncurses 6.0 high-level + (ncurses, ncursesw) and low-level + (tinfo, tinfo) libraries should not require + re-linking since the binary interface did not change, nor did + the structure offsets with TERMINAL change.

    -

    While the intent of the release is to provide a new stable - ABI, there are other development activities which are summarized - below.

    +

    A few applications use the inner TERMTYPE + structure's offsets to refer to terminfo capabilities within + that structure. Again, those do not require modification + because their offsets within TERMINAL did not + change.

    + -
    • -

      The original release plan, e.g., for "5.10" was to improve - the MinGW port. Ultimately that was completed (wide-character - support, mouse, etc), but was deferred to focus on termcap - support and performance issues. Also, pinpointing the - problems with Console2 took a while.

      +

      When configured for wide-characters, i.e., + “ncursesw” the TERMINAL structure is + extended.

      + +

      The new data in TERMINAL holds the same + information as TERMTYPE, but with larger numbers + (“int” versus “short”). It is named + TERMTYPE2.

      + +

      The library uses this structure internally in preference + to TERMTYPE, referring to TERMTYPE + only to initialize it for applications that use the + capabilities defined in <term.h>

    • -

      A review of termcap compatibility in 2011 led to several - minor fixes in the library and improvements to utilities. To - do this properly, a review of the various extent termcap - implementations was needed.

      +

      When configured for 8-bit (narrow) characters, the + TERMTYPE2 structure is not used.

      +
    • -

      The termcap - library checker (tctest) (not part of ncurses) was one result. A followup review - of performance using ncurses-examples - in 2014 led to additional improvements.

      +
    • The updated application binary interface is 6.1.20171230 + (used for new versioned + symbols), although the interface changes were developed + several months previously.
    • +
    + +

    The motivation for making this extension came from noticing + that + termcap applications could (though not + realistically) use larger numbers than would fit in 16-bits, + and the fact that the number of color pairs for a 256-color xterm + could not be expressed in terminfo (i.e., 32767 versus 65536). + Also, a few terminals support direct-colors, which could use the + extension.

    + +

    Generally speaking, applications that use internal details of + a library are unsupported. There was exactly one exception for + ncurses: the tack program used the internal + details of TERMINAL, because it provides an + ncurses-specific feature for interactively modifying a terminfo + description and writing the updated description to a text-file. + It was possible to not only separate tack from these internal + details of ncurses, but to + generalize it so that the program works with Unix curses + (omitting the ncurses-specific feature). That was released as + + tack 1.08 in July + 2017.

    + +

    While making changes to tack to + eliminate its dependency upon ncurses internals, the publicly-visible + details of those internals were reviewed, and some symbols were + moved to private header files, while others were marked + explicitly as ncurses internals. + Future releases of ncurses may + eliminate some of those symbols (such as those used by + tack 1.07) because they are + neither part of the API or the ABI.

    + +

    Using the TERMTYPE2 extended numeric + capabilities, it is possible to support both color pair values + and color values past 32767. Taking compatibility into account, + developers readily understand that neither function signatures + nor structure offsets change. Also, existing functions have to + operate with the extended numbers. Most of that work is internal + to the library. For the external interfaces, a hybrid approach + was used:

    + +
      +
    • +

      X/Open Curses defined function prototypes such as + wattr_set with an unused parameter, for + “future” use. After 25 years, the future is here: + ncurses uses the parameter to + augment color pair values as described in the + manual page.

    • -

      Output buffering provided a further, but worthwhile - distraction. A bug report in 2012 regarding the use of signal - handlers in ncurses) pointed out - - a problem with the use of unsafe functions for handling - SIGTSTP. Other signals could be addressed with - workarounds; repairing SIGTSTP required a - different approach. The solution required changing internal - behavior of the library: how it handles output buffering.

      - -

      Now ncurses buffers its own - output, independently of the standard output. A few - applications relied upon the library's direct reuse of the - standard output buffering; however that is - unspecified behavior and has never been a - recommended practice. Identifying these applications as well - as refining the change to permit low-level applications to - work consistently took time.

      -
    • - -
    • -

      Since the introduction of the experimental support for 256 - colors early in 2005 - (released in ncurses - 5.5), there has been increased user interest. Almost all - packagers continue providing the ncurses ABI 5 which cannot - support 256 colors.

      -
    • - -
    • -

      Symbol versioning, or the lack of it in ncurses, is the - main reason why packagers would be reluctant to add a new - ncurses ABI.

      - -

      This release provides the new ABI along with - script-generated lists of versioned symbols which can be used - for both ABI 5 and 6 (with distinct names to keep the two - separate). This took time to development, as reported in - Symbol - versioning in ncurses.

      +

      Other functions such as those defining color pairs did not + have a corresponding reserved parameter. For those, + ncurses defines extended + versions such as init_extended_pair (versus + init_pair), init_extended_color + (versus init_color).

    -

    Library - improvements

    +

    Additionally, to improve performance other changes (and + extensions) are provided in this release:

    -

    Output - buffering

    +
      +
    • +

      Several new functions simplify management of large sets of + color pairs: reset_color_pairs, + alloc_pair, find_pair and + free_pair.

      +
    • -

      X/Open curses provides more than one initialization - function:

      +
    • +

      New "RGB" extension capability for direct-color support is + used to improve performance of + color_content.

      +
    • -
        -
      • - initscr (the simplest) accepts no parameters.
      • +
      • +

        The internal colorpair_t is now a struct, + eliminating an internal 8-bit limit on colors

        +
      • -
      • - newterm accepts parameters for the stream input and - output
      • +
      • +

        Allocation for SCREEN's color-pair table + starts small, grows on demand up to the limit given in the + terminal description.

        +
      • -
      • - setupterm (the low-level function) accepts a parameter for - the file descriptor of the output.
      • +
      • +

        setcchar and getcchar now treat + a negative color-pair as an error.

        +
      -

      They are documented in X/Open as if - initscr calls newterm using - stdout for output stream, and in turn - newterm calls setupterm using - fileno(stdout) for the file descriptor. As long as - an implementation acts as if it does this, it conforms. - In practice, implementations do what is implied. This creates a - problem: the low-level setupterm function's file - descriptor is unbuffered, while newterm implies - buffered output. X/Open Curses says that all output is done - through the file descriptor, and does not say how the output - stream is actually used.

      - -

      Initially, ncurses used the file - descriptor (obtained from the output stream passed to - newterm) for changing the terminal modes, and relied - upon the output parameter of newterm for buffered - output. Later (to avoid using unsafe buffered I/O in signal - handlers), ncurses was modified to - use the file descriptor (unbuffered output) when cleaning up on - receipt of a signal. Otherwise (when not handling a signal), it - continued to use the buffered output.

      - -

      That approach worked reasonably well and as a side effect, - using the same buffered output as an application might use for - printf meant that no flushing was needed when - switching between normal- and screen-modes.

      - -

      There were a couple of problems:

      +

      Other + improvements

      + +

      These are new or revised features:

      • -

        to get good performance, curses (not only ncurses, but SVr4 curses in general) set an - output buffer using setbuf or similar function. - There is no standard (or portable) way to turn that output - buffer off, and revert to line-buffering. The - NCURSES_NO_SETBUF environment variable did make it - optional.

        +

        modify c++/etip.h.in to accommodate + deprecation of throw and throws in c++17

      • -

        to handle SIGTSTP (the “stop” - signal), ncurses relied upon - unsafe functions. That is, due to the complexity of the - feature, it relied upon reusing existing functions which - should not have been called via the signal handler.

        +

        add new function unfocus_current_field

      • -
      -

      Conveniently, solving the second problem (by making ncurses do its own output buffering) - also fixed the first one. But there were special cases to - resolve: - low-level functions such as mvcur, putp, vidattr - explicitly use the standard output. Those functions were reused - internally, and required modification to distinguish whether they - were used by the high-level or low-level interfaces.

      +
    • +

      add option to preserve leading whitespace in form + fields

      +
    • -

      Finally, there may still be a few programs which should be - modified to improve their portability, e.g., adding an

      +
    • +

      add a macro for is_linetouched and adjust the + function's return value to make it possible for most + applications to check for an error-return.

      +
    • -
      -
      -fflush(stdout);
      -
      -
      +
    • +

      add build-time utility report_offsets to help + show when the various configurations of tinfo library are + compatible or not.

      +
    • +
    -

    when switching from “shell” - mode to “program” - (curses) mode. Those are fairly rare because most programmers - have learned not to mix printf and printw.

    - -

    Symbol - versioning

    - -

    This release introduces symbol-versioning to ncurses because without it, the change of ABI - would be less successful. A lengthy discussion will be presented - in Symbol - versioning in ncurses. These - notes summarize what has changed, and what can be done with the - new release.

    - -

    Symbol-versioning allows the developers of a library to mark - each public symbol (both data and functions) with an identifier - denoting the library name and the version for which it was built. - By doing this, users of the library have a way to help ensure - that applications do not accidentally load an incompatible - library. In addition, private symbols can be hidden entirely.

    - -

    This release provides sample files for the four principal - configurations of ncurses libraries: - ncurses, ncursesw, - ncursest and ncursestw. Each sample is - given in two forms:

    +

    These were done to limit or ultimately deprecate features:

    -
    -
    -
    .map
    +
      +
    • +

      drop two symbols obsoleted in 2004: + _nc_check_termtype, and + _nc_resolve_uses

      +
    • -
      These list all public symbols, together with version - names.
      +
    • +

      move _nc_tracebits, _tracedump + and _tracemouse to curses.priv.h, + since they are not part of the suggested ABI6.

      +
    • -
      .sym
      +
    • +

      mark some structs in form/menu/panel libraries as + potentially opaque without modifying API/ABI.

      +
    • -
      These list all public symbols, without version - names.
      -
    -
    +
  • +

    ifdef'd header-file definition of mouse_trafo + with NCURSES_NOMACROS

    +
  • -

    The sample files are generated by scripts which take - into account a few special cases such as tack to omit - many of the ncurses private symbols - (beginning with “_nc_”). Here are - counts of globals versus locals:

    +
  • +

    remove initialization-check for calling napms + in the term-driver configuration; none is needed.

    +
  • -
    - - - +
  • +

    modify trace to avoid overwriting existing + file

    +
  • + - +

    These are improvements to existing features:

    - +
      +
    • +

      modify make_hash to allow building with + address-sanitizer, assuming that --disable-leaks + is configured.

      +
    • -
    +
  • +

    move SCREEN field for use_tioctl + data before the ncursesw fields, and limit that to the + sp-funcs configuration to improve termlib compatibility

    +
  • - - +
  • +

    modify db-iterator:

    -
  • - +
      +
    • +

      ignore zero-length files in db-iterator; these are + useful for instance to suppress + $HOME/.terminfo when not wanted.

      +
    • -
    +
  • +

    modify update_getenv to ensure that + environment variables which are not initially set will be + checked later if an application happens to set them

    +
  • + + - +
  • +

    modify _nc_outc_wrapper to use the standard + output if the screen was not initialized, rather than + returning an error.

    +
  • - +
  • +

    improve checks for low-level terminfo functions when the + terminal has not been initialized.

    +
  • - - +
  • +

    modify set_curterm to update + ttytype[] data used by longname/p>

    +
  • - - +
  • +

    modify _nc_get_screensize to allow for + use_env and use_tioctl state to be + per-screen when sp-funcs are configured, better matching the + behavior when using the term-driver configuration.

    +
  • - +
  • +

    remove an early-return from _nc_do_color, + which can interfere with data needed by bkgd + when ncurses is configured + with extended colors

    +
  • - +
  • +

    incorporate A_COLOR mask into + COLOR_PAIR, in case user application provides an + out-of-range pair number

    +
  • - +
  • +

    modify logic for endwin-state to be able to + detect the case where the screen was never initialized, using + that to trigger a flush of ncurses' buffer for mvcur, + e.g., in the sample program dots_mvcur for the term-driver + configuration.

    +
  • + - - +

    These are corrections to existing features:

    - - +
      +
    • +

      fixes for writing extended color pairs in + putwin.

      +
    • -
    +
  • +

    modify no-leaks code for lib_cur_term.c to + account for the tgetent cache.

    +
  • - +
  • +

    amend handling of the repeat_char capability + in EmitRange to avoid scope creep: translate the + character to the alternate character set when the alternate + character set is enabled, and do not use + repeat_char for characters past 255.

    +
  • - +
  • +

    improve wide-character implementation of + myADDNSTR in frm_driver.c, which + was inconsistent with the normal implementation.

    +
  • - - +
  • +

    modify winnstr and winchnstr to + return error if the output pointer is null, as well as adding + a null pointer check of the window pointer for better + compatibility with other implementations.

    +
  • - - +
  • +

    modify setupterm to save original tty-modes + so that erasechar works as expected. Also modify + _nc_setupscreen to avoid redundant calls to get + original tty-modes.

    +
  • - +
  • +

    modify wattr_set and wattr_get + to return ERR if win-parameter is null, + as documented.

    +
  • - +
  • +

    correct order of initialization for traces in + use_env and use_tioctl versus first + _tracef calls.

    +
  • - +
  • +

    correct parameters for copywin call in + _nc_Synchronize_Attributes

    +
  • - - -
    ConfigSymbolsGlobalsLocals"_nc_"
    ncurses976796180332
    ncursesw1089905184343
    ncursest979804175358
    ncursestw1098914184372
    -
    +
  • +

    flush the standard output in _nc_flush for + the case where SP is zero, e.g., when called via + putp. This fixes a scenario where + “tput flash” did not work after changes in + 20130112.

    +
  • -

    Although only four sample configurations are presented, each - is formed by merging symbols from several combinations of - configure-script options, taking into account advice from - downstream packagers. Because they are formed by merging, the - sample files may list a symbol which is not in a given package. - That is expected. The samples have been tested and are working - with systems (such as Fedora, FreeBSD and Debian) which fully - support this feature. There are other systems which do - not support the feature, and a few (such as Solaris) - which provide incomplete support.

    - -

    The version-naming convention used allows these sample files - to build distinct libraries for ABI 5 and 6. Version names - consist of

    +
  • +

    amend internal use of tputs to consistently + use the number of lines affected, e.g., for insert/delete + character operations. While merging terminfo source early in + 1995, several descriptions used the + “*” proportional delay for these + operations, prompting a change in doupdate.

    +
  • -
    • -

      configuration name, e.g., - “NCURSESW” for the wide-character - libraries

      +

      correct return-value of extended putwin.

    • -

      ABI version (if not 5)

      +

      double-width multibyte characters were not counted + properly in winsnstr and + wins_nwstr.

    • -

      library name for two special cases which have the same - interface across configurations: - “TINFO” and - “TIC

      +

      amend fix for _nc_ripoffline from 20091031 to + make test/ditto.c work in threaded + configuration.

    • -

      release version

      +

      modify _nc_viscbuf2 and + _tracecchar_t2 to trace wide-characters as a + whole rather than their multibyte equivalents.

    • -

      patch date (for the release version)

      +

      minor fix in wadd_wchnstr to ensure that each + cell has nonzero width.

    • -
    -

    For example, running nm -D on the libraries in - the ncurses6 test package shows these symbol-versions:

    +
  • +

    move PUTC_INIT calls next to + wcrtomb calls, to avoid carry-over of error + status when processing Unicode values which are not + mapped.

    +
  • -
    -
    -0000000000000000 A NCURSES6_TIC_5.0.19991023
    -0000000000000000 A NCURSES6_TIC_5.1.20000708
    -0000000000000000 A NCURSES6_TIC_5.5.20051010
    -0000000000000000 A NCURSES6_TIC_5.7.20081102
    -0000000000000000 A NCURSES6_TIC_5.9.20150530
    -0000000000000000 A NCURSES6_TINFO_5.0.19991023
    -0000000000000000 A NCURSES6_TINFO_5.1.20000708
    -0000000000000000 A NCURSES6_TINFO_5.2.20001021
    -0000000000000000 A NCURSES6_TINFO_5.3.20021019
    -0000000000000000 A NCURSES6_TINFO_5.4.20040208
    -0000000000000000 A NCURSES6_TINFO_5.5.20051010
    -0000000000000000 A NCURSES6_TINFO_5.6.20061217
    -0000000000000000 A NCURSES6_TINFO_5.7.20081102
    -0000000000000000 A NCURSES6_TINFO_5.8.20110226
    -0000000000000000 A NCURSES6_TINFO_5.9.20150530
    -0000000000000000 A NCURSESW6_5.1.20000708
    -0000000000000000 A NCURSESW6_5.3.20021019
    -0000000000000000 A NCURSESW6_5.4.20040208
    -0000000000000000 A NCURSESW6_5.5.20051010
    -0000000000000000 A NCURSESW6_5.6.20061217
    -0000000000000000 A NCURSESW6_5.7.20081102
    -0000000000000000 A NCURSESW6_5.8.20110226
    -0000000000000000 A NCURSESW6_5.9.20150530
    -
    -
    +
  • +

    add missing assignment in lib_getch.c to make + notimeout work

    +
  • + + +

    Program + improvements

    -

    As a special case, this release (which makes the final change - for ABI 5) is marked with release version 5.9 and patch date - 20150530.

    +

    While reviewing user feedback, it became apparent that the + differences between + reset (an alias for + tset) and “tput reset” were confusing:

    -

    Miscellaneous

    +
      +
    • one (tset) + updated the terminal modes, but used only part of the terminfo + capabilities for initialization, while
    • + +
    • the other (tput) + used all of the terminal capabilities while neglecting the + terminal modes.
    • +
    -

    The new release has several improvements for performance and - building. For instance:

    +

    On further investigation, it turned out that the differences + were largely an accident due to the way those programs had + evolved.

    + +

    This release eliminates the unnecessary differences, using the + same approach for tput's + init (initialization), reset and clear + operations as the separate + reset and + clear programs. Doing this does not change the + command-line options; existing scripts are unaffected.

    + +

    These are the user-visible changes for the three programs + (tput, tset and clear):

    • -

      several files in ncurses- and progs-directories were - modified to allow const data used in internal - tables to be put by the linker into the readonly text - segment.

      +

      add the terminal-mode parts of “reset” (aka tset) to the “tput + reset” command, making the two almost the same + except for window-size.

    • -

      various improvements were made to building the Ada95 - binding, both in simplifying the generated files as well as - improving the way it uses gnatmake

      +

      improve tput's check for + being called as “init” or “reset” to + allow for transformed names.

    • -
    -

    There are also new features in the libraries:

    +
  • +

    add “clear” as a possible link/alias to + tput.

    +
  • -
      -
    • added - use_tioctl function
    • +
    • +

      amend changes for tput to + reset tty modes to “sane” if the program is run + as “reset”, like tset. Likewise, ensure that tset sends either reset- or + init-strings.

      +
    • -

      added - wgetdelay to retrieve _delay member of WINDOW if it - happens to be opaque, e.g., in the pthread configuration.

      +

      add -x option to clear/tput + to make the E3 extension optional

    • -

      added - A_ITALIC extension.

      +

      add functionality of + “tset -w” to tput, like the + “-c” feature this is not optional in + tput.

    • -

      added form library extension - O_DYNAMIC_JUSTIFY option which can be used to override - the different treatment of justification for static versus - dynamic fields .

      +

      add options -T and -V to + clear command for + compatibility with tput.

    • -

      rewrote - putwin and - getwin, making an extended version which is capable of - reading screen-dumps between the wide/normal ncurses configurations. These are text - files, except for a magic code at the beginning:

      +

      drop long-obsolete “-n” option + from tset.

      +
    • -
      -
      -0       string          \210\210        Screen-dump (ncurses)
      -
      -
      +
    • +

      modify tset's assignment to + TERM in its output to reflect the name by which + the terminal description is found, rather than the primary + name. That was an unnecessary part from the initial + conversion of tset from + termcap to terminfo. The termcap library in 4.3BSD did this + to avoid using the short 2-character name

    • -

      several changes to mouse support include:

      +

      remove a restriction in tput's support for termcap names which + omitted capabilities normally not shown in termcap + translations

      +
    • + +
    • +

      add usage message to clear + command

      +
    • + +
    • +

      improve usage messages for tset and tput.

      +
    • +
    + +

    Other user-visible improvements and new features include:

    + +
      +
    • +

      modify tic/infocmp display of numeric values to use + hexadecimal when they are "close" to a power of two, making + the result more readable.

      +
    • + +
    • +

      add “-W” option to tic/infocmp + to force long strings to wrap.

        -
      • added decoder for xterm SGR 1006 mouse mode.
      • +
      • +

        This is in addition to the + “-w” option which attempts to + fit capabilities into a given line-length.

        +
      • -
      • added experimental support for - “%u” format to terminfo.
      • +
      • +

        If “-f” option splits line, + do not further split it with + “-W”.

        +
      • -
      • improved behavior of wheel-mice for xterm protocol: - noting that there are only button-presses for buttons - “4” and “5”, so there is no need to - wait to combine events into double-clicks .
      • +
      • +

        Begin a new line when adding + “use=” after a wrapped line.

        +
    • -
    -

    There are a few new configure options dealing with library - customization:

    +
  • +

    add “-q” option to infocmp to suppress the + “Reconstructed from” comment from + the header, and a corresponding option to tic to suppress all comments from the + “tic -I” output.

    +
  • -
    • -

      add “--enable-ext-putwin” - configure option to turn on the extended putwin/getwin. By - default, this is enabled for ABI 6 and disabled with ABI - 5.

      +

      Sorted options in usage message for infocmp, to make it simpler to see unused + letters.

    • -

      add “--enable-string-hacks” - option to control whether strlcat and strlcpy may be used. - Because ncurses already does the - requisite buffer-limit checks, this feature is mainly of - interest to quiet compiler-warnings on a few systems.

      +

      Updated usage message for tic, adding “-0” + option.

    • -

      add configure option - “--with-tparm-arg” to allow - tparm's parameters to be something more likely to be the - same size as a pointer, e.g., intptr_t (again, - the default is set for ABI 6).

      +

      add infocmp/tic-Q” option, + which allows one to dump the compiled form of the terminal + entry, in hexadecimal or base64:

      + +
        +
      • A “b64:” prefix in the + TERMINFO variable tells the terminfo reader to + use base64 according to RFC-3548 as well as RFC-4648 + url/filename-safe format.
      • + +
      • A “hex:” prefix tells the + terminfo reader to accept hexadecimal data as generated by + “infocmp -0qQ1”.
      • +
    -

    Program - improvements

    - -

    Utilities

    - -

    Most of the termcap-related changes based on development of - tctest - (termcap library checker) are implemented in the tic and - infocmp programs rather than affecting the library. As noted in - the - discussion of tctest, ncurses's ability to translate between terminfo - and termcap formats has been improved at different times, but - subject to feedback from "real" termcap users. There are very few - of those. Nowadays, virtually all termcap users are - using ncurses (or NetBSD, with its - own terminfo library) and their programs are actually using - terminfo rather than termcap data.

    - -

    Still, there are a few. A comment about the translation of the - ASCII NUL character prompted a review:

    +

    Other less-visible improvements and new features include:

    • -

      Both terminfo and termcap store string capabilities as - NUL-terminated strings.

      +

      modify utility headers such as tic.h to make + it clearer which are externals that are used by tack.

    • -

      In terminfo, a \0 in a terminal description - is stored as \200.

      +

      add “reset” to list of programs + whose names might change in manpages due to + program-transformation configure options.

    • -

      There are no (known) terminals which would behave - differently when sent \0 or - \200.

      +

      modify “-T” option of + clear and tput to call use_tioctl to + obtain the operating system's notion of the screensize if + possible.

    • -

      When translating to terminfo format (or displaying a - printable version of an entry using infocmp), ncurses shows \200 as - \0.

      +

      add check in tput for + init/reset operands to ensure those use a terminal.

    • -

      It has done this since 1998 (quoting from the NEWS - file):

      - -
      -
      -980103
      -...
      -        + modify _nc_tic_expand() to generate \0 rather than \200.
      -...
      -        + correct translation of terminfo "^@", to \200, like \0.
      -
      -
      +

      modify programs clear, + tabs, tput and tset to pass the actual tty file + descriptor to setupterm rather than the standard output or + error, making padding work.

    • -

      However, the _nc_tic_expand function (which - optionally produces terminfo or termcap format) did not - address this special case for termcap. Even the later 4.4BSD - - cgetstr interprets a \0 literally, ending - that string (rather than using the terminfo - improvement).

      +

      change tset's + initialization to allow it to get settings from the standard + input as well as /dev/tty, to be more effective + when output or error are redirected.

    • -
    -

    As a result of the review, several improvements were made to - ncurses translation to/from termcap - format — and improving the checks made in tic for - consistency of entries. Most of these are not of general - interest, except for two new command-line options for tic and - infocmp:

    - -
    • -

      the “-0” option generates - termcap/terminfo source on a single line.

      +

      amend check in tput, + tabs and clear to allow those to use the + database-only features in cron + if a “-T” option gives a suitable + terminal name.

    • -

      the “-K” option provides stricter - BSD-compatibility for termcap output.

      +

      improve error message from tset/reset + when both stderr/stdout are redirected to a file or pipe.

    -

    Other user-visible improvements and new features include:

    +

    Several of the less apparent features deal with translation of + terminfo to termcap (and the reverse), with corresponding checks + by tic:

    • -

      added “-D” option to tic and - infocmp, to show the database locations that it could - use.

      +

      modify check in fmt_entry to handle a + cancelled reset string. Make similar fixes in other parts of + dump_entry.c and tput.c

    • -

      added “-s” option to toe, to sort - its output.

      +

      correct read of terminfo entry in which all strings are + absent or explicitly cancelled. Before this fix, the result + was that all were treated as only absent.

    • -

      extended “-c” and - “-n” options of infocmp to allow - comparing more than two entries.

      +

      modify infocmp to suppress + mixture of absent/cancelled capabilities that would only show + as “NULL, NULL”, unless the + “-q” option is used, e.g., to show + “-, @” or “@, + -”.

    • -

      modified toe's report when “-a” - and “-s” options are combined, to - add a column showing which entries belong to a given - database.

      +

      correct a warning from tic + about keys which are the same, to skip over missing/cancelled + values.

    • -

      modified the clear program to take into account the - “E3” extended capability to clear - the terminal's scrollback buffer.

      +

      add check in tic for use of + bold, etc., video attributes in the color capabilities, + accounting whether the feature is listed in + ncv.

    • -
    -

    Examples

    +
  • +

    add check in tic for + unnecessary use of “2” to denote a + shifted special key.

    +
  • -

    Along with the library and utilities, many improvements were - made to the ncurses-examples. - Some were made to allow building (and comparison-testing) against - NetBSD curses and PDCurses. Both lack some of the X/Open Curses - features, necessitating customization. But this activity was - useful because it showed some remaining performance issues (which - have been resolved in this release).

    +
  • +

    improve check in tic for + delays by also warning about beep/flash when a delay is not + embedded, or if those use the VT100 reverse video escape + without using a delay.

    +
  • -

    These changes were made to verify compatibility or compare - performance of ncurses:

    +
  • +

    improve checks in trim_sgr0, comp_parse.c and + parse_entry.c, for cancelled string capabilities.

    +
  • -
    • -

      made workarounds for compiling test-programs with NetBSD - curses, though it lacks some common functions such as - - use_env.

      +

      add check in tic for some + syntax errors of delays, as well as use of proportional + delays for non-line capabilities.

    • -

      added dots_termcap test-program

      +

      add check in tic for + conflict between ritm, rmso, + rmul versus sgr0.

    • -

      added dots_curses test-program, for comparison with the - low-level examples.

      +

      add check in _nc_parse_entry for invalid + entry name, setting the name to + “invalid” to avoid problems storing + entries.

    • -

      added test_setupterm test-proram to demonstrate - normal/error returns from the setupterm and restartterm - functions.

      +

      improve _nc_tparm_analyze, using that to + extend the checks made by tic + for reporting inconsistencies between the expected number of + parameters for a capability and the actual.

    • -

      added “-d”, - “-e” and - “-q” options to the demo_terminfo - and demo_termcap test-programs.

      +

      remove tic warning about + “^?” in string capabilities, which + was marked as an extension; however all Unix implementations + support this and X/Open Curses does not address it. On the + other hand, + BSD termcap did not support this feature (until the + + mid-1990s).

      + +

      in _nc_infotocap, added a check to ensure + that terminfo “^?” is not written to + termcap.

    • -

      added “-y” option to demo_termcap - and test/demo_terminfo test-programs to demonstrate behavior - with/without extended capabilities.

      +

      modify sscanf calls in + _nc_infotocap for patterns + “%{number}%+%c” and + “%'char'%+%c” to check that the + final character is really “c”, + avoiding a case in icl6404 which cannot be converted to + termcap.

    • -

      modified demo_termcap and demo_terminfo test-programs to - make their options more directly comparable, and add - “-i” option to specify a terminal - description filename to parse for names to lookup.

      +

      in _nc_tic_expand and + _nc_infotocap, improved string-length check when + deciding whether to use “^X” or + “\xxx” format for control + characters, to make the output of tic/infocmp + more predictable.

    • -

      rewrote the tests for - mvderwin and test for recursive - mvwin in the movewindow test-program.

      +

      limited termcap “%d” width to 2 + digits on input, and use “%2” in + preference to “%02” on output.

      +
    • + +
    • +

      correct terminfo/termcap conversion of + “%02” and + “%03” into + “%2” and + “%3”; the result repeated the last + character.

    -

    These changes were made to help with the MinGW port:

    +

    Examples

    + +

    Along with the library and utilities, many improvements were + made to the ncurses-examples.

    + +

    These changes were made to demonstrate new extensions in + ncurses:

    • -

      added test-screens to the ncurses test-program to show - 256-characters at a time, to help with MinGW port.

      +

      add demo_new_pair program, + to demonstrate + alloc_pair, + find_pair and + free_pair functions.

      + +

      This program iterates over the possible color + combinations, allocating or initializing color pairs. For + best results, choose screen-width dividing evenly into the + number of colors. e.g.,

      + +
      + + + + + + + + + + + + + + + + + + +
      32x64,32x128  256 colors
      24x44,24x8888 colors
      32x64,24x12816 colors
      +
    • -

      modified the view test-program to load UTF-8 when built - with MinGW by using regular win32 API because the MinGW - functions mblen and mbtowc do not work.

      +

      add extended_color program, + like the older color_set + program, but using the extended color functions, with and + without the SP-functions interface.

    • -

      added “-s” option to the view - test-program to allow it to start in single-step mode, - reducing size of trace files when it is used for debugging - MinGW changes.

      +

      add picsmap program to fill + in some testing issues not met by dots, using this as the third example in a + comparison of the + ncurses versus slang libraries.

      + +

      The program can directly read X bitmap and pixmap files, + displaying a picture. It can read other image files using + ImageMagick's convert program to translate the image + into text.

      + +

      For 16-, 88- and 256-color terminal descriptions, + picsmap can load a palette + file which tells it which color palette entries to use. For + direct-colors, the terminal descriptions use the + RGB extension capability.

    -

    These changes were made to verify new extensions in ncurses:

    +

    There are other new example programs and a few scripts:

    • -

      added - form_driver_w entrypoint to wide-character forms library, - as well as form_driver_w test-program.

      +

      add dots_xcurses program to + illustrate a different approach used for extended colors + which can be contrasted with dots_curses.

    • -

      modified ncurses test-program's b/B tests to display lines - only for the attributes which a given terminal supports, to - make room for an italics test.

      +

      add list_keys program show + function keys for one or more terminal descriptions. It uses + ncurses's convention of + modifiers for special keys, based on xterm.

    • -

      modified ncurses test-program, adding - “-E” and - “-T” options to demonstrate use_env - versus use_tioctl.

      +

      add padview program, to + compare pads with direct updates in the view program.

    • -

      modified ncurses test-program's c/C tests to cycle through - subsets of the total number of colors, to better illustrate - 8/16/88/256-colors by providing directly comparable - screens.

      +

      add sp_tinfo program to + exercise the SP-functions extension of the low-level terminfo + library.

    • -

      modified the ncurses test-program to also show position - reports in 'a' test.

      +

      add test-programs for termattrs and + term_attrs functions.

    • -
    - -

    These changes were made to make the examples more useful:

    -
    • -

      added scripts for building dpkg and rpm test-packages

      +

      add test_sgr program to + exercise all combinations of the sgr capability.

    • -

      modified the hanoi test-program to show the minimum number - of moves possible for the given number of tiles.

      +

      add tput-colorcube demo + script, imitating xterm's 88- and 256-color scripts using + tput.

    • -

      modified the knight test-program to show the number of - choices possible for each position in automove option, e.g., - to allow user to follow Warnsdorff's rule to solve the - puzzle.

      +

      add tput-initc script to + demonstrate how tput may be + used to initialize a color palette from a data file.

    -

    Terminal - database

    +

    A variety of improvements were made to existing programs, both + new features as well as options added to make the set of programs + more consistent.

    -

    This release provides improvements to tic's - “-c” checking option, which was used for - example to

    +

    The ncurses program is the + largest; a proportionately large number of changes were made to + it:

    • -

      make sgr in several entries agree with other - caps.

      +

      modify a/A screens to make exiting on an escape character + depend on the start of keypad and timeout modes, to allow + better testing of function-keys.

      + +

      add “t” toggle for + notimeout function.

    • -

      correct padding in some entries where earlier versions had - miscounted the number of octal digits.

      +

      modify layout of b/B screens to allow for additional + annotation on the right margin; some terminals with partial + support did not display well.

    • -
    -

    There are several new terminal descriptions:

    - -
      -
    • - mlterm is now aliased to mlterm3
    • - -
    • - nsterm is now derived from nsterm-256color
    • - -
    • - putty-sco
    • +
    • +

      modify c/C screens to allow for extended color pairs.

      -
    • - teken is FreeBSD's "xterm" console.
    • +

      add z/Z zoom feature to make extended color pairs + easier to test.

      -
    • - terminator
    • +

      modify test-screens to take advantage of wide screens, + reducing the number of lines used for 88- and 256-colors.

      + -
    • - terminology
    • +
    • +

      modify “d” edit-color screen to + optionally read xterm color palette directly from terminal, + as well as handling KEY_RESIZE and + screen-repainting with control/L and control/R.

      +
    • -
    • - tmux is derived from screen.
    • +
    • +

      add examples to “F” screen for + WACS_D_PLUS and WACS_T_PLUS.

      +
    • -
    • several screen.XXX entries support the respective - variations for 256 colors.
    • +
    • +

      improve “g” screen, correcting + ifdef which made the legend not reflect changes to keypad- + and scroll-modes. Added check for return-value of + putwin.

      +
    • -
    • - simpleterm is now 0.5
    • +
    • +

      make “s” test easier to + understand which subtests are available

      -
    • - vte is aliased to vte-2012
    • +

      add a corresponding “S” + wide-character overlap test-screen.

      + -
    • - vt520ansi
    • +
    • +

      add “v” screen to show + baudrate and other values.

      +
    -

    A few entries use extensions (user-defined terminal - capabilities):

    +

    These changes were made to the other examples:

    • -

      E3, used in linux, putty and xterm-basic is - tested in the clear - program to erase a terminal's scrollback.

      +

      modify blue program to use + Unicode values for card-glyphs when available, as well as + improving the check for CP437 and CP850.

    • -

      TS is used in the - xterm+sl building block to help deprecate the misuse of - tsl for xterm's title-string.

      +

      improve demo_menus program, + allowing mouse-click on the menu-headers to switch the active + menu. This requires a new extension option + O_MOUSE_MENU to tell the menu driver to put + mouse events which do not apply to the active menu back into + the queue so that the application can handle the event.

    • -

      XT is used in some terminfo entries to - improve usefulness for other applications than screen, which - would like to pretend that xterm's title is a - status-line.

      +

      correct logic in demo_terminfo program for + “-f” option

    • -

      xm is used in examples - xterm-1005 and - xterm-1006 to illustrate a way to make mouse handling - more general

      +

      modify ditto program to + allow $XTERM_PROG environment variable to + override "xterm" as the name of the program to run in the + threaded configuration.

    • -
    -

    A few terminals support italics and/or dim capabilities. In - particular, screen does not. Documented that, and accommodated - the terminals where this feature works with the - A_ITALIC extension.

    +
  • +

    add several options to the “dots” + test-programs.

    +
  • -
      -
    • konsole, mlterm3 (italics)
    • +
    • +

      modify filter program:

      + +
        +
      • illustrate an alternative to getnstr, that + polls for input while updating a clock on the right margin + as well as responding to window size-changes.
      • + +
      • adapt logic used in dialog + “--keep-tite” option for + filter program as the "-a" + option. When set, filter + attempts to suppress the alternate screen.
      • +
      +
    • -
    • nsterm (dim)
    • +
    • +

      modify knight program to + provide the "slow" solution for small screens using + “R”, noting that Warnsdorf's method + is easily done with “a”.

      +
    • -
    • screen (dim)
    • +
    • +

      modify the savescreen + program to add test patterns that exercise 88-, 256-, etc., + colors.

      +
    • -
    • vte (dim, italics)
    • +
    • +

      add options to test_arrays, + for selecting termcap vs terminfo, etc.

      +
    • -
    • xterm (dim, italics)
    • -
    +
  • +

    modify the view + program:

    -

    Documentation

    +
      +
    • expand tabs using the ncurses library rather than in + the test-program.
    • -

      As usual, this release

      +
    • eliminate the “-n” option by + simply reading the whole file.
    • + +
    • implement page up/down commands.
    • + +
    • remove the very old SIGWINCH example; just + use KEY_RESIZE.
    • +
    +
  • -
    • -

      improves documentation by describing new features,

      +

      improve animation in xmas + program by adding a time-delay in blinkit.

    • -

      attempts to improve the description of features which - users have found confusing

      +

      modify several test-programs which call + use_default_colors to consistently do this only + if the “-d” option is given.

    • -

      fills in overlooked descriptions of features which were - described in the NEWS file - but treated sketchily in manual pages.

      +

      modify the install-rule for ncurses-examples to put the + data files in the data directory, e.g., + /usr/share/ncurses-examples.

    • -
    -

    In addition, the mechanism for producing HTML versions of the - documentation has been improved:

    +
  • +

    modify several test programs to use new + popup_msgs function, adapted from the + help-screen used in the edit_field program.

    +
  • -
    • -

      use an improved version of man2html - to generate html manpages.

      +

      modify test data for xterm palettes to use the newer + color4/color12 values.

    • -

      regenerated - NCURSES-Programming-HOWTO.html to fix some of the broken - html emitted by docbook.

      +

      improve the tracemunch + script:

      + +
        +
      • show screenXX pointers and thread identifiers as + names.
      • + +
      • chang address-parameters of add_wch, + color_content and pair_content to + dummy parameters.
      • +
    -

    Interesting - bug-fixes

    +

    Terminal + database

    + +

    There are several new terminal descriptions:

    + +
    +

    dumb-emacs-ansi, dvtm, + dvtm-256color, fbterm, + iterm2, linux-m1 minitel + entries, putty-noapp, viewdata, + and vt100+4bsd building-block.

    + +

    xterm+noalt, xterm+titlestack, + xterm+alt1049, xterm+alt+title + building blocks and xterm+direct, + xterm+indirect, xterm-direct. from + xterm + patch #331.

    + +

    several other “-direct” + descriptions to address the differences of other terminal + emulators versus xterm-direct.

    +
    + +

    There are many changes to existing terminal descriptions. Some + were updates to several descriptions:

      -
    • -

      Ada95 binding:

      +
    • use xterm+sm+1006 in several terminal + descriptions which were validated as supporting the extended + mouse feature for their respective terminal emulators.
    • + +
    • corrected sgr/sgr0 strings in a few cases + reported by tic, making those + correspond to the non-sgr settings where they differ, + but otherwise use ECMA-48 consistently.
    • + +
    • add 0.1sec mandatory delay to flash capabilities + using the VT100 reverse-video control
    • +
    +

    while others affected specific descriptions. These were + retested, to take into account new/undocumented changes by their + developers:

    + +
    +

    iterm, minitel, st, + viewdata, nsterm

    +
    + +

    while these are specific fixes based on user reports, or + warnings from tic:

    + +
    +
    + ansi building blocks
    + +
      -
    • -

      modify makefile rules to ensure that the PIC option is - not used when building a static library

      -
    • +
    • restored rmir/smir in + ansi+idc to better match original + ansiterm+idc, add alias + ansiterm
    • +
    +
    -
  • -

    make Ada95 build-fix for big-endian architectures such - as sparc. This undoes one of the fixes from - 20110319, which added an - “Unused” member to - representation clauses, replacing that with pragmas to - suppress warnings about unused bits.

    -
  • +
    + icl6402
    + +
    +
      +
    • corrected missing comma-separator between string + capabilities in icl6402 and + m2-nam
    - +
    -
  • -

    Color and attributes:

    +
    + interix
    +
      -
    • -

      parenthesize parameter of COLOR_PAIR and - PAIR_NUMBER in curses.h in case it happens - to be a comma-expression.

      -
    • +
    • updated using tack and + SFU with Windows 7 Ultimate.
    • -
    • -

      improve - 20021221 workaround for broken acs, handling a case - where that ACS_xxx character is not in the - acsc string but there is a known - wide-character which can be used.

      -
    • +
    • used ^? for kdch1
    • +
    +
    -
  • -

    modify - init_pair to accept -1's for color value after - - assume_default_colors has been called.

    -
  • +
    + linux
    -
  • -

    add a check in - start_color to limit color-pairs to 256 when extended - colors are not supported.

    -
  • +
    +
      +
    • made linux3.0 entry the default + linux entry
    • + +
    • modify linux2.6 entry to improve + line-drawing so that the linux3.0 entry can be + used in non-UTF-8 mode
    • + +
    • omitted selection of ISO-8859-1 for G0 in enacs + capability from linux2.6 entry, to avoid conflict with the + user-defined mapping. The reset feature uses ISO-8859-1 in + any case.
    • + +
    • modify flash capability for linux + and wyse entries to put the delay between the + reverse/normal escapes rather than after
    • + +
    • modify linux-16color to not mask dim, + standout or reverse with the ncv capability
    - +
    -
  • -

    Resizing the screen:

    +
    + pccon entries
    +
      -
    • -

      propagate error-returns from wresize, i.e., the - internal increase_size and decrease_size functions - through - resize_term.

      -
    • +
    • fixed some inconsistencies in the + pccon* entries
    • -
    • -

      add check for zero/negative dimensions for - resizeterm and resize_term.

      -
    • +
    • add bold to pccon+sgr+acs and + pccon-base
    • -
    • -

      modify resizeterm to always push a - KEY_RESIZE onto the fifo, even if screensize - is unchanged. Modify library to push a - KEY_RESIZE if there was a SIGWINCH, even if - it does not call resizeterm). These changes - eliminate the case where a SIGWINCH is received, but ERR - is returned from wgetch or - wgetnstr because the screen dimensions did - not change.

      -
    • +
    • add keys f12-f124 to pccon+keys
    -
  • + -
  • -

    Low-level interfaces

    +
    + tmux
    +
      -
    • -

      fix an old bug in the termcap emulation; - “%i” was ignored in - tparm because the parameters to be - incremented were already on the internal stack.

      -
    • +
    • corrected sgr string, which used + screen's "standout" code rather than the + standard code.
    • -
    • -

      change “%l” behavior in tparm - to push the string length onto the stack rather than - saving the formatted length into the output buffer.

      -
    • +
    • add settings corresponding to xterm-keys + option to reflect upcoming change to make that option + "on" by default
    • -
    • -

      modify name-comparison for tgetstr, etc., to - accommodate legacy applications as well as to improve - compatbility with BSD 4.2 termcap implementations (see - note for 980725).

      -
    • +
    • uncanceled Ms
    -
  • + -
  • High-level interfaces +
    + vt100
    +
      -
    • -

      modify internal recursion in wgetch which - handles cooked mode to check if the call to - wgetnstr returned an error. This can happen - when both nocbreak and nodelay - are set, for instance (see note for 960418).

      -
    • +
    • modify vt100 rs2 string to reset + vt52 mode and scrolling regions
    • -
    • -

      add a check in internal function - waddch_nosync to ensure that tab characters - are treated as control characters; some broken locales - claim they are printable.

      -
    • +
    • corrected rs2 string for + vt100-nam
    • -
    • -

      modify menu library to ensure that a menu's top-row is - adjusted as needed to ensure that the current item is on - the screen

      -
    • +
    • made minor fixes for vt100+4bsd, e.g., + delay in sgr for consistency
    • +
    +
    -
  • -

    fix special case where double-width character - overwrites a single- width character in the first - column.

    -
  • +
    + vte
    + +
    +
      +
    • moved SGR 24 and 27 from vte-2014 to + vte-2012
    • + +
    • add a few capabilities fixed in recent VTE + development
    +
    + +
    + xterm
    + +
    +
      +
    • add rep to xterm-new, available + since + late 1996.
    • + +
    • modify xterm+256color and + xterm+256setaf to use correct number of color + pairs.
    • + +
    • modify rs1 for xterm-16color, + xterm-88color and xterm-256color + to reset palette using oc string as in + linux entry.
    • + +
    • add rs1 capability to + xterm-256color
    • + +
    • add oc capability to + xterm+256color, allowing palette reset for + xterm
    • + +
    • add op to xterm+256setaf
    • + +
    • modify xterm-r5, xterm-r6 and + xterm-xf86-v32 to use xterm+kbs + to match + xterm #272, reflecting packager's changes
    • + +
    • used ANSI reply for u8 in + xterm-new, to reflect vt220-style responses + that could be returned.
    • + +
    • made xterm-pcolor sgr consistent + with other capabilities
    • +
    +
    +
    + +

    A few entries use extensions (user-defined terminal + capabilities):

    + +
      +
    • add rmxx/smxx ECMA-48 strikeout extension + to tmux and xterm-basic
    • + +
    • used RGB capability in new *-direct + entries to denote direct-color feature.
    • +
    + +

    Documentation

    + +

    As usual, this release

    + +
      +
    • +

      improves documentation by describing new features,

      +
    • + +
    • +

      attempts to improve the description of features which + users have found confusing

      +
    • + +
    • +

      fills in overlooked descriptions of features which were + described in the NEWS + file but treated sketchily in manual pages.

    -

    Configuration changes

    +

    In particular,

    -

    Major - changes

    +
      +
    • +

      Since the underlying features for + tset, + tput, and + clear have been better + integrated, the documentation now includes information on how + those tools evolved.

      -

      The ncurses 6.0 configure script - makes changes to the default value of several configure - options, depending on the --with-abi-version option - (i.e., whether its value is “5” or - “6”):

      +

      In addition to explaining the improved integration of the + tools, the manual pages made it easier to see how the tools + are similar and how they are different.

      +
    • -
      -
      --enable-const
      +
    • +

      The addch manual page has additional + information on + portability and differences from other + implementations.

      +
    • -
      -

      Feature introduced in 970405 - supports the use of const where X/Open Curses - should have, but did not. NetBSD curses does something - similar with const.

      -
      +
    • +

      The discussion of color-pairs in the attributes + manual page is improved in its + history section.

      +
    • -
      --enable-ext-colors
      +
    • +

      The documentation of the chtype, + cchar_t types and the attribute values which can + be stored in those types, in particular the + history and + portability sections of the attributes manual + page, has been improved.

      +
    • -
      -

      Extends the cchar_t structure to allow more - than 16 colors to be encoded. This applies only to the - wide-character (--enable-widec) - configuration.

      -
      +
    • +

      improve discussion of + portability in the mouse manual.

      +
    • -
      --enable-ext-mouse
      +
    • +

      The pad manual page has a section on the + origin and portability of pads.

      +
    • -
      -

      Modifies the encoding of mouse state to make room for a - 5th mouse button. That allows one to use ncurses with a wheel - mouse with xterm or similar X terminal emulators.

      -
      +
    • +

      Differences between SVr4 and X/Open Curses soft-keys are + discussed in a new section on + portability.

      +
    • -
      --enable-ext-putwin
      +
    • +

      There are updated/improved notes on portability in the + + resizeterm and + wresize manual pages.

      +
    • +
    -
    -

    Modifies the file-format written by putwin to - use printable text rather than binary files, allowing - getwin to read screen dumps written by - differently-configured ncurses libraries. The extended - getwin can still read binary screen dumps from - the same configuration of ncurses. This does not - change the ABI (the binary interface seen by calling - applications).

    -
    +

    In addition to providing background information to explain + these features and show how they evolved, there are corrections, + clarifications, etc.:

    -
    --enable-interop
    +
      +
    • +

      add note in the + addch manual about line-drawing when it depends + upon UTF-8.

      +
    • -
      -

      Modifies the FIELDTYPE structure used for the - form library to make it more generic.

      -
      +
    • +

      improve discussion of line-drawing characters in the + + add_wch manual.

      +
    • -
      --enable-lp64
      +
    • +

      explain in + clear's manual page that + it writes to the standard output.

      +
    • -
      -

      Allows an application to define _LP64 to - declare chtype and mmask_t as - simply “unsigned” rather than the - configured types using the --with-chtype and - --with-mmask_t options.

      -
      +
    • +

      improve description of + endwin.

      +
    • -
      --enable-sp-funcs
      +
    • +

      improve discussion of field validation in the + form driver manual page.

      +
    • -
      -

      Compile-in support for extended functions which accept a - SCREEN pointer, reducing the need for juggling the global SP - value with - set_term and - delscreen.

      -
      +
    • +

      clarify the use of wint_t vs + wchar_t in + get_wstr manual page.

      +
    • -
      --with-chtype=uint32_t
      +
    • +

      clarify in the + getch manual that the keypad mode affects an + application's ability to read KEY_MOUSE codes, + but does not affect KEY_RESIZE.

      -
      -

      Makes chtype explicitly a 32-bit unsigned - value.

      -
      +

      trim some obsolete/incorrect wording about + EINTR from the getch manual page

      -
      --with-mmask_t=uint32_t
      +

      improve manual pages for + getch and + get_wch to point out that they might return + user-defined values which have no predefined names in + <curses.h>

      +
    • -
      -

      Makes mmask_t explicitly a 32-bit unsigned - value.

      -
      +
    • +

      improve description of the -R option in the + + infocmp manual page

      +
    • -
      --with-tparm-arg=intptr_t
      +
    • +

      clarify in the + resizeterm manual page how + KEY_RESIZE is pushed onto the input stream.

      +
    • -
      -

      X/Open Curses declares - tparm using long for each of the parameters - aside from the formatting string, presuming that - long and char* are the same size. - This configure option uses intptr_t which - provides a better guarantee of the sizes.

      -
      - +
    • +

      document return value of + use_extended_names

      +
    • -

      The configure script no longer checks for antique compilers; - c89 is assumed as a minimum. There are a few - features from later revisions which are used when available. The - configure script makes checks to turn on useful warnings from - clang, gcc and icc. You should be able to build ncurses 6.0 with any of the current (or not so - current) C compilers available in 2015.

      - -

      The configure script, by the way, makes changes which do not - work with systems whose /bin/sh is non-POSIX. This - mainly affects Solaris (the other vendor unix systems have followed the POSIX guidelines - for the past twenty years). If you must build on Solaris, its - xpg4 - binaries suffice, e.g.,

      - -
      - - -

      - #!/bin/sh
      - WHAT=`hostname|sed -e 's/\..*//'`
      - - OUT=configure.out
      - cat >>$OUT <<EOF/
      - ** 
      `date`
      - ** node: 
      $WHAT
      - ** user: 
      `id`
      - ** conf: $*
      - EOF/

      -  
      - SHELL=/bin/sh
      - if test -f /usr/xpg4/bin/sh
      - - then
      -         CONFIG_SHELL=/usr/xpg4/bin/sh
      -         export CONFIG_SHELL
      - -         SHELL=$CONFIG_SHELL
      - fi
      -  
      - rm -f config.status config.cache
      - TOP=$HOME/$WHAT
      - $SHELL ./configure --verbose \
      - -         --disable-echo \
      - -         --disable-overwrite \
      - -         --enable-warnings \
      - -         --with-warnings \
      - -         --prefix=$TOP $* 2>&1 | tee -a $OUT
      - -

      -
      +
    • +

      document differences in + ESCDELAY versus AIX's implementation in the + variables manual page.

      +
    • -

      Other major changes to the configure script include:

      +
    • +

      The _nc_free_tinfo function is now documented + in the + memory-leaks manual page, because it could be + used in tack for memory-leak + checking.

      +
    • -
      • -

        ABI 6 is now the default, intending that the existing ABI - 5 should build as before using the - “--with-abi-version=5” option.

        +

        add a note to the + tic manual page about -W versus -f options.

      • -

        added --with-extra-suffix option to help with - installing nonconflicting ncurses6 packages, e.g., avoiding - header- and library-conflicts.

        +

        improve terminfo manual description of + terminfo syntax.

        -

        NOTE: as a side-effect, this renames

        +

        improve terminfo manual page discussion of + control- and graphics- characters.

        -
        -

        adacurses-config to - adacurses5-config and
        - adacursesw-config to - adacursesw5-config

        -
        +

        improve + color-handling section in terminfo manual page

        +
      • + +
      • +

        clarify description in + tput manual page regarding + support for termcap names

        + +

        update + tput manual page to + reflect changes to manipulate terminal modes by sharing + functions with tset.

        +
      • + +
      • +

        clarify in manual pages that the optional verbose option + level of + tic and + infocmp is available only + when ncurses is configured for + tracing.

      • -

        the configure script looks for gnatgcc if the Ada95 - binding is built, in preference to the default gcc/cc. The - script also ensures that the Ada95 binding is built with the - level of optimization as the C libraries.

        +

        improve manual page description of tset/reset + versus window-size.

      • -

        the configure script captures define's related to - -D_XOPEN_SOURCE from the configure check and adds those to - the *-config and *.pc files, to simplify use for the - wide-character libraries.

        +

        improve description of + tgoto parameters

      -

      Configuration options

      +

      There are new manual pages:

      -

      There are several new (or extended) configure options:

      +
        +
      • + user_caps documents the terminfo extensions used by + ncurses.
      • -
        -
        --disable-db-install
        +
      • +

        + scr_dump documents the screen-dump format.

        +
      • +
      -
      -

      Do not install the terminal database. This is used to omit - features for packages, as done with - --without-progs. The option simplifies building - cross-compile support packages.

      -
      +

      Some of the improvements are more subtle, relating to the way + the information is presented:

      -
      --disable-gnat-projects
      +
        +
      • +

        Made minor fixes to manpage NAME/SYNOPSIS + sections to consistently use rule that either all functions + which are prototyped in SYNOPSIS are listed in the + NAME section, or the manual-page name is the sole + item listed in the NAME section. The latter is used + to reduce clutter, e.g., for the top-level library manual + pages as well as for certain feature-pages such as + SP-funcs and + threading.

        +
      • -
        -

        This option is used for regression testing

        -
        +
      • +

        improve manual pages for utilities with respect to POSIX + versus X/Open Curses.

        +
      • -
        --disable-lib-suffixes
        +
      • +

        improve organization of the + attributes and color manual + pages.

        +
      • +
      -
      -

      Suppress the “w”, “t” or - “tw” suffixes which normally would be added to - the library names for the --enable-widec and - --with-pthread options.

      -
      +

      Interesting + bug-fixes

      -
      --with-cxx-shared
      +
        +
      • +

        modify toe to not exit if + unable to read a terminal description, e.g., if there is a + permission problem.

        +
      • -
        -

        When --with-shared is set, build libncurses++ - as a shared library. This implicitly relies upon building - with gcc/g++, since other compiler suites may have - differences in the way shared libraries are built. libtool by - the way has similar limitations.

        -
        +
      • +

        correct 20100515 change for weak signals versus + sigprocmask

        +
      • -
        --with-hashed-db
        +
      • work around Ada tool-breakage in Debian 9 and later by + invoking gprconfig to specify the C compiler to be + used by gnatmake, and conditionally suppressing + Library_Options line for static libraries.
      • -
        -

        Extended this configure option to simplify building with - different versions of Berkeley database using FreeBSD - ports.

        -
        +
      • +

        There were, as well, several bug-fixes to handle illegal + input for tic. Because those + did not correspond to useful terminal descriptions, most + users are unaffected.

        +
      • +
      -
      --with-pc-suffix
      +

      Configuration changes

      -
      -

      If ".pc" files are installed, optionally add a suffix to - the files and corresponding package names to separate unusual - configurations. If no option value is given (or if it is - "none"), no suffix is added. This option is used in the test - package for ncurses6.

      -
      +

      Major + changes

      -
      --with-xterm-kbs
      +

      This release provides a new binary format for terminal + descriptions that use extended numeric capabilities. Applications + built with the wide-character ncursesw library can use + these extended numbers.

      -
      -

      Configure xterm's terminfo entries to use either BS - (^H, i.e., ASCII backspace) or DEL - (^?, or 127).

      -
      - +
        +
      • +

        This includes utilities such as tic and infocmp, because (as noted in New features), the feature + relies upon an extension to the low-level tinfo + library.

        +
      • -

        Portability

        +
      • +

        A few software packagers use a configuration option of + ncurses which allows the + low-level tinfo library to be shared between the + high-level ncurses and ncursesw libraries. + This new feature was designed to work in that configuration + as well.

        +
      • +
      + +

      Other applications (i.e., using the 8-bit ncurses + library) which read the extended terminal descriptions see those + numeric capabilities set to the maximum value for a signed 16-bit + number.

      -

      MinGW

      +

      Older versions of ncurses' + tic accept out-of-range numeric + capabilities, storing those as the maximum value for a signed + 16-bit number. Other implementations of curses (mentioned in the + discussion of + picsmap) give zero for these + out-of-range capabilities.

      -

      Most of the portability-related work since - ncurses 5.9 extended and improved the MinGW port - introduced in - ncurses 5.8.

      +

      Configuration options

      -

      The MinGW port can be readily cross-compiled:

      +

      These changes provide support for tack 1.08, released in + July 2017:

      • -

        modified configure script to allow creating dll's for - MinGW when cross-compiling.

        +

        add --without-tack configure option to refine + --with-progs configure option. Normally + tack is built outside the + ncurses tree, but a few + packagers combine it during the build. If + term_entry.h is installed, there is no advantage + to in-tree builds.

      • -

        enforced Windows-style path-separator if - cross-compiling,

        +

        adjust configure-script to define + HAVE_CURSES_DATA_BOOLNAMES symbol needed for + tack 1.08 when built in-tree. + Rather than relying upon internal "_nc_" functions, + tack now uses the boolean, + number and string capability name-arrays provided by + ncurses and SVr4 Unix curses. + It still uses term_entry.h for the definitions + of the extended capability arrays.

      • -

        added scripts for test-builds of cross-compiled packages - for ncurses6 to MinGW.

        +

        add dependency upon ncurses_cfg.h to tic's header-files; any program using + tic-library will have to + supply this file. Legacy tack + versions supply this file; ongoing tack development has dropped the + dependency upon tic-library + and new releases will not be affected.

      • +
      + +

      Other changes to the configure-script and generated files + include

      +
      • -

        added pc-files to the MinGW cross-compiling - test-packages.

        +

        add configure options to disable checks for form, menu and + panel libraries so that ncurses-examples can be built with + non-SVr4 curses implementations.

      • -

        added script for building test-packages of binaries - cross-compiled to MinGW using NSIS.

        +

        add configure option --enable-opaque-curses + for ncurses library and similar options for the + other libraries.

      • -

        added nc_mingw.h to installed headers for - MinGW port; this is needed for cross-compiling ncurses-examples.

        +

        add configure option --disable-wattr-macros + for use in cases where one wants to use the same headers for + ncurses5/ncurses6 development, by suppressing the + wattr* macros which differ due to the introduction + of extended colors

      • -

        added test-packages for cross-compiling ncurses-examples - using the MinGW test-packages.

        +

        modify configure macro for shared-library rules to use + -Wl,-rpath rather than -rpath to + work around a bug in scons

      • -
      -

      The MinGW-specific Windows driver accounts for several - changes:

      - -
      • -

        wide-character display is made usable by replacing MinGW's - non-working wcrtomb and wctomb - functions.

        +

        improve ncurses-examples' configure script to define as + needed NCURSES_WIDECHAR for platforms where + _XOPEN_SOURCE_EXTENDED does not work. Also + modified the test program to ensure that if building with + ncurses, that the + cchar_t type is checked, since that is normally + (since 20111030) + ifdef'd depending on this test.

      • -

        implemented some display features: beep, - flash, - - curs_set.

        +

        modify configure script to handle the case where + tic-library is renamed, but + the --with-debug option is used by itself + without normal or shared libraries

      • -

        the driver handles repainting on endwin/refresh - combination.

        +

        modify editing script which generates resulting.map to + work with the clang configuration on recent FreeBSD, which + gives an error on an empty "local" section.

      • -

        modified treatment of TERM variable for MinGW - port to allow explicit use of the Windows console driver by - checking if $TERM is set to - “#win32console” or an abbreviation - of that.

        +

        improve configure check for setting the + WILDCARD_SYMS variable; on ppc64 the variable is + in the Data section rather than + Text.

      • -

        the Windows driver also matches the special - TERM value “unknown”

        +

        correct result of configure option + --without-fallbacks, which caused FALLBACK_LIST + to be set to "no"

      • -

        the driver now returns characters for special keys, (like - ansi.sys does), when keypad mode is off, rather - than returning nothing at all.

        +

        modify --with-pkg-config-libdir option to + make it possible to install “.pc” files even if + pkg-config is not found. Limit + this change, to suppress the actual install if it is not + overridden to a valid directory at install time.

      • -

        the driver checks a new environment variable - NCURSES_CONSOLE2 to optionally work around a deficiency - in Console2 (and its descendent - ConsoleZ) which hang when an application creates - a console buffer.

        +

        disallow “no” as a possible value for + --with-shlib-version option, overlooked in + cleanup-changes for 20000708.

      -

      Finally, there are other improvements:

      +

      Portability

      + +

      Many of the portability changes are implemented via the + configure script:

      • -

        MinGW is one of the configurations where ncurses installs by default into /usr

        +

        improve configure script's CF_CC_ENV_FLAGS + macro to allow for compiler wrappers such as ccache. This change moves only the + preprocessor, optimization and warning flags to + CPPFLAGS and CFLAGS, leaving the + residue in CC. That happens to work for + gcc's various + “model” options, but may require tuning for other + compilers.

      • -
      • configuration for cross-compiling uses AC_CHECK_TOOLS in - preference to AC_PATH_PROGS when searching for ncurses*-config, - e.g., in Ada95/configure and test/configure.
      • -
      • -

        extend Windows support to work with MSYS2;

        - -
          -
        • -

          this works with a scenario where there is an - ANSI-escape handler such as ansicon running - in the console window.

          -
        • - -
        • wrap isatty calls with a macro, provide a - corresponding set of support routines to address - differences between MinGW and MSYS2.
        • -
        +

        modify ncurses-examples' configure script to use + pkg-config for the extra + form/menu/panel libraries, to be more consistent with the + handling of the curses/ncurses library.

      • -

        ensure WINVER is defined in makefiles rather - than using headers.

        +

        add configuration checks to build with NetBSD + curses, which for example lacks + use_env.

      • -

        add check for the gnatprep - “-T” option.

        +

        change ncurses-examples to use attr_t vs + chtype to follow X/Open documentation more + closely since Solaris xpg4-curses uses different values for + WA_xxx vs A_xxx + that rely on attr_t being an unsigned short. Tru64 aka OSF1, + HPUX, AIX did as ncurses does, + equating the two sets.

      • -

        work around a bug introduced by - gcc 4.8.1 in MinGW which breaks "trace" feature.

        +

        modify several test programs to reflect that ncurses honors existing signal handlers in + initscr, while other implementations do not.

      • -

        add a driver-name method to each of the drivers.

        +

        add configure check for openpty to + ncurses-examples' configure script, for ditto.

      • -
      - -

      Other - ports

      -

      These changes affect certain platforms (ports):

      +
    • +

      improve check for working poll function by + using posix_openpt as a fallback in case there + is no valid terminal on the standard input

      +
    • -
      • -

        the configure script knows how to build shared libraries - with DragonFlyBSD and Interix.

        +

        modify ncurses-examples' configure script to check for + pthread dependency of + ncursest or ncursestw library when building + the ncurses examples, e.g., in + case weak symbols are used.

      • -

        support for AIX shared libraries is improved, tested with - AIX 5.3, 6.1 and 7.1 with both gcc 4.2.4 and cc:

        +

        add checks in ncurses-examples' configure script for some + functions neither in 4.3BSD curses, nor based on X/Open + Curses:

        • -

          the shared-library suffix for AIX 5 and 6 is now - ".so"

          +

          modify a loop limit in firework.c to work around + absense of limit checks in some libraries.

        • -

          the -brtl option is used with AIX 5-7; it - is needed to link with the shared libraries.

          +

          fill the last row of a window with + “?” in firstlast if waddch does + not return ERR on the lower-right + corner.

      • -

        the configure --enable-pc-files option takes - into account the PKG_CONFIG_PATH - variable.

        -
      • +

        build-fixes for the Portland Group (PGI) compilers

        -
      • -

        the configure option --with-pkg-config-libdir - provides control over the actual directory into which - pc-files are installed.

        -
      • +
          +
        • +

          accept whitespace in sed expression for generating + expanded.c

          +
        • -
        • -

          the build scripts add explicit -ltinfo, etc., to the - generated ".pc" file when ld option - “--as-needed” is used, or when - ncurses and tinfo are installed without using rpath.

          +
        • +

          modify configure check that g++ compiler warnings are + not used.

          +
        • + +
        • +

          add configure check for -fPIC option needed for shared + libraries.

          +
        • +
      • -

        the configure script disallows conflicting options - “--with-termlib” and - “--enable-term-driver”.

        +

        modify configure script for clang as used on FreeBSD, to + work around clang's differences in exit codes vs gcc.

      • -

        the check for missing c++ compiler to work when no error - is reported, and no variables set is improved (see note for - 20021206).

        +

        fixes for configure/build using clang on OSX

        + +
          +
        • +

          do not redefine “inline” in + ncurses_cfg.h; this was originally to solve + a problem with gcc/g++, but is aggravated by clang's + misuse of symbols to pretend it is gcc.

          +
        • + +
        • +

          add braces to configure script to prevent unwanted + addition of “-lstdc++” option to + the CXXLIBS symbol.

          +
        • + +
        • +

          improve/update test-program used for checking + existence of stdc++ library.

          +
        • + +
        • +

          if $CXXLIBS is set, the linkage test uses + that in addition to $LIBS.

          +
        • +
      • -

        the misc/gen_edit.sh script selects a "linux" entry which - works with the current kernel rather than assuming it is - always "linux3.0"

        +

        fixes for OS/2:

        + +
          +
        • +

          use button instead of kbuf[0] in + EMX-specific part of lib_mouse.c

          +
        • + +
        • +

          support building with libtool on OS/2

          +
        • + +
        • +

          use stdc++ library with OS/2 kLIBC

          +
        • + +
        • +

          clear configure script's cf_XOPEN_SOURCE + for OS/2, to work with its header files

          +
        • +
      • -

        the test/configure script makes it simpler to override - names of curses-related libraries, to help with linking with - pdcurses in MinGW environment.

        +

        add “newer” baudrate symbols to the + baudrate function in the ncurses library as + well as to a corresponding table in tset.

      • -

        the configure-script/ifdef's allow the BSD OLD_TTY feature - to be suppressed if the type of ospeed is - configured using the option --with-ospeed to not - be a short. By default, it is a - short for termcap-compatibility.

        +

        modify ncurses-examples savescreen to work with AIX and HPUX.

      • -

        the MKlib_gen.sh script works around a recent change in - gcc 5 (released mid-2015) which essentially - emits multiple #line statements for the same - position in a file.

        +

        define WIN32_LEAN_AND_MEAN for MinGW port, + making builds faster.

      • -

        the configure script works with Minix3.2 (see note - on portability)

        +

        add a configure check for wcwidth versus the + ncurses line-drawing + characters, to use in special-casing systems such as Solaris. + Solaris, however, requires a special case that maps Unicode + line-drawing characters into the acsc string for non-Unicode + locales. Solaris also has a misconfigured wcwidth which marks + all of the line drawing characters as double-width.

      • -

        OS/2 redux:

        +

        string-hacks (non-standard):

        • -

          the configure script supports OS/2 kLIBC.

          +

          fix configure script to record when + strlcat is found on OpenBSD.

          +
        • + +
        • +

          add --enable-string-hacks option to + ncurses-examples' configure script.

        • -

          the --with-lib-prefix option allows - configuring for old/new flavors of OS/2 EMX.

          +

          completed string-hacks for sprintf, etc., + including the ncurses-examples programs.

          +
        • + +
        • +

          make --enable-string-hacks option work + with Debian by checking for the "bsd" library and its + associated "<bsd/string.h>" header.

      • -

        improved configure-script checks for - _XOPEN_SOURCE:

        +

        workaround for Debian's antique/unmaintained version of + mawk:

        • -

          the definition works starting with Solaris 10.

          +

          see Debian #65617, which was fixed in mawk's upstream releases in + 2009.

        • -

          the definition is suppressed for IRIX64, since its - header files have a conflict versus - _SGI_SOURCE.

          +

          related fixes when building link_test.


      -

      Features of ncurses

      +

      Features of + ncurses

      -

      The ncurses package is fully +

      The ncurses package is fully upward-compatible with SVr4 (System V Release 4) curses:

        @@ -1836,14 +2355,14 @@ fflush(stdout);
      • -

        ncurses supports all of the +

        ncurses supports all of the for SVr4 curses features including keyboard mapping, color, forms-drawing with ACS characters, and automatic recognition of keypad and function keys.

      • -

        ncurses provides these SVr4 +

        ncurses provides these SVr4 add-on libraries (not part of X/Open Curses):

          @@ -1865,14 +2384,16 @@ fflush(stdout);
        • -

          ncurses's terminal database is - fully compatible with that used by SVr4 curses.

          +

          ncurses's terminal database + is fully compatible with that used by SVr4 curses.

            -
          • ncurses supports - user-defined capabilities which it can see, but which are - hidden from SVr4 curses applications using the - same terminal database.
          • +
          • +

            ncurses supports + user-defined capabilities which it can see, but which are + hidden from SVr4 curses applications using the + same terminal database.

            +
          • It can be optionally configured to match the format @@ -1880,23 +2401,23 @@ fflush(stdout);

          • -

            Alternatively, ncurses can - be configured to use hashed databases rather than the +

            Alternatively, ncurses + can be configured to use hashed databases rather than the directory of files used by SVr4 curses.

        • -

          The ncurses utilities have +

          The ncurses utilities have options to allow you to filter terminfo entries for use with less capable curses/terminfo versions such as the HP/UX and AIX ports.

        -

        The ncurses package also has many - useful extensions over SVr4:

        +

        The ncurses package also has + many useful extensions over SVr4:

        • @@ -1909,7 +2430,7 @@ fflush(stdout);
        • -

          Unlike SVr3 curses, ncurses +

          Unlike SVr3 curses, ncurses can write to the rightmost-bottommost corner of the screen if your terminal has an insert-character capability.

        • @@ -1942,9 +2463,9 @@ fflush(stdout);
        • The functions keyok and define_key allow you to better control the use - of function keys, e.g., disabling the ncurses KEY_MOUSE, or by defining more than - one control sequence to map to a given key code.

          + of function keys, e.g., disabling the ncurses KEY_MOUSE, or by defining more + than one control sequence to map to a given key code.

        • @@ -1992,20 +2513,22 @@ fflush(stdout);
        • The tic/captoinfo - utility provided with ncurses has - the ability to translate many termcaps from the XENIX, IBM - and AT&T extension sets.

          + "https://invisible-island.net/ncurses/man/tic.1m.html"> + tic/captoinfo + utility provided with ncurses + has the ability to translate many termcaps from the XENIX, + IBM and AT&T extension sets.

        • A BSD-like tset - utility is provided.

          + "https://invisible-island.net/ncurses/man/tset.1.html"> + tset utility is provided.

        • -

          The ncurses library and +

          The ncurses library and utilities will automatically read terminfo entries from $HOME/.terminfo if it exists, and compile to that directory if it exists and the user has no write access to the system @@ -2030,9 +2553,9 @@ fflush(stdout);

        • The table-of-entries utility toe - makes it easy for users to see exactly what terminal types - are available on the system.

          + "https://invisible-island.net/ncurses/man/toe.1m.html"> + toe makes it easy for users to see exactly what + terminal types are available on the system.

        • @@ -2044,46 +2567,55 @@ fflush(stdout);
        • Extensive documentation is provided (see the + "https://invisible-island.net/ncurses/ncurses.faq.html#additional_reading"> Additional Reading section of the - ncurses FAQ for online documentation).

          + "https://invisible-island.net/ncurses/ncurses.faq.html"> + ncurses FAQ for online documentation).

        Applications using - ncurses

        + ncurses -

        The ncurses distribution includes - a selection of test programs (including a few games). These are - available separately as ncurses-examples

        +

        The ncurses distribution + includes a selection of test programs (including a few games). + These are available separately as ncurses-examples

        The ncurses library has been tested with a wide variety of applications including:

        -
        cdk
        +
        aptitude
        + +
        +

        FrontEnd to Apt, the debian package manager

        + +

        https://wiki.debian.org/Aptitude

        +
        + +
        cdk

        Curses Development Kit

        http://invisible-island.net/cdk/
        + "https://invisible-island.net/cdk/">https://invisible-island.net/cdk/

        -
        ded
        +
        ded

        directory-editor

        http://invisible-island.net/ded/

        + "https://invisible-island.net/ded/">https://invisible-island.net/ded/

        -
        dialog
        +
        dialog

        the underlying application used in Slackware's setup, @@ -2091,56 +2623,57 @@ fflush(stdout); many systems.

        http://invisible-island.net/dialog/

        + "https://invisible-island.net/dialog/">https://invisible-island.net/dialog/

        -
        lynx
        +
        lynx

        the text WWW browser

        http://lynx.isc.org/

        + "https://lynx.invisible-island.net/">https://lynx.invisible-island.net/

        -
        Midnight Commander
        +
        mutt
        -

        file manager

        +

        mail utility

        http://www.midnight-commander.org/

        + "http://www.mutt.org/">http://www.mutt.org/

        -
        mutt
        +
        ncftp
        -

        mail utility

        +

        file-transfer utility

        http://www.mutt.org/

        + "https://www.ncftp.com/">https://www.ncftp.com/

        -
        ncftp
        +
        nvi
        -

        file-transfer utility

        +

        New vi uses ncurses.

        http://www.ncftp.com/

        + "https://sites.google.com/a/bostic.com/keithbostic/vi">https://sites.google.com/a/bostic.com/keithbostic/vi
        +

        -
        nvi
        +
        ranger
        -

        New vi uses ncurses.

        +

        A console file manager with VI key bindings in + Python.

        https://sites.google.com/a/bostic.com/keithbostic/nvi
        -

        + "https://ranger.github.io/">https://ranger.github.io/

        -
        tin
        +
        tin

        newsreader, supporting color, MIME

        @@ -2148,24 +2681,32 @@ fflush(stdout);

        http://www.tin.org/

        + +
        vifm
        + +
        +

        File manager with vi like keybindings

        + +

        https://vifm.info/

        +
        -

        as well as some that use ncurses - for the terminfo support alone:

        +

        as well as some that use ncurses for the terminfo support alone:

        -
        minicom
        +
        minicom

        terminal emulator for serial modem connections

        http://alioth.debian.org/projects/minicom/

        + "https://alioth.debian.org/projects/minicom/">https://alioth.debian.org/projects/minicom/

        -
        mosh
        +
        mosh

        a replacement for ssh.

        @@ -2174,32 +2715,32 @@ fflush(stdout); "https://mosh.mit.edu/">https://mosh.mit.edu/

        -
        tack
        +
        tack

        terminfo action checker

        http://invisible-island.net/ncurses/tack.html

        + "https://invisible-island.net/ncurses/tack.html">https://invisible-island.net/ncurses/tack.html

        -
        tmux
        +
        tmux

        terminal multiplexor

        http://tmux.github.io/

        + "https://github.com/tmux/tmux/wiki">https://github.com/tmux/tmux/wiki

        -
        vile
        +
        vile

        vi-like-emacs may be built to use the terminfo, termcap or curses interfaces.

        http://invisible-island.net/vile/

        + "https://invisible-island.net/vile/">https://invisible-island.net/vile/

        @@ -2208,31 +2749,41 @@ fflush(stdout);
        -
        emacs
        +
        emacs

        text editor

        http://www.gnu.org/software/emacs/

        + "https://www.gnu.org/software/emacs/">https://www.gnu.org/software/emacs/

        +
        + +
        less
        + +
        +

        The most commonly used pager (a program that + displays text files).

        + +

        http://www.greenwoodsoftware.com/less/

        -
        screen
        +
        screen

        terminal multiplexor

        http://www.gnu.org/software/screen/

        + "https://www.gnu.org/software/screen/">https://www.gnu.org/software/screen/

        -
        vim
        +
        vim

        text editor

        http://www.vim.org/

        + "https://www.vim.org/">https://www.vim.org/

        @@ -2240,14 +2791,14 @@ fflush(stdout);

        Development activities

        -

        Zeyd Ben-Halim started ncurses +

        Zeyd Ben-Halim started ncurses from a previous package pcurses, written by Pavel Curtis. Eric S. Raymond continued development. Jürgen Pfeifer wrote most of the form and menu libraries. Ongoing development work is done by Thomas Dickey. Thomas Dickey also acts as the maintainer for the Free Software Foundation, which holds the copyright + "https://invisible-island.net/ncurses/ncurses-license.html">copyright on ncurses.

        Contact the current maintainers at

        @@ -2271,12 +2822,15 @@ fflush(stdout);

        This list is open to anyone interested in helping with the development and testing of this package.

        -

        Beta versions of ncurses and +

        Beta versions of ncurses and patches to the current release are made available at

        ftp://invisible-island.net/ncurses/ .

        + "ftp://ftp.invisible-island.net/ncurses/">ftp://ftp.invisible-island.net/ncurses/ + and
        + https://invisible-mirror.net/archives/ncurses/ .

        There is an archive of the mailing list here:

        @@ -2296,34 +2850,28 @@ fflush(stdout); @@ -2334,8 +2882,9 @@ fflush(stdout); terminfo-format terminal description file once maintained by Eric Raymond . Unlike the older version, the termcap and - terminfo data are provided in the same file, and provides several - user-definable extensions beyond the X/Open specification.

        + terminfo data are provided in the same file, which also provides + several user-definable extensions beyond the X/Open + specification.

        You can find lots of information on terminal-related topics not covered in the terminfo file at Library improvements

      • @@ -2392,23 +2938,15 @@ fflush(stdout);
      -
    • - Portability - - -
    • +
    • Portability
    -
  • Features of ncurses
  • +
  • Features of ncurses
  • -
  • Applications using ncurses
  • +
  • Applications using ncurses
  • Development activities
  • diff --git a/doc/html/man/adacurses6-config.1.html b/doc/html/man/adacurses6-config.1.html index a6f73794..d74c2a8a 100644 --- a/doc/html/man/adacurses6-config.1.html +++ b/doc/html/man/adacurses6-config.1.html @@ -125,7 +125,7 @@

    SEE ALSO

            curses(3x)
     
    -       This describes ncurses version 6.0 (patch 20180106).
    +       This describes ncurses version 6.1 (patch 20180127).
     
     
     
    diff --git a/doc/html/man/captoinfo.1m.html b/doc/html/man/captoinfo.1m.html
    index a79bdcce..bdff8230 100644
    --- a/doc/html/man/captoinfo.1m.html
    +++ b/doc/html/man/captoinfo.1m.html
    @@ -190,7 +190,7 @@
     

    SEE ALSO

            infocmp(1m), curses(3x), terminfo(5)
     
    -       This describes ncurses version 6.0 (patch 20180106).
    +       This describes ncurses version 6.1 (patch 20180127).
     
     
     

    AUTHOR

    diff --git a/doc/html/man/clear.1.html b/doc/html/man/clear.1.html
    index a43e788d..66563a05 100644
    --- a/doc/html/man/clear.1.html
    +++ b/doc/html/man/clear.1.html
    @@ -148,7 +148,7 @@
     

    SEE ALSO

            tput(1), terminfo(5)
     
    -       This describes ncurses version 6.0 (patch 20180106).
    +       This describes ncurses version 6.1 (patch 20180127).
     
     
     
    diff --git a/doc/html/man/curs_termcap.3x.html b/doc/html/man/curs_termcap.3x.html
    index 42436ac6..55b21c16 100644
    --- a/doc/html/man/curs_termcap.3x.html
    +++ b/doc/html/man/curs_termcap.3x.html
    @@ -26,7 +26,7 @@
       * sale, use or other dealings in this Software without prior written       *
       * authorization.                                                           *
       ****************************************************************************
    -  * @Id: curs_termcap.3x,v 1.36 2018/01/01 15:13:16 tom Exp @
    +  * @Id: curs_termcap.3x,v 1.37 2018/01/23 10:14:38 tom Exp @
     -->
     
     
    @@ -149,80 +149,83 @@
            o   Normally the ncurses library is compiled with terminfo support.  In
                that case, tgoto uses tparm(3x) (a more capable formatter).
     
    -       The  tputs  routine  is described on the curs_terminfo(3x) manual page.
    +           However,  tparm  is not a termcap feature, and portable termcap ap-
    +           plications should not rely upon its availability.
    +
    +       The tputs routine is described on the  curs_terminfo(3x)  manual  page.
            It can retrieve capabilities by either termcap or terminfo name.
     
     
     

    GLOBAL VARIABLES

    -       The variables PC, UP and BC are set by tgetent to the terminfo  entry's
    +       The  variables PC, UP and BC are set by tgetent to the terminfo entry's
            data for pad_char, cursor_up and backspace_if_not_bs, respectively.  UP
    -       is not used by ncurses.  PC is used in the tdelay_output function.   BC
    -       is  used in the tgoto emulation.  The variable ospeed is set by ncurses
    +       is  not used by ncurses.  PC is used in the tdelay_output function.  BC
    +       is used in the tgoto emulation.  The variable ospeed is set by  ncurses
            in a system-specific coding to reflect the terminal speed.
     
     
     

    RETURN VALUE

    -       Except where explicitly noted, routines that return an  integer  return
    -       ERR  upon  failure  and OK (SVr4 only specifies "an integer value other
    +       Except  where  explicitly noted, routines that return an integer return
    +       ERR upon failure and OK (SVr4 only specifies "an  integer  value  other
            than ERR") upon successful completion.
     
            Routines that return pointers return NULL on 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
    +       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  sup-
    -       port  termcap,  will  check  if  the string is indeed terminfo-style by
    -       looking for "%p" parameters or "$<..>" delays, and  invoke  a  termcap-
    +       all you do with it is call tgoto or tparm, which both expand  terminfo-
    +       style  strings as terminfo.  (The tgoto function, if configured to sup-
    +       port 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 capa-
    -       bilities differ from termcap's, tputs("50"); will  put  out  a  literal
    +       Because terminfo conventions for representing padding in  string  capa-
    +       bilities  differ  from  termcap's,  tputs("50"); will put out a literal
            "50" rather than busy-waiting for 50 milliseconds.  Cope with it.
     
    -       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
    +       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 ac-
            commodate termcap's limitation in this respect.
     
     
     

    PORTABILITY

    -       The  XSI  Curses standard, Issue 4 describes these functions.  However,
    +       The XSI Curses standard, Issue 4 describes these  functions.   However,
            they are marked TO BE WITHDRAWN and may be removed in future versions.
     
    -       Neither the XSI Curses standard nor the SVr4 man pages  documented  the
    -       return  values  of tgetent correctly, though all three were in fact re-
    -       turned ever since SVr1.  In particular, an omission in the  XSI  Curses
    -       documentation  has  been misinterpreted to mean that tgetent returns OK
    -       or ERR.  Because the purpose of these functions is to provide  compati-
    -       bility  with the termcap library, that is a defect in XCurses, Issue 4,
    +       Neither  the  XSI Curses standard nor the SVr4 man pages documented the
    +       return values of tgetent correctly, though all three were in  fact  re-
    +       turned  ever  since SVr1.  In particular, an omission in the XSI Curses
    +       documentation has been misinterpreted to mean that tgetent  returns  OK
    +       or  ERR.  Because the purpose of these functions is to provide compati-
    +       bility with the termcap library, that is a defect in XCurses, Issue  4,
            Version 2 rather than in ncurses.
     
            External variables are provided for support of certain termcap applica-
            tions.  However, termcap applications' use of those variables is poorly
            documented, e.g., not distinguishing between input and output.  In par-
    -       ticular,  some  applications  are reported to declare and/or modify os-
    +       ticular, some applications are reported to declare  and/or  modify  os-
            peed.
     
    -       The comment that only the first two characters of the id parameter  are
    +       The  comment that only the first two characters of the id parameter are
            used escapes many application developers.  The original BSD 4.2 termcap
            library (and historical relics thereof) did not require a trailing null
    -       NUL  on  the  parameter  name  passed to tgetstr, tgetnum and tgetflag.
    -       Some applications assume that the termcap interface  does  not  require
    +       NUL on the parameter name passed  to  tgetstr,  tgetnum  and  tgetflag.
    +       Some  applications  assume  that the termcap interface does not require
            the trailing NUL for the parameter name.  Taking into account these is-
            sues:
     
    -       o   As a special case,  tgetflag  matched  against  a  single-character
    -           identifier  provided  that  was at the end of the terminal descrip-
    +       o   As  a  special  case,  tgetflag  matched against a single-character
    +           identifier provided that was at the end of  the  terminal  descrip-
                tion.  You should not rely upon this behavior in portable programs.
    -           This  implementation disallows matches against single-character ca-
    +           This implementation disallows matches against single-character  ca-
                pability names.
     
    -       o   This implementation disallows  matches  by  the  termcap  interface
    +       o   This  implementation  disallows  matches  by  the termcap interface
                against extended capability names which are longer than two charac-
                ters.
     
    diff --git a/doc/html/man/form.3x.html b/doc/html/man/form.3x.html
    index 04c255bc..48ebfd41 100644
    --- a/doc/html/man/form.3x.html
    +++ b/doc/html/man/form.3x.html
    @@ -246,7 +246,7 @@
            curses(3x)  and  related  pages  whose names begin "form_" for detailed
            descriptions of the entry points.
     
    -       This describes ncurses version 6.0 (patch 20180106).
    +       This describes ncurses version 6.1 (patch 20180127).
     
     
     
    diff --git a/doc/html/man/infocmp.1m.html b/doc/html/man/infocmp.1m.html
    index dbf8e17e..dfafeedb 100644
    --- a/doc/html/man/infocmp.1m.html
    +++ b/doc/html/man/infocmp.1m.html
    @@ -27,7 +27,7 @@
       * sale, use or other dealings in this Software without prior written       *
       * authorization.                                                           *
       ****************************************************************************
    -  * @Id: infocmp.1m,v 1.69 2018/01/01 15:12:48 tom Exp @
    +  * @Id: infocmp.1m,v 1.70 2018/01/23 10:10:17 tom Exp @
     -->
     
     
    @@ -364,40 +364,45 @@
     
                    3  hexadecimal and base64
     
    +            For example, this prints the compiled terminfo value as  a  string
    +            which could be assigned to the TERMINFO environment variable:
    +
    +                infocmp -0 -q -Q2
    +
            -q   This makes the output a little shorter:
     
    -            o   Make the comparison listing shorter by  omitting  subheadings,
    +            o   Make  the  comparison listing shorter by omitting subheadings,
                     and using "-" for absent capabilities, "@" for canceled rather
                     than "NULL".
     
    -            o   However, show differences between absent and  cancelled  capa-
    +            o   However,  show  differences between absent and cancelled capa-
                     bilities.
     
                 o   Omit the "Reconstructed from" comment for source listings.
     
            -Rsubset
    -            Restrict  output  to  a given subset.  This option is for use with
    -            archaic versions of terminfo like those on SVr1, Ultrix, or  HP/UX
    -            that  do not support the full set of SVR4/XSI Curses terminfo; and
    -            variants such as AIX that have their own  extensions  incompatible
    +            Restrict output to a given subset.  This option is  for  use  with
    +            archaic  versions of terminfo like those on SVr1, Ultrix, or HP/UX
    +            that do not support the full set of SVR4/XSI Curses terminfo;  and
    +            variants  such  as AIX that have their own extensions incompatible
                 with SVr4/XSI.
     
    -            o   Available  terminfo  subsets  are  "SVr1", "Ultrix", "HP", and
    +            o   Available terminfo subsets are  "SVr1",  "Ultrix",  "HP",  and
                     "AIX"; see terminfo(5) for details.
     
    -            o   You can also choose the subset "BSD" which selects only  capa-
    -                bilities  with  termcap equivalents recognized by 4.4BSD.  The
    +            o   You  can also choose the subset "BSD" which selects only capa-
    +                bilities with termcap equivalents recognized by  4.4BSD.   The
                     -C option sets the "BSD" subset as a side-effect.
     
    -            o   If you select any other value for -R, it is  the  same  as  no
    -                subset,  i.e., all capabilities are used.  The -I option like-
    +            o   If  you  select  any  other value for -R, it is the same as no
    +                subset, i.e., all capabilities are used.  The -I option  like-
                     wise selects no subset as a side-effect.
     
            -s [d|i|l|c]
    -            The -s option sorts the fields within each type according  to  the
    +            The  -s  option sorts the fields within each type according to the
                 argument below:
     
    -            d    leave  fields  in  the order that they are stored in the ter-
    +            d    leave fields in the order that they are stored  in  the  ter-
                      minfo database.
     
                 i    sort by terminfo name.
    @@ -406,45 +411,45 @@
     
                 c    sort by the termcap name.
     
    -            If the -s option is not given, the  fields  printed  out  will  be
    -            sorted  alphabetically  by  the  terminfo  name  within each type,
    -            except in the case of the -C or the -L options,  which  cause  the
    -            sorting  to  be  done  by  the termcap name or the long C variable
    +            If  the  -s  option  is  not given, the fields printed out will be
    +            sorted alphabetically by  the  terminfo  name  within  each  type,
    +            except  in  the  case of the -C or the -L options, which cause the
    +            sorting to be done by the termcap name  or  the  long  C  variable
                 name, respectively.
     
    -       -T   eliminates size-restrictions  on  the  generated  text.   This  is
    +       -T   eliminates  size-restrictions  on  the  generated  text.   This is
                 mainly  useful  for  testing  and  analysis,  since  the  compiled
    -            descriptions are limited (e.g., 1023 for termcap,  4096  for  ter-
    +            descriptions  are  limited  (e.g., 1023 for termcap, 4096 for ter-
                 minfo).
     
    -       -t   tells  tic  to  discard commented-out capabilities.  Normally when
    -            translating from terminfo to termcap, untranslatable  capabilities
    +       -t   tells tic to discard commented-out  capabilities.   Normally  when
    +            translating  from terminfo to termcap, untranslatable capabilities
                 are commented-out.
     
    -       -U   tells  infocmp  to  not  post-process  the  data after parsing the
    -            source file.  This feature helps when comparing  the  actual  con-
    -            tents  of  two source files, since it excludes the inferences that
    +       -U   tells infocmp to not  post-process  the  data  after  parsing  the
    +            source  file.   This  feature helps when comparing the actual con-
    +            tents of two source files, since it excludes the  inferences  that
                 infocmp makes to fill in missing data.
     
            -V   reports the version of ncurses which was used in this program, and
                 exits.
     
    -       -v n prints  out  tracing  information on standard error as the program
    +       -v n prints out tracing information on standard error  as  the  program
                 runs.
     
    -            The optional parameter n is a number  from  1  to  10,  inclusive,
    +            The  optional  parameter  n  is  a number from 1 to 10, inclusive,
                 indicating the desired level of detail of information.  If ncurses
    -            is built  without  tracing  support,  the  optional  parameter  is
    +            is  built  without  tracing  support,  the  optional  parameter is
                 ignored.
     
    -       -W   By  itself,  the  -w  option  will  not  force  long strings to be
    +       -W   By itself, the -w  option  will  not  force  long  strings  to  be
                 wrapped.  Use the -W option to do this.
     
            -w width
                 changes the output to width characters.
     
            -x   print information for user-defined capabilities.  These are exten-
    -            sions  to the terminfo repertoire which can be loaded using the -x
    +            sions to the terminfo repertoire which can be loaded using the  -x
                 option of tic.
     
     
    @@ -453,16 +458,16 @@
     
     
     

    EXTENSIONS

    -       The -0, -1, -E, -F, -G, -Q, -R, -T, -V, -a, -e, -f, -g, -i, -l, -p,  -q
    +       The  -0, -1, -E, -F, -G, -Q, -R, -T, -V, -a, -e, -f, -g, -i, -l, -p, -q
            and -t options are not supported in SVr4 curses.
     
            SVr4 infocmp does not distinguish between absent and cancelled capabil-
            ities.  Also, it shows missing integer capabilities as -1 (the internal
    -       value  used  to represent missing integers).  This implementation shows
    +       value used to represent missing integers).  This  implementation  shows
            those as "NULL", for consistency with missing strings.
     
    -       The -r option's notion of "termcap" capabilities is  System  V  Release
    -       4's.   Actual  BSD curses versions will have a more restricted set.  To
    +       The  -r  option's  notion of "termcap" capabilities is System V Release
    +       4's.  Actual BSD curses versions will have a more restricted  set.   To
            see only the 4.4BSD set, use -r -RBSD.
     
     
    @@ -471,12 +476,12 @@
     
     
     

    SEE ALSO

    -       captoinfo(1m),  infotocap(1m),  tic(1m),  toe(1m),   curses(3x),   ter-
    +       captoinfo(1m),   infotocap(1m),   tic(1m),  toe(1m),  curses(3x),  ter-
            minfo(5).
     
            https://invisible-island.net/ncurses/tctest.html
     
    -       This describes ncurses version 6.0 (patch 20180106).
    +       This describes ncurses version 6.1 (patch 20180127).
     
     
     

    AUTHOR

    diff --git a/doc/html/man/infotocap.1m.html b/doc/html/man/infotocap.1m.html
    index 146807a2..ff52c19f 100644
    --- a/doc/html/man/infotocap.1m.html
    +++ b/doc/html/man/infotocap.1m.html
    @@ -85,7 +85,7 @@
     

    SEE ALSO

            curses(3x), tic(1m), infocmp(1m), terminfo(5)
     
    -       This describes ncurses version 6.0 (patch 20180106).
    +       This describes ncurses version 6.1 (patch 20180127).
     
     
     

    AUTHOR

    diff --git a/doc/html/man/menu.3x.html b/doc/html/man/menu.3x.html
    index 9d9c1296..b51a2601 100644
    --- a/doc/html/man/menu.3x.html
    +++ b/doc/html/man/menu.3x.html
    @@ -221,7 +221,7 @@
            curses(3x)  and  related  pages  whose names begin "menu_" for detailed
            descriptions of the entry points.
     
    -       This describes ncurses version 6.0 (patch 20180106).
    +       This describes ncurses version 6.1 (patch 20180127).
     
     
     
    diff --git a/doc/html/man/ncurses.3x.html b/doc/html/man/ncurses.3x.html
    index 3b069992..1e1a8af6 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 20180106).
    +       This describes ncurses version 6.1 (patch 20180127).
     
            The  ncurses  library emulates the curses library of System V Release 4
            UNIX, and XPG4 (X/Open Portability Guide) curses  (also  known  as  XSI
    diff --git a/doc/html/man/ncurses6-config.1.html b/doc/html/man/ncurses6-config.1.html
    index d469eb7b..3ae08423 100644
    --- a/doc/html/man/ncurses6-config.1.html
    +++ b/doc/html/man/ncurses6-config.1.html
    @@ -112,7 +112,7 @@
     

    SEE ALSO

            curses(3x)
     
    -       This describes ncurses version 6.0 (patch 20180106).
    +       This describes ncurses version 6.1 (patch 20180127).
     
     
     
    diff --git a/doc/html/man/panel.3x.html b/doc/html/man/panel.3x.html
    index 73bb61cc..30b3ef05 100644
    --- a/doc/html/man/panel.3x.html
    +++ b/doc/html/man/panel.3x.html
    @@ -204,7 +204,7 @@
     

    SEE ALSO

            curses(3x), curs_variables(3x),
     
    -       This describes ncurses version 6.0 (patch 20180106).
    +       This describes ncurses version 6.1 (patch 20180127).
     
     
     

    AUTHOR

    diff --git a/doc/html/man/tabs.1.html b/doc/html/man/tabs.1.html
    index 54ae4fc1..f957805c 100644
    --- a/doc/html/man/tabs.1.html
    +++ b/doc/html/man/tabs.1.html
    @@ -164,7 +164,7 @@
     

    SEE ALSO

            tset(1), infocmp(1m), curses(3x), terminfo(5).
     
    -       This describes ncurses version 6.0 (patch 20180106).
    +       This describes ncurses version 6.1 (patch 20180127).
     
     
     
    diff --git a/doc/html/man/term.5.html b/doc/html/man/term.5.html
    index 2659fc47..1b1dfd50 100644
    --- a/doc/html/man/term.5.html
    +++ b/doc/html/man/term.5.html
    @@ -26,7 +26,7 @@
       * sale, use or other dealings in this Software without prior written       *
       * authorization.                                                           *
       ****************************************************************************
    -  * @Id: term.5,v 1.26 2017/02/18 16:58:21 tom Exp @
    +  * @Id: term.5,v 1.27 2017/12/16 21:27:20 tom Exp @
     -->
     
     
    @@ -85,7 +85,7 @@
                 base otherwise.
     
     
    -

    STORAGE FORMAT

    +

    LEGACY STORAGE FORMAT

            The format has been chosen so that it will be the same on all hardware.
            An 8 or more bit byte is assumed, but no assumptions about byte  order-
            ing or sign extension are made.
    @@ -187,68 +187,110 @@
            extended  capabilities  in  order,  e.g.,  booleans,  then  numbers and
            finally strings.
     
    +       Applications which manipulate terminal data  can  use  the  definitions
    +       described  in  term_variables(3x)  which  associate the long capability
    +       names with members of a TERMTYPE structure.
    +
    +
    +

    EXTENDED NUMBER FORMAT

    +       On occasion, 16-bit signed integers are not large enough.  With ncurses
    +       6.1,  a  new format is introduced by making a few changes to the legacy
    +       format:
    +
    +       o   a different magic number (0542)
    +
    +       o   changing the type for the number array from signed 16-bit  integers
    +           to signed 32-bit integers.
    +
    +       To  maintain  compatibility,  the library presents the same data struc-
    +       tures to direct users of the TERMTYPE structure as in previous formats.
    +       However,  that  cannot  provide callers with the extended numbers.  The
    +       library uses a similar but hidden data structure TERMTYPE2  to  provide
    +       data for the terminfo functions.
    +
     
     

    PORTABILITY

    -       Note that it is possible for setupterm to expect  a  different  set  of
    -       capabilities  than  are actually present in the file.  Either the data-
    +       Note  that  it  is  possible for setupterm to expect a different set of
    +       capabilities than are actually present in the file.  Either  the  data-
            base may have been updated since setupterm has been recompiled (result-
    -       ing  in extra unrecognized entries in the file) or the program may have
    -       been recompiled more recently than the database was updated  (resulting
    -       in  missing  entries).  The routine setupterm must be prepared for both
    -       possibilities - this is why the numbers and sizes are included.   Also,
    -       new  capabilities must always be added at the end of the lists of bool-
    +       ing in extra unrecognized entries in the file) or the program may  have
    +       been  recompiled more recently than the database was updated (resulting
    +       in missing entries).  The routine setupterm must be prepared  for  both
    +       possibilities  - this is why the numbers and sizes are included.  Also,
    +       new capabilities must always be added at the end of the lists of  bool-
            ean, number, and string capabilities.
     
    -       Despite the consistent use of little-endian for numbers and the  other-
    -       wise  self-describing format, it is not wise to count on portability of
    -       binary terminfo entries between commercial UNIX versions.  The  problem
    -       is  that  there  are  at least three versions of terminfo (under HP-UX,
    -       AIX, and OSF/1) which diverged from System V terminfo after  SVr1,  and
    -       have  added  extension  capabilities  to  the string table that (in the
    -       binary format) collide with System V and XSI  Curses  extensions.   See
    -       terminfo(5)  for  detailed  discussion of terminfo source compatibility
    +       Despite  the consistent use of little-endian for numbers and the other-
    +       wise self-describing format, it is not wise to count on portability  of
    +       binary  terminfo entries between commercial UNIX versions.  The problem
    +       is that there are at least three versions  of  terminfo  (under  HP-UX,
    +       AIX,  and  OSF/1) which diverged from System V terminfo after SVr1, and
    +       have added extension capabilities to the  string  table  that  (in  the
    +       binary  format)  collide  with System V and XSI Curses extensions.  See
    +       terminfo(5) for detailed discussion of  terminfo  source  compatibility
            issues.
     
    +       Direct access to the TERMTYPE structure is provided for legacy applica-
    +       tions.  Portable applications should  use  the  tigetflag  and  related
    +       functions described in curs_terminfo(3x) for reading terminal capabili-
    +       ties.
    +
    +       A small number of terminal descriptions  use  uppercase  characters  in
    +       their  names.   If  the  underlying  filesystem  ignores the difference
    +       between uppercase and lowercase, ncurses represents the "first  charac-
    +       ter" of the terminal name used as the intermediate level of a directory
    +       tree in (two-character) hexadecimal form.
    +
     
     

    EXAMPLE

    -       As an example, here is a hex dump of  the  description  for  the  Lear-
    -       Siegler ADM-3, a popular though rather stupid early terminal:
    -
    -       adm3a|lsi adm3a,
    -               am,
    -               cols#80, lines#24,
    -               bel=^G, clear= 32$<1>, cr=^M, cub1=^H, cud1=^J,
    -               cuf1=^L, cup=\E=%p1%{32}%+%c%p2%{32}%+%c, cuu1=^K,
    -               home=^^, ind=^J,
    -
    -       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  ).....+. ..-.....
    -       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  ........ ........
    -       0080  ff ff ff ff ff ff ff ff  ff ff ff ff ff ff ff ff  ........ ........
    -       0090  ff ff ff ff ff ff ff ff  ff ff ff ff ff ff ff ff  ........ ........
    -       00a0  ff ff ff ff ff ff ff ff  ff ff ff ff ff ff ff ff  ........ ........
    -       00b0  ff ff ff ff ff ff ff ff  ff ff ff ff ff ff ff ff  ........ ........
    -       00c0  ff ff ff ff ff ff ff ff  ff ff ff ff ff ff ff ff  ........ ........
    -       00d0  ff ff ff ff ff ff ff ff  ff ff ff ff ff ff ff ff  ........ ........
    -       00e0  ff ff ff ff ff ff ff ff  ff ff ff ff ff ff ff ff  ........ ........
    -       00f0  ff ff ff ff ff ff ff ff  ff ff ff ff ff ff ff ff  ........ ........
    -       0100  ff ff ff ff ff ff ff ff  ff ff ff ff ff ff ff ff  ........ ........
    -       0110  ff ff ff ff ff ff ff ff  ff ff ff ff ff ff ff ff  ........ ........
    -       0120  ff ff ff ff ff ff 2f 00  07 00 0d 00 1a 24 3c 31  ....../. .....$<1
    -       0130  3e 00 1b 3d 25 70 31 25  7b 33 32 7d 25 2b 25 63  >..=%p1% {32}%+%c
    -       0140  25 70 32 25 7b 33 32 7d  25 2b 25 63 00 0a 00 1e  %p2%{32} %+%c....
    -       0150  00 08 00 0c 00 0b 00 0a  00                       ........ .
    +       As an example, here is a description for the Lear-Siegler ADM-3, a pop-
    +       ular though rather stupid early terminal:
    +
    +           adm3a|lsi adm3a,
    +                   am,
    +                   cols#80, lines#24,
    +                   bel=^G, clear= 32$<1>, cr=^M, cub1=^H, cud1=^J,
    +                   cuf1=^L, cup=\E=%p1%{32}%+%c%p2%{32}%+%c, cuu1=^K,
    +                   home=^^, ind=^J,
    +
    +
    +       and a hexadecimal dump of the compiled terminal description:
    +
    +           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  ).....+. ..-.....
    +           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  ........ ........
    +           0080  ff ff ff ff ff ff ff ff  ff ff ff ff ff ff ff ff  ........ ........
    +           0090  ff ff ff ff ff ff ff ff  ff ff ff ff ff ff ff ff  ........ ........
    +           00a0  ff ff ff ff ff ff ff ff  ff ff ff ff ff ff ff ff  ........ ........
    +           00b0  ff ff ff ff ff ff ff ff  ff ff ff ff ff ff ff ff  ........ ........
    +           00c0  ff ff ff ff ff ff ff ff  ff ff ff ff ff ff ff ff  ........ ........
    +           00d0  ff ff ff ff ff ff ff ff  ff ff ff ff ff ff ff ff  ........ ........
    +           00e0  ff ff ff ff ff ff ff ff  ff ff ff ff ff ff ff ff  ........ ........
    +           00f0  ff ff ff ff ff ff ff ff  ff ff ff ff ff ff ff ff  ........ ........
    +           0100  ff ff ff ff ff ff ff ff  ff ff ff ff ff ff ff ff  ........ ........
    +           0110  ff ff ff ff ff ff ff ff  ff ff ff ff ff ff ff ff  ........ ........
    +           0120  ff ff ff ff ff ff 2f 00  07 00 0d 00 1a 24 3c 31  ....../. .....$<1
    +           0130  3e 00 1b 3d 25 70 31 25  7b 33 32 7d 25 2b 25 63  >..=%p1% {32}%+%c
    +           0140  25 70 32 25 7b 33 32 7d  25 2b 25 63 00 0a 00 1e  %p2%{32} %+%c....
    +           0150  00 08 00 0c 00 0b 00 0a  00                       ........ .
     
     
     
     

    LIMITS

    -       Some limitations: total compiled entries cannot exceed 4096 bytes.  The
    -       name field cannot exceed 128 bytes.
    +       Some limitations:
    +
    +       o   total  compiled entries cannot exceed 4096 bytes in the legacy for-
    +           mat.
    +
    +       o   total compiled entries cannot exceed 32768 bytes  in  the  extended
    +           format.
    +
    +       o   the name field cannot exceed 128 bytes.
     
     
     

    FILES

    @@ -263,8 +305,10 @@
            Thomas E. Dickey
            extended terminfo format for ncurses 5.0
            hashed database support for ncurses 5.6
    +       extended number support for ncurses 6.1
     
            Eric S. Raymond
    +       documented legacy terminfo format, e.g., from pcurses.
     
     
     
    @@ -277,8 +321,9 @@
     
  • DESCRIPTION
  • PORTABILITY
  • diff --git a/doc/html/man/terminfo.5.html b/doc/html/man/terminfo.5.html index 0781262c..9e06e2ba 100644 --- a/doc/html/man/terminfo.5.html +++ b/doc/html/man/terminfo.5.html @@ -74,7 +74,7 @@ Terminfo describes terminals by giving a set of capabilities which they have, by specifying how to perform screen operations, and by specifying padding requirements and initialization sequences. This describes - ncurses version 6.0 (patch 20180106). + ncurses version 6.1 (patch 20180127).

    Terminfo Entry Syntax

    diff --git a/doc/html/man/tic.1m.html b/doc/html/man/tic.1m.html
    index d466faa3..686ab158 100644
    --- a/doc/html/man/tic.1m.html
    +++ b/doc/html/man/tic.1m.html
    @@ -364,7 +364,7 @@
            infocmp(1m),   captoinfo(1m),   infotocap(1m),   toe(1m),   curses(3x),
            term(5).  terminfo(5).
     
    -       This describes ncurses version 6.0 (patch 20180106).
    +       This describes ncurses version 6.1 (patch 20180127).
     
     
     

    AUTHOR

    diff --git a/doc/html/man/toe.1m.html b/doc/html/man/toe.1m.html
    index 36aa8061..37012457 100644
    --- a/doc/html/man/toe.1m.html
    +++ b/doc/html/man/toe.1m.html
    @@ -113,7 +113,7 @@
            tic(1m), infocmp(1m), captoinfo(1m),  infotocap(1m),  curses(3x),  ter-
            minfo(5).
     
    -       This describes ncurses version 6.0 (patch 20180106).
    +       This describes ncurses version 6.1 (patch 20180127).
     
     
     
    diff --git a/doc/html/man/tput.1.html b/doc/html/man/tput.1.html
    index d7be3531..f28f36af 100644
    --- a/doc/html/man/tput.1.html
    +++ b/doc/html/man/tput.1.html
    @@ -482,7 +482,7 @@
     

    SEE ALSO

            clear(1), stty(1), tabs(1), tset(1), terminfo(5), curs_termcap(3x).
     
    -       This describes ncurses version 6.0 (patch 20180106).
    +       This describes ncurses version 6.1 (patch 20180127).
     
     
     
    diff --git a/doc/html/man/tset.1.html b/doc/html/man/tset.1.html
    index 33a1aa8e..36882224 100644
    --- a/doc/html/man/tset.1.html
    +++ b/doc/html/man/tset.1.html
    @@ -389,7 +389,7 @@
            csh(1),  sh(1),  stty(1),   curs_terminfo(3x),   tty(4),   terminfo(5),
            ttys(5), environ(7)
     
    -       This describes ncurses version 6.0 (patch 20180106).
    +       This describes ncurses version 6.1 (patch 20180127).
     
     
     
    diff --git a/man/curs_termcap.3x b/man/curs_termcap.3x
    index 7696ee9a..cdec18d6 100644
    --- a/man/curs_termcap.3x
    +++ b/man/curs_termcap.3x
    @@ -26,7 +26,7 @@
     .\" authorization.                                                           *
     .\"***************************************************************************
     .\"
    -.\" $Id: curs_termcap.3x,v 1.36 2018/01/01 15:13:16 tom Exp $
    +.\" $Id: curs_termcap.3x,v 1.37 2018/01/23 10:14:38 tom Exp $
     .TH curs_termcap 3X ""
     .de bP
     .ie n  .IP \(bu 4
    @@ -167,6 +167,9 @@ In that case, the first parameter is merely a placeholder.
     .bP
     Normally the ncurses library is compiled with terminfo support.
     In that case, \fBtgoto\fP uses \fBtparm\fP(3X) (a more capable formatter).
    +.IP
    +However, \fBtparm\fP is not a \fItermcap\fP feature,
    +and portable \fItermcap\fP applications should not rely upon its availability.
     .PP
     The \fBtputs\fR routine is described on the \fBcurs_terminfo\fR(3X) manual
     page.  It can retrieve capabilities by either termcap or terminfo name.
    diff --git a/man/infocmp.1m b/man/infocmp.1m
    index 6062ab98..34efbf63 100644
    --- a/man/infocmp.1m
    +++ b/man/infocmp.1m
    @@ -27,7 +27,7 @@
     .\" authorization.                                                           *
     .\"***************************************************************************
     .\"
    -.\" $Id: infocmp.1m,v 1.69 2018/01/01 15:12:48 tom Exp $
    +.\" $Id: infocmp.1m,v 1.70 2018/01/23 10:10:17 tom Exp $
     .TH @INFOCMP@ 1M ""
     .ie \n(.g .ds `` \(lq
     .el       .ds `` ``
    @@ -38,6 +38,19 @@
     .ie n  .IP \(bu 4
     .el    .IP \(bu 2
     ..
    +.de NS
    +.ie n  .sp
    +.el    .sp .5
    +.ie n  .in +4
    +.el    .in +2
    +.nf
    +.ft C			\" Courier
    +..
    +.de NE
    +.fi
    +.ft R
    +.in -4
    +..
     .ds d @TERMINFO@
     .SH NAME
     \fB@INFOCMP@\fR \- compare or print out \fIterminfo\fR descriptions
    @@ -436,6 +449,12 @@ base64
     3
     hexadecimal and base64
     .RE
    +.IP
    +For example, this prints the compiled terminfo value as a string
    +which could be assigned to the \fBTERMINFO\fP environment variable:
    +.NS
    +@INFOCMP@ -0 -q -Q2
    +.NE
     .TP 5
     \fB\-q\fR
     This makes the output a little shorter:
    diff --git a/misc/terminfo.src b/misc/terminfo.src
    index fd69ceb3..84f48108 100644
    --- a/misc/terminfo.src
    +++ b/misc/terminfo.src
    @@ -6,8 +6,8 @@
     # Report bugs and new terminal descriptions to
     #	bug-ncurses@gnu.org
     #
    -#	$Revision: 1.650 $
    -#	$Date: 2018/01/22 01:14:23 $
    +#	$Revision: 1.675 $
    +#	$Date: 2018/01/27 15:14:08 $
     #
     # The original header is preserved below for reference.  It is noted that there
     # is a "newer" version which differs in some cosmetic details (but actually
    @@ -334,52 +334,53 @@ vanilla|dumb tty,
     
     # ANSI capabilities are broken up into pieces, so that a terminal
     # implementing some ANSI subset can use many of them.
    -ansi+local1,
    +ansi+local1|ANSI normal-mode cursor-keys,
     	cub1=\E[D, cud1=\E[B, cuf1=\E[C, cuu1=\E[A,
    -ansi+local,
    +ansi+local|ANSI normal-mode parameterized cursor-keys,
     	cub=\E[%p1%dD, cud=\E[%p1%dB, cuf=\E[%p1%dC,
     	cuu=\E[%p1%dA, use=ansi+local1,
    -ansi+tabs,
    +ansi+tabs|ANSI tab-stops,
     	cbt=\E[Z, ht=^I, hts=\EH, tbc=\E[3g,
    -ansi+inittabs,
    +ansi+inittabs|ANSI initial tab-stops,
     	it#8, use=ansi+tabs,
    -ansi+erase,
    +ansi+erase|ANSI clear screen/line,
     	clear=\E[H\E[J, ed=\E[J, el=\E[K,
    -ansi+rca,
    +ansi+rca|ANSI relative cursor-addressing,
     	hpa=\E[%p1%{1}%+%dG, vpa=\E[%p1%{1}%+%dd,
    -ansi+cup,
    +ansi+cup|ANSI absolute cursor-addressing,
     	cup=\E[%i%p1%d;%p2%dH, home=\E[H,
    -ansi+rep,
    +ansi+rep|ANSI repeat-character,
     	rep=%p1%c\E[%p2%{1}%-%db,
    -ansi+idl1,
    +ansi+idl1|ANSI insert/delete one line,
     	dl1=\E[M, il1=\E[L,
    -ansi+idl,
    +ansi+idl|ANSI insert/delete lines,
     	dl=\E[%p1%dM, il=\E[%p1%dL, use=ansi+idl1,
    -ansi+idc,
    -	dch1=\E[P, ich=\E[%p1%d@, ich1=\E[@, rmir=\E[4l,
    -	smir=\E[4h,
    -ansi+arrows,
    +ansi+idc1|ANSI insert/delete one character,
    +	dch1=\E[P, ich1=\E[@, rmir=\E[4l, smir=\E[4h,
    +ansi+idc|ANSI insert/delete characters,
    +	dch=\E[%p1%dP, ich=\E[%p1%d@, use=ansi+idc1,
    +ansi+arrows|ANSI normal-mode cursor-keys,
     	kbs=^H, kcub1=\E[D, kcud1=\E[B, kcuf1=\E[C, kcuu1=\E[A,
     	khome=\E[H,
    -ansi+sgr|ansi graphic renditions,
    +ansi+sgr|ANSI graphic renditions,
     	blink=\E[5m, invis=\E[8m, rev=\E[7m,
     	sgr=\E[0%?%p3%t;7%;%?%p4%t;5%;%?%p7%t;8%;m,
     	sgr0=\E[0m,
    -ansi+sgrso|ansi standout only,
    +ansi+sgrso|ANSI standout only,
     	rmso=\E[m, smso=\E[7m,
     ansi+sgrul|ansi underline only,
     	rmul=\E[m, smul=\E[4m,
    -ansi+sgrbold|ansi graphic renditions; assuming terminal has bold; not dim,
    +ansi+sgrbold|ANSI graphic renditions; assuming terminal has bold; not dim,
     	bold=\E[1m,
     	sgr=\E[%?%p1%t7;%;%?%p2%t4;%;%?%p3%t7;%;%?%p4%t5;%;%?%p6%t1;
     	    %;%?%p7%t8;%;m,
     	use=ansi+sgr, use=ansi+sgrso, use=ansi+sgrul,
    -ansi+sgrdim|ansi graphic renditions; assuming terminal has dim; not bold,
    +ansi+sgrdim|ANSI graphic renditions; assuming terminal has dim; not bold,
     	dim=\E[2m,
     	sgr=\E[%?%p1%t7;%;%?%p2%t4;%;%?%p3%t7;%;%?%p4%t5;%;%?%p5%t2;
     	    %;%?%p7%t8;%;m,
     	use=ansi+sgr, use=ansi+sgrso, use=ansi+sgrul,
    -ansi+csr|ansi scroll-region plus cursor save & restore,
    +ansi+csr|ANSI scroll-region plus cursor save & restore,
     	csr=\E[%i%p1%d;%p2%dr, rc=\E8, sc=\E7,
     
     # The normal (ANSI) flavor of "media copy" building block asserts that
    @@ -1292,11 +1293,11 @@ nsterm-bce|AppKit Terminal.app v71+/v100.1.8+ with Mac OS X version 10.3/10.4 (b
     nsterm-256color|Terminal.app in OS X 10.8,
     	use=xterm+256setaf, use=nsterm-bce,
     
    +# removed bogus kDC7 -TD
     nsterm-build326|Terminal.app in OS X 10.9,
     	kDC=\E[3;2~, kLFT=\E[1;2D, kRIT=\E[1;2C, kcbt=\E[Z,
    -	kf18=\E[32~, kDC5=\E[3;5~, kDC7=\E[3;5~, kLFT3=\Eb,
    -	kLFT5=\E[1;5D, kRIT3=\Ef, kRIT5=\E[1;5C,
    -	use=nsterm-256color,
    +	kf18=\E[32~, kDC5=\E[3;5~, kLFT3=\Eb, kLFT5=\E[1;5D,
    +	kRIT3=\Ef, kRIT5=\E[1;5C, use=nsterm-256color,
     
     # actually "343.7"
     nsterm-build343|Terminal.app in OS X 10.10,
    @@ -1341,11 +1342,21 @@ nsterm-build343|Terminal.app in OS X 10.10,
     # + no support for "dynamic colors"
     # + no support for tcap-query.
     nsterm-build361|Terminal.app in OS X 10.11,
    +	XT,
     	kmous=\E[M, use=nsterm-build343,
     
    +# reviewed Terminal.app in High Sierra (version 2.8 build 400) -TD
    +# Comparing with build361, little has changed, except that italics work.
    +# Direct-color is not supported, by the way.
    +#
    +# Improved rmso/rmul -TD
    +nsterm-build400|Terminal.app in OS X 10.13,
    +	rmso=\E[27m, rmul=\E[24m, use=xterm+sm+1006,
    +	use=ecma+italics, use=nsterm-build361,
    +
     # This is an alias which should always point to the "current" version
     nsterm|Apple_Terminal|AppKit Terminal.app,
    -	use=nsterm-build361,
    +	use=nsterm-build400,
     
     ######## iTerm, iTerm2
     
    @@ -1361,7 +1372,7 @@ nsterm|Apple_Terminal|AppKit Terminal.app,
     # According to its documentation, iTerm uses terminfo to obtain function key
     # definitions.  For example, if it is started with TERM=xterm, it uses key
     # definitons from that terminal description from the local OSX machine.  Those
    -# $TERM settings may be augmented using the bookmark and profile dialogs. 
    +# $TERM settings may be augmented using the bookmark and profile dialogs.
     # However, the behavior seen with tack does not agree with either the terminfo
     # description or the function keys in its "xterm" profile.
     #
    @@ -1392,17 +1403,17 @@ iTerm.app|iterm|iTerm.app terminal emulator for Mac OS X,
     	csr=\E[%i%p1%d;%p2%dr, cub=\E[%p1%dD, cub1=^H,
     	cud=\E[%p1%dB, cud1=\n, cuf=\E[%p1%dC, cuf1=\E[C,
     	cup=\E[%i%p1%d;%p2%dH, cuu=\E[%p1%dA, cuu1=\E[A,
    -	dch=\E[%p1%dP, dch1=\E[P, dl=\E[%p1%dM, dl1=\E[M,
    -	dsl=\E]2;\007, ed=\E[J, el=\E[K, el1=\E[1K, enacs=\E(B\E)0,
    -	flash=\E[?5h$<200/>\E[?5l, fsl=^G, home=\E[H,
    -	hpa=\E[%i%p1%dG, ht=^I, hts=\EH, ich=\E[%p1%d@, ich1=\E[@,
    -	il=\E[%p1%dL, il1=\E[L, ind=\n, kLFT=\E[1;2D, kRIT=\E[1;2C,
    -	kbs=^?, kcbt=\E[Z, kcub1=\EOD, kcud1=\EOB, kcuf1=\EOC,
    -	kcuu1=\EOA, kdch1=\E[3~, kend=\EOF, kent=\EOM, kf1=\EOP,
    -	kf10=\E[21~, kf11=\E[23~, kf12=\E[24~, kf2=\EOQ, kf3=\EOR,
    -	kf4=\EOS, kf5=\E[15~, kf6=\E[17~, kf7=\E[18~, kf8=\E[19~,
    -	kf9=\E[20~, khome=\EOH, knp=\E[6~, kpp=\E[5~, op=\E[0m,
    -	rc=\E8, rev=\E[7m, ri=\EM, rmacs=^O, rmam=\E[?7l,
    +	dch=\E[%p1%dP, dch1=\E[P, dl=\E[%p1%dM, dl1=\E[M, ed=\E[J,
    +	el=\E[K, el1=\E[1K, enacs=\E(B\E)0,
    +	flash=\E[?5h$<200/>\E[?5l, home=\E[H, hpa=\E[%i%p1%dG,
    +	ht=^I, hts=\EH, ich=\E[%p1%d@, ich1=\E[@, il=\E[%p1%dL,
    +	il1=\E[L, ind=\n, kLFT=\E[1;2D, kRIT=\E[1;2C, kbs=^?,
    +	kcbt=\E[Z, kcub1=\EOD, kcud1=\EOB, kcuf1=\EOC, kcuu1=\EOA,
    +	kdch1=\E[3~, kend=\EOF, kent=\EOM, kf1=\EOP, kf10=\E[21~,
    +	kf11=\E[23~, kf12=\E[24~, kf2=\EOQ, kf3=\EOR, kf4=\EOS,
    +	kf5=\E[15~, kf6=\E[17~, kf7=\E[18~, kf8=\E[19~, kf9=\E[20~,
    +	khome=\EOH, knp=\E[6~, kpp=\E[5~, op=\E[0m, rc=\E8,
    +	rev=\E[7m, ri=\EM, rmacs=^O, rmam=\E[?7l,
     	rmcup=\E[2J\E[?47l\E8, rmir=\E[4l, rmkx=\E[?1l\E>,
     	rmso=\E[m, rmul=\E[m,
     	rs2=\E>\E[?3l\E[?4l\E[?5l\E[?7h\E[?8h, sc=\E7,
    @@ -1410,10 +1421,10 @@ iTerm.app|iterm|iTerm.app terminal emulator for Mac OS X,
     	    %p9%t\016%e\017%;,
     	sgr0=\E[m\017, smacs=^N, smam=\E[?7h, smcup=\E7\E[?47h,
     	smir=\E[4h, smkx=\E[?1h\E=, smso=\E[7m, smul=\E[4m,
    -	tbc=\E[3g, tsl=\E]2;, u6=\E[%i%d;%dR, u7=\E[6n,
    -	u8=\E[?1;2c, u9=\E[c, vpa=\E[%i%p1%dd, TS=\E]2;,
    -	kEND5=\E[1;5F, kHOM5=\E[1;5H, use=vt100+keypad,
    -	use=xterm+x11mouse, use=xterm+256setaf,
    +	tbc=\E[3g, u6=\E[%i%d;%dR, u7=\E[6n, u8=\E[?1;2c, u9=\E[c,
    +	vpa=\E[%i%p1%dd, kEND5=\E[1;5F, kHOM5=\E[1;5H,
    +	use=xterm+sl-twm, use=vt100+keypad, use=xterm+x11mouse,
    +	use=xterm+256setaf,
     
     # iTerm2 3.0.15
     #
    @@ -2716,7 +2727,7 @@ rcons-color|BSD rasterconsole with ANSI color,
     # for PocketBSD,PocketLinux,NetBSD/{hpcmips,mac68k}
     # -- the setf/setb are probably incorrect, more likely setaf/setab -TD
     # -- compare with cons25w
    -mgterm,
    +mgterm|MGL/MGL2 MobileGear Graphic Library,
     	OTbs, OTpt, am, bce, bw, eo, km, msgr, npc,
     	colors#8, cols#80, it#8, lines#18, pairs#64,
     	bel=^G, blink=\E[5m, bold=\E[1m, cbt=\E[Z, clear=\E[H\E[J,
    @@ -4017,8 +4028,37 @@ teraterm4.59|Tera Term Pro,
     	acsc=``aaffggjjkkllmmnnooppqqrrssttuuvvwwxxyyzz{{||}}~~,
     	kmous=\E[M, use=teraterm2.3,
     
    +# Version 4.97
    +#
    +# Testing with tack:
    +#	- no bell (flash works)
    +#	- bold is yellow, blink is red.
    +#	- default keyboard sends ^? for Delete, can be configured for kdch1
    +#	- no meta mode
    +# Testing with vttest:
    +#	+ autowrap has problems...
    +#	+ color-tests for bce feature match xterm's behavior
    +#	+ handles most of xterm's mouse-controls other than highlight-tracking.
    +#	  xterm's SGR 1006 works.
    +#	+ partial support for DEC locator-events
    +#	+ implements ECMA-48 SD/SU, but not REP, SL/SR.
    +#	+ has a "Tek" window, but does not work with vttest's examples
    +#	+ supports the dtterm window modify/report controls
    +#	+ responds to DECRQM and DECRQSS controls, but not consistent with DSR
    +#	  e.g., for VT220
    +#	+ VT220 screen-display tests are ok
    +#	+ no VT52 support
    +# Other tests:
    +#	+ recognizes xterm's original direct-colors sequences, but result is
    +#	  poor.
    +#	+ no UTF-8 apparent when UTF-8 is set, with font Lucida Control
    +teraterm4.97|Tera Term Pro,
    +	XT, use=ecma+color, use=xterm+sm+1006, use=teraterm4.59,
    +teraterm-256color|TeraTerm with xterm 256-colors,
    +	use=xterm+256setaf, use=teraterm,
    +
     teraterm|Tera Term,
    -	use=teraterm4.59,
    +	use=teraterm4.97,
     
     # Tested with WinNT 4.0, the telnet application assumes the screensize is
     # 25x80.  This entry uses the 'Terminal' font, to get line-drawing characters.
    @@ -4343,6 +4383,18 @@ xterm+app|fragment with cursor keys in application mode,
     # compatibility reasons, they are still available as a setting of xterm's
     # modifyCursorKeys resource.  These fragments list the modified cursor-keys
     # that might apply to xterm+pcfkeys with different values of that resource.
    +#
    +# These entries will have warnings when checking with tic because the kri/kind
    +# capabilities duplicate the kUP/kDN extensions.  This is intentional, though
    +# not part of the original plan.  The changes for xterm patch #206 (2005/11/3)
    +# show that kri/kind were seen much later as part of a set including kLFT/kRIT:
    +#
    +#   * modify  xterm-new  terminfo  entry to use capabilities for shifted       
    +#     scroll forward/reverse as shifted cursor up/down.
    +#
    +# In the 1980s when terminfo was defined, the developers made more of
    +# a distinction between shifted up/down versus shifted left/right since most
    +# terminals can index (scroll up/down), while few can scroll left/right.
     xterm+pcc3|fragment with modifyCursorKeys:3,
     	kLFT=\E[>1;2D, kRIT=\E[>1;2C, kind=\E[>1;2B,
     	kri=\E[>1;2A, kDN=\E[>1;2B, kDN3=\E[>1;3B, kDN4=\E[>1;4B,
    @@ -4510,6 +4562,8 @@ xterm-basic|modern xterm terminal emulator - common,
     xterm-xi|xterm on XI Graphics Accelerated X under BSD/OS 3.1,
     	rmso=\E[m, rmul=\E[m, use=xterm-xf86-v33,
     
    +#### XTERM Colors
    +
     # 16-colors is one of the variants of XFree86 3.3 xterm, updated for 4.0
     # (T.Dickey)
     #
    @@ -4575,7 +4629,7 @@ xterm-88color|xterm with 88 colors,
     
     # Emacs 26.1 and later support direct color mode in terminals, using a
     # combination of user-defined capabilities and ncurses-dependent function
    -# calls.  We will not include that here.  
    +# calls.  We will not include that here.
     #
     # Here is a first revision, which (disregarding the reuse of colors 1-7 which
     # is of interest only to the numerically illiterate), is compatible with other
    @@ -4608,6 +4662,12 @@ xterm+direct|xterm with direct-color indexing,
     xterm-direct|xterm with direct-color indexing,
     	use=xterm+direct, use=xterm,
     
    +# Here are corresponding flavors for terminals which could use the feature:
    +iterm2-direct|iTerm2 with direct-color indexing,
    +	use=xterm+direct, use=iterm2,
    +mlterm-direct|mlterm with direct-color indexing,
    +	use=xterm+direct, use=mlterm,
    +
     # Meanwhile, in KDE #107487, the patch submitter and the developer both saw
     # that xterm's original implementation should have used colons for the
     # subparameter separators, but chose not to correct this in konsole.  As of
    @@ -4626,7 +4686,21 @@ konsole-direct|konsole with direct-color indexing,
     st-direct|st with direct-color indexing,
     	use=xterm+indirect, use=st,
     vte-direct|vte with direct-color indexing,
    -	use=xterm+direct, use=vte,
    +	use=xterm+indirect, use=vte,
    +
    +# As for others:
    +# + Apple's Terminal.app does not recognize either form of the direct-color
    +#   sequences.
    +# + Cygwin's mintty recognizes xterm's original implementation, does okay with
    +#   the colors.  Like vte, it is a subset of xterm, although different
    +#   omissions/reservations of modified-keys are seen in testing.
    +# + PuTTY 0.70 seems to recognize xterm's original implementation but does
    +#   nothing useful with the colors.
    +# + Teraterm 4.97, like PuTTY (no good).
    +# + terminology 0.91 recognizes xterm's original implementation, but does
    +#   nothing useful with it.
    +
    +#### XTERM Features
     
     # This chunk is based on suggestions by Ailin Nemui and Nicholas Marriott, who
     # asked for some of xterm's advanced features to be added to its terminfo
    @@ -4983,6 +5057,7 @@ kterm-color|kterm-co|kterm with ANSI colors,
     	ncv@, use=kterm, use=ecma+color,
     
     #### Other XTERM
    +
     # These (xtermc and xtermm) are distributed with Solaris.  They refer to a
     # variant of xterm which is apparently no longer supported, but are interesting
     # because they illustrate SVr4 curses mouse controls - T.Dickey
    @@ -5214,12 +5289,12 @@ vte-2012|VTE 0.34.1,
     gnome-2012|GNOME Terminal 3.6.0,
     	use=vte-2012,
     
    -# GNOME terminal may automatically use the contents of the "xterm" terminfo to
    -# supply key information which is not built into the program.  With 2.22.3,
    -# this list is built into the program (which addresses the inadvertent use of
    -# random terminfo data, though using a set of values which does not correspond
    -# to any that xterm produces - still not solving the problem that GNOME
    -# terminal hardcodes the $TERM variable as "xterm").
    +# Before 2008, GNOME terminal could automatically use the contents of the
    +# "xterm" terminfo to supply key information which is not built into the
    +# program.  With 2.22.3, this list was built into the program (which addressed
    +# the inadvertent use of random terminfo data, though using a set of values
    +# which did not correspond to any that xterm produced - still not solving the
    +# problem that GNOME terminal hardcoded the $TERM variable as "xterm").
     #
     #	terminfo	modifier	code	keys
     #	kf13-kf24	shift		2	F1 to F12
    @@ -5246,14 +5321,35 @@ gnome|GNOME Terminal,
     	use=vte-2012,
     
     # relevant changes were made in January 2014, and later.
    +#
    +# Originally VTE was promoted as a library able to emulate any terminal by
    +# reading its terminal description.  In practice, that never got beyond the
    +# ability to read definitions of special keys (function-, editing-, cursor).
    +#
    +# Before 2014, VTE had a termcap reader (originally pointing to a private copy
    +# of a termcap file derived from xterm).  That was incomplete because it did
    +# not have any of the modifier-key information used for xterm's function-,
    +# editing-, and cursor-keys.  Having its own reader was unnecessary since
    +# ncurses provides that information; used since xterm patch #225 in 2007.
    +#
    +# During April/May 2014, a few bug reports (e.g., gnome #169295, gnome #728900,
    +# gnome #730137) dealt with attempts to recast that termcap reader as library
    +# calls, then attempting to adapt a chunk of code from ncurses (src/vteti.c),
    +# abandoning that and finally constructing a table to match xterm's default
    +# behavior, e.g., for "xterm+pcfkeys".
     vte-2014|VTE 0.35.1,
     	ncv@,
     	cbt=\E[Z, el1=\E[1K, flash=\E[?5h$<100/>\E[?5l,
     	ich=\E[%p1%d@, indn=\E[%p1%dS, kent=\EOM, rin=\E[%p1%dT,
     	use=xterm+sm+1006, use=xterm+pcfkeys, use=vte-2012,
     
    +# As of January 2018, this is the  most recent release,
    +# e.g., with gnome-terminal 3.26.2
    +vte-2017|VTE 0.50.2,
    +	use=ecma+strikeout, use=vte-2014,
    +
     vte|VTE aka GNOME Terminal,
    -	use=vte-2014,
    +	use=vte-2017,
     
     vte-256color|VTE with xterm 256-colors,
     	use=xterm+256color, use=vte,
    @@ -5330,7 +5426,7 @@ kvt|KDE terminal,
     	bce, km@,
     	kdch1=^?, kend=\E[F, khome=\E[H, use=xterm-color,
     
    -# Konsole 1.0.1
    +# Konsole 1.0.1 (2001/11/25)
     # (formerly known as kvt)
     #
     # This program hardcodes $TERM to 'xterm', which is not accurate.  However, to
    @@ -5364,27 +5460,91 @@ kvt|KDE terminal,
     # Updated for konsole 1.6.6:
     #    add control-key modifiers for function-keys, etc.
     #
    -# Updated for konsole 2.12.4:
    +# Updated for konsole 2.3 (October 2008):
    +#    vttest menu 1 shows that both konsole and gnome terminal do wrapping
    +#    different from xterm (and vt100's).  They have the same behavior in
    +#    this detail, but it is unclear which copies the other.
    +#
    +# Updated for konsole 2.12.4 (late 2013):
     #    add sitm/ritm
     #
    -# vttest menu 1 shows that both konsole and gnome terminal do wrapping
    -# different from xterm (and vt100's).  They have the same behavior in this
    -# detail, but it is unclear which copies the other.
    +# Updated for konsole 16.07 (mid 2016):
    +#    add dim, invis, strikeout
    +#    (also overline, which is too rarely used to provide as an extension)
    +#
    +# Updated for konsole 17.12.0 (late 2017):
     konsole-base|KDE console window,
     	bce, km@, npc, XT,
     	ncv@,
    -	bel@, blink=\E[5m, civis=\E[?25l, cnorm=\E[?25h,
    +	bel@, blink=\E[5m, civis=\E[?25l, cnorm=\E[?25h, dim=\E[2m,
     	ech=\E[%p1%dX, flash=\E[?5h$<100/>\E[?5l,
    -	hpa=\E[%i%p1%dG, indn=\E[%p1%dS, kbs=^?, kdch1=\E[3~,
    -	kend=\E[4~, kf1@, kf10@, kf11@, kf12@, kf13@, kf14@, kf15@, kf16@,
    -	kf17@, kf18@, kf19@, kf2@, kf20@, kf3@, kf4@, kf5@, kf6@, kf7@, kf8@,
    -	kf9@, kfnd@, khome=\E[1~, kslt@, rin=\E[%p1%dT, rmam=\E[?7l,
    -	rmso=\E[27m, rmul=\E[24m,
    +	hpa=\E[%i%p1%dG, indn=\E[%p1%dS, invis=\E[8m, kbs=^?,
    +	kdch1=\E[3~, kend=\E[4~, kf1@, kf10@, kf11@, kf12@, kf13@, kf14@,
    +	kf15@, kf16@, kf17@, kf18@, kf19@, kf2@, kf20@, kf3@, kf4@, kf5@, kf6@,
    +	kf7@, kf8@, kf9@, kfnd@, khome=\E[1~, kslt@, rin=\E[%p1%dT,
    +	rmam=\E[?7l, rmso=\E[27m, rmul=\E[24m,
     	rs2=\E7\E[r\E8\E[m\E[?7h\E[?1;3;4;6l\E[4l\E>\E[?1000l\E[?25h,
    -	sgr=\E[0%?%p6%t;1%;%?%p2%t;4%;%?%p1%p3%|%t;7%;%?%p4%t;5%;m%?
    -	    %p9%t\016%e\017%;,
    +	sgr=\E[0%?%p6%t;1%;%?%p2%t;4%;%?%p1%p3%|%t;7%;%?%p4%t;5%;%?
    +	    %p5%t;2%;%?%p7%t;8%;m%?%p9%t\016%e\017%;,
     	sgr0=\E[0m\017, smam=\E[?7h, vpa=\E[%i%p1%dd,
    -	use=ecma+italics, use=ecma+color, use=xterm-r6,
    +	use=ecma+strikeout, use=ecma+italics, use=ecma+color,
    +	use=xterm-r6,
    +
    +# The keytab feature was introduced in 0.9.12 (February 2000) with "linux" and
    +# "vt100" key-table files along with a compiled-in default key-table.
    +#
    +# The main difference between the two keytabs was that the developer equated
    +# "vt100" with xterm, and noticed that the Linux console's F1-F5 differed from
    +# that.  For the same reason, the home/end keys differ.  A VT100 had none of
    +# that.  The otherwise identical keytabs have definitions to model the VT52
    +# cursor-keys and the VT100 cursor-keys with application versus normal modes.
    +#
    +# An "x11r5" keytab (displayed in the menu as "X11 R5") was added in January
    +# 2001, and shortly after retitled to "XFree 3.x.x".  Both it and "vt100" were
    +# dropped from the install in June 2008.
    +#
    +# The default keytab added in January 2000 was originally titled "X11 R6",
    +# and likewise retitled to "XFree 4".
    +#
    +# A "solaris" keytab was added in Febrary 2005, copying the "vt100" keytab
    +# and changing backspace to ^H, removing that keytab's attempt to model the
    +# VT100 keypad and VT52 (KDE #20459).
    +#
    +# The developers made changes to the default and linux keytabs.  Comparing
    +# the original and 2018 versions using diffstat:
    +#	default: 119 added, 147 deleted, 28 unchanged
    +#	linux:   47 added, 28 deleted, 104 unchanged
    +#
    +# Most of the change for the default keytab was to make konsole act more like
    +# xterm.  That was a feature named AnyMod which came in May 2005 for KDE #92749
    +# (see also Redhat #122815).  Later, in June 2007 the compiled-in keytab was
    +# made an external file (like "linux" and "solaris"), and some further
    +# refinement made.  But there are still flaws in the scheme.
    +#
    +# Essentially AnyMod maps the xterm "PC-style" modifier codes such as 2 for
    +# Shift into a placeholder in the table entries.  That works well if all of the
    +# modified keys are modified in the same way.  But xterm does not do that.  The
    +# first 4 function keys are used in xterm to support the VT100 PF1-PF4 keypad
    +# keys.  For example, F2 sends \EOQ in both terminals because of this feature.
    +# But a shifted F2 (F14=F2+12) differs like this, in infocmp's listing:
    +#	kf14: '\E[1;2Q', '\EO2Q'.
    +#
    +# In effect, a quarter of konsole's function-keys are different from xterm.
    +#
    +# It is not a simple blunder:
    +# a) xterm patch #121 (November 1999), providing the first version of the
    +#    PC-style modifiers would send \EO2Q
    +# b) xterm patch #216 (July 2006) amended this and other details, provided
    +#    better documentation for the modifiers and made the behavior configurable,
    +#    e.g., using the modifyFunctionKeys resource.  The reason why it sends
    +#    \E[1;2Q is that \E[O2Q is not a legal ECMA-48 control sequence.  The
    +#    changelog points this out as "avoid sending SS3 with parameters".
    +# c) That came after AnyMod was introduced, but still early enough that one
    +#    might expect konsole's developers to followup.  Twelve years later that
    +#    has yet to happen.
    +#
    +# As of 2018, konsole still provides 3 keyboard profiles ("XFree 4", "linux",
    +# "solaris").
     konsole-linux|KDE console window with linux keyboard,
     	kf1=\E[[A, kf10=\E[21~, kf11=\E[23~, kf12=\E[24~, kf13@,
     	kf14@, kf15@, kf16@, kf17@, kf18@, kf19@, kf2=\E[[B, kf20@,
    @@ -5392,35 +5552,47 @@ konsole-linux|KDE console window with linux keyboard,
     	kf8=\E[19~, kf9=\E[20~, use=konsole-base,
     konsole-solaris|KDE console window with Solaris keyboard,
     	kbs=^H, kend=\E[4~, khome=\E[1~, use=konsole-vt100,
    -# KDE's "XFree86 3.x.x" keyboard is based on reading the xterm terminfo rather
    -# than testing the code.
    +
    +# Obsolete: x11r5.keymap
    +# KDE's "XFree86 3.x.x" keyboard was obviously based on reading the xterm
    +# terminfo at the time rather than testing the code.
     konsole-xf3x|KDE console window with keyboard for XFree86 3.x xterm,
     	kend=\E[4~, khome=\E[1~, use=konsole-vt100,
    -# The value for kbs reflects local customization rather than the settings used
    -# for XFree86 xterm.
    +
    +# The value for kbs (see konsole-vt100) reflects local customization rather
    +# than the settings used for XFree86 xterm.
     konsole-xf4x|KDE console window with keyboard for XFree86 4.x xterm,
     	kend=\EOF, khome=\EOH, use=konsole+pcfkeys,
     	use=konsole-vt100,
    -# Konsole does not implement shifted cursor-keys.
    +
     konsole+pcfkeys|konsole subset of xterm+pcfkeys,
    -	kLFT@, kRIT@, kcbt=\E[Z, kind@, kri@, kDN@, kUP@, use=xterm+pcc2,
    -	use=xterm+pcf0,
    +	kcbt=\E[Z, use=xterm+pcc2, use=xterm+pcf0,
    +	use=xterm+pce2,
    +
    +# Obsolete: vt100.keymap
     # KDE's "vt100" keyboard has no relationship to any terminal that DEC made, but
    -# it is still useful for deriving the other entries.
    +# it is still useful for deriving the other entries, since the developer
    +# provided function-keys based on xterm.
     konsole-vt100|KDE console window with vt100 (sic) keyboard,
     	kbs=^?, kdch1=\E[3~, kend=\E[F, kf1=\E[11~, kf10=\E[21~,
     	kf11=\E[23~, kf12=\E[24~, kf13@, kf14@, kf15@, kf16@, kf17@,
     	kf18@, kf19@, kf2=\E[12~, kf20@, kf3=\E[13~, kf4=\E[14~,
     	kf5=\E[15~, kf6=\E[17~, kf7=\E[18~, kf8=\E[19~, kf9=\E[20~,
     	khome=\E[H, use=konsole-base,
    +
    +# Obsolete: vt420pc.keytab was added in June 2000, dropped from the install in
    +# September 2008 and removed in June 2016.  The developer who removed it stated
    +# that it was never installed.
     konsole-vt420pc|KDE console window with vt420 pc keyboard,
     	kbs=^H, kdch1=^?, use=konsole-vt100,
    -konsole-16color|klone of xterm-16color,
    -	ncv#32, use=ibm+16color, use=konsole,
    +
     # make a default entry for konsole
     konsole|KDE console window,
     	use=konsole-xf4x,
     
    +# These were written for ncurses:
    +konsole-16color|klone of xterm-16color,
    +	ncv#32, use=ibm+16color, use=konsole,
     konsole-256color|KDE console window with xterm 256-colors,
     	use=xterm+256setaf, use=konsole,
     
    @@ -6073,7 +6245,7 @@ st|stterm| simpleterm,
     
     # Reviewed 0.7:
     #	dim is intermittent, sometimes works, sometimes does not
    -#	italics may show up with yellow color 
    +#	italics may show up with yellow color
     #	has control cursor-keys, alt cursor-keys, still no combinations
     #	has control pageup/down
     st-0.7|simpleterm 0.7,
    @@ -6092,7 +6264,7 @@ st-0.7|simpleterm 0.7,
     	kLFT3=\E[1;3D, kLFT5=\E[1;5D, kNXT3=\E[6;3~,
     	kNXT5=\E[6;5~, kPRV3=\E[5;3~, kPRV5=\E[5;5~,
     	kRIT3=\E[1;3C, kRIT5=\E[1;5C, kUP3=\E[1;3A, kUP5=\E[1;5A,
    -	rmxx=\E[29m, smxx=\E[9m, use=st-0.6,
    +	use=ecma+strikeout, use=st-0.6,
     
     # st-0.4.1
     #
    @@ -6543,7 +6715,7 @@ dumb-emacs-ansi|Emacs dumb terminal with ANSI color codes,
     # sgr are not impacted (because that usually resets all capabilities before
     # setting any), but termcap applications do not use sgr -TD
     screen|VT 100/ANSI X3.64 virtual terminal,
    -	OTbs, OTpt, am, km, mir, msgr, xenl, G0, XT,
    +	OTbs, OTpt, am, km, mir, msgr, xenl, G0,
     	colors#8, cols#80, it#8, lines#24, ncv@, pairs#64, U8#1,
     	acsc=++\,\,--..00``aaffgghhiijjkkllmmnnooppqqrrssttuuvvwwxxy
     	     yzz{{||}}~~,
    @@ -6680,7 +6852,7 @@ screen.xterm-xfree86|screen.xterm-new|screen customized for modern xterm,
     # xterm-r6 does not really support khome/kend unless it is propped up by
     # the translations resource.
     screen.xterm-r6|screen customized for X11R6 xterm,
    -	bw, use=screen+fkeys, use=xterm-r6,
    +	bw, use=xterm+x11mouse, use=screen+fkeys, use=xterm-r6,
     # Color applications running in screen and TeraTerm do not play well together
     # on Solaris because Sun's curses implementation gets confused.
     screen.teraterm|disable ncv in teraterm,
    @@ -6688,31 +6860,36 @@ screen.teraterm|disable ncv in teraterm,
     	acsc=+\020\,\021-\030.^Y0\333`\004a\261f\370g\361h\260i
     	     \316j\331k\277l\332m\300n\305o~p\304q\304r\304s_t\303u
     	     \264v\301w\302x\263y\363z\362{\343|\330}\234~\376,
    -	use=screen+fkeys, use=screen,
    +	use=screen+fkeys, use=xterm+x11mouse, use=screen,
     # Other terminals
     screen.rxvt|screen in rxvt,
     	bw, XT,
     	cvvis@, flash@, kcub1=\EOD, kcud1=\EOB, kcuf1=\EOC,
     	kcuu1=\EOA, use=screen+fkeys, use=vt100+enq,
    -	use=rxvt+pcfkeys, use=vt220+keypad, use=screen,
    +	use=rxvt+pcfkeys, use=xterm+x11mouse, use=vt220+keypad,
    +	use=screen,
     screen.Eterm|screen in Eterm,
    -	use=screen+fkeys, use=Eterm,
    +	use=xterm+x11mouse, use=screen+fkeys, use=Eterm,
     screen.mrxvt|screen in mrxvt,
    -	use=screen+fkeys, use=mrxvt,
    +	use=xterm+x11mouse, use=screen+fkeys, use=mrxvt,
     screen.vte|screen in any VTE-based terminal,
    -	use=screen+italics, use=screen+fkeys, use=vte,
    +	use=xterm+x11mouse, use=screen+italics,
    +	use=screen+fkeys, use=vte,
     screen.gnome|screen in GNOME Terminal,
    -	use=screen+italics, use=screen+fkeys, use=gnome,
    +	use=xterm+x11mouse, use=screen+italics,
    +	use=screen+fkeys, use=gnome,
     screen.konsole|screen in KDE console window,
    -	use=screen+italics, use=screen+fkeys, use=konsole,
    +	use=xterm+x11mouse, use=screen+italics,
    +	use=screen+fkeys, use=konsole,
     # fix the backspace key
     screen.linux|screen in linux console,
     	bw,
    -	kbs=^?, kcbt@, use=screen+fkeys, use=screen,
    +	kbs=^?, kcbt@, use=xterm+x11mouse, use=screen+fkeys,
    +	use=screen,
     screen.mlterm|screen in mlterm,
    -	use=screen+fkeys, use=mlterm,
    +	use=xterm+x11mouse, use=screen+fkeys, use=mlterm,
     screen.putty|screen in putty,
    -	use=screen+fkeys, use=putty,
    +	use=xterm+x11mouse, use=screen+fkeys, use=putty,
     
     # The default "screen" entry is reasonably portable, but not optimal for the
     # most widely-used terminal emulators.  The "bce" capability is supported in
    @@ -6784,8 +6961,14 @@ screen3|older VT 100/ANSI X3.64 virtual terminal,
     
     #### Tmux
     
    -# tmux is compatible with screen, but has support for italics, and some of the
    -# xterm cursor bits.
    +# tmux is mostly compatible with screen, but has support for italics, and some
    +# of the xterm cursor bits.
    +#
    +# However, unlike screen, tmux has no provision for using derived terminal
    +# descriptions.  When screen starts, it looks for a suitable "inner" terminal
    +# such as "screen.$TERM" to correspond to the outer terminal's quirks.  The
    +# various entries such as screen.xterm-new provide a way to more closely
    +# match the terminal.
     tmux|tmux terminal multiplexer,
     	invis=\E[8m, rmso=\E[27m,
     	sgr=\E[0%?%p6%t;1%;%?%p1%t;7%;%?%p2%t;4%;%?%p3%t;7%;%?%p4%t;
    @@ -7231,33 +7414,33 @@ news-unk|SONY NEWS vt100 emulator common entry,
     	sgr0=\E[m, smkx=\E[?1h\E=, smso=\E[7m, smul=\E[4m,
     #
     # (news-29: this had :TY=ascii: --esr)
    -news-29,
    +news-29|SONY NEWS vt100 emulator with 29 lines,
     	lines#29, use=news-unk,
     # (news-29-euc: this had :TY=euc: --esr)
    -news-29-euc,
    +news-29-euc|SONY NEWS vt100 emulator with 29 lines and EUC,
     	use=news-29,
     # (news-29-sjis: this had :TY=sjis: --esr)
    -news-29-sjis,
    +news-29-sjis|SONY NEWS vt100 emulator with 29 lines and SJIS,
     	use=news-29,
     #
     # (news-33: this had :TY=ascii: --esr)
    -news-33,
    +news-33|SONY NEWS vt100 with 33 lines,
     	lines#33, use=news-unk,
     # (news-33-euc: this had :TY=euc: --esr)
    -news-33-euc,
    +news-33-euc|SONY NEWS vt100 with 33 lines and EUC,
     	use=news-33,
     # (news-33-sjis: this had :TY=sjis: --esr)
    -news-33-sjis,
    +news-33-sjis|SONY NEWS vt100 with 33 lines and SJIS,
     	use=news-33,
     #
     # (news-42: this had :TY=ascii: --esr)
    -news-42,
    +news-42|SONY NEWS vt100 with 42 lines,
     	lines#42, use=news-unk,
     # (news-42-euc: this had :TY=euc: --esr)
    -news-42-euc,
    +news-42-euc|SONY NEWS vt100 with 42 lines and EUC,
     	use=news-42,
     # (news-42-sjis: this had :TY=sjis: --esr)
    -news-42-sjis,
    +news-42-sjis|SONY NEWS vt100 with 42 lines and SJIS,
     	use=news-42,
     #
     #	NEWS-OS old termcap entry
    @@ -7861,16 +8044,16 @@ pcmw|PC running Microsoft Works,
     # the documentation dated from 1.9.9e) -TD
     #
     # For a US keyboard, with 12 function-kecbt=\E[Z, ys,
    -#	kf1-kf12 are unmodifiedcbt=\E[Z, cbt=\E[Z, 
    +#	kf1-kf12 are unmodifiedcbt=\E[Z, cbt=\E[Z,
     #	kf13-kf24 use the shift-key
     #	kf25-kf36 use the left alt-key
     #	kf37-kf38 use the control-key
     #	kf49-kf60 use the shift- and control-keys
     # The shifted cursor keys send the sequences originally used for kf61-kf64:
     #	down=\EF+	(kf61)
    -#	up=\EF-		(kf62) 
    +#	up=\EF-		(kf62)
     #	left=\EF^	(unassigned)
    -#	right=\EF$	(kf64) 
    +#	right=\EF$	(kf64)
     
     interix|opennt|opennt-25|ntconsole|ntconsole-25|OpenNT-term compatible with color,
     	am, bce, msgr,
    @@ -19448,7 +19631,7 @@ amiga-vnc|Amiga using VNC console (black on light gray),
     
     # MorphOS on Genesi Pegasos
     # By Pavel Fedin 
    -morphos,
    +morphos|MorphOS on Genesi Pegasos,
     	acsc=, dl=\233%p1%dM, dl1=\233M, il=\233%p1%dL, il1=\233L,
     	ind=\204, indn@, kend=\23345~, kf11=\23320~, kf12=\23321~,
     	khome=\23344~, kich1=\23340~, knp=\23342~, kpp=\23341~,
    @@ -19945,7 +20128,7 @@ screen.minitel1|Screen specific for minitel1,
     	     yzz||}}~~,
     	bel=\007\E\^ \E\\, bold@, csr@, flash=\Eg\E\^ \E\\, kmous@,
     	rmul@, smul@, u6=\E[%i%d;%dR, u7=\E[6n, u8=\E[?1;2c, u9=\EZ,
    -	use=screen,
    +	use=xterm+x11mouse, use=screen,
     
     screen.minitel1b|Screen specific for minitel1b,
     	kclr=\E[2J, kdl1=\E[M, kf13=^Y{1, kf14=^Y{2, kf15=^Y{3,
    @@ -20073,7 +20256,7 @@ screen.linux-m1|Linux m1 specific for screen,
     	   \n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
     	   \n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
     	   \n\n\n\n\n\n\n\n\n\n,
    -	use=screen,
    +	use=xterm+x11mouse, use=screen,
     
     screen.linux-m1b|Linux m1b specific for screen,
     	colors@, pairs@,
    @@ -23616,7 +23799,8 @@ v3220|LANPAR Vision II model 3220/3221/3222,
     # "default".
     #
     # XT is harder, since screen's manpage does not give more details.  For that,
    -# we must read screen's source-code.  When XT is set, screen assumes
    +# we must read screen's source-code.  For example, when XT is set, screen
    +# assumes
     #
     # a) OSC 1 sets the title string, e.g., for the icon.  Recent versions of
     #    screen may also set the terminal's name, which is (for xterm) distinct
    @@ -23631,8 +23815,16 @@ v3220|LANPAR Vision II model 3220/3221/3222,
     #    sequence.  However, because screen uses only termcap, the values returned
     #    by Af/Ab are not usable because they rely on expressions that termcap
     #    does not support.  Therefore, screen uses a hardcoded string to work
    -#    around the limitation.
    +#    around the limitation.  In a few cases, screen also uses tparm, which
    +#    is a terminfo function rather than termcap.
     # f) all entries named "*xterm*" or "*rxvt*" have the bce flag set.
    +# g) screen also uses the feature to decide whether to pay attention to other
    +#    xterm-related features which are unrelated to the description in the
    +#    manual page.
    +#
    +# Since XT is useful only when the outer terminal matches screen's assumptions,
    +# it is appropriate to use it in the derived terminal descriptions such as
    +# "screen.xterm", but not in the generic "screen", "screen-bce" entries.
     #
     # The other ISO-2022 features are rarely used, but provided here to make
     # screen's termcap features available.
    @@ -25487,4 +25679,22 @@ v3220|LANPAR Vision II model 3220/3221/3222,
     #	  mode does not work with those programs.  konsole is debatable -TD
     #	+ add "termite" entry (report by Markus Pfeiffer) -TD
     #
    +# 2017-01-27
    +#	+ trim "XT" from screen entry -TD
    +#	+ modify iterm to use xterm+sl-twm building block -TD
    +#	+ mark konsole-420pc, konsole-vt100, konsole-xf3x obsolete reflecting
    +#	  konsole's removal in 2008 -TD
    +#	+ expanded the history section of konsole to explain its flawed
    +#	  imitation of xterm's keyboard -TD
    +#	+ use xterm+x11mouse in screen.* entries because screen does not yet
    +#	  support xterm's 1006 mode -TD
    +#	+ add nsterm-build400 for macOS 10.13 -TD
    +#	+ add ansi+idc1, use that in ansi+idc adding dch for consistency -TD
    +#	+ update vte to vte-2017 -TD
    +#	+ add ecma+strikeout to vte-2017 -TD
    +#	+ add iterm2-direct -TD
    +#	+ updated teraterm, added teraterm-256color -TD
    +#	+ add mlterm-direct -TD
    +#	+ add descriptions for ANSI building-blocks -TD
    +#
     ######## SHANTIH!  SHANTIH!  SHANTIH!
    diff --git a/package/debian-mingw/changelog b/package/debian-mingw/changelog
    index 8b790c7a..0042a6a2 100644
    --- a/package/debian-mingw/changelog
    +++ b/package/debian-mingw/changelog
    @@ -1,8 +1,8 @@
    -ncurses6 (6.0+20180121) unstable; urgency=low
    +ncurses6 (6.1+20180127) unstable; urgency=low
     
       * latest weekly patch
     
    - -- Thomas E. Dickey   Sat, 20 Jan 2018 19:48:08 -0500
    + -- Thomas E. Dickey   Mon, 22 Jan 2018 20:01:38 -0500
     
     ncurses6 (5.9-20131005) unstable; urgency=low
     
    diff --git a/package/debian-mingw64/changelog b/package/debian-mingw64/changelog
    index 8b790c7a..0042a6a2 100644
    --- a/package/debian-mingw64/changelog
    +++ b/package/debian-mingw64/changelog
    @@ -1,8 +1,8 @@
    -ncurses6 (6.0+20180121) unstable; urgency=low
    +ncurses6 (6.1+20180127) unstable; urgency=low
     
       * latest weekly patch
     
    - -- Thomas E. Dickey   Sat, 20 Jan 2018 19:48:08 -0500
    + -- Thomas E. Dickey   Mon, 22 Jan 2018 20:01:38 -0500
     
     ncurses6 (5.9-20131005) unstable; urgency=low
     
    diff --git a/package/debian/changelog b/package/debian/changelog
    index b623363e..42570c59 100644
    --- a/package/debian/changelog
    +++ b/package/debian/changelog
    @@ -1,8 +1,8 @@
    -ncurses6 (6.0+20180121) unstable; urgency=low
    +ncurses6 (6.1+20180127) unstable; urgency=low
     
       * latest weekly patch
     
    - -- Thomas E. Dickey   Sat, 20 Jan 2018 19:48:08 -0500
    + -- Thomas E. Dickey   Mon, 22 Jan 2018 20:01:38 -0500
     
     ncurses6 (5.9-20120608) unstable; urgency=low
     
    diff --git a/package/mingw-ncurses.nsi b/package/mingw-ncurses.nsi
    index c07042c6..bc6eaa2b 100644
    --- a/package/mingw-ncurses.nsi
    +++ b/package/mingw-ncurses.nsi
    @@ -1,4 +1,4 @@
    -; $Id: mingw-ncurses.nsi,v 1.252 2018/01/21 00:48:08 tom Exp $
    +; $Id: mingw-ncurses.nsi,v 1.254 2018/01/23 01:01:38 tom Exp $
     
     ; TODO add examples
     ; TODO bump ABI to 6
    @@ -8,9 +8,9 @@
     !define EXENAME "ncurses.exe"
     
     !define VERSION_MAJOR "6"
    -!define VERSION_MINOR "0"
    +!define VERSION_MINOR "1"
     !define VERSION_YYYY  "2018"
    -!define VERSION_MMDD  "0121"
    +!define VERSION_MMDD  "0127"
     !define VERSION_PATCH ${VERSION_YYYY}${VERSION_MMDD}
     
     !define MY_ABI   "5"
    diff --git a/package/mingw-ncurses.spec b/package/mingw-ncurses.spec
    index 58019b98..645db618 100644
    --- a/package/mingw-ncurses.spec
    +++ b/package/mingw-ncurses.spec
    @@ -2,8 +2,8 @@
     
     Summary: shared libraries for terminal handling
     Name: mingw32-ncurses6
    -Version: 6.0
    -Release: 20180121
    +Version: 6.1
    +Release: 20180127
     License: X11
     Group: Development/Libraries
     Source: ncurses-%{version}-%{release}.tgz
    diff --git a/package/ncurses.spec b/package/ncurses.spec
    index ce293127..3066d784 100644
    --- a/package/ncurses.spec
    +++ b/package/ncurses.spec
    @@ -1,7 +1,7 @@
     Summary: shared libraries for terminal handling
     Name: ncurses6
    -Version: 6.0
    -Release: 20180121
    +Version: 6.1
    +Release: 20180127
     License: X11
     Group: Development/Libraries
     Source: ncurses-%{version}-%{release}.tgz
    diff --git a/progs/tic.c b/progs/tic.c
    index 478da6c4..da227c32 100644
    --- a/progs/tic.c
    +++ b/progs/tic.c
    @@ -1,5 +1,5 @@
     /****************************************************************************
    - * Copyright (c) 1998-2016,2017 Free Software Foundation, Inc.              *
    + * Copyright (c) 1998-2017,2018 Free Software Foundation, Inc.              *
      *                                                                          *
      * Permission is hereby granted, free of charge, to any person obtaining a  *
      * copy of this software and associated documentation files (the            *
    @@ -48,7 +48,7 @@
     #include 
     #include 
     
    -MODULE_ID("$Id: tic.c,v 1.248 2017/12/16 23:05:21 tom Exp $")
    +MODULE_ID("$Id: tic.c,v 1.252 2018/01/25 19:16:50 tom Exp $")
     
     #define STDIN_NAME ""
     
    @@ -1614,6 +1614,9 @@ check_screen(TERMTYPE2 *tp)
     	bool have_kmouse = FALSE;
     	bool use_sgr_39_49 = FALSE;
     	char *name = _nc_first_name(tp->term_names);
    +	bool is_screen = !strncmp(name, "screen", 6);
    +	bool screen_base = (is_screen
    +			    && strchr(name, '.') == 0);
     
     	if (!VALID_BOOLEAN(have_bce)) {
     	    have_bce = FALSE;
    @@ -1635,12 +1638,10 @@ check_screen(TERMTYPE2 *tp)
     
     	if (have_XM && have_XT) {
     	    _nc_warning("Screen's XT capability conflicts with XM");
    -	} else if (have_XT
    -		   && strstr(name, "screen") != 0
    -		   && strchr(name, '.') != 0) {
    +	} else if (have_XT && screen_base) {
     	    _nc_warning("Screen's \"screen\" entries should not have XT set");
     	} else if (have_XT) {
    -	    if (!have_kmouse && have_bce) {
    +	    if (!have_kmouse && is_screen) {
     		if (VALID_STRING(key_mouse)) {
     		    _nc_warning("Value of kmous inconsistent with screen's usage");
     		} else {
    @@ -1654,8 +1655,11 @@ check_screen(TERMTYPE2 *tp)
     	    if (VALID_STRING(to_status_line))
     		_nc_warning("\"tsl\" capability is redundant, given XT");
     	} else {
    -	    if (have_kmouse && !have_XM)
    +	    if (have_kmouse
    +		&& !have_XM
    +		&& !screen_base && strchr(name, '+') == 0) {
     		_nc_warning("Expected XT to be set, given kmous");
    +	    }
     	}
         }
     #endif
    diff --git a/test/test.priv.h b/test/test.priv.h
    index f0a68c2e..e9966129 100644
    --- a/test/test.priv.h
    +++ b/test/test.priv.h
    @@ -1,5 +1,5 @@
     /****************************************************************************
    - * Copyright (c) 1998-2016,2017 Free Software Foundation, Inc.              *
    + * Copyright (c) 1998-2017,2018 Free Software Foundation, Inc.              *
      *                                                                          *
      * Permission is hereby granted, free of charge, to any person obtaining a  *
      * copy of this software and associated documentation files (the            *
    @@ -29,7 +29,7 @@
     /****************************************************************************
      *  Author: Thomas E. Dickey                    1996-on                     *
      ****************************************************************************/
    -/* $Id: test.priv.h,v 1.162 2017/12/26 22:20:42 tom Exp $ */
    +/* $Id: test.priv.h,v 1.164 2018/01/27 20:27:16 tom Exp $ */
     
     #ifndef __TEST_PRIV_H
     #define __TEST_PRIV_H 1
    @@ -442,6 +442,9 @@ extern int optind;
     #ifndef GCC_PRINTFLIKE
     #define GCC_PRINTFLIKE(a,b)	/* nothing */
     #endif
    +#ifndef GCC_SCANFLIKE
    +#define GCC_SCANFLIKE(a,b)	/* nothing */
    +#endif
     #ifndef GCC_UNUSED
     #define GCC_UNUSED		/* nothing */
     #endif
    @@ -611,9 +614,17 @@ extern int optind;
     
     #ifndef WA_NORMAL
     #define WA_NORMAL       A_NORMAL
    +#endif
    +#ifndef WA_BOLD
     #define WA_BOLD         A_BOLD
    +#endif
    +#ifndef WA_REVERSE
     #define WA_REVERSE      A_REVERSE
    +#endif
    +#ifndef WA_UNDERLINE
     #define WA_UNDERLINE    A_UNDERLINE
    +#endif
    +#ifndef WA_BLINK
     #define WA_BLINK        A_BLINK
     #endif