- 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/pub/gnu/ncurses. It is also
- available at [2]ftp://ftp.clark.net/pub/dickey/ncurses.
-
- Release Notes
-
- We decided to release ncurses as a new whole number release (5.0)
- because it incorporates several interface changes, including some that
- would invalidate existing shared libraries. These are the highlights
- from the change-log since ncurses 4.2 release.
-
- Interface changes:
- * The principal source of changes to the interface comes from the
- release of X/Open Curses in 1997. Earlier versions of ncurses (4.0
- and before) were based on a draft version of the specification.
- The release version adds parameters to some functions to support
- the evolving internationalization of curses. These summarize the
- impact:
- + modified several prototypes to correspond with 1997 version
- of X/Open Curses (affects ABI since developers have used
- attr_get).
- + corrected prototypes for slk_* functions, using chtype rather
- than attr_t.
- + the slk_attr_{set,off,on} functions need an additional void*
- parameter according to XSI.
- + correct macros for wattr_set, wattr_get, separate wattrset
- macro from these to preserve behavior that allows attributes
- to be combined with color pair numbers.
- + reviewed/updated curses.h, term.h against X/Open Curses Issue
- 4 Version 2. This includes making some parameters
- NCURSES_CONST rather than const, e.g., in termcap.h.
- + reviewed/corrected macros in curses.h as per XSI document.
- + add set_a_attributes and set_pglen_inch to terminfo
- structure, as per XSI and Solaris 2.5.
- * The newest version of the X/Open Curses is implemented on Solaris
- and other vendor's systems. It adds new features to the terminfo
- descriptions:
- + implement tparm %l format.
- + implement tparm printf-style width and precision for %s, %d,
- %x, %o as per XSI.
- * We made additional changes to reduce impact by future interface
- changes:
- + rename key_names[] array to _nc_key_names since it is not
- part of the curses interface.
- + move macro winch to a function, to hide details of struct
- ldat
- * modify configure script to embed ABI in shared libraries for HP-UX
- 10.x (detailed request by Tim Mooney).
- * modify configuration of shared libraries on Digital Unix so that
- versioning is embedded in the library, rather than implied by
- links (patch by Tim Mooney).
-
- New features:
- * enable sigwinch handler by default.
- * turn on hashmap scrolling code by default
- * improved support for termcap applications
- + modify tput to accept termcap names as an alternative to
- terminfo names.
- + provide support for termcap PC variable by copying it from
- terminfo data and using it as the padding character in tputs.
- + provide support for termcap ospeed variable by copying it
- from the internal cur_term member, and using ospeed as the
- baudrate reference for the delay_output and tputs functions.
- + change name-comparisons in lib_termcap to compare no more
- than 2 characters.
- + add configure option --enable-tcap-names, which essentially
- allows users to define new capabilities as in termcap.
- * add mouse support to ncurses menus.
- * add mouse and dll support for OS/2 EMX
- * modify terminfo parsing to accept octal and hexadecimal constants
- * add configure option --enable-no-padding, to allow environment
- variable $NCURSES_NO_PADDING to eliminate non-mandatory padding,
- thereby making terminal emulators (e.g., for vt100) a little more
- efficient.
- * modify lib_color.c to eliminate dependency on orig_colors and
- orig_pair, since SVr4 curses does not require these either, but
- uses them when they are available.
- * add -f option to infocmp and tic, which formats the terminfo
- if/then/else/endif so that they are readable (with newlines and
- tabs).
- * modify tic to compile into %'char' form in preference to
- %{number}, since that is a little more efficient.
-
- Major bug fixes:
- * modify lib_tstp.c to block SIGTTOU when handling SIGTSTP, fixes a
- problem where ncurses applications which were run via a shell
- script would hang when given a ^Z. Also, check if the terminal's
- process group is consistent, i.e., a shell has not taken ownership
- of it, before deciding to save the current terminal settings in
- the SIGTSTP handler.
- * suppress sc/rc capabilities from terminal description if they
- appear in smcup/rmcup. This affects only scrolling optimization,
- to fix a problem reported by several people with xterm's alternate
- screen, though the problem is more general.
- * modify relative_move and tputs to avoid an interaction with the
- BSD-style padding. The relative_move function could produce a
- string to replace on the screen which began with a numeric
- character, which was then interpreted by tputs as padding.
- * modify setupterm so that cancelled strings are treated the same as
- absent strings, cancelled and absent booleans false (does not
- affect tic, infocmp).
- * modify lib_vidattr.c to allow for terminal types (e.g.,
- xterm-color) which may reset all attributes in the 'op'
- capability, so that colors are set before turning on bold and
- other attributes, but still after turning attributes off.
- * use 'access()' to check if ncurses library should be permitted to
- open or modify files with fopen/open/link/unlink/remove calls, in
- case the calling application is running in setuid mode.
- * correction to doupdate, for case where terminal does not support
- insert/delete character. The logic did not check that there was a
- difference in alignment of changes to old/new screens before
- repainting the whole non-blank portion of the line. Modified to
- fall through into logic that reduces by the portion which does not
- differ.
-
- Features of Ncurses
-
- The ncurses package is fully compatible with SVr4 (System V Release 4)
- curses:
- * All 257 of the SVr4 calls have been implemented (and are
- documented).
- * Full support for SVr4 curses features including keyboard mapping,
- color, forms-drawing with ACS characters, and automatic
- recognition of keypad and function keys.
- * An emulation of the SVr4 panels library, supporting a stack of
- windows with backing store, is included.
- * An emulation of the SVr4 menus library, supporting a uniform but
- flexible interface for menu programming, is included.
- * An emulation of the SVr4 form library, supporting data collection
- through on-screen forms, is included.
- * Binary terminfo entries generated by the ncurses tic(1)
- implementation are bit-for-bit-compatible with the entry format
- SVr4 curses uses.
- * The 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.
-
+ * 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:
+
+ https://invisible-island.net/archives/ncurses/ or
+ https://invisible-mirror.net/archives/ncurses/ .
+
+ It is also available at the GNU distribution site
+
+ https://ftp.gnu.org/gnu/ncurses/ .
+
+Release Notes
+
+ These notes are for ncurses 6.4, released December 31, 2022.
+
+ This release is designed to be source-compatible with ncurses 5.0
+ through 6.3; 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 robustness
+ issues. The release notes also mention some other bug-fixes, but are
+ focused on new features and improvements to existing features since
+ ncurses 6.3 release.
+
+ Library improvements
+
+ New features
+
+ There are no new features in this release.
+
+ Other improvements
+
+ These are improvements to existing features:
+ * modify delscreen to more effectively delete all windows on the
+ given screen.
+ * modify wnoutrefresh to call pnoutrefresh if its parameter is a
+ pad, rather than treating it as an error, and modify new_panel to
+ permit its window-parameter to be a pad
+ * modify curses_trace() to show the trace-mask as symbols, e.g.,
+ TRACE_ORDINARY, DEBUG_LEVEL(3).
+ * improve checks for valid mouse events when an intermediate mouse
+ state is not part of the mousemask specified by the caller
+ * allow extended-color number in opts parameter of wattr_on.
+ * improve _tracecchar_t2 formatting of base+combining character.
+ * trim out some unwanted linker options from ncurses*config and .pc
+ files seen in Fedora 36+.
+ * improve shell-scripts with shellcheck
+ * improve use of "trap" in shell scripts, using a script.
+ * modify make-tar.sh scripts to make timestamps more predictable.
+
+ These are corrections to existing features:
+ * modify misc/gen-pkgconfig.in to allow for the case where the
+ library directory does not yet exist, since this is processed
+ before doing an install
+ * set trailing null on string passed from winsnstr to wins_nwstr.
+ * modify waddch_literal to allow for double-width base character
+ when merging a combining character
+
+ Program improvements
+
+ Several improvements were made to the utility programs:
+
+ infocmp
+
+ + rewrite canonical_name function of infocmp to ensure buffer
+ size
+ + improve readability of long parameterized expressions with
+ the infocmp "-f" option by allowing split before a "%p"
+ marker.
+ + modify verbose-option of infocmp, tic, toe to enable
+ debug-tracing if that is configured.
+
+ tabs
+ limit tab-stop values to max-columns
+
+ tic
+ add consistency check in tic for u6/u7/u8/u9 and NQ
+ capabilities.
+
+ tput
+ corrected use of original tty-modes in init/reset subcommands
+
+ Examples
+
+ Along with the library and utilities, improvements were made to the
+ ncurses-examples. Most of this activity aimed at improving the
+ test-packages:
+ * add minimal -h (usage) and -V (version) getopt logic to all
+ ncurses-examples programs.
+ * fix an error in "@" command in test/ncurses.c F-menu
+ * add curses_trace to ifdef's for START_TRACE in test/test.priv.h
+ * improve pthread-configuration for test/worm.c
+ * add setlocale call to several test-programs.
+ * workaround in test/picsmap.c for use of floating point for rgb
+ values by ImageMagick 6.9.11, which appears to use the wrong upper
+ limit.
+ * use static libraries for AdaCurses test-package for Mageia, since
+ no gprbuild package is available.
+ * install Ada95 sample programs in libexecdir, adding a wrapper
+ script to invoke those.
+ * install ncurses-examples programs in libexecdir, adding a wrapper
+ script to invoke those.
+
+ There are other new demo/test programs and reusable examples:
+
+ test/combine
+ demonstrate combining characters
+
+ test/test_delwin
+ demonstrate deleting a window
+
+ test/test_mouse
+ observe mouse events in the raw terminal or parsed ncurses
+ modes
+
+ test/test_unget_wch
+ demonstrate the unget_wch and unget functions
+
+ Terminal database
+
+ There are several new terminal descriptions:
+ * mosh
+ * mosh-256color
+ * teken-16color
+ * teken-sc
+ * teken-vt
+ * xgterm
+
+ There are many changes to existing terminal descriptions. Some were
+ updates to several descriptions:
+ * make description-fields distinct
+ * fix errata in description fields
+ * add/use several building-blocks:
+ + aixterm+sl
+ + ansi+cpr
+ + apollo+vt132
+ + decid+cpr
+ + ncr260vp+sl
+ + wyse+sl
+ + x10term+sl
+ + xterm+acs
+ + xterm+alt47
+
+ while others affected specific descriptions. These were retested, to
+ take into account changes by their developers:
+ * kitty
+ * teken
+
+ while these are specific fixes based on reviewing documentation, user
+ reports, or warnings from tic:
+
+ att610+cvis0
+ amended note as per documentation for att610, att620, att730
+
+ kon, kon2, jfbterm
+ revise to undo "linux2.6" change to smacs/rmacs/enacs
+
+ st-0.6
+ add dim, ecma+strikeout
+
+ foot+base
+ add xterm+sl-alt
+
+ dec+sl
+ correct dsl in dec+sl
+
+ mintty and tmux
+ correct setal in mintty/tmux entries, add to vte-2018
+
+ nsterm
+ modify nsterm to use xterm+alt1049
+
+ putty
+ modify putty to use xterm+alt1049
+
+ vte-2018
+ add blink and setal
+
+ A few entries use extensions (user-defined terminal capabilities):
+ * use ansi+enq and decid+cpr in cases where the terminal probably
+ supported the u6-u9 extension
+ * remove u6-u9 from teken-2018
+ * use NQ to flag entries where the terminal does not support query
+ and response
+ * add/use bracketed+paste to help identify terminals supporting this
+ xterm feature
+ * modify samples for xterm mouse 1002/1003 modes to use 1006 mode,
+ and also provide for focus in/out responses
+ * xterm patch #371 supports DEC-compatible status-line. add dec+sl
+ to xterm-new, per xterm #371, add xterm-p371, add xterm-p370, for
+ use in older terminals, and set "xterm-new" to "xterm-p370" (to
+ ease adoption).
+
+ 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:
+ + remove a stray '/' from description of %g in terminfo(5).
+ + correct/improve font-formatting in curs_getch.3x, as well as
+ other manual pages.
+ * New/improved history and portability sections:
+ + add portability notes for delscreen and delwin in manual.
+ + improve curs_slk.3x discussion of extensions and portability
+ * Other improvements:
+ + improve curs_bkgd.3x, explaining that bkgdset can affect
+ results for bkgd
+ + add note on portable memory-leak checking in curs_memleaks.3x
+ + expanded description in resizeterm.3x
+ + add section on releasing memory to curs_termcap.3x and
+ curs_terminfo.3x manpages.
+ + add clarification of the scope of dynamic variables in
+ terminfo(5).
+ + improve formatting of ncurses-intro.html and hackguide.html
+ + improve curs_clear.3x links to other pages
+ + update ncurses-howto, making documentation fixes along with
+ corrections to example programs.
+ + use newer version 1.36 of gnathtml for generating Ada html
+ files.
+ + update external links in Ada95.html
+
+ There are no new manual pages (all of the manual page updates are to
+ existing pages).
+
+ Interesting bug-fixes
+
+ While there were many bugs fixed during development of ncurses 6.4,
+ 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 those dealing with memory leaks and buffer
+ overflows. Although the utilities are designed for text files (which
+ they do properly), some choose to test them with non-text files.
+ * Text files contain no embedded nulls. Also, they end with a
+ newline. Feeding tic non-text files exposed a few cases where the
+ program did not check for those issues. As a result, further
+ processing of the input found limit-checks whose assumptions were
+ invalid.
+ * Fixing the limit-checks (first) found a problem with tic managing
+ the list of strings in a terminal description. In merging two
+ terminal descriptions (i.e., the "use=" feature), tic was not
+ allocating a complete copy. A quick repair for that introduced a
+ memory leak.
+ * The checks for non-text files are improved (i.e., embedded nulls
+ in the input file will cause tic to reject it rather than
+ attempting to process it).
+ * The string allocations in tic are likewise improved.
+
+ Configuration changes
+
+ Major changes
+
+ There are no major changes. No new options were added. Several
+ improvements were made to configure checks.
+
+ Configuration options
+
+ There are a few new/modified configure options:
+
+ --with-abi-version
+ add ABI 7 defaults to configure script.
+
+ --with-caps
+ add warning in configure script if file specified for
+ "--with-caps" does not exist.
+
+ --with-manpage-format
+ bzip2 and xz compression are now supported
+
+ --with-xterm-kbs
+ add check/warning in configure script if option
+ "--with-xterm-kbs" is missing or inconsistent
+
+ Portability
+
+ Many of the portability changes are implemented via the configure
+ script:
+ * amend configure option's auto-search to account for systems where
+ none of the directories known to pkg-config exist
+ * corrected regex needed for older pkg-config used in Solaris 10
+ * improve handling of --with-pkg-config-libdir option, allowing for
+ the case where either $PKG_CONFIG_LIBDIR or the option value has a
+ colon-separated list of directories
+ * if the --with-pkg-config-libdir option is not given, use
+ ${libdir}/pkgconfig as a default
+ * improve search-path check for pkg-config, e.g., for Debian testing
+ which installs pkg-config with architecture-prefixes.
+ * build-fix for cross-compiling to MingW, conditionally add -lssp
+ * improve configure check for getttynam
+ * fixes to build with dietlibc:
+ + add configure check for fpathconf
+ + add configure check for math sine/cosine, needed in
+ test/tclock, and eliminate pow() from test/hanoi
+ + use wcsnlen as an alternative to wmemchr if it is not found
+ * modify configure macro CF_BUILD_CC to check if the build-compiler
+ works, rather than that it is different from the cross-compiler,
+ e.g., to accommodate a compiler which can be used for either
+ purpose with different flags
+ * modify configure/scripts to work around interference by GNU grep
+ 3.8
+
+ Here are some of the other portability fixes:
+ * change man_db.renames to template, to handle ncurses*-config
+ script with the --extra-suffix configure option.
+ * update CF_XOPEN_SOURCE macro, adding variants "gnueabi" and
+ "gnueabihf" to get _DEFAULT_SOURCE special case, as well as adding
+ GNU libc suffixes for "abi64", "abin32", "x32" to distinguish it
+ from other libc flavors.
+ * work around musl's nonstandard use of feature test macros by
+ adding a definition for NCURSES_WIDECHAR to the generated ".pc"
+ and *-config files.
+ * use "command -v" rather than "type" in Ada95/gen/Makefile.in to
+ fix a portability issue.
+ _________________________________________________________________
+
+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
+ curses.
+ * 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.
+