- a terminfo compiler tic(1), a decompiler infocmp(1), clear(1),
- tput(1), tset(1), and a termcap conversion tool captoinfo(1). Full
- manual pages are provided for the library and tools.
-
- The ncurses distribution is available via anonymous FTP at the GNU
- distribution site [1]ftp://ftp.gnu.org/gnu/ncurses/ .
- It is also available at [2]ftp://invisible-island.net/ncurses/ .
-
- Release Notes
-
- This release is designed to be upward compatible from ncurses 5.0
- through 5.7; very few applications will require recompilation,
- depending on the platform. These are the highlights from the
- change-log since ncurses 5.7 release.
-
-Interface changes
-
- * turn on _XOPEN_CURSES definition in curses.h.
- * change _nc_has_mouse to has_mouse, reflect its use in C++ and
- Ada95.
- * add is_pad and is_subwin functions for opaque access to the WINDOW
- structure.
- * add tiparm, based on review of X/Open Curses Issue 7.
-
-New features and improvements
-
- Library Improvements
-
- * add a terminal driver for Windows console, which supports a MinGW
- port to Windows.
- * add extended functions which specify the SCREEN pointer for
- several curses functions which use the global SP.
- * improve the NCURSES_NO_UTF8_ACS feature by adding a check for an
- extended terminfo capability U8.
- * improve performance of tigetstr, etc., by using hashing code from
- tic.
- * add WACS_xxx definitions to wide-character configuration for
- thick- and double-lines.
- * modify init_pair to allow caller to create extra color pairs
- beyond the color_pairs limit, which use default colors.
-
- Improvements to Programs
-
- * add tabs program.
- * modify tic's -I/-C dump to reformat acsc strings into canonical
- form (sorted, unique mapping).
- * add checks in tic for inconsistent cursor-movement controls, and
- for inconsistent printer-controls.
- * add special case to _nc_infotocap (used by tic and infocmp) to
- recognize the setaf/setab strings from xterm+256color and
- xterm+88color, and provide a reduced version which works with
- termcap.
-
- Terminal Database
-
- * added entries:
- + bterm terminfo entry, based on bogl 0.1.18
- + cons25-debian entry
- + eterm-color entry
- + linux-16color
- + mlterm+256color entry, for mlterm 3.0.0
- + several screen-bce.xxx entries
- + screen.Eterm terminfo entry
- + vwmterm entry
- + xterm-utf8 entry as a demo of the U8 feature
- * updated/improved entries:
- + use extended capabilities:
- o add U8 feature to denote entries for terminal emulators
- which do not support VT100 SI/SO when processing UTF-8
- encoding
- o add XT capability to entries for terminals that support
- both xterm-style mouse- and title-controls, for screen
- which special-cases TERM beginning with xterm or rxvt
- + improvements based on new checks in tic:
- +
- o fill in no-parameter forms of cursor-movement where a
- parameterized form is available
- o fill in missing cursor controls where the form of the
- controls is ANSI
- o add parameterized cursor-controls to linux-basic
- o modify nsterm, xnuppc and tek4115 to make sgr/sgr0
- consistent
- o change several terminfo entries to make consistent use
- of ANSI clear-all-tabs
- + extend ansi.sys pfkey capability from kf1-kf10 to kf1-kf48,
- moving function key definitions from emx-base for
- consistency.
- + correct missing final 'p' in pfkey capability of
- ansi.sys-old.
- + rename atari and st52 terminfo entries to atari-old,
- st52-old, use newer entries from FreeMiNT.
- + repurpose gnome terminfo entries as vte, retaining gnome
- variants for compatibility, but generally deprecating those
- since the VTE library is what actually defines the behavior
- of "gnome", etc., since 2003.
- + improve interix smso terminfo capability by using reverse
- rather than bold.
- + correct initc capability of linux-c-nc end-of-range, make
- similar change for dg+ccc and dgunix+ccc.
- + update minix terminfo entry.
- + updated nsterm* entries.
- + remove unnecessary kcan assignment to ^C from putty.
- + suppress ncv in screen and konsole-base entries, allowing
- underline.
- + change ncv and op capabilities in sun-color terminfo entry to
- match Sun's entry for this.
- + fix typo in rmso for tek4106 entry.
- + improve acsc string for vt52, show arrow keys.
- + add hard-reset for rs2 to wsvt25 to help ensure that reset
- ends the alternate character set.
- + add ccc and initc capabilities to xterm-16color.
-
-Major bug fixes
-
- * ncurses library
- + wide character support
- o modify length returned by getcchar to count the trailing
- null which is documented in X/Open.
- o fix an infinite recursion when adding a legacy-coding
- 8-bit value using insch.
- o improve a workaround in adding wide-characters, when a
- control character is found. The library uses unctrl to
- obtain a printable version of the control character, but
- was not passing color or video attributes.
- o modify waddch_literal, updating line-pointer after a
- multicolumn character is found to not fit on the current
- row, and wrapping is done. Since the line-pointer was
- not updated, the wrapped multicolumn character was
- written to the beginning of the current row.
- o fixes in wins_nwstr and related functions to ensure that
- special characters, i.e., control characters are handled
- properly with the wide-character configuration.
- o correct internal _nc_insert_ch to use _nc_insert_wch
- when inserting wide characters, since the wins_wch
- function that it used did not update the cursor
- position.
- + mouse
- o add check if Gpm_Open returns a -2, e.g., for "xterm".
- This is normally suppressed but can be overridden using
- $NCURSES_GPM_TERMS. Ensure that Gpm_Close is called in
- this case.
- o add check in mouse-driver to disable connection if GPM
- returns a zero, indicating that the connection is
- closed.
- o modify getmouse to act as its documentation implied,
- returning on each call the preceding event until none
- are left. When no more events remain, it will return
- ERR.
- + miscellaneous
- o improve handling of color-pairs embedded in attributes
- for the extended-colors configuration.
- o add check for failure to open hashed-database needed for
- db4.6.
- o modify use of $CC environment variable which is defined
- by X/Open as a curses feature, to ignore it if it is not
- a single character.
- o modify declaration of cur_term when broken-linker is
- used, but enable-reentrant is not, to match pre-5.7.
- o correct limit-checks in derwin.
- o remove old check in mvderwin which prevented moving a
- derived window whose origin happened to coincide with
- its parent's origin.
- o correct limit-checks in newwin, to ensure that windows
- have nonzero size.
- o modify set_curterm to make broken-linker configuration
- work with changes from 20090228.
- o modify wgetch to ensure it checks SIGWINCH when it gets
- an error in non-blocking mode.
- o correct limit-check in wredrawln, accounting for
- begy/begx values.
- o fix a null-pointer check in _nc_format_slks in
- lib_slk.c, from 20070704 changes.
- o correct translation of "^" in _nc_infotocap, used to
- transform terminfo to termcap strings.
- o modify _nc_wgetch to check for a -1 in the fifo, e.g.,
- after a SIGWINCH, and discard that value, to avoid
- confusing application.
- * other libraries
- + correct transfer of multicolumn characters in multirow
- field_buffer, which stopped at the end of the first row due
- to filling of unused entries in a cchar_t array with nulls.
- + correct buffer-size after internal resizing of wide-character
- set_field_buffer, broken in 20081018 changes.
- + correct layout of working window used to extract data in
- wide-character configured by set_field_buffer
-
-Portability
-
- * configure script:
- + new options:
-
- --disable-libtool-version
- use the "-version-number" feature which was added
- in libtool 1.5. The default value for the option
- uses the newer feature, which makes libraries
- generated using libtool compatible with the
- standard builds of ncurses.
-
- --disable-rpath-hack
- disable a feature which adds rpath options for
- libraries in unusual places.
-
- --enable-interop
- integrate changes for generic/interop support to
- form-library.
-
- --enable-pc-files
- generate ".pc" files for each of the libraries, and
- install them in pkg-config's library directory.
-
- --enable-pthreads-eintr
- control whether to allow EINTR to interrupt a read
- operation in wgetch. This applies only to the
- pthread configuration
-
- --enable-sp-funcs
- 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.
-
- --enable-term-driver
- compile with terminal-driver. That is used in the
- MinGW port, and (being somewhat more complicated)
- is an experimental alternative to the conventional
- termlib internals. Currently, it requires the
- sp-funcs feature to be enabled.
-
- --with-ncurses-wrap-prefix
- allows setting the prefix for functions used to
- wrap global variables to something other than
- "_nc_".
-
- --with-pkg-config=[DIR]
- check for pkg-config, optionally specifying its
- path.
-
- --without-manpages
- tells the configure script to suppress the install
- of ncurses' manpages.
-
- --without-tests
- suppress building test programs.
-
- + improved options:
- o correct logic for --with-database, which was coded as an
- enable-type switch.
- o omit the opaque-functions from lib_gen.o when
- --disable-ext-funcs is used.
- * packaging:
- + *-config scripts:
- o modify adacurses-config to look for ".ali" files in the
- adalib directory.
- o correct install for the Ada95 tree, which omitted
- libAdaCurses.a used in adacurses-config.
- o change install for adacurses-config to provide
- additional flavors such as adacursesw-config, for
- ncursesw.
- o modify scripts to generate ncurses*-config and pc-files
- to add dependency for tinfo library.
- o use ncurses*-config scripts if available for
- test/configure.
- o correct name for termlib in ncurses*-config, e.g., if it
- is renamed to provide a single file for ncurses/ncursesw
- libraries.
- o generate manpages for the *-config scripts, adapted from
- help2man.
- o modify install-rule for manpages so that *-config
- manpages will install when building with --srcdir.
- o build-fixes for OpenSolaris aka Solaris 11, for
- wide-character configuration as well as for rpath
- feature in *-config scripts.
- o use $includedir symbol in misc/ncurses-config.in, add
- --includedir option.
- o improve install-rules for pc-files.
- o create the pkg-config library directory if needed.
- o fix typo "==" where "=" is needed in ncurses-config.in
- and gen-pkgconfig.in files.
- o modify gen-pkgconfig.in to eliminate a dependency on
- rpath when deciding whether to add $LIBS to --libs
- output; that should be shown for the ncurses and tinfo
- libraries without taking rpath into account.
- o modify handling of $PKG_CONFIG_LIBDIR to use only the
- first item in a possibly colon-separated list.
- + other packaging issues
- o add make-tar.sh scripts to Ada95 and test subdirectories
- to help with making those separately distributable.
- o add Ada95/configure script, to use in tar-file created
- by Ada95/make-tar.sh.
- o remove tar-copy.sh and related configure/Makefile
- chunks, since the Ada95 binding is now installed using
- rules in Ada95/src.
- * cross-compiling:
- + improve configure checks for location of tic and infocmp
- programs used for installing database and for generating
- fallback data, e.g., for cross-compiling.
- + modify #define's for build-compiler to suppress cchar_t
- symbol from compile of make_hash and make_keys, improving
- cross-compilation of ncursesw.
- + simplify include-dependencies of make_hash and make_keys, to
- reduce the need for setting BUILD_CPPFLAGS in cross-compiling
- when the build- and target-machines differ.
- + correct cross-compiling configure check for CF_MKSTEMP macro,
- by adding a check cache variable set by AC_CHECK_FUNC.
- * library dependencies:
- + revise wadd_wch and wecho_wchar to eliminate dependency on
- unctrl.
- + adjust configure script so that "t" is not added to library
- suffix when weak-symbols are used, allowing the pthread
- configuration to more closely match the non-thread naming.
- * building the Ada95 tree:
- + changes to use gnatmake project files in the Ada95 tree.
- + add/use configure check to turn on project rules for
- Ada95/src.
- + old gnatmake (3.15) does not produce libraries using
- project-file; work around by adding script to generate
- alternate makefile.
- + add configure --with-ada-sharedlib option, for the test_make
- rule.
- + move Ada95-related logic into aclocal.m4, since additional
- checks will be needed to distinguish old/new implementations
- of gnat.
- + add test_make / test_clean / test_install rules in Ada95/src
- + change install-path for adainclude directory to
- /usr/share/ada (was /usr/lib/ada).
- * other configure/build issues:
- + make CCHARW_MAX value configurable, noting that changing this
- would change the size of cchar_t, and would be
- ABI-incompatible.
- + improve comparison of program-names when checking for linked
- flavors such as "reset" by ignoring the executable suffix.
- + drop mkdirs.sh, use "mkdir -p".
- + drop misc/ncu-indent and misc/jpf-indent; they are provided
- by an external package [3]cindent.
- + change makefiles to use $ARFLAGS rather than $AR_OPTS,
- provide a configure check to detect whether a "-" is needed
- before "ar" options.
- + modify CF_DISABLE_LEAKS configure macro so that the
- --enable-leaks option is not the same as --disable-leaks.
- + improve configure script macros CF_HEADER_PATH and
- CF_LIBRARY_PATH by adding CFLAGS, CPPFLAGS and LDFLAGS, LIBS
- values to the search-lists.
- + improve configure macros CF_GCC_VERSION and CF_GCC_WARNINGS
- to work with gcc 4.x's c89 alias, which gives warning
- messages for cases where older versions would produce an
- error.
- + modify CF_WITH_LIBTOOL configure check to allow unreleased
- libtool version numbers (e.g. which include alphabetic chars,
- as well as digits, after the final '.').
- + improve use of symbolic links in makefiles by using "-f"
- option if it is supported, to eliminate temporary removal of
- the target
- + add a configure-time check to pick a suitable value for
- CC_SHARED_OPTS for Solaris.
- + add -shared option to MK_SHARED_LIB when -Bsharable is used,
- for *BSD's, without which "main" might be one of the shared
- library's dependencies.
- + modify configure script to allow building shared libraries
- with gcc on AIX 5 or 6.
- + suppress configure check for static/dynamic linker flags for
- gcc on Solaris 10, since gcc is confused by absence of static
- libc, and does not switch back to dynamic mode before
- finishing the libraries.
- + suppress configure check for static/dynamic linker flags for
- gcc on Darwin.
- + modify misc/run_tic.in to create parent directory, in case
- this is a new install of hashed database.
- + modify configure check for tic program, used for fallbacks,
- to a warning if not found. This makes it simpler to use
- additonal scripts to bootstrap the fallbacks code using tic
- from the build tree.
- * test programs:
- + add test/demo_terminfo, for comparison with demo_termcap.
- + improve test/ncurses.c 'F' test, show combining characters in
- color.
- + fix logic for 'V' in test/ncurses.c tests f/F.
- + improve test/ncurses.c 'a test to put mouse droppings in the
- proper window.
- + modify ncurses 'F' test to demo wborder_set with colored
- lines.
- + modify ncurses 'f' test to demo wborder with colored lines.
- + improve test/ncurses.c 'a' test, using unctrl more
- consistently to display meta-characters.
- + correct use of key_name in test/ncurses.c 'A' test, which
- only displays wide-characters, not key-codes since 20070612.
- + add test/clip_printw.c to illustrate how to use printw
- without wrapping.
- + modify test-programs, e.g,. test/view.c, to address subtle
- differences between Tru64/Solaris and HPUX/AIX getcchar
- return values.
- + add some test programs (and make these use the same special
- keys by sharing linedata.h functions): test/test_addstr.c
- test/test_addwstr.c test/test_addchstr.c
- test/test_add_wchstr.c
- + add test/xterm-256color.dat
- + modify test programs to allow them to be built with NetBSD
+ * captoinfo, a termcap conversion tool
+ * clear, utility for clearing the screen
+ * infocmp, the terminfo decompiler
+ * tabs, set tabs on a terminal
+ * tic, the terminfo compiler
+ * toe, list (table of) terminfo entries
+ * tput, utility for retrieving terminal capabilities in shell
+ scripts
+ * tset, to initialize the terminal
+
+ Full manual pages are provided for the library and tools.
+
+ The ncurses distribution is available at ncurses' homepage:
+
+ 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://ftp.gnu.org/gnu/ncurses/ .
+
+Release Notes
+
+ These notes are for ncurses 6.2, released February 12, 2020.
+
+ This release is designed to be source-compatible with ncurses 5.0
+ through 6.1; providing extensions to the application binary interface
+ (ABI). Although the source can still be configured to support the
+ ncurses 5 ABI, the reason for the release is to reflect improvements
+ to the ncurses 6 ABI and the supporting utility programs.
+
+ There are, of course, numerous other improvements, listed in this
+ announcement.
+
+ The most important bug-fixes/improvements dealt with user-defined
+ capabilities in terminal descriptions. The release notes also mention
+ some other bug-fixes, but are focused on new features and improvements
+ to existing features since ncurses 6.1 release.
+
+ Library improvements
+
+ New features
+
+ There are several new features:
+ * O_EDGE_INSERT_STAY tells the form library to optionally delay
+ cursor movement on a field edge/boundary
+ * O_INPUT_FIELD extension to form library allows a dynamic field to
+ shrink if the new limit is smaller than the current field size.
+ * added exit_curses and exit_terminfo to replace internal symbols
+ for leak-checking.
+ * added curses_trace, to replace trace().
+
+ Additionally, to improve performance other changes (and extensions)
+ are provided in this release:
+ * mouse decoding now handles shift/control/alt logic when decoding
+ xterm's 1006 mode
+ * ncurses now defines a limit for wgetnstr, wgetn_wstr when length
+ is negative or "too large".
+ * reordered loop-limit checks in winsnstr in case the string has no
+ terminating null and only the number of characters is used.
+ * there is now no buffer-size limit when reading the $TERMCAP
+ variable.
+ * the $TERMCAP variable may be interpreted as a fallback to a
+ terminfo entry
+ * mvcur now decides whether to use hard-tabs, using xt, tbc and hts
+ as clues.
+ * extended colors are improved by modifying an internal call to
+ vid_puts to pass extended color pairs e.g., from tty_update.c and
+ lib_mvcur.c
+ * the initialization functions now avoid relying upon persistent
+ data for the result from getenv
+ * scrolling is improved:
+ + a limit check in newline_forces_scroll handles the case where
+ the row is inside scroll-margins, but not at the end.
+ + improved loop limits in _nc_scroll_window handle a case where
+ the scrolled data is a pad which is taller than the window.
+
+ Other improvements
+
+ These are revised features:
+ * used "const" in some prototypes rather than NCURSES_CONST where
+ X/Open Curses was updated to do this, e.g., wscanw, newterm, the
+ terminfo interface. Also use "const" for consistency in the
+ termcap interface, which was withdrawn by X/Open Curses in Issue 5
+ (2007). As of Issue 7, X/Open Curses still lacks "const" for
+ certain return values, e.g., keyname.
+ * modified wbkgd and wbkgrnd to improve compatibility with SVr4
+ curses, changing the way the window rendition is updated when the
+ background character is modified
+ * improved terminfo write/read by modifying the fourth item of the
+ extended header to denote the number of valid strings in the
+ extended string table (see term(5)).
+ * modified the initialization checks for mouse so that the
+ xterm+sm+1006 block will work with terminal descriptions not
+ mentioning xterm.
+
+ These were done to limit or ultimately deprecate features:
+ * deprecated safe-sprintf, since the vsnprintf function, which does
+ what was needed, was standardized long ago.
+ * marked vwprintw and vwscanw as deprecated; recommend using
+ vw_printw and vw_scanw, respectively.
+ * added deprecation warnings for internal functions called by older
+ versions of tack.
+ * removed unused _nc_import_termtype2 function.
+
+ These are improvements to existing features:
+ * check parameter of set_escdelay, return ERR if negative.
+ * check parameter of set_tabsize, return ERR if not greater than
+ zero
+ * correct a status-check in _nc_read_tic_entry() so that if reading
+ a hex/b64 $TERMINFO, and the $TERM does not match, fall-through to
+ the compiled-in search list.
+ * amend check for repeat_char to handle a case where setlocale() was
+ called after initscr
+ * move macro for is_linetouched inside NCURSES_NOMACROS ifndef.
+ * use _nc_copy_termtype2 rather than direct assignment in setupterm,
+ in case it is called repeatedly using fallback terminfo
+ descriptions
+ * improve workaround for Solaris wcwidth versus line-drawing
+ characters
+ * add checks in repair_subwindows to keep the current position and
+ scroll-margins inside the resized subwindow.
+ * correct a buffer-limit in write_entry.c for systems that use
+ caseless filenames.
+ * improved build-time utility report_offsets:
+ + add categories, e.g., "w" for wide-character, "t" for threads
+ to make the report more readable. Reorganized the structures
+ reported to make the categories more apparent.
+ + add NCURSES_GLOBALS and NCURSES_PRESCREEN to report to show
+ how similar the different libtinfo configurations are.
+ * modified some header files to ensure that those include necessary
+ files except for the previously-documented cases
+ * added some traces in initialization to show whether a fallback
+ entry is used.
+ * made minor optimization to reduce calls to _nc_reserve_pairs
+
+ These are corrections to existing features:
+ * fix a special case in PutAttrChar where a cell is marked as
+ alternate-character set, but the terminal does not actually
+ support the given graphic character. This would happen in an older
+ terminal such as vt52, which lacks most line-drawing capability.
+ * corrected flag for "seq" method of db 1.8.5 interface, needed by
+ toe on some of the BSDs.
+ * modify comparison in make_hash.c to correct a special case in
+ collision handling for Caps-hpux11
+ * add extended_slk_color{,_sp} symbols to the appropriate
+ package/*.{map,sym} files
+ * modify lib_setup to avoid calling pthread_self() without first
+ verifying that the address is valid, i.e., for weak symbols
+ * add a couple of broken-linker symbols to the list of versioned
+ symbols to help with link-time optimization versus weak symbols.
+
+ Program improvements
+
+ Several improvements were made to the utility programs:
+
+ clear
+
+ + improved logic for clearing with the E3 extension, in case
+ the terminal scrolls content onto its saved-lines before
+ actually clearing the display, by clearing the saved-lines
+ after clearing the display
+
+ infocmp
+
+ + omit filtering of "OTxx" names which are used for obsolete
+ capabilities, when the output is sorted by long-names. This
+ change helps when making a table of the short/long capability
+ names.
+
+ tic
+
+ + added check for consistent alternate character set
+ capabilities.
+ + added check for paired indn/rin.
+ + added check for terminals with parm_dch vs parm_ich.
+ + added check for the case where setf/setb are given using
+ different strings, but provide identical results to
+ setaf/setab.
+ + corrected check for ich1.
+ + changed a too-large terminal entry from a fatal error to a
+ warning.
+
+ toe
+
+ + ignores any hex/b64 $TERMINFO value in the list of terminfo
+ databases.
+
+ tset
+
+ + replace check in reset command for obsolete "pt" capability
+ using tbc and hts capabilities as clues
+ + modify reset to allow for tabstops at intervals other than 8.
+ + change reset's behavior for margins to simply clear
+ soft-margins if possible, rather than clearing and then
+ setting them according to the terminal's width.
+
+ tput
+
+ + add "x" to getopt string so that "tput -x clear" works.
+
+ Several changes were made to the generated ncurses*config scripts and
+ the analogous ".pc" files to reduce differences between the
+ configurations they report:
+ * modified the ncurse*-config and pc-files to more closely match for
+ the -I and -l options.
+ * filtered out linker-specs from the --libs report.
+ * amended the ncurses*-config and pc-files to take into account the
+ rpath hack which differed between those files.
+ * modified generated ncurses*config and ncurses.pc, ncursesw.pc,
+ etc., to list helper libraries such as gpm for static linking.
+
+ Examples
+
+ Along with the library and utilities, improvements were made to the
+ ncurses-examples. Most of this activity aimed at improving the
+ test-packages. A few changes are more generally useful, e.g., for the
+ main ncurses test-program, and for analyzing traces using the
+ tracemunch script:
+ * improve recovery from error when reading command-character in
+ test/ncurses.c, showing the relevant error message and not exiting
+ on EINTR.
+ * improve tracemunch, by keeping track of TERMINAL* values, and if
+ tracing was first turned on after initialization, attempt to show
+ distinct screen, window and terminal names anyway.
+ * modify tracemunch to accept filename parameters in addition to use
+ as a pipe/filter.
+ * update tracemunch to work with perl 5.26.2, which changed the
+ rules for escaping regular expressions.
+ * add some checks in tracemunch for undefined variables.
+ * modify TurnOn/TurnOff macros (in lib_vidattr.c and lib_vid_attr.c)
+ to avoid expansion of "CUR" in trace.
+
+ There are other new demo/test programs and reusable examples:
+
+ color_content
+ Demonstrate the color_content and extended_color_content
+ functions.
+
+ demo_tabs
+ A simple demo of tabs in curses.
+
+ dump_window
+ A portable curses screen-dump, used to compare ncurses screen
+ contents with Solaris.
+
+ pair_content
+ Demonstrate the pair_content and extended_pair_content
+ functions.
+
+ report_hashing
+ Check hash-tables used for terminfo and termcap names.
+
+ parse_rgb
+ Sample implementation of the ncurses RGB extension from
+ user_caps.5, used in picsmap and savescreen programs.
+
+ 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.
+ * add "-l" option to test/background, to dump screen contents in a
+ form that lets different curses implementations be compared.
+ * add "@" command to test/ncurses F-test, to allow rapid jump to
+ different character pages.
+ * added enum, regex examples to test/demo_forms
+ * amend Scaled256() macro in test/picsmap.c to cover the full range
+ 0..1000
+ * corrected pathname used in Ada95 sample programs for explain.txt,
+ to work with test-packages, and used an awk script to split the
+ resulting pathname when it would be too long for a single line.
+ * ignore interrupted system-call in test/ncurses's command-line,
+ e.g., if the terminal were resized.
+ * improved ifdef's for TABSIZE variable, to help with AIX/HPUX
+ ports.
+
+ Terminal database
+
+ There are several new terminal descriptions:
+
+ alacritty, domterm, kitty, mintty, mintty-direct, ms-terminal,
+ n7900, nsterm-build309, nsterm-direct, screen5, ti703, ti707,
+ ti703-w, ti707-w vscode, vscode-direct, xterm-mono, xterm.js
+
+ There are many changes to existing terminal descriptions. Some were
+ updates to several descriptions:
+ * use ansi+rep in a dozen places
+ * add rs1 to konsole, mlterm
+ * improve several flash capabilities with trailing mandatory delays
+ * drop ich1 from rxvt-basic, Eterm and mlterm to improve
+ compatibility with old non-curses programs
+ * add/use xterm+keypad in xterm-new
+ * use xterm+sl-twm for consistency, nine places
+ * improve xm example in xterm+x11mouse and xterm+sm_1006.
+
+ while others affected specific descriptions. These were retested, to
+ take into account changes by their developers:
+
+ terminator, st
+
+ while these are specific fixes based on reviewing documentation, user
+ reports, or warnings from tic:
+
+ adds200:
+
+ + fix typo
+
+ gnome-256color
+
+ + base entry on "gnome", not "vte", for consistency
+
+ interix
+
+ + trim unnecessary setf/setb
+
+ linux-16color
+
+ + accommodate Linux console driver incompatibility introduced
+ in early 2018
+
+ nsterm-256color:
+
+ + add nsterm-build309 to replace nsterm-256color, assigning the
+ latter as an alias of nsterm, to make mouse work with
+ nsterm-256color
+
+ regent40:
+
+ + renumber function-keys to match manual
+
+ regent60:
+
+ + add cd (clr_eos)
+ + corrected acsc
+ + add shifted function-keys
+
+ tvi950:
+
+ + added function-key definitions to agree with Televideo 950
+ manual
+ + corrected acsc
+ + remove bogus kf0
+ + add bel
+
+ tvi955:
+
+ + fix typo
+
+ vi200:
+
+ + add acsc string, including right/down-arrow
+
+ wy50:
+
+ + corrected acsc
+
+ wy50 and wy60:
+
+ + add shifted function-keys as kF1 to kF16
+
+ xterm+x11hilite:
+
+ + eliminate unused p5 parameter.
+
+ A few entries use extensions (user-defined terminal capabilities):
+ * use xterm+sm+1006 (aka "SGR 1006 mouse") for konsole-base and
+ putty
+ * add Smol/Rmol user-defined capability to tmux and vte-2018
+ * add Smulx user-defined capability to tmux, vte-2018
+
+ 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.
+
+ In addition to providing background information to explain these
+ features and show how they evolved, there are corrections,
+ clarifications, etc.:
+ * Corrections:
+ + correct error-returns listed in manual pages for a few form
+ functions
+ + corrected prototypes in several manpages using script to
+ extract those in compilable form.
+ + fix typo in term.5, improve explanation of format
+ * Clarify in manual pages that vwprintw and vwscanw are obsolete.
+ They have not been part of X/Open Curses since 2007.
+ * New/improved history and portability sections:
+ + curs_addch.3x gives some background for ACS symbols.
+ + curs_getcchar.3x explains a difference between ncurses and
+ X/Open Curses.
+ + curs_getstr.3x gives historical/portability background for
+ the length parameter of wgetnstr.
+ + curs_slk.3x lists a few differences between SVr4 curses and
+ X/Open Curses for soft-keys.
+ + curs_terminfo.3x explains that the initial implementation of
+ terminfo in SVr2 was mostly replaced by other developers in
+ SVr3.
+ + infocmp.1 explains that the initial version of terminfo had
+ no tool for decompiling descriptions. That came later, with
+ SVr3, with a different developer.
+ + tabs.1 tells more than you wanted to know about the tool.
+ + tic.1 explains that the initial version of terminfo had a
+ rudimentary tool (based on termcap) for compiling entries.
+ The tool used with Unix was developed by others for SVr3.
+ + toe.1 explains the origin of this tool.
+ * Improvements for user_caps.5:
+ + mention meml, memu and box1
+ + expanded description of XM
+ + add a clarification regarding the RGB capability.
+ + mention user_caps.5 in the tic and infocmp manual pages.
+ * Other improvements:
+ + curs_add_wch.3x adds note about Unicode terminology for the
+ line-drawing characters.
+ + curs_color.3x improves discussion of error returns and
+ extensions.
+ + curs_mouse.3x explains how the kmous and XM capabilities are
+ used for xterm-mouse input.
+ + curs_refresh.3x improves documentation regarding the virtual
+ and physical screens.
+ + curs_util.3x mentions a difference between SVr4 and X/Open
+ Curses for unctrl.h
+ + curs_variables.3x improves description of the init_tabs
+ capability and TABSIZE variable.
+ + ncurses.3x improves documentation regarding feature-test
+ macros in curses.h
+ + resizeterm.3x about top-level windows which touch the
+ screen's borders.
+ + tput.1 clarifies how tput determines the terminal size.
+
+ There are no new manual pages (all of the manual page updates are to
+ existing pages).
+
+ Some of the improvements are more subtle, relating to the way the
+ information is presented. For instance, the generated terminfo.5 file
+ uses a different table layout, allowing it to use space on wide
+ terminals more effectively.
+
+ Interesting bug-fixes
+
+ While there were many bugs fixed during development of ncurses 6.2,
+ only a few (the reason for this release) were both important and
+ interesting. Most of the bug-fixes were for local issues which did not
+ affect compatibility across releases. Since those are detailed in the
+ NEWS file no elaboration is needed here.
+
+ The interesting bugs were in tic/infocmp's handling of user-defined
+ capabilities. These were not recent bugs. Initially it was a simple
+ problem:
+ * The user-defined capabilities can be any type (boolean, number or
+ string), but once given a type all uses of the name must conform
+ to that type--unless some special support for a particular
+ multi-typed name is built into ncurses.
+ * One of simpleterm's contributors copied some definitions for using
+ tmux's user-defined capabilities in late in 2016.
+
+diff --git a/st.info b/st.info
+@@ -185,7 +185,10 @@ st| simpleterm,
+ tsl=\E]0;,
+ xenl,
+ vpa=\E[%i%p1%dd,
+-
++# Tmux unofficial extensions, see TERMINFO EXTENSIONS in tmux(1)
++ Se,
++ Ss,
++ Tc,
+
+ st-256color| simpleterm with 256 colors,
+ use=st,
+
+ * Later, in (referring to a version from mid-2017), a user asked to
+ have it updated in ncurses.
+ * However, it had an error from the change in late 2016. The
+ terminal description made what tmux expected to be string actually
+ a boolean.
+ Over the years, there were problems with each of simpleterm's
+ terminal descriptions. I repaired those, and usually dealt with
+ the problem.
+ * The difference in this case was that when compiling the terminal
+ database, tic may have in memory the definitions for more than one
+ terminal description (so that it can resolve "use=" clauses).
+ Seeing two different types for the same name, in certain
+ situations it would incorrectly merge the symbol tables for the
+ two terminal descriptions.
+ * On simpleterm's side, their bug was finally fixed in late 2019,
+ three years after the bug was created.
+
+ For ncurses, the elapsed time to fix this bug was less than three
+ years. Someone reported a problem with the terminal description a few
+ weeks after releasing ncurses 6.1 (in tmux #1264), and the terminal
+ description was updated that week (ncurses patch 20180224):
+
+20180224
+ + modify _nc_resolve_uses2() to detect incompatible types when merging
+ a "use=" clause of extended capabilities. The problem was seen in a
+ defective terminfo integrated from simpleterm sources in 20171111,
+ compounded by repair in 20180121.
+ + correct Ss/Ms interchange in st-0.7 entry (tmux #1264) -TD
+
+ The larger part of that change added a check to prevent a simple merge
+ of terminal descriptions where the same user-defined name was used
+ with different types. But it raised some questions:
+ * Was there a reliable way to manage terminal descriptions which
+ used the same extended name in different ways?
+ * Should ncurses provide a registry of well-known extended names,
+ with their types?
+
+ Since the correction to terminfo.src could have been readily adopted
+ by packagers, there was nothing more to be done from ncurses'
+ standpoint on that part. But improving ncurses to prevent issues like
+ that is the reason for making a release.
+
+ Nothing more (constructive) was mentioned with regard to simpleterm.
+ But a few problems were found in the handling of user-defined
+ capabilities:
+ * Forward-references to user-defined capabilities in a "use=" clause
+ did not allocate new data for each use. In tic, successive
+ compilation of terminal entries could add user-defined
+ capabilities to the wrong terminal entry.
+ This was not noticed before, since xterm's terminal descriptions
+ were the main users of the feature, and almost all of the uses of
+ the building-blocks which contained user-defined capabilities were
+ backward-references.
+ * There is one (documented) case where ncurses 6.1 supports a
+ user-defined capability that could be any type (i.e., "RGB"). The
+ check added in February 2018 to guard against mismatches did not
+ handle all of the combinations needed.
+
+ Both of these issues dated from the original implementation of
+ user-defined capabilities. Fixing them does not change the terminal
+ database, but a older tic without the fixes will not be able to handle
+ terminfo sources which rely upon those fixes. Starting in June 2019,
+ the download link for the terminfo source file was capped at that
+ date. The development sources have an up-to-date copy of the file, for
+ people with a legitimate need for it.
+
+ The "-c" (check) option of tic is not very useful if it cannot offer
+ advice on parameters needed for user-defined capabilities. The various
+ Caps files were reorganized to reduce redundancy, and in the common
+ portion (Caps-ncurses), a registry of user-defined capabilities is
+ provided for use by tic. While users can still define their own custom
+ capabilities, tic will not offer any advice when their parameters do
+ not match.
+
+ In ncurses 6.2, tic makes a special check to allow any type for RGB,
+ but its being able to do this relies upon fixes made in the ncurses
+ library in mid-2019.
+
+ Configuration changes
+
+ Major changes
+
+ There are no major changes. Several new options were added to ease
+ integration of packages with systems using different versions of GNAT
+ and ncurses. Also, improvements were made to configure checks.
+
+ Configuration options
+
+ There are a few new/modified configure options:
+
+ --with-config-suffix
+ helps work around a filename conflict with Debian packages
+ versus test-packages.
+
+ --with-ada-libname
+ allows one to rename the "AdaCurses" library (at least one
+ packager prefers a lowercase name).
+
+ --with-fallbacks
+ now ensures there is a value, and adds the fallback information
+ to top-level Makefile summary.
+
+ --with-pcre2
+ check for pcre-posix library to help with MinGW port.
+
+ --with-tic-path and
+
+ --with-infocmp-path
+ help work around problems building fallback source using
+ pre-6.0 tic/infocmp.
+
+ --with-versioned-syms
+ option value can now be a relative pathname.
+
+ Portability
+
+ Many of the portability changes are implemented via the configure
+ script:
+ * ignore $TERMINFO as a default value in configure script if it came
+ from the infocmp -Q option.
+ * distinguish gcc from icc and clang when the --enable-warnings
+ option is not used, to avoid unnecessary warnings about
+ unrecognized inline options
+ * consistently prepend new libraries as they are found during
+ configuration, rather than relying upon the linker to resolve
+ order dependencies of libraries.
+ * modified configure scripts to reduce relinking/ranlib during
+ library install :
+ + use "install -p" when available, to avoid need for ranlib of
+ static libraries.
+ + scripts which use "--disable-relink;" add a 1-second sleep to
+ work around tools which use whole-second timestamps, e.g., in
+ utime rather than the actual file system resolution.
+ * add configure check for getenv to work around implementation shown
+ in Emscripten which overwrites the previous return value on each
+ call.
+ Use that to optionally suppress START_TRACE macro, whose call to
+ getenv may not work properly
+ * change target configure level for _XOPEN_SOURCE to 600 to address
+ use of vsscanf and setenv.
+ * reduce use of _GNU_SOURCE for current glibc where _DEFAULT_SOURCE
+ combines with _XOPEN_SOURCE
+ Allow for Cygwin's newlib when checking for the _DEFAULT_SOURCE
+ symbol.
+ MidnightBSD is now checked for the _XOPEN_SOURCE-related
+ definitions.
+ * If the check for va_copy or __va_copy fails,
+ + configure now tries copying the pointers for va_list, or as
+ an array.
+ + alternatively, it checks for __builtin_va_copy(), which could
+ be used with AIX xlc in c89 mode.
+ * several changes to support a port to Ultrix 3.1:
+ + check if "b" binary feature of fopen works
+ + check for missing feature of locale.h
+ + add fallback for strstr() in test-programs
+ + add fallback for STDOUT_FILENO in test-programs
+ * The test/configure script (used for ncurses-examples) is improved:
+ + work around non-ncurses termcap.h file, e.g., in Slackware.
+ + check for TABSIZE variable.
+ + checks for the X11/Intrinsic.h header, accommodate recent
+ MacOS changes which largely emptied /usr/include.
+
+ Here are some of the other portability fixes:
+ * added dummy "check" rule in top-level and test-Makefile to
+ simplify building test-packages for ArchLinux.
+ * dropped library-dependency on psapi for MinGW port, since
+ win_driver.c defines PSAPI_VERSION to 2, making it use
+ GetProcessImageFileName from kernel32.dll
+ * made build-fixes for configuration using --program-suffix with
+ Ada95, noticed with MacOS but applicable to other platforms
+ without libpanelw, etc.
+ * modified ncurses/Makefile.in to fix a case where Debian/testing
+ changes to the ld --as-needed configuration broke ncurses-examples
+ test packages.
+ * used _WIN32/_WIN64 in preference to __MINGW32__/__MINGW64__
+ symbols to simplify building with Microsoft Visual C++, since the
+ former are defined in both compiler configurations.
+ _________________________________________________________________
+
+Features of ncurses
+
+ The ncurses package is fully upward-compatible with SVr4 (System V
+ Release 4) curses:
+ * All of the SVr4 calls have been implemented (and are documented).
+ * 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 add-on libraries (not part of X/Open
+ Curses):
+ + the panels library, supporting a stack of windows with
+ backing store.
+ + the menus library, supporting a uniform but flexible
+ interface for menu programming.
+ + the form library, supporting data collection through
+ on-screen forms.
+ * 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.
+ + It can be optionally configured to match the format used in
+ related systems such as AIX and Tru64.
+ + Alternatively, ncurses can be configured to use hashed
+ databases rather than the directory of files used by SVr4