- Announcing ncurses 6.0
+ Announcing ncurses 6.1
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
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 <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
+ [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 <term.h>
+ * 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
* 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 <curses.h>
+ * 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 <<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
-
- 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
+ "<bsd/string.h>" 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
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
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:
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
-- 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
---------------------------------------------------------------------
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.
--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.
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
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.
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
--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
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.
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.
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.
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 <term.h> 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:
-- 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
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
-5:0:9 6.0 20180121
+5:0:9 6.0 20180127
<!--
- $Id: announce.html.in,v 1.91 2015/08/08 19:27:17 tom Exp $
+ $Id: announce.html.in,v 1.92 2018/01/27 02:09:18 tom Exp $
****************************************************************************
- * Copyright (c) 1998-2013,2015 Free Software Foundation, Inc. *
+ * Copyright (c) 1998-2015,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 *
* authorization. *
****************************************************************************
-->
-<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN">
<html>
<head>
<style type="text/css">
p,li { max-width:700px; }
dd { max-width:630px; }
+ *.main-name {
+ font-style: italic;
+ font-variant: small-caps;
+ }
+ *.part-name {
+ font-family: "Andale Mono", "Monotype.com", monospace;
+ font-size: 12pt;
+ font-weight: bold;
+ }
</style>
</head>
<h2><a name="h2-overview" id="h2-overview">Overview</a></h2>
- <p>The <em class="small-caps">ncurses</em> (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
+ <p>The <span class="main-name">ncurses</span> (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.</p>
+ enhancements over BSD curses. SVr4 curses became the basis of
+ X/Open Curses.</p>
<p>In mid-June 1995, the maintainer of 4.4BSD curses declared
that he considered 4.4BSD curses obsolete, and encouraged the
- keepers of <em class="small-caps">unix</em> releases such as
- BSD/OS, FreeBSD and NetBSD to switch over to <em class=
- "small-caps">ncurses</em>.</p>
+ keepers of <span class="main-name">unix</span> releases such as
+ BSD/OS, FreeBSD and NetBSD to switch over to <span class=
+ "main-name">ncurses</span>.</p>
- <p>Since 1995, <em class="small-caps">ncurses</em> has been
+ <p>Since 1995, <span class="main-name">ncurses</span> has been
ported to many systems:</p>
<ul>
first of these was EMX on OS/2 Warp.</li>
<li>It is used (though usually not as the <em>system</em>
- curses) on all of the vendor <em class="small-caps">unix</em>
- systems, e.g., AIX, HP-UX, IRIX64, SCO, Solaris, Tru64.</li>
+ curses) on all of the vendor <span class=
+ "main-name">unix</span> systems, e.g., AIX, HP-UX, IRIX64, SCO,
+ Solaris, Tru64.</li>
<li>It should work readily on any ANSI/POSIX-conforming
- <em class="small-caps">unix</em>.</li>
+ <span class="main-name">unix</span>.</li>
</ul>
<p>The distribution includes the library and support utilities,
<ul>
<li><a href=
- "http://invisible-island.net/ncurses/man/captoinfo.1m.html">captoinfo</a>,
- a termcap conversion tool</li>
+ "https://invisible-island.net/ncurses/man/captoinfo.1m.html"><span class="part-name">
+ captoinfo</span></a>, a termcap conversion tool</li>
<li><a href=
- "http://invisible-island.net/ncurses/man/clear.1.html">clear</a>,
- utility for clearing the screen</li>
+ "https://invisible-island.net/ncurses/man/clear.1.html"><span class="part-name">
+ clear</span></a>, utility for clearing the screen</li>
<li><a href=
- "http://invisible-island.net/ncurses/man/infocmp.1m.html">infocmp</a>,
- the terminfo decompiler</li>
+ "https://invisible-island.net/ncurses/man/infocmp.1m.html"><span class="part-name">
+ infocmp</span></a>, the terminfo decompiler</li>
<li><a href=
- "http://invisible-island.net/ncurses/man/tabs.1.html">tabs</a>,
- set tabs on a terminal</li>
+ "https://invisible-island.net/ncurses/man/tabs.1.html"><span class="part-name">
+ tabs</span></a>, set tabs on a terminal</li>
<li><a href=
- "http://invisible-island.net/ncurses/man/tic.1m.html">tic</a>,
- the terminfo compiler</li>
+ "https://invisible-island.net/ncurses/man/tic.1m.html"><span class="part-name">
+ tic</span></a>, the terminfo compiler</li>
<li><a href=
- "http://invisible-island.net/ncurses/man/toe.1m.html">toe</a>,
- list (table of) terminfo entries</li>
+ "https://invisible-island.net/ncurses/man/toe.1m.html"><span class="part-name">
+ toe</span></a>, list (table of) terminfo entries</li>
<li><a href=
- "http://invisible-island.net/ncurses/man/tput.1.html">tput</a>,
- utility for retrieving terminal capabilities in shell
- scripts</li>
+ "https://invisible-island.net/ncurses/man/tput.1.html"><span class="part-name">
+ tput</span></a>, utility for retrieving terminal capabilities
+ in shell scripts</li>
<li><a href=
- "http://invisible-island.net/ncurses/man/tset.1.html">tset</a>,
- to initialize the terminal</li>
+ "https://invisible-island.net/ncurses/man/tset.1.html"><span class="part-name">
+ tset</span></a>, to initialize the terminal</li>
</ul>
<p>Full manual pages are provided for the library and tools.</p>
- <p>The <em class="small-caps">ncurses</em> distribution is
- available via anonymous FTP at the GNU distribution site</p>
+ <p>The <span class="main-name">ncurses</span> distribution is
+ available at <span class="main-name">ncurses</span>' <a href=
+ "https://invisible-island.net/ncurses/">homepage</a>:</p>
<blockquote>
<p><a href=
- "ftp://ftp.gnu.org/gnu/ncurses/">ftp://ftp.gnu.org/gnu/ncurses/</a> .</p>
- </blockquote>It is also available at
+ "ftp://ftp.invisible-island.net/ncurses/">ftp://ftp.invisible-island.net/ncurses/</a>
+ or<br>
+ <a href=
+ "https://invisible-mirror.net/archives/ncurses/">https://invisible-mirror.net/archives/ncurses/</a> .</p>
+ </blockquote>
+
+ <p>It is also available via anonymous FTP at the GNU distribution
+ site</p>
<blockquote>
<p><a href=
- "ftp://invisible-island.net/ncurses/">ftp://invisible-island.net/ncurses/</a> .</p>
+ "ftp://ftp.gnu.org/gnu/ncurses/">ftp://ftp.gnu.org/gnu/ncurses/</a> .</p>
</blockquote>
<h2><a name="h2-release-notes" id="h2-release-notes">Release
Notes</a></h2>
- <p>These notes are for <em class="small-caps">ncurses</em>
- @VERSION@, released <strong>August 8, 2015</strong>.</p>
+ <p>These notes are for <span class="main-name">ncurses</span>
+ @VERSION@, released <strong>January 27, 2018</strong>.</p>
<p>This release is designed to be source-compatible with
- <em class="small-caps">ncurses</em> 5.0 through 5.9; providing a
- new application binary interface (ABI). Although the source can
- still be configured to support the <em class=
- "small-caps">ncurses</em> 5 ABI, the intent of the release is to
- provide extensions which are generally useful, but
- binary-incompatible with <em class="small-caps">ncurses</em>
- 5:</p>
+ <span class="main-name">ncurses</span> 5.0 through 6.0; providing
+ extensions to the application binary interface (ABI). Although
+ the source can still be configured to support the <span class=
+ "main-name">ncurses</span> 5 ABI, the intent of the release is to
+ provide extensions to the <span class="main-name">ncurses</span>
+ <strong>6</strong> ABI:</p>
<ul>
<li>
- <p>Extend the <code>cchar_t</code> structure to allow more
- than 16 colors to be encoded.</p>
+ <p>improve integration of <span class="part-name">tput</span>
+ and <span class="part-name">tset</span></p>
</li>
<li>
- <p>Modify the encoding of mouse state to make room for a 5th
- mouse button. That allows one to use <em class=
- "small-caps">ncurses</em> with a wheel mouse with xterm or
- similar X terminal emulators.</p>
+ <p>provide support for extended numeric capabilities.</p>
</li>
</ul>
- <p>There are, of course, numerous other improvements,
- including</p>
+ <p>There are, of course, numerous other improvements, listed in
+ this announcement.</p>
+
+ <p>The release notes also mention some bug-fixes, but are focused
+ on new features and improvements to existing features since
+ <span class="main-name">ncurses</span> 6.0 release.</p>
+
+ <h3><a name="h3-library" id="h3-library">Library
+ improvements</a></h3>
+
+ <h4><a name="h4-new-library" id="h4-new-library">New
+ features</a></h4>
+
+ <p>The improved integration of <span class=
+ "part-name">tput</span> and <span class="part-name">tset</span>
+ made only small changes to the libraries. However, supporting
+ extended numeric capabilities required a few changes:</p>
<ul>
<li>
- <p>fixes made based on the Clang and Coverity static
- analyzers.</p>
+ <p>The <code>TERMINAL</code> structure in
+ <code><term.h></code> is now opaque. Doing that allowed
+ making the structure larger, to hold the extended numeric
+ data.</p>
+
+ <p>A few applications required changes during development of
+ <span class="main-name">ncurses 6.1</span> because those
+ applications misused the members of that structure, e.g.,
+ directly modifying it rather than using <a href=
+ "https://invisible-island.net/ncurses/man/curs_kernel.3x.html#h3-def_prog_mode_-def_shell_mode">
+ def_prog_mode</a>.</p>
</li>
<li>
- <p>memory leak fixes using Valgrind</p>
- </li>
- </ul>
+ <p>Having made <code>TERMINAL</code> opaque (and because none
+ of the library functions use anything except a pointer to
+ <code>TERMINAL</code>), it was possible to increase the size
+ of the structure, adding to the end.</p>
- <p>The release notes mention some bug-fixes, but are focused on
- new features and improvements to existing features log since
- <em class="small-caps">ncurses</em> 5.9 release.</p>
+ <p>Existing applications which were linked to the
+ <span class="part-name">ncurses 6.0</span> high-level
+ (<em>ncurses</em>, <em>ncursesw</em>) and low-level
+ (<em>tinfo</em>, <em>tinfo</em>) libraries should not require
+ re-linking since the binary interface did not change, nor did
+ the structure offsets with <code>TERMINAL</code> change.</p>
- <p>While the intent of the release is to provide a new stable
- ABI, there are other development activities which are summarized
- below.</p>
+ <p>A few applications use the inner <code>TERMTYPE</code>
+ structure's offsets to refer to terminfo capabilities within
+ that structure. Again, those do not require modification
+ because their offsets within <code>TERMINAL</code> did not
+ change.</p>
+ </li>
- <ul>
<li>
- <p>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 <code>Console2</code> took a while.</p>
+ <p>When configured for wide-characters, i.e.,
+ “ncursesw” the <code>TERMINAL</code> structure is
+ extended.</p>
+
+ <p>The new data in <code>TERMINAL</code> holds the same
+ information as <code>TERMTYPE</code>, but with larger numbers
+ (“int” versus “short”). It is named
+ <code>TERMTYPE2</code>.</p>
+
+ <p>The library uses this structure internally in preference
+ to <code>TERMTYPE</code>, referring to <code>TERMTYPE</code>
+ only to initialize it for applications that use the
+ capabilities defined in <code><term.h></code></p>
</li>
<li>
- <p>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.</p>
+ <p>When configured for 8-bit (narrow) characters, the
+ <code>TERMTYPE2</code> structure is not used.</p>
+ </li>
- <p>The <a href=
- "http://invisible-island.net/ncurses/tctest.html">termcap
- library checker (tctest)</a> (not part of <em class=
- "small-caps">ncurses</em>) was one result. A followup review
- of performance using <a href=
- "http://invisible-island.net/ncurses/ncurses-examples.html">ncurses-examples</a>
- in 2014 led to additional improvements.</p>
+ <li>The updated application binary interface is 6.1.20171230
+ (used for new <a href=
+ "https://invisible-island.net/ncurses/ncurses-mapsyms.html">versioned
+ symbols</a>), although the interface changes were developed
+ several months previously.</li>
+ </ul>
+
+ <p>The motivation for making this extension came from noticing
+ that <a href=
+ "https://invisible-island.net/ncurses/tctest.html#bsd42-numeric-caps">
+ termcap applications</a> could (though not <a href=
+ "https://invisible-island.net/ncurses/ncurses-slang.html#cause_numbers">
+ realistically</a>) 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.</p>
+
+ <p>Generally speaking, applications that use internal details of
+ a library are unsupported. There was exactly one exception for
+ <span class="main-name">ncurses</span>: the <span class=
+ "main-name">tack</span> program <em>used</em> the internal
+ details of <code>TERMINAL</code>, 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 <span class=
+ "main-name">tack</span> from these <a href=
+ "https://invisible-island.net/ncurses/tack.html#portable">internal
+ details of <span class="main-name">ncurses</span></a>, but to
+ generalize it so that the program works with Unix curses
+ (omitting the ncurses-specific feature). That was released as
+ <a href=
+ "https://invisible-island.net/ncurses/tack/CHANGES.html#index-t20170726">
+ <span class="main-name">tack</span> 1.08</a> in July
+ 2017.</p>
+
+ <p>While making changes to <span class="main-name">tack</span> to
+ eliminate its dependency upon <span class=
+ "main-name">ncurses</span> 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 <span class="main-name">ncurses</span> internals.
+ Future releases of <span class="main-name">ncurses</span> may
+ eliminate some of those symbols (such as those used by
+ <span class="main-name">tack</span> 1.07) because they are
+ neither part of the API or the ABI.</p>
+
+ <p>Using the <code>TERMTYPE2</code> 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:</p>
+
+ <ul>
+ <li>
+ <p>X/Open Curses defined function prototypes such as
+ <code>wattr_set</code> with an unused parameter, for
+ “future” use. After 25 years, the future is here:
+ <span class="main-name">ncurses</span> uses the parameter to
+ augment color pair values as described in the <a href=
+ "https://invisible-island.net/ncurses/man/curs_attr.3x.html#h2-EXTENSIONS">
+ manual page</a>.</p>
</li>
<li>
- <p>Output buffering provided a further, but worthwhile
- distraction. A bug report in 2012 regarding the use of signal
- handlers in <em class="small-caps">ncurses</em>) pointed out
- <a href=
- "http://lists.gnu.org/archive/html/bug-ncurses/2012-07/msg00029.html">
- a problem</a> with the use of unsafe functions for handling
- <code>SIGTSTP</code>. Other signals could be addressed with
- workarounds; repairing <code>SIGTSTP</code> required a
- different approach. The solution required changing internal
- behavior of the library: how it handles output buffering.</p>
-
- <p>Now <em class="small-caps">ncurses</em> 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
- <em>unspecified</em> 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.</p>
- </li>
-
- <li>
- <p>Since the introduction of the experimental support for 256
- colors early in <a href=
- "http://invisible-island.net/ncurses/NEWS.html#t20050101">2005</a>
- (released in <a href=
- "http://invisible-island.net/ncurses/announce-5.5.html">ncurses
- 5.5</a>), there has been increased user interest. Almost all
- packagers continue providing the ncurses ABI 5 which cannot
- support 256 colors.</p>
- </li>
-
- <li>
- <p>Symbol versioning, or the lack of it in ncurses, is the
- main reason why packagers would be reluctant to add a new
- ncurses ABI.</p>
-
- <p>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
- <a href=
- "http://invisible-island.net/ncurses/ncurses-mapsyms.html">Symbol
- versioning in <em class="small-caps">ncurses</em></a>.</p>
+ <p>Other functions such as those defining color pairs did not
+ have a corresponding <em>reserved</em> parameter. For those,
+ <span class="main-name">ncurses</span> defines extended
+ versions such as <code>init_extended_pair</code> (versus
+ <code>init_pair</code>), <code>init_extended_color</code>
+ (versus <code>init_color</code>).</p>
</li>
</ul>
- <h3><a name="h3-library" id="h3-library">Library
- improvements</a></h3>
+ <p>Additionally, to improve performance other changes (and
+ extensions) are provided in this release:</p>
- <h3><a name="h3-lib-setbuf" id="h3-lib-setbuf">Output
- buffering</a></h3>
+ <ul>
+ <li>
+ <p>Several new functions simplify management of large sets of
+ color pairs: <code>reset_color_pairs</code>,
+ <code>alloc_pair</code>, <code>find_pair</code> and
+ <code>free_pair</code>.</p>
+ </li>
- <p>X/Open curses provides more than one initialization
- function:</p>
+ <li>
+ <p>New "RGB" extension capability for direct-color support is
+ used to improve performance of
+ <code>color_content</code>.</p>
+ </li>
- <ul>
- <li><a href=
- "http://invisible-island.net/ncurses/man/curs_initscr.3x.html#h3-initscr">
- initscr</a> (the simplest) accepts no parameters.</li>
+ <li>
+ <p>The internal <code>colorpair_t</code> is now a struct,
+ eliminating an internal 8-bit limit on colors</p>
+ </li>
- <li><a href=
- "http://invisible-island.net/ncurses/man/curs_initscr.3x.html#h3-newterm">
- newterm</a> accepts parameters for the stream input and
- output</li>
+ <li>
+ <p>Allocation for <code>SCREEN</code>'s color-pair table
+ starts small, grows on demand up to the limit given in the
+ terminal description.</p>
+ </li>
- <li><a href=
- "http://invisible-island.net/ncurses/man/curs_terminfo.3x.html#h3-Initialization">
- setupterm</a> (the low-level function) accepts a parameter for
- the <em>file descriptor</em> of the output.</li>
+ <li>
+ <p><code>setcchar</code> and <code>getcchar</code> now treat
+ a negative color-pair as an error.</p>
+ </li>
</ul>
- <p>They are documented in X/Open <em>as if</em>
- <code>initscr</code> calls <code>newterm</code> using
- <code>stdout</code> for output stream, and in turn
- <code>newterm</code> calls <code>setupterm</code> using
- <code>fileno(stdout)</code> for the file descriptor. As long as
- an implementation acts <em>as if</em> it does this, it conforms.
- In practice, implementations do what is implied. This creates a
- problem: the low-level <code>setupterm</code> function's file
- descriptor is unbuffered, while <code>newterm</code> 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.</p>
-
- <p>Initially, <em class="small-caps">ncurses</em> used the file
- descriptor (obtained from the output stream passed to
- <code>newterm</code>) for changing the terminal modes, and relied
- upon the output parameter of <code>newterm</code> for buffered
- output. Later (to avoid using unsafe buffered I/O in signal
- handlers), <em class="small-caps">ncurses</em> 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.</p>
-
- <p>That approach worked reasonably well and as a side effect,
- using the same buffered output as an application might use for
- <code>printf</code> meant that no flushing was needed when
- switching between normal- and screen-modes.</p>
-
- <p>There were a couple of problems:</p>
+ <h4><a name="h4-fixes-library" id="h4-fixes-library">Other
+ improvements</a></h4>
+
+ <p>These are new or revised features:</p>
<ul>
<li>
- <p>to get good performance, curses (not only <em class=
- "small-caps">ncurses</em>, but SVr4 curses in general) set an
- output buffer using <code>setbuf</code> or similar function.
- There is no standard (or portable) way to turn that output
- buffer off, and revert to line-buffering. The <code><a href=
- "http://invisible-island.net/ncurses/man/ncurses.3x.html#h3-NCURSES_NO_SETBUF">
- NCURSES_NO_SETBUF</a></code> environment variable did make it
- optional.</p>
+ <p>modify <code>c++/etip.h.in</code> to accommodate
+ deprecation of throw and throws in c++17</p>
</li>
<li>
- <p>to handle <code>SIGTSTP</code> (the “stop”
- signal), <em class="small-caps">ncurses</em> 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.</p>
+ <p>add new function <code>unfocus_current_field</code></p>
</li>
- </ul>
- <p>Conveniently, solving the second problem (by making <em class=
- "small-caps">ncurses</em> do its <em>own</em> output buffering)
- also fixed the first one. But there were special cases to
- resolve: <a href=
- "http://invisible-island.net/ncurses/man/curs_terminfo.3x.html"><em>
- low-level</em></a> 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.</p>
+ <li>
+ <p>add option to preserve leading whitespace in form
+ fields</p>
+ </li>
- <p>Finally, there may still be a few programs which should be
- modified to improve their portability, e.g., adding an</p>
+ <li>
+ <p>add a macro for <code>is_linetouched</code> and adjust the
+ function's return value to make it possible for most
+ applications to check for an error-return.</p>
+ </li>
- <blockquote>
- <pre class="code-block">
-fflush(stdout);
-</pre>
- </blockquote>
+ <li>
+ <p>add build-time utility <code>report_offsets</code> to help
+ show when the various configurations of tinfo library are
+ compatible or not.</p>
+ </li>
+ </ul>
- <p>when switching from “<a href=
- "http://invisible-island.net/ncurses/man/curs_kernel.3x.html#h3-reset_prog_mode_-reset_shell_mode">shell</a>”
- mode to “<a href=
- "http://invisible-island.net/ncurses/man/curs_kernel.3x.html#h3-reset_prog_mode_-reset_shell_mode">program</a>”
- (curses) mode. Those are fairly rare because most programmers
- have learned not to mix <code>printf</code> and <code><a href=
- "http://invisible-island.net/ncurses/man/curs_printw.3x.html">printw</a></code>.</p>
-
- <h3><a name="h3-lib-versioning" id="h3-lib-versioning">Symbol
- versioning</a></h3>
-
- <p>This release introduces symbol-versioning to <em class=
- "small-caps">ncurses</em> because without it, the change of ABI
- would be less successful. A lengthy discussion will be presented
- in <a href=
- "http://invisible-island.net/ncurses/ncurses-mapsyms.html">Symbol
- versioning in <em class="small-caps">ncurses</em></a>. These
- notes summarize what has changed, and what can be done with the
- new release.</p>
-
- <p>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.</p>
-
- <p>This release provides sample files for the four principal
- configurations of <em class="small-caps">ncurses</em> libraries:
- <code>ncurses</code>, <code>ncursesw</code>,
- <code>ncursest</code> and <code>ncursestw</code>. Each sample is
- given in two forms:</p>
+ <p>These were done to limit or ultimately deprecate features:</p>
- <blockquote>
- <dl>
- <dt>“<code>.map</code>”</dt>
+ <ul>
+ <li>
+ <p>drop two symbols obsoleted in 2004:
+ <code>_nc_check_termtype</code>, and
+ <code>_nc_resolve_uses</code></p>
+ </li>
- <dd>These list all public symbols, together with version
- names.</dd>
+ <li>
+ <p>move <code>_nc_tracebits</code>, <code>_tracedump</code>
+ and <code>_tracemouse</code> to <code>curses.priv.h</code>,
+ since they are not part of the suggested ABI6.</p>
+ </li>
- <dt>“<code>.sym</code>”</dt>
+ <li>
+ <p>mark some structs in form/menu/panel libraries as
+ potentially opaque without modifying API/ABI.</p>
+ </li>
- <dd>These list all public symbols, without version
- names.</dd>
- </dl>
- </blockquote>
+ <li>
+ <p>ifdef'd header-file definition of <code>mouse_trafo</code>
+ with <code>NCURSES_NOMACROS</code></p>
+ </li>
- <p>The sample files are <em>generated</em> by scripts which take
- into account a few special cases such as <a href=
- "http://invisible-island.net/ncurses/tack.html">tack</a> to omit
- many of the <em class="small-caps">ncurses</em> private symbols
- (beginning with “<code>_nc_</code>”). Here are
- counts of globals versus locals:</p>
+ <li>
+ <p>remove initialization-check for calling <code>napms</code>
+ in the term-driver configuration; none is needed.</p>
+ </li>
- <blockquote>
- <table border="1" summary="Total global and local symbols">
- <tr>
- <th>Config</th>
+ <li>
+ <p>modify <code>trace</code> to avoid overwriting existing
+ file</p>
+ </li>
+ </ul>
- <th>Symbols</th>
+ <p>These are improvements to existing features:</p>
- <th>Globals</th>
+ <ul>
+ <li>
+ <p>modify <code>make_hash</code> to allow building with
+ address-sanitizer, assuming that <code>--disable-leaks</code>
+ is configured.</p>
+ </li>
- <th>Locals</th>
+ <li>
+ <p>move <code>SCREEN</code> field for <code>use_tioctl</code>
+ data before the ncursesw fields, and limit that to the
+ sp-funcs configuration to improve termlib compatibility</p>
+ </li>
- <th>"_nc_"</th>
- </tr>
+ <li>
+ <p>modify db-iterator:</p>
- <tr>
- <td>ncurses</td>
+ <ul>
+ <li>
+ <p>ignore zero-length files in db-iterator; these are
+ useful for instance to suppress
+ <code>$HOME/.terminfo</code> when not wanted.</p>
+ </li>
- <td align="right">976</td>
+ <li>
+ <p>modify <code>update_getenv</code> to ensure that
+ environment variables which are not initially set will be
+ checked later if an application happens to set them</p>
+ </li>
+ </ul>
+ </li>
- <td align="right">796</td>
+ <li>
+ <p>modify <code>_nc_outc_wrapper</code> to use the standard
+ output if the screen was not initialized, rather than
+ returning an error.</p>
+ </li>
- <td align="right">180</td>
+ <li>
+ <p>improve checks for low-level terminfo functions when the
+ terminal has not been initialized.</p>
+ </li>
- <td align="right">332</td>
- </tr>
+ <li>
+ <p>modify <code>set_curterm</code> to update
+ <code>ttytype[]</code> data used by longname/p></p>
+ </li>
- <tr>
- <td>ncursesw</td>
+ <li>
+ <p>modify <code>_nc_get_screensize</code> to allow for
+ <code>use_env</code> and <code>use_tioctl</code> state to be
+ per-screen when sp-funcs are configured, better matching the
+ behavior when using the term-driver configuration.</p>
+ </li>
- <td align="right">1089</td>
+ <li>
+ <p>remove an early-return from <code>_nc_do_color,</code>
+ which can interfere with data needed by <code>bkgd</code>
+ when <span class="main-name">ncurses</span> is configured
+ with extended colors</p>
+ </li>
- <td align="right">905</td>
+ <li>
+ <p>incorporate <code>A_COLOR</code> mask into
+ <code>COLOR_PAIR</code>, in case user application provides an
+ out-of-range pair number</p>
+ </li>
- <td align="right">184</td>
+ <li>
+ <p>modify logic for <code>endwin</code>-state to be able to
+ detect the case where the screen was never initialized, using
+ that to trigger a flush of <span class=
+ "main-name">ncurses'</span> buffer for <code>mvcur</code>,
+ e.g., in the sample program <span class=
+ "part-name">dots_mvcur</span> for the term-driver
+ configuration.</p>
+ </li>
+ </ul>
- <td align="right">343</td>
- </tr>
+ <p>These are corrections to existing features:</p>
- <tr>
- <td>ncursest</td>
+ <ul>
+ <li>
+ <p>fixes for writing extended color pairs in
+ <code>putwin</code>.</p>
+ </li>
- <td align="right">979</td>
+ <li>
+ <p>modify no-leaks code for <code>lib_cur_term.c</code> to
+ account for the <code>tgetent</code> cache.</p>
+ </li>
- <td align="right">804</td>
+ <li>
+ <p>amend handling of the <code>repeat_char</code> capability
+ in <code>EmitRange</code> to avoid scope creep: translate the
+ character to the alternate character set when the alternate
+ character set is enabled, and do not use
+ <code>repeat_char</code> for characters past 255.</p>
+ </li>
- <td align="right">175</td>
+ <li>
+ <p>improve wide-character implementation of
+ <code>myADDNSTR</code> in <code>frm_driver.c</code>, which
+ was inconsistent with the normal implementation.</p>
+ </li>
- <td align="right">358</td>
- </tr>
+ <li>
+ <p>modify <code>winnstr</code> and <code>winchnstr</code> 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.</p>
+ </li>
- <tr>
- <td>ncursestw</td>
+ <li>
+ <p>modify <code>setupterm</code> to save original tty-modes
+ so that <code>erasechar</code> works as expected. Also modify
+ <code>_nc_setupscreen</code> to avoid redundant calls to get
+ original tty-modes.</p>
+ </li>
- <td align="right">1098</td>
+ <li>
+ <p>modify <code>wattr_set</code> and <code>wattr_get</code>
+ to return <code>ERR</code> if <em>win</em>-parameter is null,
+ as documented.</p>
+ </li>
- <td align="right">914</td>
+ <li>
+ <p>correct order of initialization for traces in
+ <code>use_env</code> and <code>use_tioctl</code> versus first
+ <code>_tracef</code> calls.</p>
+ </li>
- <td align="right">184</td>
+ <li>
+ <p>correct parameters for <code>copywin</code> call in
+ <code>_nc_Synchronize_Attributes</code></p>
+ </li>
- <td align="right">372</td>
- </tr>
- </table>
- </blockquote>
+ <li>
+ <p>flush the standard output in <code>_nc_flush</code> for
+ the case where <code>SP</code> is zero, e.g., when called via
+ <code>putp</code>. This fixes a scenario where
+ “tput flash” did not work after changes in
+ 20130112.</p>
+ </li>
- <p>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
- <em>not</em> support the feature, and a few (such as Solaris)
- which provide incomplete support.</p>
-
- <p>The version-naming convention used allows these sample files
- to build distinct libraries for ABI 5 and 6. Version names
- consist of</p>
+ <li>
+ <p>amend internal use of <code>tputs</code> 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
+ “<code>*</code>” proportional delay for these
+ operations, prompting a change in <code>doupdate</code>.</p>
+ </li>
- <ul>
<li>
- <p>configuration name, e.g.,
- “<code>NCURSESW</code>” for the wide-character
- libraries</p>
+ <p>correct return-value of extended <code>putwin</code>.</p>
</li>
<li>
- <p>ABI version (if not 5)</p>
+ <p>double-width multibyte characters were not counted
+ properly in <code>winsnstr</code> and
+ <code>wins_nwstr</code>.</p>
</li>
<li>
- <p>library name for two special cases which have the same
- interface across configurations:
- “<code>TINFO</code>” and
- “<code>TIC</code>”</p>
+ <p>amend fix for <code>_nc_ripoffline</code> from 20091031 to
+ make <code>test/ditto.c</code> work in threaded
+ configuration.</p>
</li>
<li>
- <p>release version</p>
+ <p>modify <code>_nc_viscbuf2</code> and
+ <code>_tracecchar_t2</code> to trace wide-characters as a
+ whole rather than their multibyte equivalents.</p>
</li>
<li>
- <p>patch date (for the release version)</p>
+ <p>minor fix in <code>wadd_wchnstr</code> to ensure that each
+ cell has nonzero width.</p>
</li>
- </ul>
- <p>For example, running <code>nm -D</code> on the libraries in
- the ncurses6 test package shows these symbol-versions:</p>
+ <li>
+ <p>move <code>PUTC_INIT</code> calls next to
+ <code>wcrtomb</code> calls, to avoid carry-over of error
+ status when processing Unicode values which are not
+ mapped.</p>
+ </li>
- <blockquote>
- <pre class="code-block">
-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
-</pre>
- </blockquote>
+ <li>
+ <p>add missing assignment in <code>lib_getch.c</code> to make
+ <code>notimeout</code> work</p>
+ </li>
+ </ul>
+
+ <h3><a name="h3-programs" id="h3-programs">Program
+ improvements</a></h3>
- <p>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.</p>
+ <p>While reviewing user feedback, it became apparent that the
+ differences between <a href=
+ "https://invisible-island.net/ncurses/man/tset.1.html#h3-reset---reinitialization">
+ <span class="part-name">reset</span></a> (an alias for
+ <span class="part-name">tset</span>) and “<span class=
+ "part-name">tput reset</span>” were confusing:</p>
- <h3><a name="h3-lib-other" id=
- "h3-lib-other">Miscellaneous</a></h3>
+ <ul>
+ <li>one (<a href=
+ "https://invisible-island.net/ncurses/man/tset.1.html">tset</a>)
+ updated the terminal modes, but used only part of the terminfo
+ capabilities for initialization, while</li>
+
+ <li>the other (<a href=
+ "https://invisible-island.net/ncurses/man/tput.1.html"><span class="part-name">tput</span></a>)
+ used all of the terminal capabilities while neglecting the
+ terminal modes.</li>
+ </ul>
- <p>The new release has several improvements for performance and
- building. For instance:</p>
+ <p>On further investigation, it turned out that the differences
+ were largely an accident due to the way those programs had
+ evolved.</p>
+
+ <p>This release eliminates the unnecessary differences, using the
+ same approach for <span class="part-name">tput</span>'s
+ <em>init</em> (initialization), <em>reset</em> and <em>clear</em>
+ operations as the separate <a href=
+ "https://invisible-island.net/ncurses/man/tset.1.html#h3-reset---reinitialization">
+ reset</a> and <a href=
+ "https://invisible-island.net/ncurses/man/clear.1.html"><span class="part-name">
+ clear</span></a> programs. Doing this does not change the
+ command-line options; existing scripts are unaffected.</p>
+
+ <p>These are the user-visible changes for the three programs
+ (<span class="part-name">tput</span>, <span class=
+ "part-name">tset</span> and <span class=
+ "part-name">clear</span>):</p>
<ul>
<li>
- <p>several files in ncurses- and progs-directories were
- modified to allow <code>const</code> data used in internal
- tables to be put by the linker into the readonly text
- segment.</p>
+ <p>add the terminal-mode parts of “<span class=
+ "part-name">reset</span>” (aka <span class=
+ "part-name">tset</span>) to the “<code>tput
+ reset</code>” command, making the two almost the same
+ except for window-size.</p>
</li>
<li>
- <p>various improvements were made to building the Ada95
- binding, both in simplifying the generated files as well as
- improving the way it uses <code>gnatmake</code></p>
+ <p>improve <span class="part-name">tput</span>'s check for
+ being called as “init” or “reset” to
+ allow for transformed names.</p>
</li>
- </ul>
- <p>There are also new features in the libraries:</p>
+ <li>
+ <p>add “clear” as a possible link/alias to
+ <span class="part-name">tput</span>.</p>
+ </li>
- <ul>
- <li>added <a href=
- "http://invisible-island.net/ncurses/man/curs_util.3x.html#h3-use_tioctl">
- use_tioctl</a> function</li>
+ <li>
+ <p>amend changes for <span class="part-name">tput</span> to
+ reset tty modes to “sane” if the program is run
+ as “reset”, like <span class=
+ "part-name">tset</span>. Likewise, ensure that <span class=
+ "part-name">tset</span> sends either reset- or
+ init-strings.</p>
+ </li>
<li>
- <p>added <a href=
- "http://invisible-island.net/ncurses/man/curs_opaque.3x.html">
- wgetdelay</a> to retrieve _delay member of WINDOW if it
- happens to be opaque, e.g., in the pthread configuration.</p>
+ <p>add <code>-x</code> option to <span class=
+ "part-name">clear</span>/<span class="part-name">tput</span>
+ to make the <code>E3</code> extension optional</p>
</li>
<li>
- <p>added <a href=
- "http://invisible-island.net/ncurses/man/curs_attr.3x.html#h2-PORTABILITY">
- A_ITALIC</a> extension.</p>
+ <p>add functionality of
+ “<code>tset -w</code>” to <span class=
+ "part-name">tput</span>, like the
+ “<code>-c</code>” feature this is not optional in
+ <span class="part-name">tput</span>.</p>
</li>
<li>
- <p>added form library extension <a href=
- "http://invisible-island.net/ncurses/man/form_field_opts.3x.html">
- O_DYNAMIC_JUSTIFY</a> option which can be used to override
- the different treatment of justification for static versus
- dynamic fields .</p>
+ <p>add options <code>-T</code> and <code>-V</code> to
+ <span class="part-name">clear</span> command for
+ compatibility with <span class="part-name">tput</span>.</p>
</li>
<li>
- <p>rewrote <a href=
- "http://invisible-island.net/ncurses/man/curs_util.3x.html#h3-putwin_getwin">
- putwin</a> and <a href=
- "http://invisible-island.net/ncurses/man/curs_util.3x.html#h3-putwin_getwin">
- getwin</a>, making an extended version which is capable of
- reading screen-dumps between the wide/normal <em class=
- "small-caps">ncurses</em> configurations. These are text
- files, except for a <em>magic</em> code at the beginning:</p>
+ <p>drop long-obsolete “<code>-n</code>” option
+ from <span class="part-name">tset</span>.</p>
+ </li>
- <blockquote>
- <pre class="code-block">
-0 string \210\210 Screen-dump (ncurses)
-</pre>
- </blockquote>
+ <li>
+ <p>modify <span class="part-name">tset</span>'s assignment to
+ <code>TERM</code> 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 <span class="part-name">tset</span> from
+ termcap to terminfo. The termcap library in 4.3BSD did this
+ to avoid using the short 2-character name</p>
</li>
<li>
- <p>several changes to mouse support include:</p>
+ <p>remove a restriction in <span class=
+ "part-name">tput</span>'s support for termcap names which
+ omitted capabilities normally not shown in termcap
+ translations</p>
+ </li>
+
+ <li>
+ <p>add usage message to <span class="part-name">clear</span>
+ command</p>
+ </li>
+
+ <li>
+ <p>improve usage messages for <span class=
+ "part-name">tset</span> and <span class=
+ "part-name">tput</span>.</p>
+ </li>
+ </ul>
+
+ <p>Other user-visible improvements and new features include:</p>
+
+ <ul>
+ <li>
+ <p>modify <span class="part-name">tic</span>/<span class=
+ "part-name">infocmp</span> display of numeric values to use
+ hexadecimal when they are "close" to a power of two, making
+ the result more readable.</p>
+ </li>
+
+ <li>
+ <p>add “<code>-W</code>” option to <span class=
+ "part-name">tic</span>/<span class="part-name">infocmp</span>
+ to force long strings to wrap.</p>
<ul>
- <li>added decoder for xterm SGR 1006 mouse mode.</li>
+ <li>
+ <p>This is in addition to the
+ “<code>-w</code>” option which attempts to
+ fit capabilities into a given line-length.</p>
+ </li>
- <li>added experimental support for
- “<code>%u</code>” format to terminfo.</li>
+ <li>
+ <p>If “<code>-f</code>” option splits line,
+ do not further split it with
+ “<code>-W</code>”.</p>
+ </li>
- <li>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 .</li>
+ <li>
+ <p>Begin a new line when adding
+ “<code>use=</code>” after a wrapped line.</p>
+ </li>
</ul>
</li>
- </ul>
- <p>There are a few new configure options dealing with library
- customization:</p>
+ <li>
+ <p>add “<code>-q</code>” option to <span class=
+ "part-name">infocmp</span> to suppress the
+ “<code>Reconstructed from</code>” comment from
+ the header, and a corresponding option to <span class=
+ "part-name">tic</span> to suppress all comments from the
+ “<code>tic -I</code>” output.</p>
+ </li>
- <ul>
<li>
- <p>add “<code>--enable-ext-putwin</code>”
- configure option to turn on the extended putwin/getwin. By
- default, this is enabled for ABI 6 and disabled with ABI
- 5.</p>
+ <p>Sorted options in usage message for <span class=
+ "part-name">infocmp</span>, to make it simpler to see unused
+ letters.</p>
</li>
<li>
- <p>add “<code>--enable-string-hacks</code>”
- option to control whether strlcat and strlcpy may be used.
- Because <em class="small-caps">ncurses</em> already does the
- requisite buffer-limit checks, this feature is mainly of
- interest to quiet compiler-warnings on a few systems.</p>
+ <p>Updated usage message for <span class=
+ "part-name">tic</span>, adding “<code>-0</code>”
+ option.</p>
</li>
<li>
- <p>add configure option
- “<code>--with-tparm-arg</code>” to allow <a href=
- "http://invisible-island.net/ncurses/man/curs_terminfo.3x.html#h3-Formatting-Output">
- tparm</a>'s parameters to be something more likely to be the
- same size as a pointer, e.g., <code>intptr_t</code> (again,
- the default is set for ABI 6).</p>
+ <p>add <span class="part-name">infocmp</span>/<span class=
+ "part-name">tic</span> “<code>-Q</code>” option,
+ which allows one to dump the compiled form of the terminal
+ entry, in hexadecimal or base64:</p>
+
+ <ul>
+ <li>A “<code>b64:</code>” prefix in the
+ <code>TERMINFO</code> variable tells the terminfo reader to
+ use base64 according to RFC-3548 as well as RFC-4648
+ url/filename-safe format.</li>
+
+ <li>A “<code>hex:</code>” prefix tells the
+ terminfo reader to accept hexadecimal data as generated by
+ “<code>infocmp -0qQ1</code>”.</li>
+ </ul>
</li>
</ul>
- <h3><a name="h3-programs" id="h3-programs">Program
- improvements</a></h3>
-
- <h4><a name="h4-utilities" id="h4-utilities">Utilities</a></h4>
-
- <p>Most of the termcap-related changes based on development of
- <a href="http://invisible-island.net/ncurses/tctest.html">tctest
- (termcap library checker)</a> are implemented in the tic and
- infocmp programs rather than affecting the library. As noted in
- the <a href=
- "http://invisible-island.net/ncurses/tctest.html#my-better-translation">
- discussion</a> of <code>tctest</code>, <em class=
- "small-caps">ncurses</em>'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 <em>termcap</em> users are
- using <em class="small-caps">ncurses</em> (or NetBSD, with its
- own terminfo library) and their programs are actually using
- terminfo rather than termcap data.</p>
-
- <p>Still, there are a few. A comment about the translation of the
- ASCII <code>NUL</code> character prompted a review:</p>
+ <p>Other less-visible improvements and new features include:</p>
<ul>
<li>
- <p>Both terminfo and termcap store string capabilities as
- <code>NUL</code>-terminated strings.</p>
+ <p>modify utility headers such as <code>tic.h</code> to make
+ it clearer which are externals that are used by <span class=
+ "main-name">tack</span>.</p>
</li>
<li>
- <p>In terminfo, a <code>\0</code> in a terminal description
- is stored as <code>\200</code>.</p>
+ <p>add “<code>reset</code>” to list of programs
+ whose names might change in manpages due to
+ program-transformation configure options.</p>
</li>
<li>
- <p>There are no (known) terminals which would behave
- differently when sent <code>\0</code> or
- <code>\200</code>.</p>
+ <p>modify “<code>-T</code>” option of
+ <span class="part-name">clear</span> and <span class=
+ "part-name">tput</span> to call <code>use_tioctl</code> to
+ obtain the operating system's notion of the screensize if
+ possible.</p>
</li>
<li>
- <p>When translating to terminfo format (or displaying a
- printable version of an entry using infocmp), <em class=
- "small-caps">ncurses</em> shows <code>\200</code> as
- <code>\0</code>.</p>
+ <p>add check in <span class="part-name">tput</span> for
+ init/reset operands to ensure those use a terminal.</p>
</li>
<li>
- <p>It has done this since 1998 (quoting from the NEWS
- file):</p>
-
- <blockquote>
- <pre class="code-block">
-<a href=
-"http://invisible-island.net/ncurses/NEWS.html#t980103">980103</a>
-...
- + modify _nc_tic_expand() to generate \0 rather than \200.
-...
- + correct translation of terminfo "^@", to \200, like \0.
-</pre>
- </blockquote>
+ <p>modify programs <span class="part-name">clear</span>,
+ <span class="part-name">tabs</span>, <span class=
+ "part-name">tput</span> and <span class=
+ "part-name">tset</span> to pass the actual tty file
+ descriptor to setupterm rather than the standard output or
+ error, making padding work.</p>
</li>
<li>
- <p>However, the <code>_nc_tic_expand</code> function (which
- optionally produces terminfo or termcap format) did not
- address this special case for termcap. Even the later 4.4BSD
- <a href=
- "https://svnweb.freebsd.org/base/head/lib/libc/gen/getcap.c?revision=244092&view=markup#l784">
- cgetstr</a> interprets a <code>\0</code> literally, ending
- <em>that</em> string (rather than using the terminfo
- improvement).</p>
+ <p>change <span class="part-name">tset</span>'s
+ initialization to allow it to get settings from the standard
+ input as well as <code>/dev/tty</code>, to be more effective
+ when output or error are redirected.</p>
</li>
- </ul>
- <p>As a result of the review, several improvements were made to
- <em class="small-caps">ncurses</em> 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:</p>
-
- <ul>
<li>
- <p>the “<code>-0</code>” option generates
- termcap/terminfo source on a single line.</p>
+ <p>amend check in <span class="part-name">tput</span>,
+ <span class="part-name">tabs</span> and <span class=
+ "part-name">clear</span> to allow those to use the
+ database-only features in <span class="part-name">cron</span>
+ if a “<code>-T</code>” option gives a suitable
+ terminal name.</p>
</li>
<li>
- <p>the “<code>-K</code>” option provides stricter
- BSD-compatibility for termcap output.</p>
+ <p>improve error message from <span class=
+ "part-name">tset</span>/<span class="part-name">reset</span>
+ when both stderr/stdout are redirected to a file or pipe.</p>
</li>
</ul>
- <p>Other user-visible improvements and new features include:</p>
+ <p>Several of the less apparent features deal with translation of
+ terminfo to termcap (and the reverse), with corresponding checks
+ by <span class="part-name">tic</span>:</p>
<ul>
<li>
- <p>added “<code>-D</code>” option to tic and
- infocmp, to show the database locations that it could
- use.</p>
+ <p>modify check in <code>fmt_entry</code> to handle a
+ cancelled reset string. Make similar fixes in other parts of
+ <code>dump_entry.c</code> and <code>tput.c</code></p>
</li>
<li>
- <p>added “<code>-s</code>” option to toe, to sort
- its output.</p>
+ <p>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.</p>
</li>
<li>
- <p>extended “<code>-c</code>” and
- “<code>-n</code>” options of infocmp to allow
- comparing more than two entries.</p>
+ <p>modify <span class="part-name">infocmp</span> to suppress
+ mixture of absent/cancelled capabilities that would only show
+ as “<code>NULL, NULL</code>”, unless the
+ “<code>-q</code>” option is used, e.g., to show
+ “<code>-, @</code>” or “<code>@,
+ -</code>”.</p>
</li>
<li>
- <p>modified toe's report when “<code>-a</code>”
- and “<code>-s</code>” options are combined, to
- add a column showing which entries belong to a given
- database.</p>
+ <p>correct a warning from <span class="part-name">tic</span>
+ about keys which are the same, to skip over missing/cancelled
+ values.</p>
</li>
<li>
- <p>modified the clear program to take into account the
- “<code>E3</code>” extended capability to clear
- the terminal's scrollback buffer.</p>
+ <p>add check in <span class="part-name">tic</span> for use of
+ bold, etc., video attributes in the color capabilities,
+ accounting whether the feature is listed in
+ <code>ncv</code>.</p>
</li>
- </ul>
- <h4><a name="h4-examples" id="h4-examples">Examples</a></h4>
+ <li>
+ <p>add check in <span class="part-name">tic</span> for
+ unnecessary use of “<code>2</code>” to denote a
+ shifted special key.</p>
+ </li>
- <p>Along with the library and utilities, many improvements were
- made to the <a href=
- "http://invisible-island.net/ncurses/ncurses-examples.html">ncurses-examples</a>.
- 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).</p>
+ <li>
+ <p>improve check in <span class="part-name">tic</span> 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.</p>
+ </li>
- <p>These changes were made to verify compatibility or compare
- performance of <em class="small-caps">ncurses</em>:</p>
+ <li>
+ <p>improve checks in <code>trim_sgr0</code>, comp_parse.c and
+ parse_entry.c, for cancelled string capabilities.</p>
+ </li>
- <ul>
<li>
- <p>made workarounds for compiling test-programs with NetBSD
- curses, though it lacks some common functions such as
- <a href="http://invisible-island.net/ncurses/man/curs_util.3x.html#h3-use_env">
- use_env</a>.</p>
+ <p>add check in <span class="part-name">tic</span> for some
+ syntax errors of delays, as well as use of proportional
+ delays for non-line capabilities.</p>
</li>
<li>
- <p>added dots_termcap test-program</p>
+ <p>add check in <span class="part-name">tic</span> for
+ conflict between <code>ritm</code>, <code>rmso</code>,
+ <code>rmul</code> versus <code>sgr0</code>.</p>
</li>
<li>
- <p>added dots_curses test-program, for comparison with the
- low-level examples.</p>
+ <p>add check in <code>_nc_parse_entry</code> for invalid
+ entry name, setting the name to
+ “<code>invalid</code>” to avoid problems storing
+ entries.</p>
</li>
<li>
- <p>added test_setupterm test-proram to demonstrate
- normal/error returns from the setupterm and restartterm
- functions.</p>
+ <p>improve <code>_nc_tparm_analyze</code>, using that to
+ extend the checks made by <span class="part-name">tic</span>
+ for reporting inconsistencies between the expected number of
+ parameters for a capability and the actual.</p>
</li>
<li>
- <p>added “<code>-d</code>”,
- “<code>-e</code>” and
- “<code>-q</code>” options to the demo_terminfo
- and demo_termcap test-programs.</p>
+ <p>remove <span class="part-name">tic</span> warning about
+ “<code>^?</code>” 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, <a href=
+ "https://invisible-island.net/ncurses/tctest.html#bsd42-ctl-question">
+ BSD termcap</a> did not support this feature (until the
+ <a href=
+ "https://invisible-island.net/ncurses/tctest.html#freebsd-ctl-question">
+ mid-1990s</a>).</p>
+
+ <p>in <code>_nc_infotocap</code>, added a check to ensure
+ that terminfo “<code>^?</code>” is not written to
+ termcap.</p>
</li>
<li>
- <p>added “<code>-y</code>” option to demo_termcap
- and test/demo_terminfo test-programs to demonstrate behavior
- with/without extended capabilities.</p>
+ <p>modify <code>sscanf</code> calls in
+ <code>_nc_infotocap</code> for patterns
+ “<code>%{number}%+%c</code>” and
+ “<code>%'char'%+%c</code>” to check that the
+ final character is really “<code>c</code>”,
+ avoiding a case in icl6404 which cannot be converted to
+ termcap.</p>
</li>
<li>
- <p>modified demo_termcap and demo_terminfo test-programs to
- make their options more directly comparable, and add
- “<code>-i</code>” option to specify a terminal
- description filename to parse for names to lookup.</p>
+ <p>in <code>_nc_tic_expand</code> and
+ <code>_nc_infotocap</code>, improved string-length check when
+ deciding whether to use “<code>^X</code>” or
+ “<code>\xxx</code>” format for control
+ characters, to make the output of <span class=
+ "part-name">tic</span>/<span class="part-name">infocmp</span>
+ more predictable.</p>
</li>
<li>
- <p>rewrote the tests for <a href=
- "http://invisible-island.net/ncurses/man/curs_window.3x.html#h3-derwin">
- mvderwin</a> and test for recursive <a href=
- "http://invisible-island.net/ncurses/man/curs_window.3x.html#h3-mvwin">
- mvwin</a> in the movewindow test-program.</p>
+ <p>limited termcap “<code>%d</code>” width to 2
+ digits on input, and use “<code>%2</code>” in
+ preference to “<code>%02</code>” on output.</p>
+ </li>
+
+ <li>
+ <p>correct terminfo/termcap conversion of
+ “<code>%02</code>” and
+ “<code>%03</code>” into
+ “<code>%2</code>” and
+ “<code>%3</code>”; the result repeated the last
+ character.</p>
</li>
</ul>
- <p>These changes were made to help with the MinGW port:</p>
+ <h4><a name="h4-examples" id="h4-examples">Examples</a></h4>
+
+ <p>Along with the library and utilities, many improvements were
+ made to the <a href=
+ "https://invisible-island.net/ncurses/ncurses-examples.html">ncurses-examples</a>.</p>
+
+ <p>These changes were made to demonstrate new extensions in
+ <span class="main-name">ncurses</span>:</p>
<ul>
<li>
- <p>added test-screens to the ncurses test-program to show
- 256-characters at a time, to help with MinGW port.</p>
+ <p>add <span class="part-name">demo_new_pair</span> program,
+ to demonstrate <a href=
+ "https://invisible-island.net/ncurses/man/new_pair.3x.html#h3-alloc_pair">
+ <code>alloc_pair</code></a>, <a href=
+ "https://invisible-island.net/ncurses/man/new_pair.3x.html#h3-find_pair">
+ <code>find_pair</code></a> and <a href=
+ "https://invisible-island.net/ncurses/man/new_pair.3x.html#h3-free_pair">
+ <code>free_pair</code></a> functions.</p>
+
+ <p>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.,</p>
+
+ <blockquote>
+ <table summary="sample layouts for demo_new_pair">
+ <tr>
+ <td><code>32x64,32x128</code> </td>
+
+ <td>256 colors</td>
+ </tr>
+
+ <tr>
+ <td><code>24x44,24x88</code></td>
+
+ <td>88 colors</td>
+ </tr>
+
+ <tr>
+ <td><code>32x64,24x128</code></td>
+
+ <td>16 colors</td>
+ </tr>
+ </table>
+ </blockquote>
</li>
<li>
- <p>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.</p>
+ <p>add <span class="part-name">extended_color</span> program,
+ like the older <span class="part-name">color_set</span>
+ program, but using the extended color functions, with and
+ without the SP-functions interface.</p>
</li>
<li>
- <p>added “<code>-s</code>” 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.</p>
+ <p>add <span class="part-name">picsmap</span> program to fill
+ in some testing issues not met by <span class=
+ "part-name">dots</span>, using this as the third example in a
+ comparison of the <a href=
+ "https://invisible-island.net/ncurses/ncurses-slang.html#compare_picsmap">
+ ncurses versus slang</a> libraries.</p>
+
+ <p>The program can directly read X bitmap and pixmap files,
+ displaying a picture. It can read other image files using
+ <span class="part-name">ImageMagick</span>'s <span class=
+ "part-name">convert</span> program to translate the image
+ into text.</p>
+
+ <p>For 16-, 88- and 256-color terminal descriptions,
+ <span class="part-name">picsmap</span> can load a palette
+ file which tells it which color palette entries to use. For
+ direct-colors, the terminal descriptions use the
+ <code>RGB</code> extension capability.</p>
</li>
</ul>
- <p>These changes were made to verify new extensions in <em class=
- "small-caps">ncurses</em>:</p>
+ <p>There are other new example programs and a few scripts:</p>
<ul>
<li>
- <p>added <a href=
- "http://invisible-island.net/ncurses/man/form_driver.3x.html#h3-form_driver_w">
- form_driver_w</a> entrypoint to wide-character forms library,
- as well as form_driver_w test-program.</p>
+ <p>add <span class="part-name">dots_xcurses</span> program to
+ illustrate a different approach used for extended colors
+ which can be contrasted with <span class=
+ "part-name">dots_curses</span>.</p>
</li>
<li>
- <p>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.</p>
+ <p>add <span class="part-name">list_keys</span> program show
+ function keys for one or more terminal descriptions. It uses
+ <span class="main-name">ncurses'</span>s convention of
+ modifiers for special keys, based on xterm.</p>
</li>
<li>
- <p>modified ncurses test-program, adding
- “<code>-E</code>” and
- “<code>-T</code>” options to demonstrate use_env
- versus use_tioctl.</p>
+ <p>add <span class="part-name">padview</span> program, to
+ compare pads with direct updates in the <span class=
+ "part-name">view</span> program.</p>
</li>
<li>
- <p>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.</p>
+ <p>add <span class="part-name">sp_tinfo</span> program to
+ exercise the SP-functions extension of the low-level terminfo
+ library.</p>
</li>
<li>
- <p>modified the ncurses test-program to also show position
- reports in 'a' test.</p>
+ <p>add test-programs for <code>termattrs</code> and
+ <code>term_attrs</code> functions.</p>
</li>
- </ul>
-
- <p>These changes were made to make the examples more useful:</p>
- <ul>
<li>
- <p>added scripts for building dpkg and rpm test-packages</p>
+ <p>add <span class="part-name">test_sgr</span> program to
+ exercise all combinations of the sgr capability.</p>
</li>
<li>
- <p>modified the hanoi test-program to show the minimum number
- of moves possible for the given number of tiles.</p>
+ <p>add <span class="part-name">tput-colorcube</span> demo
+ script, imitating xterm's 88- and 256-color scripts using
+ <span class="part-name">tput</span>.</p>
</li>
<li>
- <p>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.</p>
+ <p>add <span class="part-name">tput-initc</span> script to
+ demonstrate how <span class="part-name">tput</span> may be
+ used to initialize a color palette from a data file.</p>
</li>
</ul>
- <h3><a name="h3-database" id="h3-database">Terminal
- database</a></h3>
+ <p>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.</p>
- <p>This release provides improvements to tic's
- “<code>-c</code>” checking option, which was used for
- example to</p>
+ <p>The <span class="part-name">ncurses</span> program is the
+ largest; a proportionately large number of changes were made to
+ it:</p>
<ul>
<li>
- <p>make <code>sgr</code> in several entries agree with other
- caps.</p>
+ <p>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.</p>
+
+ <p>add “<code>t</code>” toggle for
+ <code>notimeout</code> function.</p>
</li>
<li>
- <p>correct padding in some entries where earlier versions had
- miscounted the number of octal digits.</p>
+ <p>modify layout of b/B screens to allow for additional
+ annotation on the right margin; some terminals with partial
+ support did not display well.</p>
</li>
- </ul>
- <p>There are several new terminal descriptions:</p>
-
- <ul>
- <li><a href=
- "http://invisible-island.net/ncurses/terminfo.src.html#toc-_M_L_T_E_R_M">
- mlterm</a> is now aliased to mlterm3</li>
-
- <li><a href=
- "http://invisible-island.net/ncurses/terminfo.src.html#tic-nsterm">
- nsterm</a> is now derived from nsterm-256color</li>
-
- <li><a href=
- "http://invisible-island.net/ncurses/terminfo.src.html#tic-putty-sco">
- putty-sco</a></li>
+ <li>
+ <p>modify c/C screens to allow for extended color pairs.</p>
- <li><a href=
- "http://invisible-island.net/ncurses/terminfo.src.html#tic-teken">
- teken</a> is FreeBSD's "xterm" console.</li>
+ <p>add z/Z <em>zoom</em> feature to make extended color pairs
+ easier to test.</p>
- <li><a href=
- "http://invisible-island.net/ncurses/terminfo.src.html#toc-_T_E_R_M_I_N_A_T_O_R">
- terminator</a></li>
+ <p>modify test-screens to take advantage of wide screens,
+ reducing the number of lines used for 88- and 256-colors.</p>
+ </li>
- <li><a href=
- "http://invisible-island.net/ncurses/terminfo.src.html#toc-_T_E_R_M_I_N_O_L_O_G_Y">
- terminology</a></li>
+ <li>
+ <p>modify “<code>d</code>” edit-color screen to
+ optionally read xterm color palette directly from terminal,
+ as well as handling <code>KEY_RESIZE</code> and
+ screen-repainting with control/L and control/R.</p>
+ </li>
- <li><a href=
- "http://invisible-island.net/ncurses/terminfo.src.html#tic-tmux">
- tmux</a> is derived from screen.</li>
+ <li>
+ <p>add examples to “<code>F</code>” screen for
+ <code>WACS_D_PLUS</code> and <code>WACS_T_PLUS</code>.</p>
+ </li>
- <li>several screen.XXX entries support the respective
- variations for 256 colors.</li>
+ <li>
+ <p>improve “<code>g</code>” screen, correcting
+ ifdef which made the legend not reflect changes to keypad-
+ and scroll-modes. Added check for return-value of
+ <code>putwin</code>.</p>
+ </li>
- <li><a href=
- "http://invisible-island.net/ncurses/terminfo.src.html#toc-_S_I_M_P_L_E_T_E_R_M">
- simpleterm</a> is now 0.5</li>
+ <li>
+ <p>make “<code>s</code>” test easier to
+ understand which subtests are available</p>
- <li><a href=
- "http://invisible-island.net/ncurses/terminfo.src.html#tic-vte">
- vte</a> is aliased to vte-2012</li>
+ <p>add a corresponding “<code>S</code>”
+ wide-character overlap test-screen.</p>
+ </li>
- <li><a href=
- "http://invisible-island.net/ncurses/terminfo.src.html#tic-vt520ansi">
- vt520ansi</a></li>
+ <li>
+ <p>add “<code>v</code>” screen to show
+ <code>baudrate</code> and other values.</p>
+ </li>
</ul>
- <p>A few entries use extensions (user-defined terminal
- capabilities):</p>
+ <p>These changes were made to the other examples:</p>
<ul>
<li>
- <p><code>E3</code>, used in linux, putty and xterm-basic is
- tested in the <a href=
- "http://aerie.jexium-island.net/ncurses/man/clear.1.html">clear</a>
- program to erase a terminal's scrollback.</p>
+ <p>modify <span class="part-name">blue</span> program to use
+ Unicode values for card-glyphs when available, as well as
+ improving the check for CP437 and CP850.</p>
</li>
<li>
- <p><code>TS</code> is used in the <a href=
- "http://invisible-island.net/ncurses/terminfo.src.html#tic-xterm_sl">
- xterm+sl</a> building block to help deprecate the misuse of
- <code>tsl</code> for xterm's title-string.</p>
+ <p>improve <span class="part-name">demo_menus</span> program,
+ allowing mouse-click on the menu-headers to switch the active
+ menu. This requires a new extension option
+ <code>O_MOUSE_MENU</code> 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.</p>
</li>
<li>
- <p><code>XT</code> 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.</p>
+ <p>correct logic in <span class=
+ "part-name">demo_terminfo</span> program for
+ “<code>-f</code>” option</p>
</li>
<li>
- <p><code>xm</code> is used in examples <a href=
- "http://invisible-island.net/ncurses/terminfo.src.html#tic-xterm-1005">
- xterm-1005</a> and <a href=
- "http://invisible-island.net/ncurses/terminfo.src.html#tic-xterm-1006">
- xterm-1006</a> to illustrate a way to make mouse handling
- more general</p>
+ <p>modify <span class="part-name">ditto</span> program to
+ allow <code>$XTERM_PROG</code> environment variable to
+ override "xterm" as the name of the program to run in the
+ threaded configuration.</p>
</li>
- </ul>
- <p>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
- <code>A_ITALIC</code> extension.</p>
+ <li>
+ <p>add several options to the “<em>dots</em>”
+ test-programs.</p>
+ </li>
- <ul>
- <li>konsole, mlterm3 (italics)</li>
+ <li>
+ <p>modify <span class="part-name">filter</span> program:</p>
+
+ <ul>
+ <li>illustrate an alternative to <code>getnstr</code>, that
+ polls for input while updating a clock on the right margin
+ as well as responding to window size-changes.</li>
+
+ <li>adapt logic used in <a href=
+ "https://invisible-island.net/dialog/"><span class=
+ "main-name">dialog</span></a> <a href=
+ "https://invisible-island.net/dialog/manpage/dialog.html#h3-Common-Options">
+ “<code>--keep-tite</code>” option</a> for
+ <span class="part-name">filter</span> program as the "-a"
+ option. When set, <span class="part-name">filter</span>
+ attempts to suppress the alternate screen.</li>
+ </ul>
+ </li>
- <li>nsterm (dim)</li>
+ <li>
+ <p>modify <span class="part-name">knight</span> program to
+ provide the "slow" solution for small screens using
+ “<code>R</code>”, noting that Warnsdorf's method
+ is easily done with “<code>a</code>”.</p>
+ </li>
- <li>screen (dim)</li>
+ <li>
+ <p>modify the <span class="part-name">savescreen</span>
+ program to add test patterns that exercise 88-, 256-, etc.,
+ colors.</p>
+ </li>
- <li>vte (dim, italics)</li>
+ <li>
+ <p>add options to <span class="part-name">test_arrays</span>,
+ for selecting termcap vs terminfo, etc.</p>
+ </li>
- <li>xterm (dim, italics)</li>
- </ul>
+ <li>
+ <p>modify the <span class="part-name">view</span>
+ program:</p>
- <h3><a name="h3-documentation" id=
- "h3-documentation">Documentation</a></h3>
+ <ul>
+ <li>expand tabs using the ncurses library rather than in
+ the test-program.</li>
- <p>As usual, this release</p>
+ <li>eliminate the “<code>-n</code>” option by
+ simply reading the whole file.</li>
+
+ <li>implement page up/down commands.</li>
+
+ <li>remove the very old <code>SIGWINCH</code> example; just
+ use <code>KEY_RESIZE</code>.</li>
+ </ul>
+ </li>
- <ul>
<li>
- <p>improves documentation by describing new features,</p>
+ <p>improve animation in <span class="part-name">xmas</span>
+ program by adding a time-delay in <code>blinkit</code>.</p>
</li>
<li>
- <p>attempts to improve the description of features which
- users have found confusing</p>
+ <p>modify several test-programs which call
+ <code>use_default_colors</code> to consistently do this only
+ if the “<code>-d</code>” option is given.</p>
</li>
<li>
- <p>fills in overlooked descriptions of features which were
- described in the <a href=
- "http://invisible-island.net/ncurses/NEWS.html">NEWS</a> file
- but treated sketchily in manual pages.</p>
+ <p>modify the install-rule for ncurses-examples to put the
+ data files in the data directory, e.g.,
+ <code>/usr/share/ncurses-examples</code>.</p>
</li>
- </ul>
- <p>In addition, the mechanism for producing HTML versions of the
- documentation has been improved:</p>
+ <li>
+ <p>modify several test programs to use new
+ <code>popup_msgs</code> function, adapted from the
+ help-screen used in the <code>edit_field</code> program.</p>
+ </li>
- <ul>
<li>
- <p>use an improved version of <a href=
- "http://invisible-island.net/scripts/man2html.html">man2html</a>
- to generate html manpages.</p>
+ <p>modify test data for xterm palettes to use the newer
+ color4/color12 values.</p>
</li>
<li>
- <p>regenerated <a href=
- "http://invisible-island.net/ncurses/NCURSES-Programming-HOWTO.html">
- NCURSES-Programming-HOWTO.html</a> to fix some of the broken
- html emitted by docbook.</p>
+ <p>improve the <span class="part-name">tracemunch</span>
+ script:</p>
+
+ <ul>
+ <li>show screenXX pointers and thread identifiers as
+ names.</li>
+
+ <li>chang address-parameters of <code>add_wch</code>,
+ <code>color_content</code> and <code>pair_content</code> to
+ dummy parameters.</li>
+ </ul>
</li>
</ul>
- <h3><a name="h3-bug-fixes" id="h3-bug-fixes">Interesting
- bug-fixes</a></h3>
+ <h3><a name="h3-database" id="h3-database">Terminal
+ database</a></h3>
+
+ <p>There are several new terminal descriptions:</p>
+
+ <blockquote>
+ <p><code>dumb-emacs-ansi</code>, <code>dvtm</code>,
+ <code>dvtm-256color</code>, <code>fbterm</code>,
+ <code>iterm2</code>, <code>linux-m1</code> <em>minitel
+ entries</em>, <code>putty-noapp</code>, <code>viewdata</code>,
+ and <code>vt100+4bsd</code> <em>building-block</em>.</p>
+
+ <p><code>xterm+noalt</code>, <code>xterm+titlestack</code>,
+ <code>xterm+alt1049</code>, <code>xterm+alt+title</code>
+ <em>building blocks</em> and <code>xterm+direct</code>,
+ <code>xterm+indirect</code>, <code>xterm-direct</code>. from
+ <a href=
+ "https://invisible-island.net/xterm/xterm.log.html#xterm_331">xterm
+ patch #331</a>.</p>
+
+ <p>several other “<code>-direct</code>”
+ descriptions to address the differences of other terminal
+ emulators versus <code>xterm-direct</code>.</p>
+ </blockquote>
+
+ <p>There are many changes to existing terminal descriptions. Some
+ were updates to several descriptions:</p>
<ul>
- <li>
- <p>Ada95 binding:</p>
+ <li>use <code>xterm+sm+1006</code> in several terminal
+ descriptions which were validated as supporting the extended
+ mouse feature for their respective terminal emulators.</li>
+
+ <li>corrected <em>sgr</em>/<em>sgr0</em> strings in a few cases
+ reported by <span class="part-name">tic</span>, making those
+ correspond to the non-<em>sgr</em> settings where they differ,
+ but otherwise use ECMA-48 consistently.</li>
+
+ <li>add 0.1sec mandatory delay to <em>flash</em> capabilities
+ using the VT100 reverse-video control</li>
+ </ul>
+ <p>while others affected specific descriptions. These were
+ retested, to take into account new/undocumented changes by their
+ developers:</p>
+
+ <blockquote>
+ <p><code>iterm</code>, <code>minitel</code>, <code>st</code>,
+ <code>viewdata</code>, <code>nsterm</code></p>
+ </blockquote>
+
+ <p>while these are specific fixes based on user reports, or
+ warnings from <span class="part-name">tic</span>:</p>
+
+ <dl>
+ <dt><a href=
+ "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">
+ <code>ansi</code> <em>building blocks</em></a></dt>
+
+ <dd>
<ul>
- <li>
- <p>modify makefile rules to ensure that the PIC option is
- not used when building a static library</p>
- </li>
+ <li>restored <em>rmir</em>/<em>smir</em> in
+ <code>ansi+idc</code> to better match original
+ <code>ansiterm+idc</code>, add alias
+ <code>ansiterm</code></li>
+ </ul>
+ </dd>
- <li>
- <p>make Ada95 build-fix for big-endian architectures such
- as sparc. This undoes one of the fixes from <a href=
- "http://invisible-island.net/ncurses/NEWS.html#t20110319">
- 20110319</a>, which added an
- “<code>Unused</code>” member to
- representation clauses, replacing that with pragmas to
- suppress warnings about unused bits.</p>
- </li>
+ <dt><a href=
+ "https://invisible-island.net/ncurses/terminfo.src.html#tic-icl6404">
+ <code>icl6402</code></a></dt>
+
+ <dd>
+ <ul>
+ <li>corrected missing comma-separator between string
+ capabilities in <code>icl6402</code> and
+ <code>m2-nam</code></li>
</ul>
- </li>
+ </dd>
- <li>
- <p>Color and attributes:</p>
+ <dt><a href=
+ "https://invisible-island.net/ncurses/terminfo.src.html#tic-interix">
+ <code>interix</code></a></dt>
+ <dd>
<ul>
- <li>
- <p>parenthesize parameter of <code>COLOR_PAIR</code> and
- <code>PAIR_NUMBER</code> in curses.h in case it happens
- to be a comma-expression.</p>
- </li>
+ <li>updated using <span class="main-name">tack</span> and
+ SFU with Windows 7 Ultimate.</li>
- <li>
- <p>improve <a href=
- "http://invisible-island.net/ncurses/NEWS.html#t20021221">
- 20021221</a> workaround for broken acs, handling a case
- where that ACS_<em>xxx</em> character is not in the
- <code>acsc</code> string but there is a known
- wide-character which can be used.</p>
- </li>
+ <li>used <code>^?</code> for <em>kdch1</em></li>
+ </ul>
+ </dd>
- <li>
- <p>modify <a href=
- "http://invisible-island.net/ncurses/man/curs_color.3x.html#h3-Routine-Descriptions">
- init_pair</a> to accept -1's for color value after
- <a href=
- "http://invisible-island.net/ncurses/man/default_colors.3x.html">
- assume_default_colors</a> has been called.</p>
- </li>
+ <dt><a href=
+ "https://invisible-island.net/ncurses/terminfo.src.html#toc-_Linux_consoles">
+ <code>linux</code></a></dt>
- <li>
- <p>add a check in <a href=
- "http://invisible-island.net/ncurses/man/curs_color.3x.html#h3-Routine-Descriptions">
- start_color</a> to limit color-pairs to 256 when extended
- colors are not supported.</p>
- </li>
+ <dd>
+ <ul>
+ <li>made <code>linux3.0</code> entry the default
+ <strong><code>linux</code></strong> entry</li>
+
+ <li>modify <code>linux2.6</code> entry to improve
+ line-drawing so that the <code>linux3.0</code> entry can be
+ used in non-UTF-8 mode</li>
+
+ <li>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.</li>
+
+ <li>modify <em>flash</em> capability for <code>linux</code>
+ and <code>wyse</code> entries to put the delay between the
+ reverse/normal escapes rather than after</li>
+
+ <li>modify <code>linux-16color</code> to not mask dim,
+ standout or reverse with the <em>ncv</em> capability</li>
</ul>
- </li>
+ </dd>
- <li>
- <p>Resizing the screen:</p>
+ <dt><a href=
+ "https://invisible-island.net/ncurses/terminfo.src.html#toc-_Open_B_S_D_consoles">
+ <code>pccon</code> <em>entries</em></a></dt>
+ <dd>
<ul>
- <li>
- <p>propagate error-returns from wresize, i.e., the
- internal increase_size and decrease_size functions
- through <a href=
- "http://invisible-island.net/ncurses/man/resizeterm.3x.html">
- resize_term</a>.</p>
- </li>
+ <li>fixed some inconsistencies in the
+ <code><em>pccon*</em></code> entries</li>
- <li>
- <p>add check for zero/negative dimensions for
- <code>resizeterm</code> and <code>resize_term</code>.</p>
- </li>
+ <li>add bold to <code>pccon+sgr+acs</code> and
+ <code>pccon-base</code></li>
- <li>
- <p>modify <code>resizeterm</code> to always push a
- <code>KEY_RESIZE</code> onto the fifo, even if screensize
- is unchanged. Modify library to push a
- <code>KEY_RESIZE</code> if there was a SIGWINCH, even if
- it does not call <code>resizeterm</code>). These changes
- eliminate the case where a SIGWINCH is received, but ERR
- is returned from <code>wgetch</code> or
- <code>wgetnstr</code> because the screen dimensions did
- not change.</p>
- </li>
+ <li>add keys f12-f124 to <code>pccon+keys</code></li>
</ul>
- </li>
+ </dd>
- <li>
- <p>Low-level interfaces</p>
+ <dt><a href=
+ "https://invisible-island.net/ncurses/terminfo.src.html#toc-_Tmux">
+ <code>tmux</code></a></dt>
+ <dd>
<ul>
- <li>
- <p>fix an old bug in the termcap emulation;
- “<code>%i</code>” was ignored in
- <code>tparm</code> because the parameters to be
- incremented were already on the internal stack.</p>
- </li>
+ <li>corrected <em>sgr</em> string, which used
+ <code>screen</code>'s "standout" code rather than the
+ standard code.</li>
- <li>
- <p>change “<code>%l</code>” behavior in tparm
- to push the string length onto the stack rather than
- saving the formatted length into the output buffer.</p>
- </li>
+ <li>add settings corresponding to <code>xterm-keys</code>
+ option to reflect upcoming change to make that option
+ <em>"on"</em> by default</li>
- <li>
- <p>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 <a href=
- "http://invisible-island.net/ncurses/NEWS.html#t980725">980725</a>).</p>
- </li>
+ <li>uncanceled <em>Ms</em></li>
</ul>
- </li>
+ </dd>
- <li>High-level interfaces
+ <dt><a href=
+ "https://invisible-island.net/ncurses/terminfo.src.html#toc-_D_E_C__V_T100_and_compatibles">
+ <code>vt100</code></a></dt>
+ <dd>
<ul>
- <li>
- <p>modify internal recursion in <code>wgetch</code> which
- handles cooked mode to check if the call to
- <code>wgetnstr</code> returned an error. This can happen
- when both <code>nocbreak</code> and <code>nodelay</code>
- are set, for instance (see note for <a href=
- "http://invisible-island.net/ncurses/NEWS.html#t960418">960418</a>).</p>
- </li>
+ <li>modify <code>vt100</code> <em>rs2</em> string to reset
+ vt52 mode and scrolling regions</li>
- <li>
- <p>add a check in internal function
- <code>waddch_nosync</code> to ensure that tab characters
- are treated as control characters; some broken locales
- claim they are printable.</p>
- </li>
+ <li>corrected <em>rs2</em> string for
+ <code>vt100-nam</code></li>
- <li>
- <p>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</p>
- </li>
+ <li>made minor fixes for <code>vt100+4bsd</code>, e.g.,
+ delay in <em>sgr</em> for consistency</li>
+ </ul>
+ </dd>
- <li>
- <p>fix special case where double-width character
- overwrites a single- width character in the first
- column.</p>
- </li>
+ <dt><a href=
+ "https://invisible-island.net/ncurses/terminfo.src.html#toc-_G_N_O_M_E__V_T_E_">
+ <code>vte</code></a></dt>
+
+ <dd>
+ <ul>
+ <li>moved SGR 24 and 27 from <code>vte-2014</code> to
+ <code>vte-2012</code></li>
+
+ <li>add a few capabilities fixed in recent <em>VTE</em>
+ development</li>
</ul>
+ </dd>
+
+ <dt><a href=
+ "https://invisible-island.net/ncurses/terminfo.src.html#toc-_X_T_E_R_M">
+ <code>xterm</code></a></dt>
+
+ <dd>
+ <ul>
+ <li>add <em>rep</em> to <code>xterm-new</code>, available
+ since <a href=
+ "https://invisible-island.net/xterm/xterm.log.html#xterm_32">
+ late 1996</a>.</li>
+
+ <li>modify <code>xterm+256color</code> and
+ <code>xterm+256setaf</code> to use correct number of color
+ pairs.</li>
+
+ <li>modify <em>rs1</em> for <code>xterm-16color</code>,
+ <code>xterm-88color</code> and <code>xterm-256color</code>
+ to reset palette using <em>oc</em> string as in
+ <code>linux</code> entry.</li>
+
+ <li>add <em>rs1</em> capability to
+ <code>xterm-256color</code></li>
+
+ <li>add <em>oc</em> capability to
+ <code>xterm+256color</code>, allowing palette reset for
+ <span class="main-name">xterm</span></li>
+
+ <li>add <em>op</em> to <code>xterm+256setaf</code></li>
+
+ <li>modify <code>xterm-r5</code>, <code>xterm-r6</code> and
+ <code>xterm-xf86-v32</code> to use <code>xterm+kbs</code>
+ to match <a href=
+ "https://invisible-island.net/xterm/xterm.log.html#xterm_272">
+ xterm #272</a>, reflecting packager's changes</li>
+
+ <li>used ANSI reply for <em>u8</em> in
+ <code>xterm-new</code>, to reflect vt220-style responses
+ that could be returned.</li>
+
+ <li>made <code>xterm-pcolor</code> <em>sgr</em> consistent
+ with other capabilities</li>
+ </ul>
+ </dd>
+ </dl>
+
+ <p>A few entries use extensions (user-defined terminal
+ capabilities):</p>
+
+ <ul>
+ <li>add <em>rmxx</em>/<em>smxx</em> ECMA-48 strikeout extension
+ to <code>tmux</code> and <code>xterm-basic</code></li>
+
+ <li>used <em>RGB</em> capability in new <em>*-direct</em>
+ entries to denote direct-color feature.</li>
+ </ul>
+
+ <h3><a name="h3-documentation" id=
+ "h3-documentation">Documentation</a></h3>
+
+ <p>As usual, this release</p>
+
+ <ul>
+ <li>
+ <p>improves documentation by describing new features,</p>
+ </li>
+
+ <li>
+ <p>attempts to improve the description of features which
+ users have found confusing</p>
+ </li>
+
+ <li>
+ <p>fills in overlooked descriptions of features which were
+ described in the <a href=
+ "https://invisible-island.net/ncurses/NEWS.html">NEWS</a>
+ file but treated sketchily in manual pages.</p>
</li>
</ul>
- <h3><a name="h3-config-config" id=
- "h3-config-config">Configuration changes</a></h3>
+ <p>In particular,</p>
- <h4><a name="h4-config-major" id="h4-config-major">Major
- changes</a></h4>
+ <ul>
+ <li>
+ <p>Since the underlying features for <a href=
+ "https://invisible-island.net/ncurses/man/clear.1.html#h2-HISTORY">
+ <span class="part-name">tset</span></a>, <a href=
+ "https://invisible-island.net/ncurses/man/clear.1.html#h2-HISTORY">
+ <span class="part-name">tput</span></a>, and <a href=
+ "https://invisible-island.net/ncurses/man/clear.1.html#h2-HISTORY">
+ <span class="part-name">clear</span></a> have been better
+ integrated, the documentation now includes information on how
+ those tools evolved.</p>
- <p>The <em class="small-caps">ncurses</em> 6.0 configure script
- makes changes to the <em>default</em> value of several configure
- options, depending on the <code>--with-abi-version</code> option
- (i.e., whether its value is “5” or
- “6”):</p>
+ <p>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.</p>
+ </li>
- <dl>
- <dt><code>--enable-const</code></dt>
+ <li>
+ <p>The <code>addch</code> manual page has additional
+ information on <a href=
+ "https://invisible-island.net/ncurses/man/curs_addch.3x.html#h2-PORTABILITY">
+ portability</a> and differences from other
+ implementations.</p>
+ </li>
- <dd>
- <p>Feature introduced in <a href=
- "http://invisible-island.net/ncurses/NEWS.html#t970405">970405</a>
- supports the use of <code>const</code> where X/Open Curses
- should have, but did not. NetBSD curses does something
- similar with <code>const</code>.</p>
- </dd>
+ <li>
+ <p>The discussion of color-pairs in the <em>attributes</em>
+ manual page is improved in its <a href=
+ "https://invisible-island.net/ncurses/man/curs_attr.3x.html#h2-HISTORY">
+ history section</a>.</p>
+ </li>
- <dt><code>--enable-ext-colors</code></dt>
+ <li>
+ <p>The documentation of the <code>chtype</code>,
+ <code>cchar_t</code> types and the attribute values which can
+ be stored in those types, in particular the <a href=
+ "https://invisible-island.net/ncurses/man/curs_attr.3x.html#h2-HISTORY">
+ history</a> and <a href=
+ "https://invisible-island.net/ncurses/man/curs_attr.3x.html#h2-PORTABILITY">
+ portability</a> sections of the <em>attributes</em> manual
+ page, has been improved.</p>
+ </li>
- <dd>
- <p>Extends the <code>cchar_t</code> structure to allow more
- than 16 colors to be encoded. This applies only to the
- wide-character (<code>--enable-widec</code>)
- configuration.</p>
- </dd>
+ <li>
+ <p>improve discussion of <a href=
+ "https://invisible-island.net/ncurses/man/curs_mouse.3x.html#h2-PORTABILITY">
+ portability</a> in the <em>mouse</em> manual.</p>
+ </li>
- <dt><code>--enable-ext-mouse</code></dt>
+ <li>
+ <p>The <em>pad</em> manual page has a section on the <a href=
+ "https://invisible-island.net/ncurses/man/curs_pad.3x.html#h2-PORTABILITY">
+ origin and portability</a> of pads.</p>
+ </li>
- <dd>
- <p>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.</p>
- </dd>
+ <li>
+ <p>Differences between SVr4 and X/Open Curses soft-keys are
+ discussed in a new section on <a href=
+ "https://invisible-island.net/ncurses/man/curs_slk.3x.html#h2-PORTABILITY">
+ portability</a>.</p>
+ </li>
- <dt><code>--enable-ext-putwin</code></dt>
+ <li>
+ <p>There are updated/improved notes on portability in the
+ <a href=
+ "https://invisible-island.net/ncurses/man/resizeterm.3x.html#h2-PORTABILITY">
+ resizeterm</a> and <a href=
+ "https://invisible-island.net/ncurses/man/wresize.3x.html#h2-PORTABILITY">
+ wresize</a> manual pages.</p>
+ </li>
+ </ul>
- <dd>
- <p>Modifies the file-format written by <code>putwin</code> to
- use printable text rather than binary files, allowing
- <code>getwin</code> to read screen dumps written by
- differently-configured ncurses libraries. The extended
- <code>getwin</code> can still read binary screen dumps from
- the <em>same</em> configuration of ncurses. This does not
- change the ABI (the binary interface seen by calling
- applications).</p>
- </dd>
+ <p>In addition to providing background information to explain
+ these features and show how they evolved, there are corrections,
+ clarifications, etc.:</p>
- <dt><code>--enable-interop</code></dt>
+ <ul>
+ <li>
+ <p>add note in the <a href=
+ "https://invisible-island.net/ncurses/man/curs_addch.3x.html#h3-ACS-Symbols">
+ <em>addch</em></a> manual about line-drawing when it depends
+ upon UTF-8.</p>
+ </li>
- <dd>
- <p>Modifies the <code>FIELDTYPE</code> structure used for the
- form library to make it more generic.</p>
- </dd>
+ <li>
+ <p>improve discussion of line-drawing characters in the
+ <a href=
+ "https://invisible-island.net/ncurses/man/curs_add_wch.3x.html">
+ <em>add_wch</em></a> manual.</p>
+ </li>
- <dt><code>--enable-lp64</code></dt>
+ <li>
+ <p>explain in <a href=
+ "https://invisible-island.net/ncurses/man/clear.1.html#h2-DESCRIPTION">
+ <span class="part-name">clear</span></a>'s manual page that
+ it writes to the standard output.</p>
+ </li>
- <dd>
- <p>Allows an application to define <code>_LP64</code> to
- declare <code>chtype</code> and <code>mmask_t</code> as
- simply “<code>unsigned</code>” rather than the
- configured types using the <code>--with-chtype</code> and
- <code>--with-mmask_t</code> options.</p>
- </dd>
+ <li>
+ <p>improve description of <a href=
+ "https://invisible-island.net/ncurses/man/curs_initscr.3x.html#h3-endwin">
+ <em>endwin</em></a>.</p>
+ </li>
- <dt><code>--enable-sp-funcs</code></dt>
+ <li>
+ <p>improve discussion of field validation in the <a href=
+ "https://invisible-island.net/ncurses/man/form_driver.3x.html">
+ <em>form driver</em></a> manual page.</p>
+ </li>
- <dd>
- <p>Compile-in support for extended functions which accept a
- SCREEN pointer, reducing the need for juggling the global SP
- value with <a href=
- "http://invisible-island.net/ncurses/man/curs_initscr.3x.html#h3-set_term">
- set_term</a> and <a href=
- "http://invisible-island.net/ncurses/man/curs_initscr.3x.html#h3-delscreen">
- delscreen</a>.</p>
- </dd>
+ <li>
+ <p>clarify the use of <code>wint_t</code> vs
+ <code>wchar_t</code> in <a href=
+ "https://invisible-island.net/ncurses/man/curs_get_wstr.3x.html#h2-RETURN-VALUE">
+ <em>get_wstr</em></a> manual page.</p>
+ </li>
- <dt><code>--with-chtype=uint32_t</code></dt>
+ <li>
+ <p>clarify in the <a href=
+ "https://invisible-island.net/ncurses/man/curs_getch.3x.html#h3-Predefined-key-codes">
+ <em>getch</em></a> manual that the keypad mode affects an
+ application's ability to read <code>KEY_MOUSE</code> codes,
+ but does not affect <code>KEY_RESIZE</code>.</p>
- <dd>
- <p>Makes <code>chtype</code> explicitly a 32-bit unsigned
- value.</p>
- </dd>
+ <p>trim some obsolete/incorrect wording about
+ <code>EINTR</code> from the <em>getch</em> manual page</p>
- <dt><code>--with-mmask_t=uint32_t</code></dt>
+ <p>improve manual pages for <a href=
+ "https://invisible-island.net/ncurses/man/curs_getch.3x.html#h3-Keypad-Mode">
+ <em>getch</em></a> and <a href=
+ "https://invisible-island.net/ncurses/man/curs_get_wch.3x.html#h2-DESCRIPTION">
+ <em>get_wch</em></a> to point out that they might return
+ user-defined values which have no predefined names in
+ <code><curses.h></code></p>
+ </li>
- <dd>
- <p>Makes <code>mmask_t</code> explicitly a 32-bit unsigned
- value.</p>
- </dd>
+ <li>
+ <p>improve description of the <code>-R</code> option in the
+ <a href=
+ "https://invisible-island.net/ncurses/man/infocmp.1m.html"><span class="part-name">
+ infocmp</span></a> manual page</p>
+ </li>
- <dt><code>--with-tparm-arg=intptr_t</code></dt>
+ <li>
+ <p>clarify in the <a href=
+ "https://invisible-island.net/ncurses/man/resizeterm.3x.html#h2-NOTES">
+ <em>resizeterm</em></a> manual page how
+ <code>KEY_RESIZE</code> is pushed onto the input stream.</p>
+ </li>
- <dd>
- <p>X/Open Curses declares <a href=
- "http://invisible-island.net/ncurses/man/curs_terminfo.3x.html#h3-Formatting-Output">
- tparm</a> using <code>long</code> for each of the parameters
- aside from the formatting string, presuming that
- <code>long</code> and <code>char*</code> are the same size.
- This configure option uses <code>intptr_t</code> which
- provides a better guarantee of the sizes.</p>
- </dd>
- </dl>
+ <li>
+ <p>document return value of <a href=
+ "https://invisible-island.net/ncurses/man/curs_extend.3x#h2-RETURN-VALUE">
+ <code>use_extended_names</code></a></p>
+ </li>
- <p>The configure script no longer checks for antique compilers;
- <code>c89</code> 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 <em class=
- "small-caps">ncurses</em> 6.0 with any of the current (or not so
- current) C compilers available in 2015.</p>
-
- <p>The configure script, by the way, makes changes which do not
- work with systems whose <code>/bin/sh</code> is non-POSIX. This
- mainly affects Solaris (the other vendor <em class=
- "small-caps">unix</em> systems have followed the POSIX guidelines
- for the past twenty years). If you must build on Solaris, its
- <a href=
- "http://docs.oracle.com/cd/E19253-01/html/817-0552/fhkpy.html">xpg4</a>
- binaries suffice, e.g.,</p>
-
- <blockquote class="code-block">
- <!--{{atr2html-->
-
- <p style="font-family: monospace; font-size: 10pt;">
- <font color="#800000">#!/bin/sh</font><br>
- <font color="#008080">WHAT</font>=<strong><em><font color=
- "#800000">`</font></em></strong>hostname|sed -e <font color="#800080">'s/\..*//'</font><strong><em><font color="#800000">`</font></em></strong><br>
-
- <font color="#008080">OUT</font>=configure.out<br>
- <strong><font color=
- "#000080">cat</font></strong> >><font color=
- "#008080">$OUT</font> <font color=
- "#800080"><<EOF/</font><font color="#800080"><br>
- ** </font><strong><em><font color=
- "#800000">`</font></em></strong>date<strong><em><font color=
- "#800000">`</font></em></strong><font color="#800080"><br>
- ** node: </font><font color=
- "#008080">$WHAT</font><font color="#800080"><br>
- ** user: </font><strong><em><font color=
- "#800000">`</font></em></strong>id<strong><em><font color=
- "#800000">`</font></em></strong><font color="#800080"><br>
- ** conf: $*<br>
- EOF/</font><br>
- <br>
- <font color="#008080">SHELL</font>=/bin/sh<br>
- <strong><font color=
- "#000080">if</font></strong> <strong><font color=
- "#000080">test</font></strong> -f /usr/xpg4/bin/sh<br>
-
- <strong><font color="#000080">then</font></strong><br>
- <font color=
- "#008080">CONFIG_SHELL</font>=/usr/xpg4/bin/sh<br>
- <strong><font color="#000080">export</font></strong> CONFIG_SHELL<br>
-
- <font color=
- "#008080">SHELL</font>=<font color=
- "#008080">$CONFIG_SHELL</font><br>
- <strong><font color="#000080">fi</font></strong><br>
- <br>
- rm -f config.status config.cache<br>
- <font color="#008080">TOP</font>=<font color=
- "#008080">$HOME</font>/<font color="#008080">$WHAT</font><br>
- <font color=
- "#008080">$SHELL</font> ./configure --verbose \<br>
-
- --disable-echo \<br>
-
- --disable-overwrite \<br>
-
- --enable-warnings \<br>
-
- --with-warnings \<br>
-
- --prefix=<font color="#008080">$TOP</font> <font color="#008080">$*</font> <strong><font color="#008080">2</font></strong>>&<strong><font color="#008080">1</font></strong> | tee -a <font color="#008080">$OUT</font><br>
-
- <!--atr2html}}--></p>
- </blockquote>
+ <li>
+ <p>document differences in <a href=
+ "https://invisible-island.net/ncurses/man/curs_variables.3x.html#h2-PORTABILITY">
+ <code>ESCDELAY</code></a> versus AIX's implementation in the
+ <em>variables</em> manual page.</p>
+ </li>
- <p>Other major changes to the configure script include:</p>
+ <li>
+ <p>The <code>_nc_free_tinfo</code> function is now documented
+ in the <a href=
+ "https://invisible-island.net/ncurses/man/curs_memleaks.3x.html">
+ <em>memory-leaks</em></a> manual page, because it could be
+ used in <span class="main-name">tack</span> for memory-leak
+ checking.</p>
+ </li>
- <ul>
<li>
- <p>ABI 6 is now the default, intending that the existing ABI
- 5 should build as before using the
- “<code>--with-abi-version=5</code>” option.</p>
+ <p>add a note to the <a href=
+ "https://invisible-island.net/ncurses/man/tic.1m.html"><span class="part-name">
+ tic</span></a> manual page about -W versus -f options.</p>
</li>
<li>
- <p>added <code>--with-extra-suffix</code> option to help with
- installing nonconflicting ncurses6 packages, e.g., avoiding
- header- and library-conflicts.</p>
+ <p>improve <em>terminfo manual</em> description of <a href=
+ "https://invisible-island.net/ncurses/man/terminfo.5.html#h3-Terminfo-Capabilities-Syntax">
+ terminfo syntax</a>.</p>
- <p><strong>NOTE:</strong> as a side-effect, this renames</p>
+ <p>improve terminfo manual page discussion of <a href=
+ "https://invisible-island.net/ncurses/man/terminfo.5.html#h3-Line-Graphics">
+ control- and graphics- characters</a>.</p>
- <blockquote>
- <p><code>adacurses-config</code> to
- <code>adacurses5-config</code> and<br>
- <code>adacursesw-config</code> to
- <code>adacursesw5-config</code></p>
- </blockquote>
+ <p>improve <a href=
+ "https://invisible-island.net/ncurses/man/terminfo.5.html#h3-Color-Handling">
+ color-handling</a> section in terminfo manual page</p>
+ </li>
+
+ <li>
+ <p>clarify description in <a href=
+ "https://invisible-island.net/ncurses/man/tput.1.html#h2-PORTABILITY">
+ <span class="part-name">tput</span></a> manual page regarding
+ support for termcap names</p>
+
+ <p>update <a href=
+ "https://invisible-island.net/ncurses/man/tput.1.html#h3-Aliases">
+ <span class="part-name">tput</span></a> manual page to
+ reflect changes to manipulate terminal modes by sharing
+ functions with <span class="part-name">tset</span>.</p>
+ </li>
+
+ <li>
+ <p>clarify in manual pages that the optional verbose option
+ level of <a href=
+ "https://invisible-island.net/ncurses/man/tic.1m.html#h2-OPTIONS">
+ <span class="part-name">tic</span></a> and <a href=
+ "https://invisible-island.net/ncurses/man/infocmp.1m.html#h3-Other-Options">
+ <span class="part-name">infocmp</span></a> is available only
+ when <span class="main-name">ncurses</span> is configured for
+ tracing.</p>
</li>
<li>
- <p>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.</p>
+ <p>improve manual page description of <a href=
+ "https://invisible-island.net/ncurses/man/tset.1.html"><em>tset/reset</em></a>
+ versus window-size.</p>
</li>
<li>
- <p>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.</p>
+ <p>improve description of <a href=
+ "https://invisible-island.net/ncurses/man/curs_termcap.3x.html#h3-FORMATTING-CAPABILITIES">
+ <em>tgoto</em></a> parameters</p>
</li>
</ul>
- <h4><a name="h4-config-options" id=
- "h4-config-options">Configuration options</a></h4>
+ <p>There are new manual pages:</p>
- <p>There are several new (or extended) configure options:</p>
+ <ul>
+ <li><a href=
+ "https://invisible-island.net/ncurses/man/user_caps.5.html"><em>
+ user_caps</em></a> documents the terminfo extensions used by
+ <span class="main-name">ncurses</span>.</li>
- <dl>
- <dt><code>--disable-db-install</code></dt>
+ <li>
+ <p><a href=
+ "https://invisible-island.net/ncurses/man/scr_dump.5.html"><em>
+ scr_dump</em></a> documents the screen-dump format.</p>
+ </li>
+ </ul>
- <dd>
- <p>Do not install the terminal database. This is used to omit
- features for packages, as done with
- <code>--without-progs</code>. The option simplifies building
- cross-compile support packages.</p>
- </dd>
+ <p>Some of the improvements are more subtle, relating to the way
+ the information is presented:</p>
- <dt><code>--disable-gnat-projects</code></dt>
+ <ul>
+ <li>
+ <p>Made minor fixes to manpage <em>NAME/SYNOPSIS</em>
+ sections to consistently use rule that either all functions
+ which are prototyped in <em>SYNOPSIS</em> are listed in the
+ <em>NAME</em> section, or the manual-page name is the sole
+ item listed in the <em>NAME</em> 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 <a href=
+ "https://invisible-island.net/ncurses/man/curs_sp_funcs.3x.html">
+ <em>SP-funcs</em></a> and <a href=
+ "https://invisible-island.net/ncurses/man/curs_threads.3x.html">
+ <em>threading</em></a>.</p>
+ </li>
- <dd>
- <p>This option is used for regression testing</p>
- </dd>
+ <li>
+ <p>improve manual pages for utilities with respect to POSIX
+ versus X/Open Curses.</p>
+ </li>
- <dt><code>--disable-lib-suffixes</code></dt>
+ <li>
+ <p>improve organization of the <a href=
+ "https://invisible-island.net/ncurses/man/curs_attr.3x.html"><em>
+ attributes</em></a> and <a href=
+ "/ncurses/man/curs_color.3x.html"><em>color</em></a> manual
+ pages.</p>
+ </li>
+ </ul>
- <dd>
- <p>Suppress the “w”, “t” or
- “tw” suffixes which normally would be added to
- the library names for the <code>--enable-widec</code> and
- <code>--with-pthread</code> options.</p>
- </dd>
+ <h3><a name="h3-bug-fixes" id="h3-bug-fixes">Interesting
+ bug-fixes</a></h3>
- <dt><code>--with-cxx-shared</code></dt>
+ <ul>
+ <li>
+ <p>modify <span class="part-name">toe</span> to not exit if
+ unable to read a terminal description, e.g., if there is a
+ permission problem.</p>
+ </li>
- <dd>
- <p>When <code>--with-shared</code> 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.</p>
- </dd>
+ <li>
+ <p>correct 20100515 change for weak signals versus
+ sigprocmask</p>
+ </li>
- <dt><code>--with-hashed-db</code></dt>
+ <li>work around Ada tool-breakage in Debian 9 and later by
+ invoking <code>gprconfig</code> to specify the C compiler to be
+ used by <code>gnatmake</code>, and conditionally suppressing
+ <code>Library_Options</code> line for static libraries.</li>
- <dd>
- <p>Extended this configure option to simplify building with
- different versions of Berkeley database using FreeBSD
- ports.</p>
- </dd>
+ <li>
+ <p>There were, as well, several bug-fixes to handle illegal
+ input for <span class="part-name">tic</span>. Because those
+ did not correspond to useful terminal descriptions, most
+ users are unaffected.</p>
+ </li>
+ </ul>
- <dt><code>--with-pc-suffix</code></dt>
+ <h3><a name="h3-config-config" id=
+ "h3-config-config">Configuration changes</a></h3>
- <dd>
- <p>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.</p>
- </dd>
+ <h4><a name="h4-config-major" id="h4-config-major">Major
+ changes</a></h4>
- <dt><code>--with-xterm-kbs</code></dt>
+ <p>This release provides a new binary format for terminal
+ descriptions that use extended numeric capabilities. Applications
+ built with the wide-character <em>ncursesw</em> library can use
+ these extended numbers.</p>
- <dd>
- <p>Configure xterm's terminfo entries to use either BS
- (<code>^H</code>, i.e., ASCII backspace) or DEL
- (<code>^?</code>, or 127).</p>
- </dd>
- </dl>
+ <ul>
+ <li>
+ <p>This includes utilities such as <span class=
+ "part-name">tic</span> and <span class=
+ "part-name">infocmp</span>, because (as noted in <a href=
+ "#h4-new-library"><em>New features</em></a>), the feature
+ relies upon an extension to the low-level <em>tinfo</em>
+ library.</p>
+ </li>
- <h3><a name="h3-portability" id=
- "h3-portability">Portability</a></h3>
+ <li>
+ <p>A few software packagers use a configuration option of
+ <span class="main-name">ncurses</span> which allows the
+ low-level <em>tinfo</em> library to be shared between the
+ high-level <em>ncurses</em> and <em>ncursesw</em> libraries.
+ This new feature was designed to work in that configuration
+ as well.</p>
+ </li>
+ </ul>
+
+ <p>Other applications (i.e., using the 8-bit <em>ncurses</em>
+ library) which read the extended terminal descriptions see those
+ numeric capabilities set to the maximum value for a signed 16-bit
+ number.</p>
- <h4><a name="h4-port-mingw" id="h4-port-mingw">MinGW</a></h4>
+ <p>Older versions of <span class="main-name">ncurses</span>'
+ <span class="part-name">tic</span> 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 <a href=
+ "https://invisible-island.net/ncurses/ncurses-slang.html#compare_picsmap">
+ <span class="part-name">picsmap</span></a>) give zero for these
+ out-of-range capabilities.</p>
- <p>Most of the portability-related work since <a href=
- "http://invisible-island.net/ncurses/announce-5.9.html"><em class="small-caps">
- ncurses</em> 5.9</a> extended and improved the MinGW port
- introduced in <a href=
- "http://invisible-island.net/ncurses/announce-5.8.html"><em class="small-caps">
- ncurses</em> 5.8</a>.</p>
+ <h4><a name="h4-config-options" id=
+ "h4-config-options">Configuration options</a></h4>
- <p>The MinGW port can be readily cross-compiled:</p>
+ <p>These changes provide support for <span class=
+ "main-name">tack</span> 1.08, released in <a href=
+ "https://invisible-island.net/ncurses/tack/CHANGES.html#index-t20170726">
+ July 2017</a>:</p>
<ul>
<li>
- <p>modified configure script to allow creating dll's for
- MinGW when cross-compiling.</p>
+ <p>add <code>--without-tack</code> configure option to refine
+ <code>--with-progs</code> configure option. Normally
+ <span class="main-name">tack</span> is built outside the
+ <span class="main-name">ncurses</span> tree, but a few
+ packagers combine it during the build. If
+ <code>term_entry.h</code> is installed, there is no advantage
+ to in-tree builds.</p>
</li>
<li>
- <p>enforced Windows-style path-separator if
- cross-compiling,</p>
+ <p>adjust configure-script to define
+ <code>HAVE_CURSES_DATA_BOOLNAMES</code> symbol needed for
+ <span class="main-name">tack</span> 1.08 when built in-tree.
+ Rather than relying upon internal "_nc_" functions,
+ <span class="main-name">tack</span> now uses the boolean,
+ number and string capability name-arrays provided by
+ <span class="main-name">ncurses</span> and SVr4 Unix curses.
+ It still uses <code>term_entry.h</code> for the definitions
+ of the extended capability arrays.</p>
</li>
<li>
- <p>added scripts for test-builds of cross-compiled packages
- for ncurses6 to MinGW.</p>
+ <p>add dependency upon ncurses_cfg.h to <span class=
+ "part-name">tic</span>'s header-files; any program using
+ <span class="part-name">tic</span>-library will have to
+ supply this file. Legacy <span class="main-name">tack</span>
+ versions supply this file; ongoing <span class=
+ "main-name">tack</span> development has dropped the
+ dependency upon <span class="part-name">tic</span>-library
+ and new releases will not be affected.</p>
</li>
+ </ul>
+
+ <p>Other changes to the configure-script and generated files
+ include</p>
+ <ul>
<li>
- <p>added pc-files to the MinGW cross-compiling
- test-packages.</p>
+ <p>add configure options to disable checks for form, menu and
+ panel libraries so that ncurses-examples can be built with
+ non-SVr4 curses implementations.</p>
</li>
<li>
- <p>added script for building test-packages of binaries
- cross-compiled to MinGW using NSIS.</p>
+ <p>add configure option <code>--enable-opaque-curses</code>
+ for <em>ncurses</em> library and similar options for the
+ other libraries.</p>
</li>
<li>
- <p>added <code>nc_mingw.h</code> to installed headers for
- MinGW port; this is needed for cross-compiling <a href=
- "http://invisible-island.net/ncurses/ncurses-examples.html">ncurses-examples</a>.</p>
+ <p>add configure option <code>--disable-wattr-macros</code>
+ for use in cases where one wants to use the same headers for
+ ncurses5/ncurses6 development, by suppressing the
+ <em>wattr*</em> macros which differ due to the introduction
+ of extended colors</p>
</li>
<li>
- <p>added test-packages for cross-compiling ncurses-examples
- using the MinGW test-packages.</p>
+ <p>modify configure macro for shared-library rules to use
+ <code>-Wl,-rpath</code> rather than <code>-rpath</code> to
+ work around a bug in <span class="part-name">scons</span></p>
</li>
- </ul>
- <p>The MinGW-specific Windows driver accounts for several
- changes:</p>
-
- <ul>
<li>
- <p>wide-character display is made usable by replacing MinGW's
- non-working <code>wcrtomb</code> and <code>wctomb</code>
- functions.</p>
+ <p>improve ncurses-examples' configure script to define as
+ needed <code>NCURSES_WIDECHAR</code> for platforms where
+ <code>_XOPEN_SOURCE_EXTENDED</code> does not work. Also
+ modified the test program to ensure that if building with
+ <span class="main-name">ncurses</span>, that the
+ <code>cchar_t</code> type is checked, since that is normally
+ (since <a href=
+ "https://invisible-island.net/ncurses/NEWS.html#t20111030">20111030</a>)
+ ifdef'd depending on this test.</p>
</li>
<li>
- <p>implemented some display features: <a href=
- "http://invisible-island.net/ncurses/man/curs_beep.3x.html">beep</a>,
- <a href=
- "http://invisible-island.net/ncurses/man/curs_beep.3x.html">flash</a>,
- <a href=
- "http://invisible-island.net/ncurses/man/curs_kernel.3x.html#h3-curs_set">
- curs_set</a>.</p>
+ <p>modify configure script to handle the case where
+ <span class="part-name">tic</span>-library is renamed, but
+ the <code>--with-debug</code> option is used by itself
+ without normal or shared libraries</p>
</li>
<li>
- <p>the driver handles repainting on endwin/refresh
- combination.</p>
+ <p>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.</p>
</li>
<li>
- <p>modified treatment of <code>TERM</code> variable for MinGW
- port to allow explicit use of the Windows console driver by
- checking if <code>$TERM</code> is set to
- “<code>#win32console</code>” or an abbreviation
- of that.</p>
+ <p>improve configure check for setting the
+ <code>WILDCARD_SYMS</code> variable; on ppc64 the variable is
+ in the <strong><em>Data</em></strong> section rather than
+ <strong><em>Text</em></strong>.</p>
</li>
<li>
- <p>the Windows driver also matches the special
- <code>TERM</code> value “unknown”</p>
+ <p>correct result of configure option
+ <code>--without-fallbacks</code>, which caused FALLBACK_LIST
+ to be set to "no"</p>
</li>
<li>
- <p>the driver now returns characters for special keys, (like
- <code>ansi.sys</code> does), when keypad mode is off, rather
- than returning nothing at all.</p>
+ <p>modify <code>--with-pkg-config-libdir</code> option to
+ make it possible to install “.pc” files even if
+ <span class="part-name">pkg-config</span> is not found. Limit
+ this change, to suppress the actual install if it is not
+ overridden to a valid directory at install time.</p>
</li>
<li>
- <p>the driver checks a new environment variable <a href=
- "http://invisible-island.net/ncurses/man/ncurses.3x.html#h3-NCURSES_CONSOLE2">
- NCURSES_CONSOLE2</a> to optionally work around a deficiency
- in <code>Console2</code> (and its descendent
- <code>ConsoleZ</code>) which hang when an application creates
- a console buffer.</p>
+ <p>disallow “no” as a possible value for
+ <code>--with-shlib-version</code> option, overlooked in
+ cleanup-changes for <a href=
+ "https://invisible-island.net/ncurses/NEWS.html#t20000708">20000708</a>.</p>
</li>
</ul>
- <p>Finally, there are other improvements:</p>
+ <h3><a name="h3-portability" id=
+ "h3-portability">Portability</a></h3>
+
+ <p>Many of the portability changes are implemented via the
+ configure script:</p>
<ul>
<li>
- <p>MinGW is one of the configurations where <em class=
- "small-caps">ncurses</em> installs by default into /usr</p>
+ <p>improve configure script's <code>CF_CC_ENV_FLAGS</code>
+ macro to allow for compiler wrappers such as <span class=
+ "part-name">ccache</span>. This change moves only the
+ preprocessor, optimization and warning flags to
+ <code>CPPFLAGS</code> and <code>CFLAGS</code>, leaving the
+ residue in <code>CC</code>. That happens to work for
+ <span class="part-name">gcc</span>'s various
+ “model” options, but may require tuning for other
+ compilers.</p>
</li>
- <li>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.</li>
-
<li>
- <p>extend Windows support to work with MSYS2;</p>
-
- <ul>
- <li>
- <p>this works with a scenario where there is an
- ANSI-escape handler such as <code>ansicon</code> running
- in the console window.</p>
- </li>
-
- <li>wrap <code>isatty</code> calls with a macro, provide a
- corresponding set of support routines to address
- differences between MinGW and MSYS2.</li>
- </ul>
+ <p>modify ncurses-examples' configure script to use
+ <span class="part-name">pkg-config</span> for the extra
+ form/menu/panel libraries, to be more consistent with the
+ handling of the curses/ncurses library.</p>
</li>
<li>
- <p>ensure <code>WINVER</code> is defined in makefiles rather
- than using headers.</p>
+ <p>add configuration checks to build with <a href=
+ "https://invisible-island.net/ncurses/ncurses-netbsd.html">NetBSD
+ curses</a>, which for example lacks <a href=
+ "https://invisible-island.net/ncurses/man/curs_util.3x.html#h3-use_env">
+ <code>use_env</code></a>.</p>
</li>
<li>
- <p>add check for the <code>gnatprep</code>
- “<code>-T</code>” option.</p>
+ <p>change ncurses-examples to use <code>attr_t</code> vs
+ <code>chtype</code> to follow X/Open documentation more
+ closely since Solaris xpg4-curses uses different values for
+ <code>WA_<em>xxx</em></code> vs <code>A_<em>xxx</em></code>
+ that rely on attr_t being an unsigned short. Tru64 aka OSF1,
+ HPUX, AIX did as <span class="main-name">ncurses</span> does,
+ equating the two sets.</p>
</li>
<li>
- <p>work around a bug introduced by <a href=
- "http://stackoverflow.com/questions/20877689/gcc-4-8-1-minggw-d-option-does-not-work-as-usual">
- gcc 4.8.1</a> in MinGW which breaks "trace" feature.</p>
+ <p>modify several test programs to reflect that <span class=
+ "main-name">ncurses</span> honors existing signal handlers in
+ initscr, while other implementations do not.</p>
</li>
<li>
- <p>add a driver-name method to each of the drivers.</p>
+ <p>add configure check for <code>openpty</code> to
+ ncurses-examples' configure script, for <span class=
+ "part-name">ditto</span>.</p>
</li>
- </ul>
-
- <h4><a name="h4-port-systems" id="h4-port-systems">Other
- ports</a></h4>
- <p>These changes affect certain platforms (ports):</p>
+ <li>
+ <p>improve check for working <code>poll</code> function by
+ using <code>posix_openpt</code> as a fallback in case there
+ is no valid terminal on the standard input</p>
+ </li>
- <ul>
<li>
- <p>the configure script knows how to build shared libraries
- with DragonFlyBSD and Interix.</p>
+ <p>modify ncurses-examples' configure script to check for
+ <span class="part-name">pthread</span> dependency of
+ <em>ncursest</em> or <em>ncursestw</em> library when building
+ the <span class="main-name">ncurses</span> examples, e.g., in
+ case weak symbols are used.</p>
</li>
<li>
- <p>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:</p>
+ <p>add checks in ncurses-examples' configure script for some
+ functions neither in 4.3BSD curses, nor based on X/Open
+ Curses:</p>
<ul>
<li>
- <p>the shared-library suffix for AIX 5 and 6 is now
- ".so"</p>
+ <p>modify a loop limit in firework.c to work around
+ absense of limit checks in some libraries.</p>
</li>
<li>
- <p>the <code>-brtl</code> option is used with AIX 5-7; it
- is needed to link with the shared libraries.</p>
+ <p>fill the last row of a window with
+ “<code>?</code>” in firstlast if waddch does
+ not return <code>ERR</code> on the lower-right
+ corner.</p>
</li>
</ul>
</li>
<li>
- <p>the configure <code>--enable-pc-files</code> option takes
- into account the <a href=
- "http://linux.die.net/man/1/pkg-config"><code>PKG_CONFIG_PATH</code></a>
- variable.</p>
- </li>
+ <p>build-fixes for the Portland Group (PGI) compilers</p>
- <li>
- <p>the configure option <code>--with-pkg-config-libdir</code>
- provides control over the actual directory into which
- pc-files are installed.</p>
- </li>
+ <ul>
+ <li>
+ <p>accept whitespace in <span class=
+ "part-name">sed</span> expression for generating
+ expanded.c</p>
+ </li>
- <li>
- <p>the build scripts add explicit -ltinfo, etc., to the
- generated ".pc" file when <code>ld</code> option
- “<code>--as-needed</code>” is used, or when
- ncurses and tinfo are installed without using rpath.</p>
+ <li>
+ <p>modify configure check that g++ compiler warnings are
+ not used.</p>
+ </li>
+
+ <li>
+ <p>add configure check for -fPIC option needed for shared
+ libraries.</p>
+ </li>
+ </ul>
</li>
<li>
- <p>the configure script disallows conflicting options
- “<code>--with-termlib</code>” and
- “<code>--enable-term-driver</code>”.</p>
+ <p>modify configure script for clang as used on FreeBSD, to
+ work around clang's differences in exit codes vs gcc.</p>
</li>
<li>
- <p>the check for missing c++ compiler to work when no error
- is reported, and no variables set is improved (see note for
- <a href=
- "http://invisible-island.net/ncurses/NEWS.html#t20021206">20021206</a>).</p>
+ <p>fixes for configure/build using clang on OSX</p>
+
+ <ul>
+ <li>
+ <p>do not redefine “inline” in
+ <code>ncurses_cfg.h</code>; this was originally to solve
+ a problem with gcc/g++, but is aggravated by clang's
+ misuse of symbols to pretend it is gcc.</p>
+ </li>
+
+ <li>
+ <p>add braces to configure script to prevent unwanted
+ addition of “<code>-lstdc++</code>” option to
+ the <code>CXXLIBS</code> symbol.</p>
+ </li>
+
+ <li>
+ <p>improve/update test-program used for checking
+ existence of stdc++ library.</p>
+ </li>
+
+ <li>
+ <p>if <code>$CXXLIBS</code> is set, the linkage test uses
+ that in addition to <code>$LIBS</code>.</p>
+ </li>
+ </ul>
</li>
<li>
- <p>the misc/gen_edit.sh script selects a "linux" entry which
- works with the current kernel rather than assuming it is
- always "linux3.0"</p>
+ <p>fixes for OS/2:</p>
+
+ <ul>
+ <li>
+ <p>use button instead of <code>kbuf[0]</code> in
+ EMX-specific part of <code>lib_mouse.c</code></p>
+ </li>
+
+ <li>
+ <p>support building with <span class=
+ "part-name">libtool</span> on OS/2</p>
+ </li>
+
+ <li>
+ <p>use stdc++ library with OS/2 kLIBC</p>
+ </li>
+
+ <li>
+ <p>clear configure script's <code>cf_XOPEN_SOURCE</code>
+ for OS/2, to work with its header files</p>
+ </li>
+ </ul>
</li>
<li>
- <p>the test/configure script makes it simpler to override
- names of curses-related libraries, to help with linking with
- pdcurses in MinGW environment.</p>
+ <p>add “newer” baudrate symbols to the <a href=
+ "https://invisible-island.net/ncurses/man/curs_termattrs.3x.html#h3-baudrate">
+ <code>baudrate</code></a> function in the ncurses library as
+ well as to a corresponding table in <span class=
+ "part-name">tset</span>.</p>
</li>
<li>
- <p>the configure-script/ifdef's allow the BSD OLD_TTY feature
- to be suppressed if the type of <code>ospeed</code> is
- configured using the option <code>--with-ospeed</code> to not
- be a <code>short</code>. By default, it is a
- <code>short</code> for termcap-compatibility.</p>
+ <p>modify ncurses-examples <span class=
+ "part-name">savescreen</span> to work with AIX and HPUX.</p>
</li>
<li>
- <p>the MKlib_gen.sh script works around a recent change in
- gcc 5 (released <a href=
- "https://gcc.gnu.org/gcc-5/">mid-2015</a>) which essentially
- emits multiple <code>#line</code> statements for the same
- position in a file.</p>
+ <p>define <code>WIN32_LEAN_AND_MEAN</code> for MinGW port,
+ making builds faster.</p>
</li>
<li>
- <p>the configure script works with Minix3.2 (see <a href=
- "http://invisible-island.net/autoconf/portability-test.html">note</a>
- on portability)</p>
+ <p>add a configure check for <em>wcwidth</em> versus the
+ <span class="main-name">ncurses</span> 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.</p>
</li>
<li>
- <p>OS/2 redux:</p>
+ <p>string-hacks (non-standard):</p>
<ul>
<li>
- <p>the configure script supports OS/2 kLIBC.</p>
+ <p>fix configure script to record when
+ <code>strlcat</code> is found on OpenBSD.</p>
+ </li>
+
+ <li>
+ <p>add <code>--enable-string-hacks</code> option to
+ ncurses-examples' configure script.</p>
</li>
<li>
- <p>the <code>--with-lib-prefix</code> option allows
- configuring for old/new flavors of OS/2 EMX.</p>
+ <p>completed string-hacks for <em>sprintf</em>, etc.,
+ including the ncurses-examples programs.</p>
+ </li>
+
+ <li>
+ <p>make <code>--enable-string-hacks</code> option work
+ with Debian by checking for the "bsd" library and its
+ associated "<bsd/string.h>" header.</p>
</li>
</ul>
</li>
<li>
- <p>improved configure-script checks for
- <code>_XOPEN_SOURCE</code>:</p>
+ <p>workaround for Debian's antique/unmaintained version of
+ mawk:</p>
<ul>
<li>
- <p>the definition works starting with Solaris 10.</p>
+ <p>see Debian #65617, which was fixed in <span class=
+ "main-name">mawk</span>'s upstream releases in <a href=
+ "https://invisible-island.net/mawk/CHANGES.html#t20090727">
+ 2009</a>.</p>
</li>
<li>
- <p>the definition is suppressed for IRIX64, since its
- header files have a conflict versus
- <code>_SGI_SOURCE</code>.</p>
+ <p>related fixes when building link_test.</p>
</li>
</ul>
</li>
</ul>
<hr>
- <h2><a name="h2-features" id="h2-features">Features of <em class=
- "small-caps">ncurses</em></a></h2>
+ <h2><a name="h2-features" id="h2-features">Features of
+ <span class="main-name">ncurses</span></a></h2>
- <p>The <em class="small-caps">ncurses</em> package is fully
+ <p>The <span class="main-name">ncurses</span> package is fully
upward-compatible with SVr4 (System V Release 4) curses:</p>
<ul>
</li>
<li>
- <p><em class="small-caps">ncurses</em> supports all of the
+ <p><span class="main-name">ncurses</span> 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.</p>
</li>
<li>
- <p><em class="small-caps">ncurses</em> provides these SVr4
+ <p><span class="main-name">ncurses</span> provides these SVr4
add-on libraries (not part of X/Open Curses):</p>
<ul>
</li>
<li>
- <p><em class="small-caps">ncurses</em>'s terminal database is
- fully compatible with that used by SVr4 curses.</p>
+ <p><span class="main-name">ncurses</span>'s terminal database
+ is fully compatible with that used by SVr4 curses.</p>
<ul>
- <li><em class="small-caps">ncurses</em> supports
- user-defined capabilities which it can see, but which are
- hidden from SVr4 curses applications using the
- <em>same</em> terminal database.</li>
+ <li>
+ <p><span class="main-name">ncurses</span> supports
+ user-defined capabilities which it can see, but which are
+ hidden from SVr4 curses applications using the
+ <em>same</em> terminal database.</p>
+ </li>
<li>
<p>It can be optionally configured to match the format
</li>
<li>
- <p>Alternatively, <em class="small-caps">ncurses</em> can
- be configured to use hashed databases rather than the
+ <p>Alternatively, <span class="main-name">ncurses</span>
+ can be configured to use hashed databases rather than the
directory of files used by SVr4 curses.</p>
</li>
</ul>
</li>
<li>
- <p>The <em class="small-caps">ncurses</em> utilities have
+ <p>The <span class="main-name">ncurses</span> utilities have
options to allow you to filter terminfo entries for use with
less capable <em>curses</em>/<em>terminfo</em> versions such
as the HP/UX and AIX ports.</p>
</li>
</ul>
- <p>The <em class="small-caps">ncurses</em> package also has many
- useful extensions over SVr4:</p>
+ <p>The <span class="main-name">ncurses</span> package also has
+ many useful extensions over SVr4:</p>
<ul>
<li>
</li>
<li>
- <p>Unlike SVr3 curses, <em class="small-caps">ncurses</em>
+ <p>Unlike SVr3 curses, <span class="main-name">ncurses</span>
can write to the rightmost-bottommost corner of the screen if
your terminal has an insert-character capability.</p>
</li>
<li>
<p>The functions <code>keyok</code> and
<code>define_key</code> allow you to better control the use
- of function keys, e.g., disabling the <em class=
- "small-caps">ncurses</em> KEY_MOUSE, or by defining more than
- one control sequence to map to a given key code.</p>
+ of function keys, e.g., disabling the <span class=
+ "main-name">ncurses</span> KEY_MOUSE, or by defining more
+ than one control sequence to map to a given key code.</p>
</li>
<li>
<li>
<p>The <a href=
- "http://invisible-island.net/ncurses/man/tic.1m.html">tic</a>/<a href="http://invisible-island.net/ncurses/man/captoinfo.1m.html">captoinfo</a>
- utility provided with <em class="small-caps">ncurses</em> has
- the ability to translate many termcaps from the XENIX, IBM
- and AT&T extension sets.</p>
+ "https://invisible-island.net/ncurses/man/tic.1m.html"><span class="part-name">
+ tic</span></a>/<a href=
+ "https://invisible-island.net/ncurses/man/captoinfo.1m.html">captoinfo</a>
+ utility provided with <span class="main-name">ncurses</span>
+ has the ability to translate many termcaps from the XENIX,
+ IBM and AT&T extension sets.</p>
</li>
<li>
<p>A BSD-like <a href=
- "http://invisible-island.net/ncurses/man/tset.1.html">tset</a>
- utility is provided.</p>
+ "https://invisible-island.net/ncurses/man/tset.1.html"><span class="part-name">
+ tset</span></a> utility is provided.</p>
</li>
<li>
- <p>The <em class="small-caps">ncurses</em> library and
+ <p>The <span class="main-name">ncurses</span> 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
<li>
<p>The table-of-entries utility <a href=
- "http://invisible-island.net/ncurses/man/toe.1m.html">toe</a>
- makes it easy for users to see exactly what terminal types
- are available on the system.</p>
+ "https://invisible-island.net/ncurses/man/toe.1m.html"><span class="part-name">
+ toe</span></a> makes it easy for users to see exactly what
+ terminal types are available on the system.</p>
</li>
<li>
<li>
<p>Extensive documentation is provided (see the <em><a href=
- "http://invisible-island.net/ncurses/ncurses.faq.html#additional_reading">
+ "https://invisible-island.net/ncurses/ncurses.faq.html#additional_reading">
Additional Reading</a></em> section of the <em><a href=
- "http://invisible-island.net/ncurses/ncurses.faq.html"><em class="small-caps">
- ncurses</em> FAQ</a></em> for online documentation).</p>
+ "https://invisible-island.net/ncurses/ncurses.faq.html"><span class="main-name">
+ ncurses</span> FAQ</a></em> for online documentation).</p>
</li>
</ul>
<h2><a name="h2-who-uses" id="h2-who-uses">Applications using
- <em class="small-caps">ncurses</em></a></h2>
+ <span class="main-name">ncurses</span></a></h2>
- <p>The <em class="small-caps">ncurses</em> distribution includes
- a selection of test programs (including a few games). These are
- available separately as <a href=
- "http://invisible-island.net/ncurses/ncurses-examples.html">ncurses-examples</a></p>
+ <p>The <span class="main-name">ncurses</span> distribution
+ includes a selection of test programs (including a few games).
+ These are available separately as <a href=
+ "https://invisible-island.net/ncurses/ncurses-examples.html">ncurses-examples</a></p>
<p>The ncurses library has been tested with a wide variety of
applications including:</p>
<blockquote>
<dl>
- <dt>cdk</dt>
+ <dt><span class="part-name">aptitude</span></dt>
+
+ <dd>
+ <p>FrontEnd to Apt, the debian package manager</p>
+
+ <p><a href=
+ "https://wiki.debian.org/Aptitude">https://wiki.debian.org/Aptitude</a></p>
+ </dd>
+
+ <dt><span class="part-name">cdk</span></dt>
<dd>
<p>Curses Development Kit</p>
<p><a href=
- "http://invisible-island.net/cdk/">http://invisible-island.net/cdk/</a><br>
+ "https://invisible-island.net/cdk/">https://invisible-island.net/cdk/</a><br>
</p>
</dd>
- <dt>ded</dt>
+ <dt><span class="part-name">ded</span></dt>
<dd>
<p>directory-editor</p>
<p><a href=
- "http://invisible-island.net/ded/">http://invisible-island.net/ded/</a></p>
+ "https://invisible-island.net/ded/">https://invisible-island.net/ded/</a></p>
</dd>
- <dt>dialog</dt>
+ <dt><span class="part-name">dialog</span></dt>
<dd>
<p>the underlying application used in Slackware's setup,
many systems.</p>
<p><a href=
- "http://invisible-island.net/dialog/">http://invisible-island.net/dialog/</a></p>
+ "https://invisible-island.net/dialog/">https://invisible-island.net/dialog/</a></p>
</dd>
- <dt>lynx</dt>
+ <dt><span class="part-name">lynx</span></dt>
<dd>
<p>the text WWW browser</p>
<p><a href=
- "http://lynx.isc.org/">http://lynx.isc.org/</a></p>
+ "https://lynx.invisible-island.net/">https://lynx.invisible-island.net/</a></p>
</dd>
- <dt>Midnight Commander</dt>
+ <dt><span class="part-name">mutt</span></dt>
<dd>
- <p>file manager</p>
+ <p>mail utility</p>
<p><a href=
- "http://www.midnight-commander.org/">http://www.midnight-commander.org/</a></p>
+ "http://www.mutt.org/">http://www.mutt.org/</a></p>
</dd>
- <dt>mutt</dt>
+ <dt><span class="part-name">ncftp</span></dt>
<dd>
- <p>mail utility</p>
+ <p>file-transfer utility</p>
<p><a href=
- "http://www.mutt.org/">http://www.mutt.org/</a></p>
+ "https://www.ncftp.com/">https://www.ncftp.com/</a></p>
</dd>
- <dt>ncftp</dt>
+ <dt><span class="part-name">nvi</span></dt>
<dd>
- <p>file-transfer utility</p>
+ <p>New vi uses ncurses.</p>
<p><a href=
- "http://www.ncftp.com/">http://www.ncftp.com/</a></p>
+ "https://sites.google.com/a/bostic.com/keithbostic/vi">https://sites.google.com/a/bostic.com/keithbostic/vi</a><br>
+ </p>
</dd>
- <dt>nvi</dt>
+ <dt><span class="part-name">ranger</span></dt>
<dd>
- <p>New vi uses ncurses.</p>
+ <p>A console file manager with VI key bindings in
+ <em>Python</em>.</p>
<p><a href=
- "https://sites.google.com/a/bostic.com/keithbostic/nvi">https://sites.google.com/a/bostic.com/keithbostic/nvi</a><br>
- </p>
+ "https://ranger.github.io/">https://ranger.github.io/</a></p>
</dd>
- <dt>tin</dt>
+ <dt><span class="part-name">tin</span></dt>
<dd>
<p>newsreader, supporting color, MIME</p>
<p><a href=
"http://www.tin.org/">http://www.tin.org/</a></p>
</dd>
+
+ <dt><span class="part-name">vifm</span></dt>
+
+ <dd>
+ <p>File manager with vi like keybindings</p>
+
+ <p><a href="https://vifm.info/">https://vifm.info/</a></p>
+ </dd>
</dl>
</blockquote>
- <p>as well as some that use <em class="small-caps">ncurses</em>
- for the terminfo support alone:</p>
+ <p>as well as some that use <span class=
+ "main-name">ncurses</span> for the terminfo support alone:</p>
<blockquote>
<dl>
- <dt>minicom</dt>
+ <dt><span class="part-name">minicom</span></dt>
<dd>
<p>terminal emulator for serial modem connections</p>
<p><a href=
- "http://alioth.debian.org/projects/minicom/">http://alioth.debian.org/projects/minicom/</a></p>
+ "https://alioth.debian.org/projects/minicom/">https://alioth.debian.org/projects/minicom/</a></p>
</dd>
- <dt>mosh</dt>
+ <dt><span class="part-name">mosh</span></dt>
<dd>
<p>a replacement for <code>ssh</code>.</p>
"https://mosh.mit.edu/">https://mosh.mit.edu/</a></p>
</dd>
- <dt>tack</dt>
+ <dt><span class="part-name">tack</span></dt>
<dd>
<p>terminfo action checker</p>
<p><a href=
- "http://invisible-island.net/ncurses/tack.html">http://invisible-island.net/ncurses/tack.html</a></p>
+ "https://invisible-island.net/ncurses/tack.html">https://invisible-island.net/ncurses/tack.html</a></p>
</dd>
- <dt>tmux</dt>
+ <dt><span class="part-name">tmux</span></dt>
<dd>
<p>terminal multiplexor</p>
<p><a href=
- "http://tmux.github.io/">http://tmux.github.io/</a></p>
+ "https://github.com/tmux/tmux/wiki">https://github.com/tmux/tmux/wiki</a></p>
</dd>
- <dt>vile</dt>
+ <dt><span class="part-name">vile</span></dt>
<dd>
<p>vi-like-emacs may be built to use the terminfo, termcap
or curses interfaces.</p>
<p><a href=
- "http://invisible-island.net/vile/">http://invisible-island.net/vile/</a></p>
+ "https://invisible-island.net/vile/">https://invisible-island.net/vile/</a></p>
</dd>
</dl>
</blockquote>
<blockquote>
<dl>
- <dt>emacs</dt>
+ <dt><span class="part-name">emacs</span></dt>
<dd>
<p>text editor</p>
<p><a href=
- "http://www.gnu.org/software/emacs/">http://www.gnu.org/software/emacs/</a></p>
+ "https://www.gnu.org/software/emacs/">https://www.gnu.org/software/emacs/</a></p>
+ </dd>
+
+ <dt><span class="part-name">less</span></dt>
+
+ <dd>
+ <p>The most commonly used <em>pager</em> (a program that
+ displays text files).</p>
+
+ <p><a href=
+ "http://www.greenwoodsoftware.com/less/">http://www.greenwoodsoftware.com/less/</a></p>
</dd>
- <dt>screen</dt>
+ <dt><span class="part-name">screen</span></dt>
<dd>
<p>terminal multiplexor</p>
<p><a href=
- "http://www.gnu.org/software/screen/">http://www.gnu.org/software/screen/</a></p>
+ "https://www.gnu.org/software/screen/">https://www.gnu.org/software/screen/</a></p>
</dd>
- <dt>vim</dt>
+ <dt><span class="part-name">vim</span></dt>
<dd>
<p>text editor</p>
<p><a href=
- "http://www.vim.org/">http://www.vim.org/</a></p>
+ "https://www.vim.org/">https://www.vim.org/</a></p>
</dd>
</dl>
</blockquote>
<h2><a name="h2-development" id="h2-development">Development
activities</a></h2>
- <p>Zeyd Ben-Halim started <em class="small-caps">ncurses</em>
+ <p>Zeyd Ben-Halim started <span class="main-name">ncurses</span>
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
<a href="mailto:dickey@invisible-island.net">Thomas Dickey</a>.
Thomas Dickey also acts as the maintainer for the Free Software
Foundation, which holds the <a href=
- "http://invisible-island.net/ncurses/ncurses-license.html">copyright
+ "https://invisible-island.net/ncurses/ncurses-license.html">copyright
on ncurses</a>.</p>
<p>Contact the current maintainers at</p>
<p>This list is open to anyone interested in helping with the
development and testing of this package.</p>
- <p>Beta versions of <em class="small-caps">ncurses</em> and
+ <p>Beta versions of <span class="main-name">ncurses</span> and
patches to the current release are made available at</p>
<blockquote>
<p><a href=
- "ftp://invisible-island.net/ncurses/">ftp://invisible-island.net/ncurses/</a> .</p>
+ "ftp://ftp.invisible-island.net/ncurses/">ftp://ftp.invisible-island.net/ncurses/</a>
+ and<br>
+ <a href=
+ "https://invisible-mirror.net/archives/ncurses/">https://invisible-mirror.net/archives/ncurses/</a> .</p>
</blockquote>
<p>There is an archive of the mailing list here:</p>
<ul>
<li><a href=
- "http://invisible-island.net/scripts/man2html.html">man2html</a></li>
-
- <li><a href=
- "http://invisible-island.nethttp://invisible-island.net/ncurses/ncurses-license.html">
- <em class="small-caps">ncurses</em> licensing</a></li>
+ "https://invisible-island.net/ncurses/ncurses-license.html"><span class="main-name">
+ ncurses</span> licensing</a></li>
<li><a href=
- "http://invisible-island.net/ncurses/ncurses-mapsyms.html">Symbol
- versioning in <em class="small-caps">ncurses</em></a></li>
+ "https://invisible-island.net/ncurses/ncurses-mapsyms.html">Symbol
+ versioning in <span class="main-name">ncurses</span></a></li>
<li><a href=
- "http://invisible-island.net/ncurses/ncurses-mingw.html">The
- MinGW port of <em class="small-caps">ncurses</em></a></li>
+ "https://invisible-island.net/ncurses/ncurses-slang.html">Comments
+ on <span class="main-name">ncurses</span> versus <span class=
+ "main-name">slang</span> (S-Lang)</a></li>
<li><a href=
- "http://invisible-island.net/ncurses/tack.html">tack –
+ "https://invisible-island.net/ncurses/tack.html">tack –
terminfo action checker</a></li>
<li><a href=
- "http://invisible-island.net/autoconf/portability-tar.html">tar
- versus portability</a></li>
-
- <li><a href=
- "http://invisible-island.net/ncurses/tctest.html">tctest
+ "https://invisible-island.net/ncurses/tctest.html">tctest
– termcap library checker</a></li>
<li><a href=
- "http://invisible-island.net/ncurses/ncurses.html#download_database">
+ "https://invisible-island.net/ncurses/ncurses.html#download_database">
Terminal Database</a></li>
</ul>
terminfo-format terminal description file once maintained by
<a href="http://www.catb.org/~esr/terminfo/">Eric
Raymond</a> . 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.</p>
+ terminfo data are provided in the same file, which also provides
+ several user-definable extensions beyond the X/Open
+ specification.</p>
<p>You can find lots of information on terminal-related topics
not covered in the terminfo file at <a href=
<a href="#h3-library">Library improvements</a>
<ul>
- <li><a href="#h3-lib-setbuf">Output
- buffering</a></li>
-
- <li><a href="#h3-lib-versioning">Symbol
- versioning</a></li>
+ <li><a href="#h4-new-library">New features</a></li>
- <li><a href="#h3-lib-other">Miscellaneous</a></li>
+ <li><a href="#h4-fixes-library">Other
+ improvements</a></li>
</ul>
</li>
</ul>
</li>
- <li>
- <a href="#h3-portability">Portability</a>
-
- <ul>
- <li><a href="#h4-port-mingw">MinGW</a></li>
-
- <li><a href="#h4-port-systems">Other ports</a></li>
- </ul>
- </li>
+ <li><a href="#h3-portability">Portability</a></li>
</ul>
</li>
- <li><a href="#h2-features">Features of <em class=
- "small-caps">ncurses</em></a></li>
+ <li><a href="#h2-features">Features of <span class=
+ "main-name">ncurses</span></a></li>
- <li><a href="#h2-who-uses">Applications using <em class=
- "small-caps">ncurses</em></a></li>
+ <li><a href="#h2-who-uses">Applications using <span class=
+ "main-name">ncurses</span></a></li>
<li><a href="#h2-development">Development activities</a></li>
# 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
# 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)
<span class="comment"><EM>-- Version of the ncurses library from extensions(3NCURSES)</EM></span>
<span class="symbol"><A NAME="ref_21_4">NCURSES_VERSION_MAJOR</A></span> : <b>constant</b> := 6;
- <span class="symbol"><A NAME="ref_22_4">NCURSES_VERSION_MINOR</A></span> : <b>constant</b> := 0;
- <span class="symbol"><A NAME="ref_23_4">Version</A></span> : <b>constant</b> String := "6.0";
+ <span class="symbol"><A NAME="ref_22_4">NCURSES_VERSION_MINOR</A></span> : <b>constant</b> := 1;
+ <span class="symbol"><A NAME="ref_23_4">Version</A></span> : <b>constant</b> String := "6.1";
<span class="comment"><EM>-- Character non-color attributes from attr(3NCURSES)</EM></span>
<!--
- @Id: announce.html.in,v 1.90 2015/08/08 18:39:58 tom Exp @
+ $Id: announce.html,v 1.59 2018/01/27 02:10:10 tom Exp $
****************************************************************************
- * Copyright (c) 1998-2013,2015 Free Software Foundation, Inc. *
+ * Copyright (c) 1998-2015,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 *
* authorization. *
****************************************************************************
-->
-<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN">
<html>
<head>
<meta name="generator" content=
"HTML Tidy for Linux (vers 25 March 2009), see www.w3.org">
- <title>Announcing ncurses 6.0</title>
+ <title>Announcing ncurses 6.1</title>
<link rev="made" href="mailto:bug-ncurses@gnu.org">
<meta http-equiv="Content-Type" content=
"text/html; charset=us-ascii">
<style type="text/css">
p,li { max-width:700px; }
dd { max-width:630px; }
+ *.main-name {
+ font-style: italic;
+ font-variant: small-caps;
+ }
+ *.part-name {
+ font-family: "Andale Mono", "Monotype.com", monospace;
+ font-size: 12pt;
+ font-weight: bold;
+ }
</style>
</head>
<body>
- <h1 class="no-header">Announcing ncurses 6.0</h1>
+ <h1 class="no-header">Announcing ncurses 6.1</h1>
<h2><a name="h2-overview" id="h2-overview">Overview</a></h2>
- <p>The <em class="small-caps">ncurses</em> (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
+ <p>The <span class="main-name">ncurses</span> (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.</p>
+ enhancements over BSD curses. SVr4 curses became the basis of
+ X/Open Curses.</p>
<p>In mid-June 1995, the maintainer of 4.4BSD curses declared
that he considered 4.4BSD curses obsolete, and encouraged the
- keepers of <em class="small-caps">unix</em> releases such as
- BSD/OS, FreeBSD and NetBSD to switch over to <em class=
- "small-caps">ncurses</em>.</p>
+ keepers of <span class="main-name">unix</span> releases such as
+ BSD/OS, FreeBSD and NetBSD to switch over to <span class=
+ "main-name">ncurses</span>.</p>
- <p>Since 1995, <em class="small-caps">ncurses</em> has been
+ <p>Since 1995, <span class="main-name">ncurses</span> has been
ported to many systems:</p>
<ul>
first of these was EMX on OS/2 Warp.</li>
<li>It is used (though usually not as the <em>system</em>
- curses) on all of the vendor <em class="small-caps">unix</em>
- systems, e.g., AIX, HP-UX, IRIX64, SCO, Solaris, Tru64.</li>
+ curses) on all of the vendor <span class=
+ "main-name">unix</span> systems, e.g., AIX, HP-UX, IRIX64, SCO,
+ Solaris, Tru64.</li>
<li>It should work readily on any ANSI/POSIX-conforming
- <em class="small-caps">unix</em>.</li>
+ <span class="main-name">unix</span>.</li>
</ul>
<p>The distribution includes the library and support utilities,
<ul>
<li><a href=
- "http://invisible-island.net/ncurses/man/captoinfo.1m.html">captoinfo</a>,
- a termcap conversion tool</li>
+ "https://invisible-island.net/ncurses/man/captoinfo.1m.html"><span class="part-name">
+ captoinfo</span></a>, a termcap conversion tool</li>
<li><a href=
- "http://invisible-island.net/ncurses/man/clear.1.html">clear</a>,
- utility for clearing the screen</li>
+ "https://invisible-island.net/ncurses/man/clear.1.html"><span class="part-name">
+ clear</span></a>, utility for clearing the screen</li>
<li><a href=
- "http://invisible-island.net/ncurses/man/infocmp.1m.html">infocmp</a>,
- the terminfo decompiler</li>
+ "https://invisible-island.net/ncurses/man/infocmp.1m.html"><span class="part-name">
+ infocmp</span></a>, the terminfo decompiler</li>
<li><a href=
- "http://invisible-island.net/ncurses/man/tabs.1.html">tabs</a>,
- set tabs on a terminal</li>
+ "https://invisible-island.net/ncurses/man/tabs.1.html"><span class="part-name">
+ tabs</span></a>, set tabs on a terminal</li>
<li><a href=
- "http://invisible-island.net/ncurses/man/tic.1m.html">tic</a>,
- the terminfo compiler</li>
+ "https://invisible-island.net/ncurses/man/tic.1m.html"><span class="part-name">
+ tic</span></a>, the terminfo compiler</li>
<li><a href=
- "http://invisible-island.net/ncurses/man/toe.1m.html">toe</a>,
- list (table of) terminfo entries</li>
+ "https://invisible-island.net/ncurses/man/toe.1m.html"><span class="part-name">
+ toe</span></a>, list (table of) terminfo entries</li>
<li><a href=
- "http://invisible-island.net/ncurses/man/tput.1.html">tput</a>,
- utility for retrieving terminal capabilities in shell
- scripts</li>
+ "https://invisible-island.net/ncurses/man/tput.1.html"><span class="part-name">
+ tput</span></a>, utility for retrieving terminal capabilities
+ in shell scripts</li>
<li><a href=
- "http://invisible-island.net/ncurses/man/tset.1.html">tset</a>,
- to initialize the terminal</li>
+ "https://invisible-island.net/ncurses/man/tset.1.html"><span class="part-name">
+ tset</span></a>, to initialize the terminal</li>
</ul>
<p>Full manual pages are provided for the library and tools.</p>
- <p>The <em class="small-caps">ncurses</em> distribution is
- available via anonymous FTP at the GNU distribution site</p>
+ <p>The <span class="main-name">ncurses</span> distribution is
+ available at <span class="main-name">ncurses</span>' <a href=
+ "https://invisible-island.net/ncurses/">homepage</a>:</p>
<blockquote>
<p><a href=
- "ftp://ftp.gnu.org/gnu/ncurses/">ftp://ftp.gnu.org/gnu/ncurses/</a> .</p>
- </blockquote>It is also available at
+ "ftp://ftp.invisible-island.net/ncurses/">ftp://ftp.invisible-island.net/ncurses/</a>
+ or<br>
+ <a href=
+ "https://invisible-mirror.net/archives/ncurses/">https://invisible-mirror.net/archives/ncurses/</a> .</p>
+ </blockquote>
+
+ <p>It is also available via anonymous FTP at the GNU distribution
+ site</p>
<blockquote>
<p><a href=
- "ftp://invisible-island.net/ncurses/">ftp://invisible-island.net/ncurses/</a> .</p>
+ "ftp://ftp.gnu.org/gnu/ncurses/">ftp://ftp.gnu.org/gnu/ncurses/</a> .</p>
</blockquote>
<h2><a name="h2-release-notes" id="h2-release-notes">Release
Notes</a></h2>
- <p>These notes are for <em class="small-caps">ncurses</em>
- 6.0, released <strong>August 8, 2015</strong>.</p>
+ <p>These notes are for <span class="main-name">ncurses</span>
+ 6.1, released <strong>January 27, 2018</strong>.</p>
<p>This release is designed to be source-compatible with
- <em class="small-caps">ncurses</em> 5.0 through 5.9; providing a
- new application binary interface (ABI). Although the source can
- still be configured to support the <em class=
- "small-caps">ncurses</em> 5 ABI, the intent of the release is to
- provide extensions which are generally useful, but
- binary-incompatible with <em class="small-caps">ncurses</em>
- 5:</p>
+ <span class="main-name">ncurses</span> 5.0 through 6.0; providing
+ extensions to the application binary interface (ABI). Although
+ the source can still be configured to support the <span class=
+ "main-name">ncurses</span> 5 ABI, the intent of the release is to
+ provide extensions to the <span class="main-name">ncurses</span>
+ <strong>6</strong> ABI:</p>
<ul>
<li>
- <p>Extend the <code>cchar_t</code> structure to allow more
- than 16 colors to be encoded.</p>
+ <p>improve integration of <span class="part-name">tput</span>
+ and <span class="part-name">tset</span></p>
</li>
<li>
- <p>Modify the encoding of mouse state to make room for a 5th
- mouse button. That allows one to use <em class=
- "small-caps">ncurses</em> with a wheel mouse with xterm or
- similar X terminal emulators.</p>
+ <p>provide support for extended numeric capabilities.</p>
</li>
</ul>
- <p>There are, of course, numerous other improvements,
- including</p>
+ <p>There are, of course, numerous other improvements, listed in
+ this announcement.</p>
+
+ <p>The release notes also mention some bug-fixes, but are focused
+ on new features and improvements to existing features since
+ <span class="main-name">ncurses</span> 6.0 release.</p>
+
+ <h3><a name="h3-library" id="h3-library">Library
+ improvements</a></h3>
+
+ <h4><a name="h4-new-library" id="h4-new-library">New
+ features</a></h4>
+
+ <p>The improved integration of <span class=
+ "part-name">tput</span> and <span class="part-name">tset</span>
+ made only small changes to the libraries. However, supporting
+ extended numeric capabilities required a few changes:</p>
<ul>
<li>
- <p>fixes made based on the Clang and Coverity static
- analyzers.</p>
+ <p>The <code>TERMINAL</code> structure in
+ <code><term.h></code> is now opaque. Doing that allowed
+ making the structure larger, to hold the extended numeric
+ data.</p>
+
+ <p>A few applications required changes during development of
+ <span class="main-name">ncurses 6.1</span> because those
+ applications misused the members of that structure, e.g.,
+ directly modifying it rather than using <a href=
+ "https://invisible-island.net/ncurses/man/curs_kernel.3x.html#h3-def_prog_mode_-def_shell_mode">
+ def_prog_mode</a>.</p>
</li>
<li>
- <p>memory leak fixes using Valgrind</p>
- </li>
- </ul>
+ <p>Having made <code>TERMINAL</code> opaque (and because none
+ of the library functions use anything except a pointer to
+ <code>TERMINAL</code>), it was possible to increase the size
+ of the structure, adding to the end.</p>
- <p>The release notes mention some bug-fixes, but are focused on
- new features and improvements to existing features log since
- <em class="small-caps">ncurses</em> 5.9 release.</p>
+ <p>Existing applications which were linked to the
+ <span class="part-name">ncurses 6.0</span> high-level
+ (<em>ncurses</em>, <em>ncursesw</em>) and low-level
+ (<em>tinfo</em>, <em>tinfo</em>) libraries should not require
+ re-linking since the binary interface did not change, nor did
+ the structure offsets with <code>TERMINAL</code> change.</p>
- <p>While the intent of the release is to provide a new stable
- ABI, there are other development activities which are summarized
- below.</p>
+ <p>A few applications use the inner <code>TERMTYPE</code>
+ structure's offsets to refer to terminfo capabilities within
+ that structure. Again, those do not require modification
+ because their offsets within <code>TERMINAL</code> did not
+ change.</p>
+ </li>
- <ul>
<li>
- <p>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 <code>Console2</code> took a while.</p>
+ <p>When configured for wide-characters, i.e.,
+ “ncursesw” the <code>TERMINAL</code> structure is
+ extended.</p>
+
+ <p>The new data in <code>TERMINAL</code> holds the same
+ information as <code>TERMTYPE</code>, but with larger numbers
+ (“int” versus “short”). It is named
+ <code>TERMTYPE2</code>.</p>
+
+ <p>The library uses this structure internally in preference
+ to <code>TERMTYPE</code>, referring to <code>TERMTYPE</code>
+ only to initialize it for applications that use the
+ capabilities defined in <code><term.h></code></p>
</li>
<li>
- <p>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.</p>
+ <p>When configured for 8-bit (narrow) characters, the
+ <code>TERMTYPE2</code> structure is not used.</p>
+ </li>
- <p>The <a href=
- "http://invisible-island.net/ncurses/tctest.html">termcap
- library checker (tctest)</a> (not part of <em class=
- "small-caps">ncurses</em>) was one result. A followup review
- of performance using <a href=
- "http://invisible-island.net/ncurses/ncurses-examples.html">ncurses-examples</a>
- in 2014 led to additional improvements.</p>
+ <li>The updated application binary interface is 6.1.20171230
+ (used for new <a href=
+ "https://invisible-island.net/ncurses/ncurses-mapsyms.html">versioned
+ symbols</a>), although the interface changes were developed
+ several months previously.</li>
+ </ul>
+
+ <p>The motivation for making this extension came from noticing
+ that <a href=
+ "https://invisible-island.net/ncurses/tctest.html#bsd42-numeric-caps">
+ termcap applications</a> could (though not <a href=
+ "https://invisible-island.net/ncurses/ncurses-slang.html#cause_numbers">
+ realistically</a>) 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.</p>
+
+ <p>Generally speaking, applications that use internal details of
+ a library are unsupported. There was exactly one exception for
+ <span class="main-name">ncurses</span>: the <span class=
+ "main-name">tack</span> program <em>used</em> the internal
+ details of <code>TERMINAL</code>, 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 <span class=
+ "main-name">tack</span> from these <a href=
+ "https://invisible-island.net/ncurses/tack.html#portable">internal
+ details of <span class="main-name">ncurses</span></a>, but to
+ generalize it so that the program works with Unix curses
+ (omitting the ncurses-specific feature). That was released as
+ <a href=
+ "https://invisible-island.net/ncurses/tack/CHANGES.html#index-t20170726">
+ <span class="main-name">tack</span> 1.08</a> in July
+ 2017.</p>
+
+ <p>While making changes to <span class="main-name">tack</span> to
+ eliminate its dependency upon <span class=
+ "main-name">ncurses</span> 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 <span class="main-name">ncurses</span> internals.
+ Future releases of <span class="main-name">ncurses</span> may
+ eliminate some of those symbols (such as those used by
+ <span class="main-name">tack</span> 1.07) because they are
+ neither part of the API or the ABI.</p>
+
+ <p>Using the <code>TERMTYPE2</code> 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:</p>
+
+ <ul>
+ <li>
+ <p>X/Open Curses defined function prototypes such as
+ <code>wattr_set</code> with an unused parameter, for
+ “future” use. After 25 years, the future is here:
+ <span class="main-name">ncurses</span> uses the parameter to
+ augment color pair values as described in the <a href=
+ "https://invisible-island.net/ncurses/man/curs_attr.3x.html#h2-EXTENSIONS">
+ manual page</a>.</p>
</li>
<li>
- <p>Output buffering provided a further, but worthwhile
- distraction. A bug report in 2012 regarding the use of signal
- handlers in <em class="small-caps">ncurses</em>) pointed out
- <a href=
- "http://lists.gnu.org/archive/html/bug-ncurses/2012-07/msg00029.html">
- a problem</a> with the use of unsafe functions for handling
- <code>SIGTSTP</code>. Other signals could be addressed with
- workarounds; repairing <code>SIGTSTP</code> required a
- different approach. The solution required changing internal
- behavior of the library: how it handles output buffering.</p>
-
- <p>Now <em class="small-caps">ncurses</em> 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
- <em>unspecified</em> 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.</p>
- </li>
-
- <li>
- <p>Since the introduction of the experimental support for 256
- colors early in <a href=
- "http://invisible-island.net/ncurses/NEWS.html#t20050101">2005</a>
- (released in <a href=
- "http://invisible-island.net/ncurses/announce-5.5.html">ncurses
- 5.5</a>), there has been increased user interest. Almost all
- packagers continue providing the ncurses ABI 5 which cannot
- support 256 colors.</p>
- </li>
-
- <li>
- <p>Symbol versioning, or the lack of it in ncurses, is the
- main reason why packagers would be reluctant to add a new
- ncurses ABI.</p>
-
- <p>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
- <a href=
- "http://invisible-island.net/ncurses/ncurses-mapsyms.html">Symbol
- versioning in <em class="small-caps">ncurses</em></a>.</p>
+ <p>Other functions such as those defining color pairs did not
+ have a corresponding <em>reserved</em> parameter. For those,
+ <span class="main-name">ncurses</span> defines extended
+ versions such as <code>init_extended_pair</code> (versus
+ <code>init_pair</code>), <code>init_extended_color</code>
+ (versus <code>init_color</code>).</p>
</li>
</ul>
- <h3><a name="h3-library" id="h3-library">Library
- improvements</a></h3>
+ <p>Additionally, to improve performance other changes (and
+ extensions) are provided in this release:</p>
- <h3><a name="h3-lib-setbuf" id="h3-lib-setbuf">Output
- buffering</a></h3>
+ <ul>
+ <li>
+ <p>Several new functions simplify management of large sets of
+ color pairs: <code>reset_color_pairs</code>,
+ <code>alloc_pair</code>, <code>find_pair</code> and
+ <code>free_pair</code>.</p>
+ </li>
- <p>X/Open curses provides more than one initialization
- function:</p>
+ <li>
+ <p>New "RGB" extension capability for direct-color support is
+ used to improve performance of
+ <code>color_content</code>.</p>
+ </li>
- <ul>
- <li><a href=
- "http://invisible-island.net/ncurses/man/curs_initscr.3x.html#h3-initscr">
- initscr</a> (the simplest) accepts no parameters.</li>
+ <li>
+ <p>The internal <code>colorpair_t</code> is now a struct,
+ eliminating an internal 8-bit limit on colors</p>
+ </li>
- <li><a href=
- "http://invisible-island.net/ncurses/man/curs_initscr.3x.html#h3-newterm">
- newterm</a> accepts parameters for the stream input and
- output</li>
+ <li>
+ <p>Allocation for <code>SCREEN</code>'s color-pair table
+ starts small, grows on demand up to the limit given in the
+ terminal description.</p>
+ </li>
- <li><a href=
- "http://invisible-island.net/ncurses/man/curs_terminfo.3x.html#h3-Initialization">
- setupterm</a> (the low-level function) accepts a parameter for
- the <em>file descriptor</em> of the output.</li>
+ <li>
+ <p><code>setcchar</code> and <code>getcchar</code> now treat
+ a negative color-pair as an error.</p>
+ </li>
</ul>
- <p>They are documented in X/Open <em>as if</em>
- <code>initscr</code> calls <code>newterm</code> using
- <code>stdout</code> for output stream, and in turn
- <code>newterm</code> calls <code>setupterm</code> using
- <code>fileno(stdout)</code> for the file descriptor. As long as
- an implementation acts <em>as if</em> it does this, it conforms.
- In practice, implementations do what is implied. This creates a
- problem: the low-level <code>setupterm</code> function's file
- descriptor is unbuffered, while <code>newterm</code> 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.</p>
-
- <p>Initially, <em class="small-caps">ncurses</em> used the file
- descriptor (obtained from the output stream passed to
- <code>newterm</code>) for changing the terminal modes, and relied
- upon the output parameter of <code>newterm</code> for buffered
- output. Later (to avoid using unsafe buffered I/O in signal
- handlers), <em class="small-caps">ncurses</em> 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.</p>
-
- <p>That approach worked reasonably well and as a side effect,
- using the same buffered output as an application might use for
- <code>printf</code> meant that no flushing was needed when
- switching between normal- and screen-modes.</p>
-
- <p>There were a couple of problems:</p>
+ <h4><a name="h4-fixes-library" id="h4-fixes-library">Other
+ improvements</a></h4>
+
+ <p>These are new or revised features:</p>
<ul>
<li>
- <p>to get good performance, curses (not only <em class=
- "small-caps">ncurses</em>, but SVr4 curses in general) set an
- output buffer using <code>setbuf</code> or similar function.
- There is no standard (or portable) way to turn that output
- buffer off, and revert to line-buffering. The <code><a href=
- "http://invisible-island.net/ncurses/man/ncurses.3x.html#h3-NCURSES_NO_SETBUF">
- NCURSES_NO_SETBUF</a></code> environment variable did make it
- optional.</p>
+ <p>modify <code>c++/etip.h.in</code> to accommodate
+ deprecation of throw and throws in c++17</p>
</li>
<li>
- <p>to handle <code>SIGTSTP</code> (the “stop”
- signal), <em class="small-caps">ncurses</em> 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.</p>
+ <p>add new function <code>unfocus_current_field</code></p>
</li>
- </ul>
- <p>Conveniently, solving the second problem (by making <em class=
- "small-caps">ncurses</em> do its <em>own</em> output buffering)
- also fixed the first one. But there were special cases to
- resolve: <a href=
- "http://invisible-island.net/ncurses/man/curs_terminfo.3x.html"><em>
- low-level</em></a> 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.</p>
+ <li>
+ <p>add option to preserve leading whitespace in form
+ fields</p>
+ </li>
- <p>Finally, there may still be a few programs which should be
- modified to improve their portability, e.g., adding an</p>
+ <li>
+ <p>add a macro for <code>is_linetouched</code> and adjust the
+ function's return value to make it possible for most
+ applications to check for an error-return.</p>
+ </li>
- <blockquote>
- <pre class="code-block">
-fflush(stdout);
-</pre>
- </blockquote>
+ <li>
+ <p>add build-time utility <code>report_offsets</code> to help
+ show when the various configurations of tinfo library are
+ compatible or not.</p>
+ </li>
+ </ul>
- <p>when switching from “<a href=
- "http://invisible-island.net/ncurses/man/curs_kernel.3x.html#h3-reset_prog_mode_-reset_shell_mode">shell</a>”
- mode to “<a href=
- "http://invisible-island.net/ncurses/man/curs_kernel.3x.html#h3-reset_prog_mode_-reset_shell_mode">program</a>”
- (curses) mode. Those are fairly rare because most programmers
- have learned not to mix <code>printf</code> and <code><a href=
- "http://invisible-island.net/ncurses/man/curs_printw.3x.html">printw</a></code>.</p>
-
- <h3><a name="h3-lib-versioning" id="h3-lib-versioning">Symbol
- versioning</a></h3>
-
- <p>This release introduces symbol-versioning to <em class=
- "small-caps">ncurses</em> because without it, the change of ABI
- would be less successful. A lengthy discussion will be presented
- in <a href=
- "http://invisible-island.net/ncurses/ncurses-mapsyms.html">Symbol
- versioning in <em class="small-caps">ncurses</em></a>. These
- notes summarize what has changed, and what can be done with the
- new release.</p>
-
- <p>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.</p>
-
- <p>This release provides sample files for the four principal
- configurations of <em class="small-caps">ncurses</em> libraries:
- <code>ncurses</code>, <code>ncursesw</code>,
- <code>ncursest</code> and <code>ncursestw</code>. Each sample is
- given in two forms:</p>
+ <p>These were done to limit or ultimately deprecate features:</p>
- <blockquote>
- <dl>
- <dt>“<code>.map</code>”</dt>
+ <ul>
+ <li>
+ <p>drop two symbols obsoleted in 2004:
+ <code>_nc_check_termtype</code>, and
+ <code>_nc_resolve_uses</code></p>
+ </li>
- <dd>These list all public symbols, together with version
- names.</dd>
+ <li>
+ <p>move <code>_nc_tracebits</code>, <code>_tracedump</code>
+ and <code>_tracemouse</code> to <code>curses.priv.h</code>,
+ since they are not part of the suggested ABI6.</p>
+ </li>
- <dt>“<code>.sym</code>”</dt>
+ <li>
+ <p>mark some structs in form/menu/panel libraries as
+ potentially opaque without modifying API/ABI.</p>
+ </li>
- <dd>These list all public symbols, without version
- names.</dd>
- </dl>
- </blockquote>
+ <li>
+ <p>ifdef'd header-file definition of <code>mouse_trafo</code>
+ with <code>NCURSES_NOMACROS</code></p>
+ </li>
- <p>The sample files are <em>generated</em> by scripts which take
- into account a few special cases such as <a href=
- "http://invisible-island.net/ncurses/tack.html">tack</a> to omit
- many of the <em class="small-caps">ncurses</em> private symbols
- (beginning with “<code>_nc_</code>”). Here are
- counts of globals versus locals:</p>
+ <li>
+ <p>remove initialization-check for calling <code>napms</code>
+ in the term-driver configuration; none is needed.</p>
+ </li>
- <blockquote>
- <table border="1" summary="Total global and local symbols">
- <tr>
- <th>Config</th>
+ <li>
+ <p>modify <code>trace</code> to avoid overwriting existing
+ file</p>
+ </li>
+ </ul>
- <th>Symbols</th>
+ <p>These are improvements to existing features:</p>
- <th>Globals</th>
+ <ul>
+ <li>
+ <p>modify <code>make_hash</code> to allow building with
+ address-sanitizer, assuming that <code>--disable-leaks</code>
+ is configured.</p>
+ </li>
- <th>Locals</th>
+ <li>
+ <p>move <code>SCREEN</code> field for <code>use_tioctl</code>
+ data before the ncursesw fields, and limit that to the
+ sp-funcs configuration to improve termlib compatibility</p>
+ </li>
- <th>"_nc_"</th>
- </tr>
+ <li>
+ <p>modify db-iterator:</p>
- <tr>
- <td>ncurses</td>
+ <ul>
+ <li>
+ <p>ignore zero-length files in db-iterator; these are
+ useful for instance to suppress
+ <code>$HOME/.terminfo</code> when not wanted.</p>
+ </li>
- <td align="right">976</td>
+ <li>
+ <p>modify <code>update_getenv</code> to ensure that
+ environment variables which are not initially set will be
+ checked later if an application happens to set them</p>
+ </li>
+ </ul>
+ </li>
- <td align="right">796</td>
+ <li>
+ <p>modify <code>_nc_outc_wrapper</code> to use the standard
+ output if the screen was not initialized, rather than
+ returning an error.</p>
+ </li>
- <td align="right">180</td>
+ <li>
+ <p>improve checks for low-level terminfo functions when the
+ terminal has not been initialized.</p>
+ </li>
- <td align="right">332</td>
- </tr>
+ <li>
+ <p>modify <code>set_curterm</code> to update
+ <code>ttytype[]</code> data used by longname/p></p>
+ </li>
- <tr>
- <td>ncursesw</td>
+ <li>
+ <p>modify <code>_nc_get_screensize</code> to allow for
+ <code>use_env</code> and <code>use_tioctl</code> state to be
+ per-screen when sp-funcs are configured, better matching the
+ behavior when using the term-driver configuration.</p>
+ </li>
- <td align="right">1089</td>
+ <li>
+ <p>remove an early-return from <code>_nc_do_color,</code>
+ which can interfere with data needed by <code>bkgd</code>
+ when <span class="main-name">ncurses</span> is configured
+ with extended colors</p>
+ </li>
- <td align="right">905</td>
+ <li>
+ <p>incorporate <code>A_COLOR</code> mask into
+ <code>COLOR_PAIR</code>, in case user application provides an
+ out-of-range pair number</p>
+ </li>
- <td align="right">184</td>
+ <li>
+ <p>modify logic for <code>endwin</code>-state to be able to
+ detect the case where the screen was never initialized, using
+ that to trigger a flush of <span class=
+ "main-name">ncurses'</span> buffer for <code>mvcur</code>,
+ e.g., in the sample program <span class=
+ "part-name">dots_mvcur</span> for the term-driver
+ configuration.</p>
+ </li>
+ </ul>
- <td align="right">343</td>
- </tr>
+ <p>These are corrections to existing features:</p>
- <tr>
- <td>ncursest</td>
+ <ul>
+ <li>
+ <p>fixes for writing extended color pairs in
+ <code>putwin</code>.</p>
+ </li>
- <td align="right">979</td>
+ <li>
+ <p>modify no-leaks code for <code>lib_cur_term.c</code> to
+ account for the <code>tgetent</code> cache.</p>
+ </li>
- <td align="right">804</td>
+ <li>
+ <p>amend handling of the <code>repeat_char</code> capability
+ in <code>EmitRange</code> to avoid scope creep: translate the
+ character to the alternate character set when the alternate
+ character set is enabled, and do not use
+ <code>repeat_char</code> for characters past 255.</p>
+ </li>
- <td align="right">175</td>
+ <li>
+ <p>improve wide-character implementation of
+ <code>myADDNSTR</code> in <code>frm_driver.c</code>, which
+ was inconsistent with the normal implementation.</p>
+ </li>
- <td align="right">358</td>
- </tr>
+ <li>
+ <p>modify <code>winnstr</code> and <code>winchnstr</code> 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.</p>
+ </li>
- <tr>
- <td>ncursestw</td>
+ <li>
+ <p>modify <code>setupterm</code> to save original tty-modes
+ so that <code>erasechar</code> works as expected. Also modify
+ <code>_nc_setupscreen</code> to avoid redundant calls to get
+ original tty-modes.</p>
+ </li>
- <td align="right">1098</td>
+ <li>
+ <p>modify <code>wattr_set</code> and <code>wattr_get</code>
+ to return <code>ERR</code> if <em>win</em>-parameter is null,
+ as documented.</p>
+ </li>
- <td align="right">914</td>
+ <li>
+ <p>correct order of initialization for traces in
+ <code>use_env</code> and <code>use_tioctl</code> versus first
+ <code>_tracef</code> calls.</p>
+ </li>
- <td align="right">184</td>
+ <li>
+ <p>correct parameters for <code>copywin</code> call in
+ <code>_nc_Synchronize_Attributes</code></p>
+ </li>
- <td align="right">372</td>
- </tr>
- </table>
- </blockquote>
+ <li>
+ <p>flush the standard output in <code>_nc_flush</code> for
+ the case where <code>SP</code> is zero, e.g., when called via
+ <code>putp</code>. This fixes a scenario where
+ “tput flash” did not work after changes in
+ 20130112.</p>
+ </li>
- <p>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
- <em>not</em> support the feature, and a few (such as Solaris)
- which provide incomplete support.</p>
-
- <p>The version-naming convention used allows these sample files
- to build distinct libraries for ABI 5 and 6. Version names
- consist of</p>
+ <li>
+ <p>amend internal use of <code>tputs</code> 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
+ “<code>*</code>” proportional delay for these
+ operations, prompting a change in <code>doupdate</code>.</p>
+ </li>
- <ul>
<li>
- <p>configuration name, e.g.,
- “<code>NCURSESW</code>” for the wide-character
- libraries</p>
+ <p>correct return-value of extended <code>putwin</code>.</p>
</li>
<li>
- <p>ABI version (if not 5)</p>
+ <p>double-width multibyte characters were not counted
+ properly in <code>winsnstr</code> and
+ <code>wins_nwstr</code>.</p>
</li>
<li>
- <p>library name for two special cases which have the same
- interface across configurations:
- “<code>TINFO</code>” and
- “<code>TIC</code>”</p>
+ <p>amend fix for <code>_nc_ripoffline</code> from 20091031 to
+ make <code>test/ditto.c</code> work in threaded
+ configuration.</p>
</li>
<li>
- <p>release version</p>
+ <p>modify <code>_nc_viscbuf2</code> and
+ <code>_tracecchar_t2</code> to trace wide-characters as a
+ whole rather than their multibyte equivalents.</p>
</li>
<li>
- <p>patch date (for the release version)</p>
+ <p>minor fix in <code>wadd_wchnstr</code> to ensure that each
+ cell has nonzero width.</p>
</li>
- </ul>
- <p>For example, running <code>nm -D</code> on the libraries in
- the ncurses6 test package shows these symbol-versions:</p>
+ <li>
+ <p>move <code>PUTC_INIT</code> calls next to
+ <code>wcrtomb</code> calls, to avoid carry-over of error
+ status when processing Unicode values which are not
+ mapped.</p>
+ </li>
- <blockquote>
- <pre class="code-block">
-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
-</pre>
- </blockquote>
+ <li>
+ <p>add missing assignment in <code>lib_getch.c</code> to make
+ <code>notimeout</code> work</p>
+ </li>
+ </ul>
+
+ <h3><a name="h3-programs" id="h3-programs">Program
+ improvements</a></h3>
- <p>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.</p>
+ <p>While reviewing user feedback, it became apparent that the
+ differences between <a href=
+ "https://invisible-island.net/ncurses/man/tset.1.html#h3-reset---reinitialization">
+ <span class="part-name">reset</span></a> (an alias for
+ <span class="part-name">tset</span>) and “<span class=
+ "part-name">tput reset</span>” were confusing:</p>
- <h3><a name="h3-lib-other" id=
- "h3-lib-other">Miscellaneous</a></h3>
+ <ul>
+ <li>one (<a href=
+ "https://invisible-island.net/ncurses/man/tset.1.html">tset</a>)
+ updated the terminal modes, but used only part of the terminfo
+ capabilities for initialization, while</li>
+
+ <li>the other (<a href=
+ "https://invisible-island.net/ncurses/man/tput.1.html"><span class="part-name">tput</span></a>)
+ used all of the terminal capabilities while neglecting the
+ terminal modes.</li>
+ </ul>
- <p>The new release has several improvements for performance and
- building. For instance:</p>
+ <p>On further investigation, it turned out that the differences
+ were largely an accident due to the way those programs had
+ evolved.</p>
+
+ <p>This release eliminates the unnecessary differences, using the
+ same approach for <span class="part-name">tput</span>'s
+ <em>init</em> (initialization), <em>reset</em> and <em>clear</em>
+ operations as the separate <a href=
+ "https://invisible-island.net/ncurses/man/tset.1.html#h3-reset---reinitialization">
+ reset</a> and <a href=
+ "https://invisible-island.net/ncurses/man/clear.1.html"><span class="part-name">
+ clear</span></a> programs. Doing this does not change the
+ command-line options; existing scripts are unaffected.</p>
+
+ <p>These are the user-visible changes for the three programs
+ (<span class="part-name">tput</span>, <span class=
+ "part-name">tset</span> and <span class=
+ "part-name">clear</span>):</p>
<ul>
<li>
- <p>several files in ncurses- and progs-directories were
- modified to allow <code>const</code> data used in internal
- tables to be put by the linker into the readonly text
- segment.</p>
+ <p>add the terminal-mode parts of “<span class=
+ "part-name">reset</span>” (aka <span class=
+ "part-name">tset</span>) to the “<code>tput
+ reset</code>” command, making the two almost the same
+ except for window-size.</p>
</li>
<li>
- <p>various improvements were made to building the Ada95
- binding, both in simplifying the generated files as well as
- improving the way it uses <code>gnatmake</code></p>
+ <p>improve <span class="part-name">tput</span>'s check for
+ being called as “init” or “reset” to
+ allow for transformed names.</p>
</li>
- </ul>
- <p>There are also new features in the libraries:</p>
+ <li>
+ <p>add “clear” as a possible link/alias to
+ <span class="part-name">tput</span>.</p>
+ </li>
- <ul>
- <li>added <a href=
- "http://invisible-island.net/ncurses/man/curs_util.3x.html#h3-use_tioctl">
- use_tioctl</a> function</li>
+ <li>
+ <p>amend changes for <span class="part-name">tput</span> to
+ reset tty modes to “sane” if the program is run
+ as “reset”, like <span class=
+ "part-name">tset</span>. Likewise, ensure that <span class=
+ "part-name">tset</span> sends either reset- or
+ init-strings.</p>
+ </li>
<li>
- <p>added <a href=
- "http://invisible-island.net/ncurses/man/curs_opaque.3x.html">
- wgetdelay</a> to retrieve _delay member of WINDOW if it
- happens to be opaque, e.g., in the pthread configuration.</p>
+ <p>add <code>-x</code> option to <span class=
+ "part-name">clear</span>/<span class="part-name">tput</span>
+ to make the <code>E3</code> extension optional</p>
</li>
<li>
- <p>added <a href=
- "http://invisible-island.net/ncurses/man/curs_attr.3x.html#h2-PORTABILITY">
- A_ITALIC</a> extension.</p>
+ <p>add functionality of
+ “<code>tset -w</code>” to <span class=
+ "part-name">tput</span>, like the
+ “<code>-c</code>” feature this is not optional in
+ <span class="part-name">tput</span>.</p>
</li>
<li>
- <p>added form library extension <a href=
- "http://invisible-island.net/ncurses/man/form_field_opts.3x.html">
- O_DYNAMIC_JUSTIFY</a> option which can be used to override
- the different treatment of justification for static versus
- dynamic fields .</p>
+ <p>add options <code>-T</code> and <code>-V</code> to
+ <span class="part-name">clear</span> command for
+ compatibility with <span class="part-name">tput</span>.</p>
</li>
<li>
- <p>rewrote <a href=
- "http://invisible-island.net/ncurses/man/curs_util.3x.html#h3-putwin_getwin">
- putwin</a> and <a href=
- "http://invisible-island.net/ncurses/man/curs_util.3x.html#h3-putwin_getwin">
- getwin</a>, making an extended version which is capable of
- reading screen-dumps between the wide/normal <em class=
- "small-caps">ncurses</em> configurations. These are text
- files, except for a <em>magic</em> code at the beginning:</p>
+ <p>drop long-obsolete “<code>-n</code>” option
+ from <span class="part-name">tset</span>.</p>
+ </li>
- <blockquote>
- <pre class="code-block">
-0 string \210\210 Screen-dump (ncurses)
-</pre>
- </blockquote>
+ <li>
+ <p>modify <span class="part-name">tset</span>'s assignment to
+ <code>TERM</code> 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 <span class="part-name">tset</span> from
+ termcap to terminfo. The termcap library in 4.3BSD did this
+ to avoid using the short 2-character name</p>
</li>
<li>
- <p>several changes to mouse support include:</p>
+ <p>remove a restriction in <span class=
+ "part-name">tput</span>'s support for termcap names which
+ omitted capabilities normally not shown in termcap
+ translations</p>
+ </li>
+
+ <li>
+ <p>add usage message to <span class="part-name">clear</span>
+ command</p>
+ </li>
+
+ <li>
+ <p>improve usage messages for <span class=
+ "part-name">tset</span> and <span class=
+ "part-name">tput</span>.</p>
+ </li>
+ </ul>
+
+ <p>Other user-visible improvements and new features include:</p>
+
+ <ul>
+ <li>
+ <p>modify <span class="part-name">tic</span>/<span class=
+ "part-name">infocmp</span> display of numeric values to use
+ hexadecimal when they are "close" to a power of two, making
+ the result more readable.</p>
+ </li>
+
+ <li>
+ <p>add “<code>-W</code>” option to <span class=
+ "part-name">tic</span>/<span class="part-name">infocmp</span>
+ to force long strings to wrap.</p>
<ul>
- <li>added decoder for xterm SGR 1006 mouse mode.</li>
+ <li>
+ <p>This is in addition to the
+ “<code>-w</code>” option which attempts to
+ fit capabilities into a given line-length.</p>
+ </li>
- <li>added experimental support for
- “<code>%u</code>” format to terminfo.</li>
+ <li>
+ <p>If “<code>-f</code>” option splits line,
+ do not further split it with
+ “<code>-W</code>”.</p>
+ </li>
- <li>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 .</li>
+ <li>
+ <p>Begin a new line when adding
+ “<code>use=</code>” after a wrapped line.</p>
+ </li>
</ul>
</li>
- </ul>
- <p>There are a few new configure options dealing with library
- customization:</p>
+ <li>
+ <p>add “<code>-q</code>” option to <span class=
+ "part-name">infocmp</span> to suppress the
+ “<code>Reconstructed from</code>” comment from
+ the header, and a corresponding option to <span class=
+ "part-name">tic</span> to suppress all comments from the
+ “<code>tic -I</code>” output.</p>
+ </li>
- <ul>
<li>
- <p>add “<code>--enable-ext-putwin</code>”
- configure option to turn on the extended putwin/getwin. By
- default, this is enabled for ABI 6 and disabled with ABI
- 5.</p>
+ <p>Sorted options in usage message for <span class=
+ "part-name">infocmp</span>, to make it simpler to see unused
+ letters.</p>
</li>
<li>
- <p>add “<code>--enable-string-hacks</code>”
- option to control whether strlcat and strlcpy may be used.
- Because <em class="small-caps">ncurses</em> already does the
- requisite buffer-limit checks, this feature is mainly of
- interest to quiet compiler-warnings on a few systems.</p>
+ <p>Updated usage message for <span class=
+ "part-name">tic</span>, adding “<code>-0</code>”
+ option.</p>
</li>
<li>
- <p>add configure option
- “<code>--with-tparm-arg</code>” to allow <a href=
- "http://invisible-island.net/ncurses/man/curs_terminfo.3x.html#h3-Formatting-Output">
- tparm</a>'s parameters to be something more likely to be the
- same size as a pointer, e.g., <code>intptr_t</code> (again,
- the default is set for ABI 6).</p>
+ <p>add <span class="part-name">infocmp</span>/<span class=
+ "part-name">tic</span> “<code>-Q</code>” option,
+ which allows one to dump the compiled form of the terminal
+ entry, in hexadecimal or base64:</p>
+
+ <ul>
+ <li>A “<code>b64:</code>” prefix in the
+ <code>TERMINFO</code> variable tells the terminfo reader to
+ use base64 according to RFC-3548 as well as RFC-4648
+ url/filename-safe format.</li>
+
+ <li>A “<code>hex:</code>” prefix tells the
+ terminfo reader to accept hexadecimal data as generated by
+ “<code>infocmp -0qQ1</code>”.</li>
+ </ul>
</li>
</ul>
- <h3><a name="h3-programs" id="h3-programs">Program
- improvements</a></h3>
-
- <h4><a name="h4-utilities" id="h4-utilities">Utilities</a></h4>
-
- <p>Most of the termcap-related changes based on development of
- <a href="http://invisible-island.net/ncurses/tctest.html">tctest
- (termcap library checker)</a> are implemented in the tic and
- infocmp programs rather than affecting the library. As noted in
- the <a href=
- "http://invisible-island.net/ncurses/tctest.html#my-better-translation">
- discussion</a> of <code>tctest</code>, <em class=
- "small-caps">ncurses</em>'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 <em>termcap</em> users are
- using <em class="small-caps">ncurses</em> (or NetBSD, with its
- own terminfo library) and their programs are actually using
- terminfo rather than termcap data.</p>
-
- <p>Still, there are a few. A comment about the translation of the
- ASCII <code>NUL</code> character prompted a review:</p>
+ <p>Other less-visible improvements and new features include:</p>
<ul>
<li>
- <p>Both terminfo and termcap store string capabilities as
- <code>NUL</code>-terminated strings.</p>
+ <p>modify utility headers such as <code>tic.h</code> to make
+ it clearer which are externals that are used by <span class=
+ "main-name">tack</span>.</p>
</li>
<li>
- <p>In terminfo, a <code>\0</code> in a terminal description
- is stored as <code>\200</code>.</p>
+ <p>add “<code>reset</code>” to list of programs
+ whose names might change in manpages due to
+ program-transformation configure options.</p>
</li>
<li>
- <p>There are no (known) terminals which would behave
- differently when sent <code>\0</code> or
- <code>\200</code>.</p>
+ <p>modify “<code>-T</code>” option of
+ <span class="part-name">clear</span> and <span class=
+ "part-name">tput</span> to call <code>use_tioctl</code> to
+ obtain the operating system's notion of the screensize if
+ possible.</p>
</li>
<li>
- <p>When translating to terminfo format (or displaying a
- printable version of an entry using infocmp), <em class=
- "small-caps">ncurses</em> shows <code>\200</code> as
- <code>\0</code>.</p>
+ <p>add check in <span class="part-name">tput</span> for
+ init/reset operands to ensure those use a terminal.</p>
</li>
<li>
- <p>It has done this since 1998 (quoting from the NEWS
- file):</p>
-
- <blockquote>
- <pre class="code-block">
-<a href=
-"http://invisible-island.net/ncurses/NEWS.html#t980103">980103</a>
-...
- + modify _nc_tic_expand() to generate \0 rather than \200.
-...
- + correct translation of terminfo "^@", to \200, like \0.
-</pre>
- </blockquote>
+ <p>modify programs <span class="part-name">clear</span>,
+ <span class="part-name">tabs</span>, <span class=
+ "part-name">tput</span> and <span class=
+ "part-name">tset</span> to pass the actual tty file
+ descriptor to setupterm rather than the standard output or
+ error, making padding work.</p>
</li>
<li>
- <p>However, the <code>_nc_tic_expand</code> function (which
- optionally produces terminfo or termcap format) did not
- address this special case for termcap. Even the later 4.4BSD
- <a href=
- "https://svnweb.freebsd.org/base/head/lib/libc/gen/getcap.c?revision=244092&view=markup#l784">
- cgetstr</a> interprets a <code>\0</code> literally, ending
- <em>that</em> string (rather than using the terminfo
- improvement).</p>
+ <p>change <span class="part-name">tset</span>'s
+ initialization to allow it to get settings from the standard
+ input as well as <code>/dev/tty</code>, to be more effective
+ when output or error are redirected.</p>
</li>
- </ul>
- <p>As a result of the review, several improvements were made to
- <em class="small-caps">ncurses</em> 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:</p>
-
- <ul>
<li>
- <p>the “<code>-0</code>” option generates
- termcap/terminfo source on a single line.</p>
+ <p>amend check in <span class="part-name">tput</span>,
+ <span class="part-name">tabs</span> and <span class=
+ "part-name">clear</span> to allow those to use the
+ database-only features in <span class="part-name">cron</span>
+ if a “<code>-T</code>” option gives a suitable
+ terminal name.</p>
</li>
<li>
- <p>the “<code>-K</code>” option provides stricter
- BSD-compatibility for termcap output.</p>
+ <p>improve error message from <span class=
+ "part-name">tset</span>/<span class="part-name">reset</span>
+ when both stderr/stdout are redirected to a file or pipe.</p>
</li>
</ul>
- <p>Other user-visible improvements and new features include:</p>
+ <p>Several of the less apparent features deal with translation of
+ terminfo to termcap (and the reverse), with corresponding checks
+ by <span class="part-name">tic</span>:</p>
<ul>
<li>
- <p>added “<code>-D</code>” option to tic and
- infocmp, to show the database locations that it could
- use.</p>
+ <p>modify check in <code>fmt_entry</code> to handle a
+ cancelled reset string. Make similar fixes in other parts of
+ <code>dump_entry.c</code> and <code>tput.c</code></p>
</li>
<li>
- <p>added “<code>-s</code>” option to toe, to sort
- its output.</p>
+ <p>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.</p>
</li>
<li>
- <p>extended “<code>-c</code>” and
- “<code>-n</code>” options of infocmp to allow
- comparing more than two entries.</p>
+ <p>modify <span class="part-name">infocmp</span> to suppress
+ mixture of absent/cancelled capabilities that would only show
+ as “<code>NULL, NULL</code>”, unless the
+ “<code>-q</code>” option is used, e.g., to show
+ “<code>-, @</code>” or “<code>@,
+ -</code>”.</p>
</li>
<li>
- <p>modified toe's report when “<code>-a</code>”
- and “<code>-s</code>” options are combined, to
- add a column showing which entries belong to a given
- database.</p>
+ <p>correct a warning from <span class="part-name">tic</span>
+ about keys which are the same, to skip over missing/cancelled
+ values.</p>
</li>
<li>
- <p>modified the clear program to take into account the
- “<code>E3</code>” extended capability to clear
- the terminal's scrollback buffer.</p>
+ <p>add check in <span class="part-name">tic</span> for use of
+ bold, etc., video attributes in the color capabilities,
+ accounting whether the feature is listed in
+ <code>ncv</code>.</p>
</li>
- </ul>
- <h4><a name="h4-examples" id="h4-examples">Examples</a></h4>
+ <li>
+ <p>add check in <span class="part-name">tic</span> for
+ unnecessary use of “<code>2</code>” to denote a
+ shifted special key.</p>
+ </li>
- <p>Along with the library and utilities, many improvements were
- made to the <a href=
- "http://invisible-island.net/ncurses/ncurses-examples.html">ncurses-examples</a>.
- 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).</p>
+ <li>
+ <p>improve check in <span class="part-name">tic</span> 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.</p>
+ </li>
- <p>These changes were made to verify compatibility or compare
- performance of <em class="small-caps">ncurses</em>:</p>
+ <li>
+ <p>improve checks in <code>trim_sgr0</code>, comp_parse.c and
+ parse_entry.c, for cancelled string capabilities.</p>
+ </li>
- <ul>
<li>
- <p>made workarounds for compiling test-programs with NetBSD
- curses, though it lacks some common functions such as
- <a href="http://invisible-island.net/ncurses/man/curs_util.3x.html#h3-use_env">
- use_env</a>.</p>
+ <p>add check in <span class="part-name">tic</span> for some
+ syntax errors of delays, as well as use of proportional
+ delays for non-line capabilities.</p>
</li>
<li>
- <p>added dots_termcap test-program</p>
+ <p>add check in <span class="part-name">tic</span> for
+ conflict between <code>ritm</code>, <code>rmso</code>,
+ <code>rmul</code> versus <code>sgr0</code>.</p>
</li>
<li>
- <p>added dots_curses test-program, for comparison with the
- low-level examples.</p>
+ <p>add check in <code>_nc_parse_entry</code> for invalid
+ entry name, setting the name to
+ “<code>invalid</code>” to avoid problems storing
+ entries.</p>
</li>
<li>
- <p>added test_setupterm test-proram to demonstrate
- normal/error returns from the setupterm and restartterm
- functions.</p>
+ <p>improve <code>_nc_tparm_analyze</code>, using that to
+ extend the checks made by <span class="part-name">tic</span>
+ for reporting inconsistencies between the expected number of
+ parameters for a capability and the actual.</p>
</li>
<li>
- <p>added “<code>-d</code>”,
- “<code>-e</code>” and
- “<code>-q</code>” options to the demo_terminfo
- and demo_termcap test-programs.</p>
+ <p>remove <span class="part-name">tic</span> warning about
+ “<code>^?</code>” 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, <a href=
+ "https://invisible-island.net/ncurses/tctest.html#bsd42-ctl-question">
+ BSD termcap</a> did not support this feature (until the
+ <a href=
+ "https://invisible-island.net/ncurses/tctest.html#freebsd-ctl-question">
+ mid-1990s</a>).</p>
+
+ <p>in <code>_nc_infotocap</code>, added a check to ensure
+ that terminfo “<code>^?</code>” is not written to
+ termcap.</p>
</li>
<li>
- <p>added “<code>-y</code>” option to demo_termcap
- and test/demo_terminfo test-programs to demonstrate behavior
- with/without extended capabilities.</p>
+ <p>modify <code>sscanf</code> calls in
+ <code>_nc_infotocap</code> for patterns
+ “<code>%{number}%+%c</code>” and
+ “<code>%'char'%+%c</code>” to check that the
+ final character is really “<code>c</code>”,
+ avoiding a case in icl6404 which cannot be converted to
+ termcap.</p>
</li>
<li>
- <p>modified demo_termcap and demo_terminfo test-programs to
- make their options more directly comparable, and add
- “<code>-i</code>” option to specify a terminal
- description filename to parse for names to lookup.</p>
+ <p>in <code>_nc_tic_expand</code> and
+ <code>_nc_infotocap</code>, improved string-length check when
+ deciding whether to use “<code>^X</code>” or
+ “<code>\xxx</code>” format for control
+ characters, to make the output of <span class=
+ "part-name">tic</span>/<span class="part-name">infocmp</span>
+ more predictable.</p>
</li>
<li>
- <p>rewrote the tests for <a href=
- "http://invisible-island.net/ncurses/man/curs_window.3x.html#h3-derwin">
- mvderwin</a> and test for recursive <a href=
- "http://invisible-island.net/ncurses/man/curs_window.3x.html#h3-mvwin">
- mvwin</a> in the movewindow test-program.</p>
+ <p>limited termcap “<code>%d</code>” width to 2
+ digits on input, and use “<code>%2</code>” in
+ preference to “<code>%02</code>” on output.</p>
+ </li>
+
+ <li>
+ <p>correct terminfo/termcap conversion of
+ “<code>%02</code>” and
+ “<code>%03</code>” into
+ “<code>%2</code>” and
+ “<code>%3</code>”; the result repeated the last
+ character.</p>
</li>
</ul>
- <p>These changes were made to help with the MinGW port:</p>
+ <h4><a name="h4-examples" id="h4-examples">Examples</a></h4>
+
+ <p>Along with the library and utilities, many improvements were
+ made to the <a href=
+ "https://invisible-island.net/ncurses/ncurses-examples.html">ncurses-examples</a>.</p>
+
+ <p>These changes were made to demonstrate new extensions in
+ <span class="main-name">ncurses</span>:</p>
<ul>
<li>
- <p>added test-screens to the ncurses test-program to show
- 256-characters at a time, to help with MinGW port.</p>
+ <p>add <span class="part-name">demo_new_pair</span> program,
+ to demonstrate <a href=
+ "https://invisible-island.net/ncurses/man/new_pair.3x.html#h3-alloc_pair">
+ <code>alloc_pair</code></a>, <a href=
+ "https://invisible-island.net/ncurses/man/new_pair.3x.html#h3-find_pair">
+ <code>find_pair</code></a> and <a href=
+ "https://invisible-island.net/ncurses/man/new_pair.3x.html#h3-free_pair">
+ <code>free_pair</code></a> functions.</p>
+
+ <p>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.,</p>
+
+ <blockquote>
+ <table summary="sample layouts for demo_new_pair">
+ <tr>
+ <td><code>32x64,32x128</code> </td>
+
+ <td>256 colors</td>
+ </tr>
+
+ <tr>
+ <td><code>24x44,24x88</code></td>
+
+ <td>88 colors</td>
+ </tr>
+
+ <tr>
+ <td><code>32x64,24x128</code></td>
+
+ <td>16 colors</td>
+ </tr>
+ </table>
+ </blockquote>
</li>
<li>
- <p>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.</p>
+ <p>add <span class="part-name">extended_color</span> program,
+ like the older <span class="part-name">color_set</span>
+ program, but using the extended color functions, with and
+ without the SP-functions interface.</p>
</li>
<li>
- <p>added “<code>-s</code>” 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.</p>
+ <p>add <span class="part-name">picsmap</span> program to fill
+ in some testing issues not met by <span class=
+ "part-name">dots</span>, using this as the third example in a
+ comparison of the <a href=
+ "https://invisible-island.net/ncurses/ncurses-slang.html#compare_picsmap">
+ ncurses versus slang</a> libraries.</p>
+
+ <p>The program can directly read X bitmap and pixmap files,
+ displaying a picture. It can read other image files using
+ <span class="part-name">ImageMagick</span>'s <span class=
+ "part-name">convert</span> program to translate the image
+ into text.</p>
+
+ <p>For 16-, 88- and 256-color terminal descriptions,
+ <span class="part-name">picsmap</span> can load a palette
+ file which tells it which color palette entries to use. For
+ direct-colors, the terminal descriptions use the
+ <code>RGB</code> extension capability.</p>
</li>
</ul>
- <p>These changes were made to verify new extensions in <em class=
- "small-caps">ncurses</em>:</p>
+ <p>There are other new example programs and a few scripts:</p>
<ul>
<li>
- <p>added <a href=
- "http://invisible-island.net/ncurses/man/form_driver.3x.html#h3-form_driver_w">
- form_driver_w</a> entrypoint to wide-character forms library,
- as well as form_driver_w test-program.</p>
+ <p>add <span class="part-name">dots_xcurses</span> program to
+ illustrate a different approach used for extended colors
+ which can be contrasted with <span class=
+ "part-name">dots_curses</span>.</p>
</li>
<li>
- <p>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.</p>
+ <p>add <span class="part-name">list_keys</span> program show
+ function keys for one or more terminal descriptions. It uses
+ <span class="main-name">ncurses'</span>s convention of
+ modifiers for special keys, based on xterm.</p>
</li>
<li>
- <p>modified ncurses test-program, adding
- “<code>-E</code>” and
- “<code>-T</code>” options to demonstrate use_env
- versus use_tioctl.</p>
+ <p>add <span class="part-name">padview</span> program, to
+ compare pads with direct updates in the <span class=
+ "part-name">view</span> program.</p>
</li>
<li>
- <p>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.</p>
+ <p>add <span class="part-name">sp_tinfo</span> program to
+ exercise the SP-functions extension of the low-level terminfo
+ library.</p>
</li>
<li>
- <p>modified the ncurses test-program to also show position
- reports in 'a' test.</p>
+ <p>add test-programs for <code>termattrs</code> and
+ <code>term_attrs</code> functions.</p>
</li>
- </ul>
-
- <p>These changes were made to make the examples more useful:</p>
- <ul>
<li>
- <p>added scripts for building dpkg and rpm test-packages</p>
+ <p>add <span class="part-name">test_sgr</span> program to
+ exercise all combinations of the sgr capability.</p>
</li>
<li>
- <p>modified the hanoi test-program to show the minimum number
- of moves possible for the given number of tiles.</p>
+ <p>add <span class="part-name">tput-colorcube</span> demo
+ script, imitating xterm's 88- and 256-color scripts using
+ <span class="part-name">tput</span>.</p>
</li>
<li>
- <p>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.</p>
+ <p>add <span class="part-name">tput-initc</span> script to
+ demonstrate how <span class="part-name">tput</span> may be
+ used to initialize a color palette from a data file.</p>
</li>
</ul>
- <h3><a name="h3-database" id="h3-database">Terminal
- database</a></h3>
+ <p>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.</p>
- <p>This release provides improvements to tic's
- “<code>-c</code>” checking option, which was used for
- example to</p>
+ <p>The <span class="part-name">ncurses</span> program is the
+ largest; a proportionately large number of changes were made to
+ it:</p>
<ul>
<li>
- <p>make <code>sgr</code> in several entries agree with other
- caps.</p>
+ <p>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.</p>
+
+ <p>add “<code>t</code>” toggle for
+ <code>notimeout</code> function.</p>
</li>
<li>
- <p>correct padding in some entries where earlier versions had
- miscounted the number of octal digits.</p>
+ <p>modify layout of b/B screens to allow for additional
+ annotation on the right margin; some terminals with partial
+ support did not display well.</p>
</li>
- </ul>
- <p>There are several new terminal descriptions:</p>
-
- <ul>
- <li><a href=
- "http://invisible-island.net/ncurses/terminfo.src.html#toc-_M_L_T_E_R_M">
- mlterm</a> is now aliased to mlterm3</li>
-
- <li><a href=
- "http://invisible-island.net/ncurses/terminfo.src.html#tic-nsterm">
- nsterm</a> is now derived from nsterm-256color</li>
-
- <li><a href=
- "http://invisible-island.net/ncurses/terminfo.src.html#tic-putty-sco">
- putty-sco</a></li>
+ <li>
+ <p>modify c/C screens to allow for extended color pairs.</p>
- <li><a href=
- "http://invisible-island.net/ncurses/terminfo.src.html#tic-teken">
- teken</a> is FreeBSD's "xterm" console.</li>
+ <p>add z/Z <em>zoom</em> feature to make extended color pairs
+ easier to test.</p>
- <li><a href=
- "http://invisible-island.net/ncurses/terminfo.src.html#toc-_T_E_R_M_I_N_A_T_O_R">
- terminator</a></li>
+ <p>modify test-screens to take advantage of wide screens,
+ reducing the number of lines used for 88- and 256-colors.</p>
+ </li>
- <li><a href=
- "http://invisible-island.net/ncurses/terminfo.src.html#toc-_T_E_R_M_I_N_O_L_O_G_Y">
- terminology</a></li>
+ <li>
+ <p>modify “<code>d</code>” edit-color screen to
+ optionally read xterm color palette directly from terminal,
+ as well as handling <code>KEY_RESIZE</code> and
+ screen-repainting with control/L and control/R.</p>
+ </li>
- <li><a href=
- "http://invisible-island.net/ncurses/terminfo.src.html#tic-tmux">
- tmux</a> is derived from screen.</li>
+ <li>
+ <p>add examples to “<code>F</code>” screen for
+ <code>WACS_D_PLUS</code> and <code>WACS_T_PLUS</code>.</p>
+ </li>
- <li>several screen.XXX entries support the respective
- variations for 256 colors.</li>
+ <li>
+ <p>improve “<code>g</code>” screen, correcting
+ ifdef which made the legend not reflect changes to keypad-
+ and scroll-modes. Added check for return-value of
+ <code>putwin</code>.</p>
+ </li>
- <li><a href=
- "http://invisible-island.net/ncurses/terminfo.src.html#toc-_S_I_M_P_L_E_T_E_R_M">
- simpleterm</a> is now 0.5</li>
+ <li>
+ <p>make “<code>s</code>” test easier to
+ understand which subtests are available</p>
- <li><a href=
- "http://invisible-island.net/ncurses/terminfo.src.html#tic-vte">
- vte</a> is aliased to vte-2012</li>
+ <p>add a corresponding “<code>S</code>”
+ wide-character overlap test-screen.</p>
+ </li>
- <li><a href=
- "http://invisible-island.net/ncurses/terminfo.src.html#tic-vt520ansi">
- vt520ansi</a></li>
+ <li>
+ <p>add “<code>v</code>” screen to show
+ <code>baudrate</code> and other values.</p>
+ </li>
</ul>
- <p>A few entries use extensions (user-defined terminal
- capabilities):</p>
+ <p>These changes were made to the other examples:</p>
<ul>
<li>
- <p><code>E3</code>, used in linux, putty and xterm-basic is
- tested in the <a href=
- "http://aerie.jexium-island.net/ncurses/man/clear.1.html">clear</a>
- program to erase a terminal's scrollback.</p>
+ <p>modify <span class="part-name">blue</span> program to use
+ Unicode values for card-glyphs when available, as well as
+ improving the check for CP437 and CP850.</p>
</li>
<li>
- <p><code>TS</code> is used in the <a href=
- "http://invisible-island.net/ncurses/terminfo.src.html#tic-xterm_sl">
- xterm+sl</a> building block to help deprecate the misuse of
- <code>tsl</code> for xterm's title-string.</p>
+ <p>improve <span class="part-name">demo_menus</span> program,
+ allowing mouse-click on the menu-headers to switch the active
+ menu. This requires a new extension option
+ <code>O_MOUSE_MENU</code> 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.</p>
</li>
<li>
- <p><code>XT</code> 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.</p>
+ <p>correct logic in <span class=
+ "part-name">demo_terminfo</span> program for
+ “<code>-f</code>” option</p>
</li>
<li>
- <p><code>xm</code> is used in examples <a href=
- "http://invisible-island.net/ncurses/terminfo.src.html#tic-xterm-1005">
- xterm-1005</a> and <a href=
- "http://invisible-island.net/ncurses/terminfo.src.html#tic-xterm-1006">
- xterm-1006</a> to illustrate a way to make mouse handling
- more general</p>
+ <p>modify <span class="part-name">ditto</span> program to
+ allow <code>$XTERM_PROG</code> environment variable to
+ override "xterm" as the name of the program to run in the
+ threaded configuration.</p>
</li>
- </ul>
- <p>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
- <code>A_ITALIC</code> extension.</p>
+ <li>
+ <p>add several options to the “<em>dots</em>”
+ test-programs.</p>
+ </li>
- <ul>
- <li>konsole, mlterm3 (italics)</li>
+ <li>
+ <p>modify <span class="part-name">filter</span> program:</p>
+
+ <ul>
+ <li>illustrate an alternative to <code>getnstr</code>, that
+ polls for input while updating a clock on the right margin
+ as well as responding to window size-changes.</li>
+
+ <li>adapt logic used in <a href=
+ "https://invisible-island.net/dialog/"><span class=
+ "main-name">dialog</span></a> <a href=
+ "https://invisible-island.net/dialog/manpage/dialog.html#h3-Common-Options">
+ “<code>--keep-tite</code>” option</a> for
+ <span class="part-name">filter</span> program as the "-a"
+ option. When set, <span class="part-name">filter</span>
+ attempts to suppress the alternate screen.</li>
+ </ul>
+ </li>
- <li>nsterm (dim)</li>
+ <li>
+ <p>modify <span class="part-name">knight</span> program to
+ provide the "slow" solution for small screens using
+ “<code>R</code>”, noting that Warnsdorf's method
+ is easily done with “<code>a</code>”.</p>
+ </li>
- <li>screen (dim)</li>
+ <li>
+ <p>modify the <span class="part-name">savescreen</span>
+ program to add test patterns that exercise 88-, 256-, etc.,
+ colors.</p>
+ </li>
- <li>vte (dim, italics)</li>
+ <li>
+ <p>add options to <span class="part-name">test_arrays</span>,
+ for selecting termcap vs terminfo, etc.</p>
+ </li>
- <li>xterm (dim, italics)</li>
- </ul>
+ <li>
+ <p>modify the <span class="part-name">view</span>
+ program:</p>
- <h3><a name="h3-documentation" id=
- "h3-documentation">Documentation</a></h3>
+ <ul>
+ <li>expand tabs using the ncurses library rather than in
+ the test-program.</li>
- <p>As usual, this release</p>
+ <li>eliminate the “<code>-n</code>” option by
+ simply reading the whole file.</li>
+
+ <li>implement page up/down commands.</li>
+
+ <li>remove the very old <code>SIGWINCH</code> example; just
+ use <code>KEY_RESIZE</code>.</li>
+ </ul>
+ </li>
- <ul>
<li>
- <p>improves documentation by describing new features,</p>
+ <p>improve animation in <span class="part-name">xmas</span>
+ program by adding a time-delay in <code>blinkit</code>.</p>
</li>
<li>
- <p>attempts to improve the description of features which
- users have found confusing</p>
+ <p>modify several test-programs which call
+ <code>use_default_colors</code> to consistently do this only
+ if the “<code>-d</code>” option is given.</p>
</li>
<li>
- <p>fills in overlooked descriptions of features which were
- described in the <a href=
- "http://invisible-island.net/ncurses/NEWS.html">NEWS</a> file
- but treated sketchily in manual pages.</p>
+ <p>modify the install-rule for ncurses-examples to put the
+ data files in the data directory, e.g.,
+ <code>/usr/share/ncurses-examples</code>.</p>
</li>
- </ul>
- <p>In addition, the mechanism for producing HTML versions of the
- documentation has been improved:</p>
+ <li>
+ <p>modify several test programs to use new
+ <code>popup_msgs</code> function, adapted from the
+ help-screen used in the <code>edit_field</code> program.</p>
+ </li>
- <ul>
<li>
- <p>use an improved version of <a href=
- "http://invisible-island.net/scripts/man2html.html">man2html</a>
- to generate html manpages.</p>
+ <p>modify test data for xterm palettes to use the newer
+ color4/color12 values.</p>
</li>
<li>
- <p>regenerated <a href=
- "http://invisible-island.net/ncurses/NCURSES-Programming-HOWTO.html">
- NCURSES-Programming-HOWTO.html</a> to fix some of the broken
- html emitted by docbook.</p>
+ <p>improve the <span class="part-name">tracemunch</span>
+ script:</p>
+
+ <ul>
+ <li>show screenXX pointers and thread identifiers as
+ names.</li>
+
+ <li>chang address-parameters of <code>add_wch</code>,
+ <code>color_content</code> and <code>pair_content</code> to
+ dummy parameters.</li>
+ </ul>
</li>
</ul>
- <h3><a name="h3-bug-fixes" id="h3-bug-fixes">Interesting
- bug-fixes</a></h3>
+ <h3><a name="h3-database" id="h3-database">Terminal
+ database</a></h3>
+
+ <p>There are several new terminal descriptions:</p>
+
+ <blockquote>
+ <p><code>dumb-emacs-ansi</code>, <code>dvtm</code>,
+ <code>dvtm-256color</code>, <code>fbterm</code>,
+ <code>iterm2</code>, <code>linux-m1</code> <em>minitel
+ entries</em>, <code>putty-noapp</code>, <code>viewdata</code>,
+ and <code>vt100+4bsd</code> <em>building-block</em>.</p>
+
+ <p><code>xterm+noalt</code>, <code>xterm+titlestack</code>,
+ <code>xterm+alt1049</code>, <code>xterm+alt+title</code>
+ <em>building blocks</em> and <code>xterm+direct</code>,
+ <code>xterm+indirect</code>, <code>xterm-direct</code>. from
+ <a href=
+ "https://invisible-island.net/xterm/xterm.log.html#xterm_331">xterm
+ patch #331</a>.</p>
+
+ <p>several other “<code>-direct</code>”
+ descriptions to address the differences of other terminal
+ emulators versus <code>xterm-direct</code>.</p>
+ </blockquote>
+
+ <p>There are many changes to existing terminal descriptions. Some
+ were updates to several descriptions:</p>
<ul>
- <li>
- <p>Ada95 binding:</p>
+ <li>use <code>xterm+sm+1006</code> in several terminal
+ descriptions which were validated as supporting the extended
+ mouse feature for their respective terminal emulators.</li>
+
+ <li>corrected <em>sgr</em>/<em>sgr0</em> strings in a few cases
+ reported by <span class="part-name">tic</span>, making those
+ correspond to the non-<em>sgr</em> settings where they differ,
+ but otherwise use ECMA-48 consistently.</li>
+
+ <li>add 0.1sec mandatory delay to <em>flash</em> capabilities
+ using the VT100 reverse-video control</li>
+ </ul>
+ <p>while others affected specific descriptions. These were
+ retested, to take into account new/undocumented changes by their
+ developers:</p>
+
+ <blockquote>
+ <p><code>iterm</code>, <code>minitel</code>, <code>st</code>,
+ <code>viewdata</code>, <code>nsterm</code></p>
+ </blockquote>
+
+ <p>while these are specific fixes based on user reports, or
+ warnings from <span class="part-name">tic</span>:</p>
+
+ <dl>
+ <dt><a href=
+ "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">
+ <code>ansi</code> <em>building blocks</em></a></dt>
+
+ <dd>
<ul>
- <li>
- <p>modify makefile rules to ensure that the PIC option is
- not used when building a static library</p>
- </li>
+ <li>restored <em>rmir</em>/<em>smir</em> in
+ <code>ansi+idc</code> to better match original
+ <code>ansiterm+idc</code>, add alias
+ <code>ansiterm</code></li>
+ </ul>
+ </dd>
- <li>
- <p>make Ada95 build-fix for big-endian architectures such
- as sparc. This undoes one of the fixes from <a href=
- "http://invisible-island.net/ncurses/NEWS.html#t20110319">
- 20110319</a>, which added an
- “<code>Unused</code>” member to
- representation clauses, replacing that with pragmas to
- suppress warnings about unused bits.</p>
- </li>
+ <dt><a href=
+ "https://invisible-island.net/ncurses/terminfo.src.html#tic-icl6404">
+ <code>icl6402</code></a></dt>
+
+ <dd>
+ <ul>
+ <li>corrected missing comma-separator between string
+ capabilities in <code>icl6402</code> and
+ <code>m2-nam</code></li>
</ul>
- </li>
+ </dd>
- <li>
- <p>Color and attributes:</p>
+ <dt><a href=
+ "https://invisible-island.net/ncurses/terminfo.src.html#tic-interix">
+ <code>interix</code></a></dt>
+ <dd>
<ul>
- <li>
- <p>parenthesize parameter of <code>COLOR_PAIR</code> and
- <code>PAIR_NUMBER</code> in curses.h in case it happens
- to be a comma-expression.</p>
- </li>
+ <li>updated using <span class="main-name">tack</span> and
+ SFU with Windows 7 Ultimate.</li>
- <li>
- <p>improve <a href=
- "http://invisible-island.net/ncurses/NEWS.html#t20021221">
- 20021221</a> workaround for broken acs, handling a case
- where that ACS_<em>xxx</em> character is not in the
- <code>acsc</code> string but there is a known
- wide-character which can be used.</p>
- </li>
+ <li>used <code>^?</code> for <em>kdch1</em></li>
+ </ul>
+ </dd>
- <li>
- <p>modify <a href=
- "http://invisible-island.net/ncurses/man/curs_color.3x.html#h3-Routine-Descriptions">
- init_pair</a> to accept -1's for color value after
- <a href=
- "http://invisible-island.net/ncurses/man/default_colors.3x.html">
- assume_default_colors</a> has been called.</p>
- </li>
+ <dt><a href=
+ "https://invisible-island.net/ncurses/terminfo.src.html#toc-_Linux_consoles">
+ <code>linux</code></a></dt>
- <li>
- <p>add a check in <a href=
- "http://invisible-island.net/ncurses/man/curs_color.3x.html#h3-Routine-Descriptions">
- start_color</a> to limit color-pairs to 256 when extended
- colors are not supported.</p>
- </li>
+ <dd>
+ <ul>
+ <li>made <code>linux3.0</code> entry the default
+ <strong><code>linux</code></strong> entry</li>
+
+ <li>modify <code>linux2.6</code> entry to improve
+ line-drawing so that the <code>linux3.0</code> entry can be
+ used in non-UTF-8 mode</li>
+
+ <li>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.</li>
+
+ <li>modify <em>flash</em> capability for <code>linux</code>
+ and <code>wyse</code> entries to put the delay between the
+ reverse/normal escapes rather than after</li>
+
+ <li>modify <code>linux-16color</code> to not mask dim,
+ standout or reverse with the <em>ncv</em> capability</li>
</ul>
- </li>
+ </dd>
- <li>
- <p>Resizing the screen:</p>
+ <dt><a href=
+ "https://invisible-island.net/ncurses/terminfo.src.html#toc-_Open_B_S_D_consoles">
+ <code>pccon</code> <em>entries</em></a></dt>
+ <dd>
<ul>
- <li>
- <p>propagate error-returns from wresize, i.e., the
- internal increase_size and decrease_size functions
- through <a href=
- "http://invisible-island.net/ncurses/man/resizeterm.3x.html">
- resize_term</a>.</p>
- </li>
+ <li>fixed some inconsistencies in the
+ <code><em>pccon*</em></code> entries</li>
- <li>
- <p>add check for zero/negative dimensions for
- <code>resizeterm</code> and <code>resize_term</code>.</p>
- </li>
+ <li>add bold to <code>pccon+sgr+acs</code> and
+ <code>pccon-base</code></li>
- <li>
- <p>modify <code>resizeterm</code> to always push a
- <code>KEY_RESIZE</code> onto the fifo, even if screensize
- is unchanged. Modify library to push a
- <code>KEY_RESIZE</code> if there was a SIGWINCH, even if
- it does not call <code>resizeterm</code>). These changes
- eliminate the case where a SIGWINCH is received, but ERR
- is returned from <code>wgetch</code> or
- <code>wgetnstr</code> because the screen dimensions did
- not change.</p>
- </li>
+ <li>add keys f12-f124 to <code>pccon+keys</code></li>
</ul>
- </li>
+ </dd>
- <li>
- <p>Low-level interfaces</p>
+ <dt><a href=
+ "https://invisible-island.net/ncurses/terminfo.src.html#toc-_Tmux">
+ <code>tmux</code></a></dt>
+ <dd>
<ul>
- <li>
- <p>fix an old bug in the termcap emulation;
- “<code>%i</code>” was ignored in
- <code>tparm</code> because the parameters to be
- incremented were already on the internal stack.</p>
- </li>
+ <li>corrected <em>sgr</em> string, which used
+ <code>screen</code>'s "standout" code rather than the
+ standard code.</li>
- <li>
- <p>change “<code>%l</code>” behavior in tparm
- to push the string length onto the stack rather than
- saving the formatted length into the output buffer.</p>
- </li>
+ <li>add settings corresponding to <code>xterm-keys</code>
+ option to reflect upcoming change to make that option
+ <em>"on"</em> by default</li>
- <li>
- <p>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 <a href=
- "http://invisible-island.net/ncurses/NEWS.html#t980725">980725</a>).</p>
- </li>
+ <li>uncanceled <em>Ms</em></li>
</ul>
- </li>
+ </dd>
- <li>High-level interfaces
+ <dt><a href=
+ "https://invisible-island.net/ncurses/terminfo.src.html#toc-_D_E_C__V_T100_and_compatibles">
+ <code>vt100</code></a></dt>
+ <dd>
<ul>
- <li>
- <p>modify internal recursion in <code>wgetch</code> which
- handles cooked mode to check if the call to
- <code>wgetnstr</code> returned an error. This can happen
- when both <code>nocbreak</code> and <code>nodelay</code>
- are set, for instance (see note for <a href=
- "http://invisible-island.net/ncurses/NEWS.html#t960418">960418</a>).</p>
- </li>
+ <li>modify <code>vt100</code> <em>rs2</em> string to reset
+ vt52 mode and scrolling regions</li>
- <li>
- <p>add a check in internal function
- <code>waddch_nosync</code> to ensure that tab characters
- are treated as control characters; some broken locales
- claim they are printable.</p>
- </li>
+ <li>corrected <em>rs2</em> string for
+ <code>vt100-nam</code></li>
- <li>
- <p>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</p>
- </li>
+ <li>made minor fixes for <code>vt100+4bsd</code>, e.g.,
+ delay in <em>sgr</em> for consistency</li>
+ </ul>
+ </dd>
- <li>
- <p>fix special case where double-width character
- overwrites a single- width character in the first
- column.</p>
- </li>
+ <dt><a href=
+ "https://invisible-island.net/ncurses/terminfo.src.html#toc-_G_N_O_M_E__V_T_E_">
+ <code>vte</code></a></dt>
+
+ <dd>
+ <ul>
+ <li>moved SGR 24 and 27 from <code>vte-2014</code> to
+ <code>vte-2012</code></li>
+
+ <li>add a few capabilities fixed in recent <em>VTE</em>
+ development</li>
</ul>
+ </dd>
+
+ <dt><a href=
+ "https://invisible-island.net/ncurses/terminfo.src.html#toc-_X_T_E_R_M">
+ <code>xterm</code></a></dt>
+
+ <dd>
+ <ul>
+ <li>add <em>rep</em> to <code>xterm-new</code>, available
+ since <a href=
+ "https://invisible-island.net/xterm/xterm.log.html#xterm_32">
+ late 1996</a>.</li>
+
+ <li>modify <code>xterm+256color</code> and
+ <code>xterm+256setaf</code> to use correct number of color
+ pairs.</li>
+
+ <li>modify <em>rs1</em> for <code>xterm-16color</code>,
+ <code>xterm-88color</code> and <code>xterm-256color</code>
+ to reset palette using <em>oc</em> string as in
+ <code>linux</code> entry.</li>
+
+ <li>add <em>rs1</em> capability to
+ <code>xterm-256color</code></li>
+
+ <li>add <em>oc</em> capability to
+ <code>xterm+256color</code>, allowing palette reset for
+ <span class="main-name">xterm</span></li>
+
+ <li>add <em>op</em> to <code>xterm+256setaf</code></li>
+
+ <li>modify <code>xterm-r5</code>, <code>xterm-r6</code> and
+ <code>xterm-xf86-v32</code> to use <code>xterm+kbs</code>
+ to match <a href=
+ "https://invisible-island.net/xterm/xterm.log.html#xterm_272">
+ xterm #272</a>, reflecting packager's changes</li>
+
+ <li>used ANSI reply for <em>u8</em> in
+ <code>xterm-new</code>, to reflect vt220-style responses
+ that could be returned.</li>
+
+ <li>made <code>xterm-pcolor</code> <em>sgr</em> consistent
+ with other capabilities</li>
+ </ul>
+ </dd>
+ </dl>
+
+ <p>A few entries use extensions (user-defined terminal
+ capabilities):</p>
+
+ <ul>
+ <li>add <em>rmxx</em>/<em>smxx</em> ECMA-48 strikeout extension
+ to <code>tmux</code> and <code>xterm-basic</code></li>
+
+ <li>used <em>RGB</em> capability in new <em>*-direct</em>
+ entries to denote direct-color feature.</li>
+ </ul>
+
+ <h3><a name="h3-documentation" id=
+ "h3-documentation">Documentation</a></h3>
+
+ <p>As usual, this release</p>
+
+ <ul>
+ <li>
+ <p>improves documentation by describing new features,</p>
+ </li>
+
+ <li>
+ <p>attempts to improve the description of features which
+ users have found confusing</p>
+ </li>
+
+ <li>
+ <p>fills in overlooked descriptions of features which were
+ described in the <a href=
+ "https://invisible-island.net/ncurses/NEWS.html">NEWS</a>
+ file but treated sketchily in manual pages.</p>
</li>
</ul>
- <h3><a name="h3-config-config" id=
- "h3-config-config">Configuration changes</a></h3>
+ <p>In particular,</p>
- <h4><a name="h4-config-major" id="h4-config-major">Major
- changes</a></h4>
+ <ul>
+ <li>
+ <p>Since the underlying features for <a href=
+ "https://invisible-island.net/ncurses/man/clear.1.html#h2-HISTORY">
+ <span class="part-name">tset</span></a>, <a href=
+ "https://invisible-island.net/ncurses/man/clear.1.html#h2-HISTORY">
+ <span class="part-name">tput</span></a>, and <a href=
+ "https://invisible-island.net/ncurses/man/clear.1.html#h2-HISTORY">
+ <span class="part-name">clear</span></a> have been better
+ integrated, the documentation now includes information on how
+ those tools evolved.</p>
- <p>The <em class="small-caps">ncurses</em> 6.0 configure script
- makes changes to the <em>default</em> value of several configure
- options, depending on the <code>--with-abi-version</code> option
- (i.e., whether its value is “5” or
- “6”):</p>
+ <p>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.</p>
+ </li>
- <dl>
- <dt><code>--enable-const</code></dt>
+ <li>
+ <p>The <code>addch</code> manual page has additional
+ information on <a href=
+ "https://invisible-island.net/ncurses/man/curs_addch.3x.html#h2-PORTABILITY">
+ portability</a> and differences from other
+ implementations.</p>
+ </li>
- <dd>
- <p>Feature introduced in <a href=
- "http://invisible-island.net/ncurses/NEWS.html#t970405">970405</a>
- supports the use of <code>const</code> where X/Open Curses
- should have, but did not. NetBSD curses does something
- similar with <code>const</code>.</p>
- </dd>
+ <li>
+ <p>The discussion of color-pairs in the <em>attributes</em>
+ manual page is improved in its <a href=
+ "https://invisible-island.net/ncurses/man/curs_attr.3x.html#h2-HISTORY">
+ history section</a>.</p>
+ </li>
- <dt><code>--enable-ext-colors</code></dt>
+ <li>
+ <p>The documentation of the <code>chtype</code>,
+ <code>cchar_t</code> types and the attribute values which can
+ be stored in those types, in particular the <a href=
+ "https://invisible-island.net/ncurses/man/curs_attr.3x.html#h2-HISTORY">
+ history</a> and <a href=
+ "https://invisible-island.net/ncurses/man/curs_attr.3x.html#h2-PORTABILITY">
+ portability</a> sections of the <em>attributes</em> manual
+ page, has been improved.</p>
+ </li>
- <dd>
- <p>Extends the <code>cchar_t</code> structure to allow more
- than 16 colors to be encoded. This applies only to the
- wide-character (<code>--enable-widec</code>)
- configuration.</p>
- </dd>
+ <li>
+ <p>improve discussion of <a href=
+ "https://invisible-island.net/ncurses/man/curs_mouse.3x.html#h2-PORTABILITY">
+ portability</a> in the <em>mouse</em> manual.</p>
+ </li>
- <dt><code>--enable-ext-mouse</code></dt>
+ <li>
+ <p>The <em>pad</em> manual page has a section on the <a href=
+ "https://invisible-island.net/ncurses/man/curs_pad.3x.html#h2-PORTABILITY">
+ origin and portability</a> of pads.</p>
+ </li>
- <dd>
- <p>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.</p>
- </dd>
+ <li>
+ <p>Differences between SVr4 and X/Open Curses soft-keys are
+ discussed in a new section on <a href=
+ "https://invisible-island.net/ncurses/man/curs_slk.3x.html#h2-PORTABILITY">
+ portability</a>.</p>
+ </li>
- <dt><code>--enable-ext-putwin</code></dt>
+ <li>
+ <p>There are updated/improved notes on portability in the
+ <a href=
+ "https://invisible-island.net/ncurses/man/resizeterm.3x.html#h2-PORTABILITY">
+ resizeterm</a> and <a href=
+ "https://invisible-island.net/ncurses/man/wresize.3x.html#h2-PORTABILITY">
+ wresize</a> manual pages.</p>
+ </li>
+ </ul>
- <dd>
- <p>Modifies the file-format written by <code>putwin</code> to
- use printable text rather than binary files, allowing
- <code>getwin</code> to read screen dumps written by
- differently-configured ncurses libraries. The extended
- <code>getwin</code> can still read binary screen dumps from
- the <em>same</em> configuration of ncurses. This does not
- change the ABI (the binary interface seen by calling
- applications).</p>
- </dd>
+ <p>In addition to providing background information to explain
+ these features and show how they evolved, there are corrections,
+ clarifications, etc.:</p>
- <dt><code>--enable-interop</code></dt>
+ <ul>
+ <li>
+ <p>add note in the <a href=
+ "https://invisible-island.net/ncurses/man/curs_addch.3x.html#h3-ACS-Symbols">
+ <em>addch</em></a> manual about line-drawing when it depends
+ upon UTF-8.</p>
+ </li>
- <dd>
- <p>Modifies the <code>FIELDTYPE</code> structure used for the
- form library to make it more generic.</p>
- </dd>
+ <li>
+ <p>improve discussion of line-drawing characters in the
+ <a href=
+ "https://invisible-island.net/ncurses/man/curs_add_wch.3x.html">
+ <em>add_wch</em></a> manual.</p>
+ </li>
- <dt><code>--enable-lp64</code></dt>
+ <li>
+ <p>explain in <a href=
+ "https://invisible-island.net/ncurses/man/clear.1.html#h2-DESCRIPTION">
+ <span class="part-name">clear</span></a>'s manual page that
+ it writes to the standard output.</p>
+ </li>
- <dd>
- <p>Allows an application to define <code>_LP64</code> to
- declare <code>chtype</code> and <code>mmask_t</code> as
- simply “<code>unsigned</code>” rather than the
- configured types using the <code>--with-chtype</code> and
- <code>--with-mmask_t</code> options.</p>
- </dd>
+ <li>
+ <p>improve description of <a href=
+ "https://invisible-island.net/ncurses/man/curs_initscr.3x.html#h3-endwin">
+ <em>endwin</em></a>.</p>
+ </li>
- <dt><code>--enable-sp-funcs</code></dt>
+ <li>
+ <p>improve discussion of field validation in the <a href=
+ "https://invisible-island.net/ncurses/man/form_driver.3x.html">
+ <em>form driver</em></a> manual page.</p>
+ </li>
- <dd>
- <p>Compile-in support for extended functions which accept a
- SCREEN pointer, reducing the need for juggling the global SP
- value with <a href=
- "http://invisible-island.net/ncurses/man/curs_initscr.3x.html#h3-set_term">
- set_term</a> and <a href=
- "http://invisible-island.net/ncurses/man/curs_initscr.3x.html#h3-delscreen">
- delscreen</a>.</p>
- </dd>
+ <li>
+ <p>clarify the use of <code>wint_t</code> vs
+ <code>wchar_t</code> in <a href=
+ "https://invisible-island.net/ncurses/man/curs_get_wstr.3x.html#h2-RETURN-VALUE">
+ <em>get_wstr</em></a> manual page.</p>
+ </li>
- <dt><code>--with-chtype=uint32_t</code></dt>
+ <li>
+ <p>clarify in the <a href=
+ "https://invisible-island.net/ncurses/man/curs_getch.3x.html#h3-Predefined-key-codes">
+ <em>getch</em></a> manual that the keypad mode affects an
+ application's ability to read <code>KEY_MOUSE</code> codes,
+ but does not affect <code>KEY_RESIZE</code>.</p>
- <dd>
- <p>Makes <code>chtype</code> explicitly a 32-bit unsigned
- value.</p>
- </dd>
+ <p>trim some obsolete/incorrect wording about
+ <code>EINTR</code> from the <em>getch</em> manual page</p>
- <dt><code>--with-mmask_t=uint32_t</code></dt>
+ <p>improve manual pages for <a href=
+ "https://invisible-island.net/ncurses/man/curs_getch.3x.html#h3-Keypad-Mode">
+ <em>getch</em></a> and <a href=
+ "https://invisible-island.net/ncurses/man/curs_get_wch.3x.html#h2-DESCRIPTION">
+ <em>get_wch</em></a> to point out that they might return
+ user-defined values which have no predefined names in
+ <code><curses.h></code></p>
+ </li>
- <dd>
- <p>Makes <code>mmask_t</code> explicitly a 32-bit unsigned
- value.</p>
- </dd>
+ <li>
+ <p>improve description of the <code>-R</code> option in the
+ <a href=
+ "https://invisible-island.net/ncurses/man/infocmp.1m.html"><span class="part-name">
+ infocmp</span></a> manual page</p>
+ </li>
- <dt><code>--with-tparm-arg=intptr_t</code></dt>
+ <li>
+ <p>clarify in the <a href=
+ "https://invisible-island.net/ncurses/man/resizeterm.3x.html#h2-NOTES">
+ <em>resizeterm</em></a> manual page how
+ <code>KEY_RESIZE</code> is pushed onto the input stream.</p>
+ </li>
- <dd>
- <p>X/Open Curses declares <a href=
- "http://invisible-island.net/ncurses/man/curs_terminfo.3x.html#h3-Formatting-Output">
- tparm</a> using <code>long</code> for each of the parameters
- aside from the formatting string, presuming that
- <code>long</code> and <code>char*</code> are the same size.
- This configure option uses <code>intptr_t</code> which
- provides a better guarantee of the sizes.</p>
- </dd>
- </dl>
+ <li>
+ <p>document return value of <a href=
+ "https://invisible-island.net/ncurses/man/curs_extend.3x#h2-RETURN-VALUE">
+ <code>use_extended_names</code></a></p>
+ </li>
- <p>The configure script no longer checks for antique compilers;
- <code>c89</code> 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 <em class=
- "small-caps">ncurses</em> 6.0 with any of the current (or not so
- current) C compilers available in 2015.</p>
-
- <p>The configure script, by the way, makes changes which do not
- work with systems whose <code>/bin/sh</code> is non-POSIX. This
- mainly affects Solaris (the other vendor <em class=
- "small-caps">unix</em> systems have followed the POSIX guidelines
- for the past twenty years). If you must build on Solaris, its
- <a href=
- "http://docs.oracle.com/cd/E19253-01/html/817-0552/fhkpy.html">xpg4</a>
- binaries suffice, e.g.,</p>
-
- <blockquote class="code-block">
- <!--{{atr2html-->
-
- <p style="font-family: monospace; font-size: 10pt;">
- <font color="#800000">#!/bin/sh</font><br>
- <font color="#008080">WHAT</font>=<strong><em><font color=
- "#800000">`</font></em></strong>hostname|sed -e <font color="#800080">'s/\..*//'</font><strong><em><font color="#800000">`</font></em></strong><br>
-
- <font color="#008080">OUT</font>=configure.out<br>
- <strong><font color=
- "#000080">cat</font></strong> >><font color=
- "#008080">$OUT</font> <font color=
- "#800080"><<EOF/</font><font color="#800080"><br>
- ** </font><strong><em><font color=
- "#800000">`</font></em></strong>date<strong><em><font color=
- "#800000">`</font></em></strong><font color="#800080"><br>
- ** node: </font><font color=
- "#008080">$WHAT</font><font color="#800080"><br>
- ** user: </font><strong><em><font color=
- "#800000">`</font></em></strong>id<strong><em><font color=
- "#800000">`</font></em></strong><font color="#800080"><br>
- ** conf: $*<br>
- EOF/</font><br>
- <br>
- <font color="#008080">SHELL</font>=/bin/sh<br>
- <strong><font color=
- "#000080">if</font></strong> <strong><font color=
- "#000080">test</font></strong> -f /usr/xpg4/bin/sh<br>
-
- <strong><font color="#000080">then</font></strong><br>
- <font color=
- "#008080">CONFIG_SHELL</font>=/usr/xpg4/bin/sh<br>
- <strong><font color="#000080">export</font></strong> CONFIG_SHELL<br>
-
- <font color=
- "#008080">SHELL</font>=<font color=
- "#008080">$CONFIG_SHELL</font><br>
- <strong><font color="#000080">fi</font></strong><br>
- <br>
- rm -f config.status config.cache<br>
- <font color="#008080">TOP</font>=<font color=
- "#008080">$HOME</font>/<font color="#008080">$WHAT</font><br>
- <font color=
- "#008080">$SHELL</font> ./configure --verbose \<br>
-
- --disable-echo \<br>
-
- --disable-overwrite \<br>
-
- --enable-warnings \<br>
-
- --with-warnings \<br>
-
- --prefix=<font color="#008080">$TOP</font> <font color="#008080">$*</font> <strong><font color="#008080">2</font></strong>>&<strong><font color="#008080">1</font></strong> | tee -a <font color="#008080">$OUT</font><br>
-
- <!--atr2html}}--></p>
- </blockquote>
+ <li>
+ <p>document differences in <a href=
+ "https://invisible-island.net/ncurses/man/curs_variables.3x.html#h2-PORTABILITY">
+ <code>ESCDELAY</code></a> versus AIX's implementation in the
+ <em>variables</em> manual page.</p>
+ </li>
- <p>Other major changes to the configure script include:</p>
+ <li>
+ <p>The <code>_nc_free_tinfo</code> function is now documented
+ in the <a href=
+ "https://invisible-island.net/ncurses/man/curs_memleaks.3x.html">
+ <em>memory-leaks</em></a> manual page, because it could be
+ used in <span class="main-name">tack</span> for memory-leak
+ checking.</p>
+ </li>
- <ul>
<li>
- <p>ABI 6 is now the default, intending that the existing ABI
- 5 should build as before using the
- “<code>--with-abi-version=5</code>” option.</p>
+ <p>add a note to the <a href=
+ "https://invisible-island.net/ncurses/man/tic.1m.html"><span class="part-name">
+ tic</span></a> manual page about -W versus -f options.</p>
</li>
<li>
- <p>added <code>--with-extra-suffix</code> option to help with
- installing nonconflicting ncurses6 packages, e.g., avoiding
- header- and library-conflicts.</p>
+ <p>improve <em>terminfo manual</em> description of <a href=
+ "https://invisible-island.net/ncurses/man/terminfo.5.html#h3-Terminfo-Capabilities-Syntax">
+ terminfo syntax</a>.</p>
- <p><strong>NOTE:</strong> as a side-effect, this renames</p>
+ <p>improve terminfo manual page discussion of <a href=
+ "https://invisible-island.net/ncurses/man/terminfo.5.html#h3-Line-Graphics">
+ control- and graphics- characters</a>.</p>
- <blockquote>
- <p><code>adacurses-config</code> to
- <code>adacurses5-config</code> and<br>
- <code>adacursesw-config</code> to
- <code>adacursesw5-config</code></p>
- </blockquote>
+ <p>improve <a href=
+ "https://invisible-island.net/ncurses/man/terminfo.5.html#h3-Color-Handling">
+ color-handling</a> section in terminfo manual page</p>
+ </li>
+
+ <li>
+ <p>clarify description in <a href=
+ "https://invisible-island.net/ncurses/man/tput.1.html#h2-PORTABILITY">
+ <span class="part-name">tput</span></a> manual page regarding
+ support for termcap names</p>
+
+ <p>update <a href=
+ "https://invisible-island.net/ncurses/man/tput.1.html#h3-Aliases">
+ <span class="part-name">tput</span></a> manual page to
+ reflect changes to manipulate terminal modes by sharing
+ functions with <span class="part-name">tset</span>.</p>
+ </li>
+
+ <li>
+ <p>clarify in manual pages that the optional verbose option
+ level of <a href=
+ "https://invisible-island.net/ncurses/man/tic.1m.html#h2-OPTIONS">
+ <span class="part-name">tic</span></a> and <a href=
+ "https://invisible-island.net/ncurses/man/infocmp.1m.html#h3-Other-Options">
+ <span class="part-name">infocmp</span></a> is available only
+ when <span class="main-name">ncurses</span> is configured for
+ tracing.</p>
</li>
<li>
- <p>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.</p>
+ <p>improve manual page description of <a href=
+ "https://invisible-island.net/ncurses/man/tset.1.html"><em>tset/reset</em></a>
+ versus window-size.</p>
</li>
<li>
- <p>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.</p>
+ <p>improve description of <a href=
+ "https://invisible-island.net/ncurses/man/curs_termcap.3x.html#h3-FORMATTING-CAPABILITIES">
+ <em>tgoto</em></a> parameters</p>
</li>
</ul>
- <h4><a name="h4-config-options" id=
- "h4-config-options">Configuration options</a></h4>
+ <p>There are new manual pages:</p>
- <p>There are several new (or extended) configure options:</p>
+ <ul>
+ <li><a href=
+ "https://invisible-island.net/ncurses/man/user_caps.5.html"><em>
+ user_caps</em></a> documents the terminfo extensions used by
+ <span class="main-name">ncurses</span>.</li>
- <dl>
- <dt><code>--disable-db-install</code></dt>
+ <li>
+ <p><a href=
+ "https://invisible-island.net/ncurses/man/scr_dump.5.html"><em>
+ scr_dump</em></a> documents the screen-dump format.</p>
+ </li>
+ </ul>
- <dd>
- <p>Do not install the terminal database. This is used to omit
- features for packages, as done with
- <code>--without-progs</code>. The option simplifies building
- cross-compile support packages.</p>
- </dd>
+ <p>Some of the improvements are more subtle, relating to the way
+ the information is presented:</p>
- <dt><code>--disable-gnat-projects</code></dt>
+ <ul>
+ <li>
+ <p>Made minor fixes to manpage <em>NAME/SYNOPSIS</em>
+ sections to consistently use rule that either all functions
+ which are prototyped in <em>SYNOPSIS</em> are listed in the
+ <em>NAME</em> section, or the manual-page name is the sole
+ item listed in the <em>NAME</em> 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 <a href=
+ "https://invisible-island.net/ncurses/man/curs_sp_funcs.3x.html">
+ <em>SP-funcs</em></a> and <a href=
+ "https://invisible-island.net/ncurses/man/curs_threads.3x.html">
+ <em>threading</em></a>.</p>
+ </li>
- <dd>
- <p>This option is used for regression testing</p>
- </dd>
+ <li>
+ <p>improve manual pages for utilities with respect to POSIX
+ versus X/Open Curses.</p>
+ </li>
- <dt><code>--disable-lib-suffixes</code></dt>
+ <li>
+ <p>improve organization of the <a href=
+ "https://invisible-island.net/ncurses/man/curs_attr.3x.html"><em>
+ attributes</em></a> and <a href=
+ "/ncurses/man/curs_color.3x.html"><em>color</em></a> manual
+ pages.</p>
+ </li>
+ </ul>
- <dd>
- <p>Suppress the “w”, “t” or
- “tw” suffixes which normally would be added to
- the library names for the <code>--enable-widec</code> and
- <code>--with-pthread</code> options.</p>
- </dd>
+ <h3><a name="h3-bug-fixes" id="h3-bug-fixes">Interesting
+ bug-fixes</a></h3>
- <dt><code>--with-cxx-shared</code></dt>
+ <ul>
+ <li>
+ <p>modify <span class="part-name">toe</span> to not exit if
+ unable to read a terminal description, e.g., if there is a
+ permission problem.</p>
+ </li>
- <dd>
- <p>When <code>--with-shared</code> 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.</p>
- </dd>
+ <li>
+ <p>correct 20100515 change for weak signals versus
+ sigprocmask</p>
+ </li>
- <dt><code>--with-hashed-db</code></dt>
+ <li>work around Ada tool-breakage in Debian 9 and later by
+ invoking <code>gprconfig</code> to specify the C compiler to be
+ used by <code>gnatmake</code>, and conditionally suppressing
+ <code>Library_Options</code> line for static libraries.</li>
- <dd>
- <p>Extended this configure option to simplify building with
- different versions of Berkeley database using FreeBSD
- ports.</p>
- </dd>
+ <li>
+ <p>There were, as well, several bug-fixes to handle illegal
+ input for <span class="part-name">tic</span>. Because those
+ did not correspond to useful terminal descriptions, most
+ users are unaffected.</p>
+ </li>
+ </ul>
- <dt><code>--with-pc-suffix</code></dt>
+ <h3><a name="h3-config-config" id=
+ "h3-config-config">Configuration changes</a></h3>
- <dd>
- <p>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.</p>
- </dd>
+ <h4><a name="h4-config-major" id="h4-config-major">Major
+ changes</a></h4>
- <dt><code>--with-xterm-kbs</code></dt>
+ <p>This release provides a new binary format for terminal
+ descriptions that use extended numeric capabilities. Applications
+ built with the wide-character <em>ncursesw</em> library can use
+ these extended numbers.</p>
- <dd>
- <p>Configure xterm's terminfo entries to use either BS
- (<code>^H</code>, i.e., ASCII backspace) or DEL
- (<code>^?</code>, or 127).</p>
- </dd>
- </dl>
+ <ul>
+ <li>
+ <p>This includes utilities such as <span class=
+ "part-name">tic</span> and <span class=
+ "part-name">infocmp</span>, because (as noted in <a href=
+ "#h4-new-library"><em>New features</em></a>), the feature
+ relies upon an extension to the low-level <em>tinfo</em>
+ library.</p>
+ </li>
- <h3><a name="h3-portability" id=
- "h3-portability">Portability</a></h3>
+ <li>
+ <p>A few software packagers use a configuration option of
+ <span class="main-name">ncurses</span> which allows the
+ low-level <em>tinfo</em> library to be shared between the
+ high-level <em>ncurses</em> and <em>ncursesw</em> libraries.
+ This new feature was designed to work in that configuration
+ as well.</p>
+ </li>
+ </ul>
+
+ <p>Other applications (i.e., using the 8-bit <em>ncurses</em>
+ library) which read the extended terminal descriptions see those
+ numeric capabilities set to the maximum value for a signed 16-bit
+ number.</p>
- <h4><a name="h4-port-mingw" id="h4-port-mingw">MinGW</a></h4>
+ <p>Older versions of <span class="main-name">ncurses</span>'
+ <span class="part-name">tic</span> 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 <a href=
+ "https://invisible-island.net/ncurses/ncurses-slang.html#compare_picsmap">
+ <span class="part-name">picsmap</span></a>) give zero for these
+ out-of-range capabilities.</p>
- <p>Most of the portability-related work since <a href=
- "http://invisible-island.net/ncurses/announce-5.9.html"><em class="small-caps">
- ncurses</em> 5.9</a> extended and improved the MinGW port
- introduced in <a href=
- "http://invisible-island.net/ncurses/announce-5.8.html"><em class="small-caps">
- ncurses</em> 5.8</a>.</p>
+ <h4><a name="h4-config-options" id=
+ "h4-config-options">Configuration options</a></h4>
- <p>The MinGW port can be readily cross-compiled:</p>
+ <p>These changes provide support for <span class=
+ "main-name">tack</span> 1.08, released in <a href=
+ "https://invisible-island.net/ncurses/tack/CHANGES.html#index-t20170726">
+ July 2017</a>:</p>
<ul>
<li>
- <p>modified configure script to allow creating dll's for
- MinGW when cross-compiling.</p>
+ <p>add <code>--without-tack</code> configure option to refine
+ <code>--with-progs</code> configure option. Normally
+ <span class="main-name">tack</span> is built outside the
+ <span class="main-name">ncurses</span> tree, but a few
+ packagers combine it during the build. If
+ <code>term_entry.h</code> is installed, there is no advantage
+ to in-tree builds.</p>
</li>
<li>
- <p>enforced Windows-style path-separator if
- cross-compiling,</p>
+ <p>adjust configure-script to define
+ <code>HAVE_CURSES_DATA_BOOLNAMES</code> symbol needed for
+ <span class="main-name">tack</span> 1.08 when built in-tree.
+ Rather than relying upon internal "_nc_" functions,
+ <span class="main-name">tack</span> now uses the boolean,
+ number and string capability name-arrays provided by
+ <span class="main-name">ncurses</span> and SVr4 Unix curses.
+ It still uses <code>term_entry.h</code> for the definitions
+ of the extended capability arrays.</p>
</li>
<li>
- <p>added scripts for test-builds of cross-compiled packages
- for ncurses6 to MinGW.</p>
+ <p>add dependency upon ncurses_cfg.h to <span class=
+ "part-name">tic</span>'s header-files; any program using
+ <span class="part-name">tic</span>-library will have to
+ supply this file. Legacy <span class="main-name">tack</span>
+ versions supply this file; ongoing <span class=
+ "main-name">tack</span> development has dropped the
+ dependency upon <span class="part-name">tic</span>-library
+ and new releases will not be affected.</p>
</li>
+ </ul>
+
+ <p>Other changes to the configure-script and generated files
+ include</p>
+ <ul>
<li>
- <p>added pc-files to the MinGW cross-compiling
- test-packages.</p>
+ <p>add configure options to disable checks for form, menu and
+ panel libraries so that ncurses-examples can be built with
+ non-SVr4 curses implementations.</p>
</li>
<li>
- <p>added script for building test-packages of binaries
- cross-compiled to MinGW using NSIS.</p>
+ <p>add configure option <code>--enable-opaque-curses</code>
+ for <em>ncurses</em> library and similar options for the
+ other libraries.</p>
</li>
<li>
- <p>added <code>nc_mingw.h</code> to installed headers for
- MinGW port; this is needed for cross-compiling <a href=
- "http://invisible-island.net/ncurses/ncurses-examples.html">ncurses-examples</a>.</p>
+ <p>add configure option <code>--disable-wattr-macros</code>
+ for use in cases where one wants to use the same headers for
+ ncurses5/ncurses6 development, by suppressing the
+ <em>wattr*</em> macros which differ due to the introduction
+ of extended colors</p>
</li>
<li>
- <p>added test-packages for cross-compiling ncurses-examples
- using the MinGW test-packages.</p>
+ <p>modify configure macro for shared-library rules to use
+ <code>-Wl,-rpath</code> rather than <code>-rpath</code> to
+ work around a bug in <span class="part-name">scons</span></p>
</li>
- </ul>
- <p>The MinGW-specific Windows driver accounts for several
- changes:</p>
-
- <ul>
<li>
- <p>wide-character display is made usable by replacing MinGW's
- non-working <code>wcrtomb</code> and <code>wctomb</code>
- functions.</p>
+ <p>improve ncurses-examples' configure script to define as
+ needed <code>NCURSES_WIDECHAR</code> for platforms where
+ <code>_XOPEN_SOURCE_EXTENDED</code> does not work. Also
+ modified the test program to ensure that if building with
+ <span class="main-name">ncurses</span>, that the
+ <code>cchar_t</code> type is checked, since that is normally
+ (since <a href=
+ "https://invisible-island.net/ncurses/NEWS.html#t20111030">20111030</a>)
+ ifdef'd depending on this test.</p>
</li>
<li>
- <p>implemented some display features: <a href=
- "http://invisible-island.net/ncurses/man/curs_beep.3x.html">beep</a>,
- <a href=
- "http://invisible-island.net/ncurses/man/curs_beep.3x.html">flash</a>,
- <a href=
- "http://invisible-island.net/ncurses/man/curs_kernel.3x.html#h3-curs_set">
- curs_set</a>.</p>
+ <p>modify configure script to handle the case where
+ <span class="part-name">tic</span>-library is renamed, but
+ the <code>--with-debug</code> option is used by itself
+ without normal or shared libraries</p>
</li>
<li>
- <p>the driver handles repainting on endwin/refresh
- combination.</p>
+ <p>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.</p>
</li>
<li>
- <p>modified treatment of <code>TERM</code> variable for MinGW
- port to allow explicit use of the Windows console driver by
- checking if <code>$TERM</code> is set to
- “<code>#win32console</code>” or an abbreviation
- of that.</p>
+ <p>improve configure check for setting the
+ <code>WILDCARD_SYMS</code> variable; on ppc64 the variable is
+ in the <strong><em>Data</em></strong> section rather than
+ <strong><em>Text</em></strong>.</p>
</li>
<li>
- <p>the Windows driver also matches the special
- <code>TERM</code> value “unknown”</p>
+ <p>correct result of configure option
+ <code>--without-fallbacks</code>, which caused FALLBACK_LIST
+ to be set to "no"</p>
</li>
<li>
- <p>the driver now returns characters for special keys, (like
- <code>ansi.sys</code> does), when keypad mode is off, rather
- than returning nothing at all.</p>
+ <p>modify <code>--with-pkg-config-libdir</code> option to
+ make it possible to install “.pc” files even if
+ <span class="part-name">pkg-config</span> is not found. Limit
+ this change, to suppress the actual install if it is not
+ overridden to a valid directory at install time.</p>
</li>
<li>
- <p>the driver checks a new environment variable <a href=
- "http://invisible-island.net/ncurses/man/ncurses.3x.html#h3-NCURSES_CONSOLE2">
- NCURSES_CONSOLE2</a> to optionally work around a deficiency
- in <code>Console2</code> (and its descendent
- <code>ConsoleZ</code>) which hang when an application creates
- a console buffer.</p>
+ <p>disallow “no” as a possible value for
+ <code>--with-shlib-version</code> option, overlooked in
+ cleanup-changes for <a href=
+ "https://invisible-island.net/ncurses/NEWS.html#t20000708">20000708</a>.</p>
</li>
</ul>
- <p>Finally, there are other improvements:</p>
+ <h3><a name="h3-portability" id=
+ "h3-portability">Portability</a></h3>
+
+ <p>Many of the portability changes are implemented via the
+ configure script:</p>
<ul>
<li>
- <p>MinGW is one of the configurations where <em class=
- "small-caps">ncurses</em> installs by default into /usr</p>
+ <p>improve configure script's <code>CF_CC_ENV_FLAGS</code>
+ macro to allow for compiler wrappers such as <span class=
+ "part-name">ccache</span>. This change moves only the
+ preprocessor, optimization and warning flags to
+ <code>CPPFLAGS</code> and <code>CFLAGS</code>, leaving the
+ residue in <code>CC</code>. That happens to work for
+ <span class="part-name">gcc</span>'s various
+ “model” options, but may require tuning for other
+ compilers.</p>
</li>
- <li>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.</li>
-
<li>
- <p>extend Windows support to work with MSYS2;</p>
-
- <ul>
- <li>
- <p>this works with a scenario where there is an
- ANSI-escape handler such as <code>ansicon</code> running
- in the console window.</p>
- </li>
-
- <li>wrap <code>isatty</code> calls with a macro, provide a
- corresponding set of support routines to address
- differences between MinGW and MSYS2.</li>
- </ul>
+ <p>modify ncurses-examples' configure script to use
+ <span class="part-name">pkg-config</span> for the extra
+ form/menu/panel libraries, to be more consistent with the
+ handling of the curses/ncurses library.</p>
</li>
<li>
- <p>ensure <code>WINVER</code> is defined in makefiles rather
- than using headers.</p>
+ <p>add configuration checks to build with <a href=
+ "https://invisible-island.net/ncurses/ncurses-netbsd.html">NetBSD
+ curses</a>, which for example lacks <a href=
+ "https://invisible-island.net/ncurses/man/curs_util.3x.html#h3-use_env">
+ <code>use_env</code></a>.</p>
</li>
<li>
- <p>add check for the <code>gnatprep</code>
- “<code>-T</code>” option.</p>
+ <p>change ncurses-examples to use <code>attr_t</code> vs
+ <code>chtype</code> to follow X/Open documentation more
+ closely since Solaris xpg4-curses uses different values for
+ <code>WA_<em>xxx</em></code> vs <code>A_<em>xxx</em></code>
+ that rely on attr_t being an unsigned short. Tru64 aka OSF1,
+ HPUX, AIX did as <span class="main-name">ncurses</span> does,
+ equating the two sets.</p>
</li>
<li>
- <p>work around a bug introduced by <a href=
- "http://stackoverflow.com/questions/20877689/gcc-4-8-1-minggw-d-option-does-not-work-as-usual">
- gcc 4.8.1</a> in MinGW which breaks "trace" feature.</p>
+ <p>modify several test programs to reflect that <span class=
+ "main-name">ncurses</span> honors existing signal handlers in
+ initscr, while other implementations do not.</p>
</li>
<li>
- <p>add a driver-name method to each of the drivers.</p>
+ <p>add configure check for <code>openpty</code> to
+ ncurses-examples' configure script, for <span class=
+ "part-name">ditto</span>.</p>
</li>
- </ul>
-
- <h4><a name="h4-port-systems" id="h4-port-systems">Other
- ports</a></h4>
- <p>These changes affect certain platforms (ports):</p>
+ <li>
+ <p>improve check for working <code>poll</code> function by
+ using <code>posix_openpt</code> as a fallback in case there
+ is no valid terminal on the standard input</p>
+ </li>
- <ul>
<li>
- <p>the configure script knows how to build shared libraries
- with DragonFlyBSD and Interix.</p>
+ <p>modify ncurses-examples' configure script to check for
+ <span class="part-name">pthread</span> dependency of
+ <em>ncursest</em> or <em>ncursestw</em> library when building
+ the <span class="main-name">ncurses</span> examples, e.g., in
+ case weak symbols are used.</p>
</li>
<li>
- <p>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:</p>
+ <p>add checks in ncurses-examples' configure script for some
+ functions neither in 4.3BSD curses, nor based on X/Open
+ Curses:</p>
<ul>
<li>
- <p>the shared-library suffix for AIX 5 and 6 is now
- ".so"</p>
+ <p>modify a loop limit in firework.c to work around
+ absense of limit checks in some libraries.</p>
</li>
<li>
- <p>the <code>-brtl</code> option is used with AIX 5-7; it
- is needed to link with the shared libraries.</p>
+ <p>fill the last row of a window with
+ “<code>?</code>” in firstlast if waddch does
+ not return <code>ERR</code> on the lower-right
+ corner.</p>
</li>
</ul>
</li>
<li>
- <p>the configure <code>--enable-pc-files</code> option takes
- into account the <a href=
- "http://linux.die.net/man/1/pkg-config"><code>PKG_CONFIG_PATH</code></a>
- variable.</p>
- </li>
+ <p>build-fixes for the Portland Group (PGI) compilers</p>
- <li>
- <p>the configure option <code>--with-pkg-config-libdir</code>
- provides control over the actual directory into which
- pc-files are installed.</p>
- </li>
+ <ul>
+ <li>
+ <p>accept whitespace in <span class=
+ "part-name">sed</span> expression for generating
+ expanded.c</p>
+ </li>
- <li>
- <p>the build scripts add explicit -ltinfo, etc., to the
- generated ".pc" file when <code>ld</code> option
- “<code>--as-needed</code>” is used, or when
- ncurses and tinfo are installed without using rpath.</p>
+ <li>
+ <p>modify configure check that g++ compiler warnings are
+ not used.</p>
+ </li>
+
+ <li>
+ <p>add configure check for -fPIC option needed for shared
+ libraries.</p>
+ </li>
+ </ul>
</li>
<li>
- <p>the configure script disallows conflicting options
- “<code>--with-termlib</code>” and
- “<code>--enable-term-driver</code>”.</p>
+ <p>modify configure script for clang as used on FreeBSD, to
+ work around clang's differences in exit codes vs gcc.</p>
</li>
<li>
- <p>the check for missing c++ compiler to work when no error
- is reported, and no variables set is improved (see note for
- <a href=
- "http://invisible-island.net/ncurses/NEWS.html#t20021206">20021206</a>).</p>
+ <p>fixes for configure/build using clang on OSX</p>
+
+ <ul>
+ <li>
+ <p>do not redefine “inline” in
+ <code>ncurses_cfg.h</code>; this was originally to solve
+ a problem with gcc/g++, but is aggravated by clang's
+ misuse of symbols to pretend it is gcc.</p>
+ </li>
+
+ <li>
+ <p>add braces to configure script to prevent unwanted
+ addition of “<code>-lstdc++</code>” option to
+ the <code>CXXLIBS</code> symbol.</p>
+ </li>
+
+ <li>
+ <p>improve/update test-program used for checking
+ existence of stdc++ library.</p>
+ </li>
+
+ <li>
+ <p>if <code>$CXXLIBS</code> is set, the linkage test uses
+ that in addition to <code>$LIBS</code>.</p>
+ </li>
+ </ul>
</li>
<li>
- <p>the misc/gen_edit.sh script selects a "linux" entry which
- works with the current kernel rather than assuming it is
- always "linux3.0"</p>
+ <p>fixes for OS/2:</p>
+
+ <ul>
+ <li>
+ <p>use button instead of <code>kbuf[0]</code> in
+ EMX-specific part of <code>lib_mouse.c</code></p>
+ </li>
+
+ <li>
+ <p>support building with <span class=
+ "part-name">libtool</span> on OS/2</p>
+ </li>
+
+ <li>
+ <p>use stdc++ library with OS/2 kLIBC</p>
+ </li>
+
+ <li>
+ <p>clear configure script's <code>cf_XOPEN_SOURCE</code>
+ for OS/2, to work with its header files</p>
+ </li>
+ </ul>
</li>
<li>
- <p>the test/configure script makes it simpler to override
- names of curses-related libraries, to help with linking with
- pdcurses in MinGW environment.</p>
+ <p>add “newer” baudrate symbols to the <a href=
+ "https://invisible-island.net/ncurses/man/curs_termattrs.3x.html#h3-baudrate">
+ <code>baudrate</code></a> function in the ncurses library as
+ well as to a corresponding table in <span class=
+ "part-name">tset</span>.</p>
</li>
<li>
- <p>the configure-script/ifdef's allow the BSD OLD_TTY feature
- to be suppressed if the type of <code>ospeed</code> is
- configured using the option <code>--with-ospeed</code> to not
- be a <code>short</code>. By default, it is a
- <code>short</code> for termcap-compatibility.</p>
+ <p>modify ncurses-examples <span class=
+ "part-name">savescreen</span> to work with AIX and HPUX.</p>
</li>
<li>
- <p>the MKlib_gen.sh script works around a recent change in
- gcc 5 (released <a href=
- "https://gcc.gnu.org/gcc-5/">mid-2015</a>) which essentially
- emits multiple <code>#line</code> statements for the same
- position in a file.</p>
+ <p>define <code>WIN32_LEAN_AND_MEAN</code> for MinGW port,
+ making builds faster.</p>
</li>
<li>
- <p>the configure script works with Minix3.2 (see <a href=
- "http://invisible-island.net/autoconf/portability-test.html">note</a>
- on portability)</p>
+ <p>add a configure check for <em>wcwidth</em> versus the
+ <span class="main-name">ncurses</span> 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.</p>
</li>
<li>
- <p>OS/2 redux:</p>
+ <p>string-hacks (non-standard):</p>
<ul>
<li>
- <p>the configure script supports OS/2 kLIBC.</p>
+ <p>fix configure script to record when
+ <code>strlcat</code> is found on OpenBSD.</p>
+ </li>
+
+ <li>
+ <p>add <code>--enable-string-hacks</code> option to
+ ncurses-examples' configure script.</p>
</li>
<li>
- <p>the <code>--with-lib-prefix</code> option allows
- configuring for old/new flavors of OS/2 EMX.</p>
+ <p>completed string-hacks for <em>sprintf</em>, etc.,
+ including the ncurses-examples programs.</p>
+ </li>
+
+ <li>
+ <p>make <code>--enable-string-hacks</code> option work
+ with Debian by checking for the "bsd" library and its
+ associated "<bsd/string.h>" header.</p>
</li>
</ul>
</li>
<li>
- <p>improved configure-script checks for
- <code>_XOPEN_SOURCE</code>:</p>
+ <p>workaround for Debian's antique/unmaintained version of
+ mawk:</p>
<ul>
<li>
- <p>the definition works starting with Solaris 10.</p>
+ <p>see Debian #65617, which was fixed in <span class=
+ "main-name">mawk</span>'s upstream releases in <a href=
+ "https://invisible-island.net/mawk/CHANGES.html#t20090727">
+ 2009</a>.</p>
</li>
<li>
- <p>the definition is suppressed for IRIX64, since its
- header files have a conflict versus
- <code>_SGI_SOURCE</code>.</p>
+ <p>related fixes when building link_test.</p>
</li>
</ul>
</li>
</ul>
<hr>
- <h2><a name="h2-features" id="h2-features">Features of <em class=
- "small-caps">ncurses</em></a></h2>
+ <h2><a name="h2-features" id="h2-features">Features of
+ <span class="main-name">ncurses</span></a></h2>
- <p>The <em class="small-caps">ncurses</em> package is fully
+ <p>The <span class="main-name">ncurses</span> package is fully
upward-compatible with SVr4 (System V Release 4) curses:</p>
<ul>
</li>
<li>
- <p><em class="small-caps">ncurses</em> supports all of the
+ <p><span class="main-name">ncurses</span> 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.</p>
</li>
<li>
- <p><em class="small-caps">ncurses</em> provides these SVr4
+ <p><span class="main-name">ncurses</span> provides these SVr4
add-on libraries (not part of X/Open Curses):</p>
<ul>
</li>
<li>
- <p><em class="small-caps">ncurses</em>'s terminal database is
- fully compatible with that used by SVr4 curses.</p>
+ <p><span class="main-name">ncurses</span>'s terminal database
+ is fully compatible with that used by SVr4 curses.</p>
<ul>
- <li><em class="small-caps">ncurses</em> supports
- user-defined capabilities which it can see, but which are
- hidden from SVr4 curses applications using the
- <em>same</em> terminal database.</li>
+ <li>
+ <p><span class="main-name">ncurses</span> supports
+ user-defined capabilities which it can see, but which are
+ hidden from SVr4 curses applications using the
+ <em>same</em> terminal database.</p>
+ </li>
<li>
<p>It can be optionally configured to match the format
</li>
<li>
- <p>Alternatively, <em class="small-caps">ncurses</em> can
- be configured to use hashed databases rather than the
+ <p>Alternatively, <span class="main-name">ncurses</span>
+ can be configured to use hashed databases rather than the
directory of files used by SVr4 curses.</p>
</li>
</ul>
</li>
<li>
- <p>The <em class="small-caps">ncurses</em> utilities have
+ <p>The <span class="main-name">ncurses</span> utilities have
options to allow you to filter terminfo entries for use with
less capable <em>curses</em>/<em>terminfo</em> versions such
as the HP/UX and AIX ports.</p>
</li>
</ul>
- <p>The <em class="small-caps">ncurses</em> package also has many
- useful extensions over SVr4:</p>
+ <p>The <span class="main-name">ncurses</span> package also has
+ many useful extensions over SVr4:</p>
<ul>
<li>
</li>
<li>
- <p>Unlike SVr3 curses, <em class="small-caps">ncurses</em>
+ <p>Unlike SVr3 curses, <span class="main-name">ncurses</span>
can write to the rightmost-bottommost corner of the screen if
your terminal has an insert-character capability.</p>
</li>
<li>
<p>The functions <code>keyok</code> and
<code>define_key</code> allow you to better control the use
- of function keys, e.g., disabling the <em class=
- "small-caps">ncurses</em> KEY_MOUSE, or by defining more than
- one control sequence to map to a given key code.</p>
+ of function keys, e.g., disabling the <span class=
+ "main-name">ncurses</span> KEY_MOUSE, or by defining more
+ than one control sequence to map to a given key code.</p>
</li>
<li>
<li>
<p>The <a href=
- "http://invisible-island.net/ncurses/man/tic.1m.html">tic</a>/<a href="http://invisible-island.net/ncurses/man/captoinfo.1m.html">captoinfo</a>
- utility provided with <em class="small-caps">ncurses</em> has
- the ability to translate many termcaps from the XENIX, IBM
- and AT&T extension sets.</p>
+ "https://invisible-island.net/ncurses/man/tic.1m.html"><span class="part-name">
+ tic</span></a>/<a href=
+ "https://invisible-island.net/ncurses/man/captoinfo.1m.html">captoinfo</a>
+ utility provided with <span class="main-name">ncurses</span>
+ has the ability to translate many termcaps from the XENIX,
+ IBM and AT&T extension sets.</p>
</li>
<li>
<p>A BSD-like <a href=
- "http://invisible-island.net/ncurses/man/tset.1.html">tset</a>
- utility is provided.</p>
+ "https://invisible-island.net/ncurses/man/tset.1.html"><span class="part-name">
+ tset</span></a> utility is provided.</p>
</li>
<li>
- <p>The <em class="small-caps">ncurses</em> library and
+ <p>The <span class="main-name">ncurses</span> 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
<li>
<p>The table-of-entries utility <a href=
- "http://invisible-island.net/ncurses/man/toe.1m.html">toe</a>
- makes it easy for users to see exactly what terminal types
- are available on the system.</p>
+ "https://invisible-island.net/ncurses/man/toe.1m.html"><span class="part-name">
+ toe</span></a> makes it easy for users to see exactly what
+ terminal types are available on the system.</p>
</li>
<li>
<li>
<p>Extensive documentation is provided (see the <em><a href=
- "http://invisible-island.net/ncurses/ncurses.faq.html#additional_reading">
+ "https://invisible-island.net/ncurses/ncurses.faq.html#additional_reading">
Additional Reading</a></em> section of the <em><a href=
- "http://invisible-island.net/ncurses/ncurses.faq.html"><em class="small-caps">
- ncurses</em> FAQ</a></em> for online documentation).</p>
+ "https://invisible-island.net/ncurses/ncurses.faq.html"><span class="main-name">
+ ncurses</span> FAQ</a></em> for online documentation).</p>
</li>
</ul>
<h2><a name="h2-who-uses" id="h2-who-uses">Applications using
- <em class="small-caps">ncurses</em></a></h2>
+ <span class="main-name">ncurses</span></a></h2>
- <p>The <em class="small-caps">ncurses</em> distribution includes
- a selection of test programs (including a few games). These are
- available separately as <a href=
- "http://invisible-island.net/ncurses/ncurses-examples.html">ncurses-examples</a></p>
+ <p>The <span class="main-name">ncurses</span> distribution
+ includes a selection of test programs (including a few games).
+ These are available separately as <a href=
+ "https://invisible-island.net/ncurses/ncurses-examples.html">ncurses-examples</a></p>
<p>The ncurses library has been tested with a wide variety of
applications including:</p>
<blockquote>
<dl>
- <dt>cdk</dt>
+ <dt><span class="part-name">aptitude</span></dt>
+
+ <dd>
+ <p>FrontEnd to Apt, the debian package manager</p>
+
+ <p><a href=
+ "https://wiki.debian.org/Aptitude">https://wiki.debian.org/Aptitude</a></p>
+ </dd>
+
+ <dt><span class="part-name">cdk</span></dt>
<dd>
<p>Curses Development Kit</p>
<p><a href=
- "http://invisible-island.net/cdk/">http://invisible-island.net/cdk/</a><br>
+ "https://invisible-island.net/cdk/">https://invisible-island.net/cdk/</a><br>
</p>
</dd>
- <dt>ded</dt>
+ <dt><span class="part-name">ded</span></dt>
<dd>
<p>directory-editor</p>
<p><a href=
- "http://invisible-island.net/ded/">http://invisible-island.net/ded/</a></p>
+ "https://invisible-island.net/ded/">https://invisible-island.net/ded/</a></p>
</dd>
- <dt>dialog</dt>
+ <dt><span class="part-name">dialog</span></dt>
<dd>
<p>the underlying application used in Slackware's setup,
many systems.</p>
<p><a href=
- "http://invisible-island.net/dialog/">http://invisible-island.net/dialog/</a></p>
+ "https://invisible-island.net/dialog/">https://invisible-island.net/dialog/</a></p>
</dd>
- <dt>lynx</dt>
+ <dt><span class="part-name">lynx</span></dt>
<dd>
<p>the text WWW browser</p>
<p><a href=
- "http://lynx.isc.org/">http://lynx.isc.org/</a></p>
+ "https://lynx.invisible-island.net/">https://lynx.invisible-island.net/</a></p>
</dd>
- <dt>Midnight Commander</dt>
+ <dt><span class="part-name">mutt</span></dt>
<dd>
- <p>file manager</p>
+ <p>mail utility</p>
<p><a href=
- "http://www.midnight-commander.org/">http://www.midnight-commander.org/</a></p>
+ "http://www.mutt.org/">http://www.mutt.org/</a></p>
</dd>
- <dt>mutt</dt>
+ <dt><span class="part-name">ncftp</span></dt>
<dd>
- <p>mail utility</p>
+ <p>file-transfer utility</p>
<p><a href=
- "http://www.mutt.org/">http://www.mutt.org/</a></p>
+ "https://www.ncftp.com/">https://www.ncftp.com/</a></p>
</dd>
- <dt>ncftp</dt>
+ <dt><span class="part-name">nvi</span></dt>
<dd>
- <p>file-transfer utility</p>
+ <p>New vi uses ncurses.</p>
<p><a href=
- "http://www.ncftp.com/">http://www.ncftp.com/</a></p>
+ "https://sites.google.com/a/bostic.com/keithbostic/vi">https://sites.google.com/a/bostic.com/keithbostic/vi</a><br>
+ </p>
</dd>
- <dt>nvi</dt>
+ <dt><span class="part-name">ranger</span></dt>
<dd>
- <p>New vi uses ncurses.</p>
+ <p>A console file manager with VI key bindings in
+ <em>Python</em>.</p>
<p><a href=
- "https://sites.google.com/a/bostic.com/keithbostic/nvi">https://sites.google.com/a/bostic.com/keithbostic/nvi</a><br>
- </p>
+ "https://ranger.github.io/">https://ranger.github.io/</a></p>
</dd>
- <dt>tin</dt>
+ <dt><span class="part-name">tin</span></dt>
<dd>
<p>newsreader, supporting color, MIME</p>
<p><a href=
"http://www.tin.org/">http://www.tin.org/</a></p>
</dd>
+
+ <dt><span class="part-name">vifm</span></dt>
+
+ <dd>
+ <p>File manager with vi like keybindings</p>
+
+ <p><a href="https://vifm.info/">https://vifm.info/</a></p>
+ </dd>
</dl>
</blockquote>
- <p>as well as some that use <em class="small-caps">ncurses</em>
- for the terminfo support alone:</p>
+ <p>as well as some that use <span class=
+ "main-name">ncurses</span> for the terminfo support alone:</p>
<blockquote>
<dl>
- <dt>minicom</dt>
+ <dt><span class="part-name">minicom</span></dt>
<dd>
<p>terminal emulator for serial modem connections</p>
<p><a href=
- "http://alioth.debian.org/projects/minicom/">http://alioth.debian.org/projects/minicom/</a></p>
+ "https://alioth.debian.org/projects/minicom/">https://alioth.debian.org/projects/minicom/</a></p>
</dd>
- <dt>mosh</dt>
+ <dt><span class="part-name">mosh</span></dt>
<dd>
<p>a replacement for <code>ssh</code>.</p>
"https://mosh.mit.edu/">https://mosh.mit.edu/</a></p>
</dd>
- <dt>tack</dt>
+ <dt><span class="part-name">tack</span></dt>
<dd>
<p>terminfo action checker</p>
<p><a href=
- "http://invisible-island.net/ncurses/tack.html">http://invisible-island.net/ncurses/tack.html</a></p>
+ "https://invisible-island.net/ncurses/tack.html">https://invisible-island.net/ncurses/tack.html</a></p>
</dd>
- <dt>tmux</dt>
+ <dt><span class="part-name">tmux</span></dt>
<dd>
<p>terminal multiplexor</p>
<p><a href=
- "http://tmux.github.io/">http://tmux.github.io/</a></p>
+ "https://github.com/tmux/tmux/wiki">https://github.com/tmux/tmux/wiki</a></p>
</dd>
- <dt>vile</dt>
+ <dt><span class="part-name">vile</span></dt>
<dd>
<p>vi-like-emacs may be built to use the terminfo, termcap
or curses interfaces.</p>
<p><a href=
- "http://invisible-island.net/vile/">http://invisible-island.net/vile/</a></p>
+ "https://invisible-island.net/vile/">https://invisible-island.net/vile/</a></p>
</dd>
</dl>
</blockquote>
<blockquote>
<dl>
- <dt>emacs</dt>
+ <dt><span class="part-name">emacs</span></dt>
<dd>
<p>text editor</p>
<p><a href=
- "http://www.gnu.org/software/emacs/">http://www.gnu.org/software/emacs/</a></p>
+ "https://www.gnu.org/software/emacs/">https://www.gnu.org/software/emacs/</a></p>
+ </dd>
+
+ <dt><span class="part-name">less</span></dt>
+
+ <dd>
+ <p>The most commonly used <em>pager</em> (a program that
+ displays text files).</p>
+
+ <p><a href=
+ "http://www.greenwoodsoftware.com/less/">http://www.greenwoodsoftware.com/less/</a></p>
</dd>
- <dt>screen</dt>
+ <dt><span class="part-name">screen</span></dt>
<dd>
<p>terminal multiplexor</p>
<p><a href=
- "http://www.gnu.org/software/screen/">http://www.gnu.org/software/screen/</a></p>
+ "https://www.gnu.org/software/screen/">https://www.gnu.org/software/screen/</a></p>
</dd>
- <dt>vim</dt>
+ <dt><span class="part-name">vim</span></dt>
<dd>
<p>text editor</p>
<p><a href=
- "http://www.vim.org/">http://www.vim.org/</a></p>
+ "https://www.vim.org/">https://www.vim.org/</a></p>
</dd>
</dl>
</blockquote>
<h2><a name="h2-development" id="h2-development">Development
activities</a></h2>
- <p>Zeyd Ben-Halim started <em class="small-caps">ncurses</em>
+ <p>Zeyd Ben-Halim started <span class="main-name">ncurses</span>
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
<a href="mailto:dickey@invisible-island.net">Thomas Dickey</a>.
Thomas Dickey also acts as the maintainer for the Free Software
Foundation, which holds the <a href=
- "http://invisible-island.net/ncurses/ncurses-license.html">copyright
+ "https://invisible-island.net/ncurses/ncurses-license.html">copyright
on ncurses</a>.</p>
<p>Contact the current maintainers at</p>
<p>This list is open to anyone interested in helping with the
development and testing of this package.</p>
- <p>Beta versions of <em class="small-caps">ncurses</em> and
+ <p>Beta versions of <span class="main-name">ncurses</span> and
patches to the current release are made available at</p>
<blockquote>
<p><a href=
- "ftp://invisible-island.net/ncurses/">ftp://invisible-island.net/ncurses/</a> .</p>
+ "ftp://ftp.invisible-island.net/ncurses/">ftp://ftp.invisible-island.net/ncurses/</a>
+ and<br>
+ <a href=
+ "https://invisible-mirror.net/archives/ncurses/">https://invisible-mirror.net/archives/ncurses/</a> .</p>
</blockquote>
<p>There is an archive of the mailing list here:</p>
<ul>
<li><a href=
- "http://invisible-island.net/scripts/man2html.html">man2html</a></li>
-
- <li><a href=
- "http://invisible-island.nethttp://invisible-island.net/ncurses/ncurses-license.html">
- <em class="small-caps">ncurses</em> licensing</a></li>
+ "https://invisible-island.net/ncurses/ncurses-license.html"><span class="main-name">
+ ncurses</span> licensing</a></li>
<li><a href=
- "http://invisible-island.net/ncurses/ncurses-mapsyms.html">Symbol
- versioning in <em class="small-caps">ncurses</em></a></li>
+ "https://invisible-island.net/ncurses/ncurses-mapsyms.html">Symbol
+ versioning in <span class="main-name">ncurses</span></a></li>
<li><a href=
- "http://invisible-island.net/ncurses/ncurses-mingw.html">The
- MinGW port of <em class="small-caps">ncurses</em></a></li>
+ "https://invisible-island.net/ncurses/ncurses-slang.html">Comments
+ on <span class="main-name">ncurses</span> versus <span class=
+ "main-name">slang</span> (S-Lang)</a></li>
<li><a href=
- "http://invisible-island.net/ncurses/tack.html">tack –
+ "https://invisible-island.net/ncurses/tack.html">tack –
terminfo action checker</a></li>
<li><a href=
- "http://invisible-island.net/autoconf/portability-tar.html">tar
- versus portability</a></li>
-
- <li><a href=
- "http://invisible-island.net/ncurses/tctest.html">tctest
+ "https://invisible-island.net/ncurses/tctest.html">tctest
– termcap library checker</a></li>
<li><a href=
- "http://invisible-island.net/ncurses/ncurses.html#download_database">
+ "https://invisible-island.net/ncurses/ncurses.html#download_database">
Terminal Database</a></li>
</ul>
terminfo-format terminal description file once maintained by
<a href="http://www.catb.org/~esr/terminfo/">Eric
Raymond</a> . 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.</p>
+ terminfo data are provided in the same file, which also provides
+ several user-definable extensions beyond the X/Open
+ specification.</p>
<p>You can find lots of information on terminal-related topics
not covered in the terminfo file at <a href=
<a href="#h3-library">Library improvements</a>
<ul>
- <li><a href="#h3-lib-setbuf">Output
- buffering</a></li>
-
- <li><a href="#h3-lib-versioning">Symbol
- versioning</a></li>
+ <li><a href="#h4-new-library">New features</a></li>
- <li><a href="#h3-lib-other">Miscellaneous</a></li>
+ <li><a href="#h4-fixes-library">Other
+ improvements</a></li>
</ul>
</li>
</ul>
</li>
- <li>
- <a href="#h3-portability">Portability</a>
-
- <ul>
- <li><a href="#h4-port-mingw">MinGW</a></li>
-
- <li><a href="#h4-port-systems">Other ports</a></li>
- </ul>
- </li>
+ <li><a href="#h3-portability">Portability</a></li>
</ul>
</li>
- <li><a href="#h2-features">Features of <em class=
- "small-caps">ncurses</em></a></li>
+ <li><a href="#h2-features">Features of <span class=
+ "main-name">ncurses</span></a></li>
- <li><a href="#h2-who-uses">Applications using <em class=
- "small-caps">ncurses</em></a></li>
+ <li><a href="#h2-who-uses">Applications using <span class=
+ "main-name">ncurses</span></a></li>
<li><a href="#h2-development">Development activities</a></li>
</PRE><H2><a name="h2-SEE-ALSO">SEE ALSO</a></H2><PRE>
<STRONG><A HREF="ncurses.3x.html">curses(3x)</A></STRONG>
- This describes <STRONG>ncurses</STRONG> version 6.0 (patch 20180106).
+ This describes <STRONG>ncurses</STRONG> version 6.1 (patch 20180127).
</PRE><H2><a name="h2-SEE-ALSO">SEE ALSO</a></H2><PRE>
<STRONG><A HREF="infocmp.1m.html">infocmp(1m)</A></STRONG>, <STRONG><A HREF="ncurses.3x.html">curses(3x)</A></STRONG>, <STRONG><A HREF="terminfo.5.html">terminfo(5)</A></STRONG>
- This describes <STRONG>ncurses</STRONG> version 6.0 (patch 20180106).
+ This describes <STRONG>ncurses</STRONG> version 6.1 (patch 20180127).
</PRE><H2><a name="h2-AUTHOR">AUTHOR</a></H2><PRE>
</PRE><H2><a name="h2-SEE-ALSO">SEE ALSO</a></H2><PRE>
<STRONG><A HREF="tput.1.html">tput(1)</A></STRONG>, <STRONG><A HREF="terminfo.5.html">terminfo(5)</A></STRONG>
- This describes <STRONG>ncurses</STRONG> version 6.0 (patch 20180106).
+ This describes <STRONG>ncurses</STRONG> version 6.1 (patch 20180127).
* 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 @
-->
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN">
<HTML>
<STRONG>o</STRONG> Normally the ncurses library is compiled with terminfo support. In
that case, <STRONG>tgoto</STRONG> uses <STRONG><A HREF="curs_terminfo.3x.html">tparm(3x)</A></STRONG> (a more capable formatter).
- The <STRONG>tputs</STRONG> routine is described on the <STRONG><A HREF="curs_terminfo.3x.html">curs_terminfo(3x)</A></STRONG> manual page.
+ However, <STRONG>tparm</STRONG> is not a <EM>termcap</EM> feature, and portable <EM>termcap</EM> ap-
+ plications should not rely upon its availability.
+
+ The <STRONG>tputs</STRONG> routine is described on the <STRONG><A HREF="curs_terminfo.3x.html">curs_terminfo(3x)</A></STRONG> manual page.
It can retrieve capabilities by either termcap or terminfo name.
</PRE><H3><a name="h3-GLOBAL-VARIABLES">GLOBAL VARIABLES</a></H3><PRE>
- The variables <STRONG>PC</STRONG>, <STRONG>UP</STRONG> and <STRONG>BC</STRONG> are set by <STRONG>tgetent</STRONG> to the terminfo entry's
+ The variables <STRONG>PC</STRONG>, <STRONG>UP</STRONG> and <STRONG>BC</STRONG> are set by <STRONG>tgetent</STRONG> to the terminfo entry's
data for <STRONG>pad_char</STRONG>, <STRONG>cursor_up</STRONG> and <STRONG>backspace_if_not_bs</STRONG>, respectively. <STRONG>UP</STRONG>
- is not used by ncurses. <STRONG>PC</STRONG> is used in the <STRONG>tdelay_output</STRONG> function. <STRONG>BC</STRONG>
- is used in the <STRONG>tgoto</STRONG> emulation. The variable <STRONG>ospeed</STRONG> is set by ncurses
+ is not used by ncurses. <STRONG>PC</STRONG> is used in the <STRONG>tdelay_output</STRONG> function. <STRONG>BC</STRONG>
+ is used in the <STRONG>tgoto</STRONG> emulation. The variable <STRONG>ospeed</STRONG> is set by ncurses
in a system-specific coding to reflect the terminal speed.
</PRE><H2><a name="h2-RETURN-VALUE">RETURN VALUE</a></H2><PRE>
- Except where explicitly noted, routines that return an integer return
- <STRONG>ERR</STRONG> upon failure and <STRONG>OK</STRONG> (SVr4 only specifies "an integer value other
+ Except where explicitly noted, routines that return an integer return
+ <STRONG>ERR</STRONG> upon failure and <STRONG>OK</STRONG> (SVr4 only specifies "an integer value other
than <STRONG>ERR</STRONG>") upon successful completion.
Routines that return pointers return <STRONG>NULL</STRONG> on error.
</PRE><H2><a name="h2-BUGS">BUGS</a></H2><PRE>
- If you call <STRONG>tgetstr</STRONG> to fetch <STRONG>ca</STRONG> or any other parameterized string, be
- aware that it will be returned in terminfo notation, not the older and
+ If you call <STRONG>tgetstr</STRONG> to fetch <STRONG>ca</STRONG> 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 <STRONG>tgoto</STRONG> or <STRONG>tparm</STRONG>, which both expand terminfo-
- style strings as terminfo. (The <STRONG>tgoto</STRONG> 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 <STRONG>tgoto</STRONG> or <STRONG>tparm</STRONG>, which both expand terminfo-
+ style strings as terminfo. (The <STRONG>tgoto</STRONG> 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, <STRONG>tputs("50");</STRONG> will put out a literal
+ Because terminfo conventions for representing padding in string capa-
+ bilities differ from termcap's, <STRONG>tputs("50");</STRONG> 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 <STRONG>sgr</STRONG> string. One
- consequence of this is that termcap applications assume me (terminfo
- <STRONG>sgr0</STRONG>) does not reset the alternate character set. This implementation
+ Note that termcap has nothing analogous to terminfo's <STRONG>sgr</STRONG> string. One
+ consequence of this is that termcap applications assume me (terminfo
+ <STRONG>sgr0</STRONG>) 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.
</PRE><H2><a name="h2-PORTABILITY">PORTABILITY</a></H2><PRE>
- 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 <STRONG>tgetent</STRONG> 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 <STRONG>tgetent</STRONG> returns <STRONG>OK</STRONG>
- or <STRONG>ERR</STRONG>. Because the purpose of these functions is to provide compati-
- bility with the <EM>termcap</EM> library, that is a defect in XCurses, Issue 4,
+ Neither the XSI Curses standard nor the SVr4 man pages documented the
+ return values of <STRONG>tgetent</STRONG> 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 <STRONG>tgetent</STRONG> returns <STRONG>OK</STRONG>
+ or <STRONG>ERR</STRONG>. Because the purpose of these functions is to provide compati-
+ bility with the <EM>termcap</EM> 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 <STRONG>os-</STRONG>
+ ticular, some applications are reported to declare and/or modify <STRONG>os-</STRONG>
<STRONG>peed</STRONG>.
- The comment that only the first two characters of the <STRONG>id</STRONG> parameter are
+ The comment that only the first two characters of the <STRONG>id</STRONG> 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 <STRONG>tgetstr</STRONG>, <STRONG>tgetnum</STRONG> and <STRONG>tgetflag</STRONG>.
- Some applications assume that the termcap interface does not require
+ NUL on the parameter name passed to <STRONG>tgetstr</STRONG>, <STRONG>tgetnum</STRONG> and <STRONG>tgetflag</STRONG>.
+ Some applications assume that the termcap interface does not require
the trailing NUL for the parameter name. Taking into account these is-
sues:
- <STRONG>o</STRONG> As a special case, <STRONG>tgetflag</STRONG> matched against a single-character
- identifier provided that was at the end of the terminal descrip-
+ <STRONG>o</STRONG> As a special case, <STRONG>tgetflag</STRONG> 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.
- <STRONG>o</STRONG> This implementation disallows matches by the termcap interface
+ <STRONG>o</STRONG> This implementation disallows matches by the termcap interface
against extended capability names which are longer than two charac-
ters.
<STRONG><A HREF="ncurses.3x.html">curses(3x)</A></STRONG> and related pages whose names begin "form_" for detailed
descriptions of the entry points.
- This describes <STRONG>ncurses</STRONG> version 6.0 (patch 20180106).
+ This describes <STRONG>ncurses</STRONG> version 6.1 (patch 20180127).
* 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 @
-->
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN">
<HTML>
3 hexadecimal and base64
+ For example, this prints the compiled terminfo value as a string
+ which could be assigned to the <STRONG>TERMINFO</STRONG> environment variable:
+
+ infocmp -0 -q -Q2
+
<STRONG>-q</STRONG> This makes the output a little shorter:
- <STRONG>o</STRONG> Make the comparison listing shorter by omitting subheadings,
+ <STRONG>o</STRONG> Make the comparison listing shorter by omitting subheadings,
and using "-" for absent capabilities, "@" for canceled rather
than "NULL".
- <STRONG>o</STRONG> However, show differences between absent and cancelled capa-
+ <STRONG>o</STRONG> However, show differences between absent and cancelled capa-
bilities.
<STRONG>o</STRONG> Omit the "Reconstructed from" comment for source listings.
<STRONG>-R</STRONG><EM>subset</EM>
- 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.
- <STRONG>o</STRONG> Available terminfo subsets are "SVr1", "Ultrix", "HP", and
+ <STRONG>o</STRONG> Available terminfo subsets are "SVr1", "Ultrix", "HP", and
"AIX"; see <STRONG><A HREF="terminfo.5.html">terminfo(5)</A></STRONG> for details.
- <STRONG>o</STRONG> You can also choose the subset "BSD" which selects only capa-
- bilities with termcap equivalents recognized by 4.4BSD. The
+ <STRONG>o</STRONG> You can also choose the subset "BSD" which selects only capa-
+ bilities with termcap equivalents recognized by 4.4BSD. The
<STRONG>-C</STRONG> option sets the "BSD" subset as a side-effect.
- <STRONG>o</STRONG> If you select any other value for <STRONG>-R</STRONG>, it is the same as no
- subset, i.e., all capabilities are used. The <STRONG>-I</STRONG> option like-
+ <STRONG>o</STRONG> If you select any other value for <STRONG>-R</STRONG>, it is the same as no
+ subset, i.e., all capabilities are used. The <STRONG>-I</STRONG> option like-
wise selects no subset as a side-effect.
<STRONG>-s</STRONG> <EM>[d|i|l|c]</EM>
- The <STRONG>-s</STRONG> option sorts the fields within each type according to the
+ The <STRONG>-s</STRONG> option sorts the fields within each type according to the
argument below:
- <STRONG>d</STRONG> leave fields in the order that they are stored in the <EM>ter-</EM>
+ <STRONG>d</STRONG> leave fields in the order that they are stored in the <EM>ter-</EM>
<EM>minfo</EM> database.
<STRONG>i</STRONG> sort by <EM>terminfo</EM> name.
<STRONG>c</STRONG> sort by the <EM>termcap</EM> name.
- If the <STRONG>-s</STRONG> option is not given, the fields printed out will be
- sorted alphabetically by the <STRONG>terminfo</STRONG> name within each type,
- except in the case of the <STRONG>-C</STRONG> or the <STRONG>-L</STRONG> options, which cause the
- sorting to be done by the <STRONG>termcap</STRONG> name or the long C variable
+ If the <STRONG>-s</STRONG> option is not given, the fields printed out will be
+ sorted alphabetically by the <STRONG>terminfo</STRONG> name within each type,
+ except in the case of the <STRONG>-C</STRONG> or the <STRONG>-L</STRONG> options, which cause the
+ sorting to be done by the <STRONG>termcap</STRONG> name or the long C variable
name, respectively.
- <STRONG>-T</STRONG> eliminates size-restrictions on the generated text. This is
+ <STRONG>-T</STRONG> 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).
- <STRONG>-t</STRONG> tells <STRONG>tic</STRONG> to discard commented-out capabilities. Normally when
- translating from terminfo to termcap, untranslatable capabilities
+ <STRONG>-t</STRONG> tells <STRONG>tic</STRONG> to discard commented-out capabilities. Normally when
+ translating from terminfo to termcap, untranslatable capabilities
are commented-out.
- <STRONG>-U</STRONG> tells <STRONG>infocmp</STRONG> 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
+ <STRONG>-U</STRONG> tells <STRONG>infocmp</STRONG> 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
<STRONG>infocmp</STRONG> makes to fill in missing data.
<STRONG>-V</STRONG> reports the version of ncurses which was used in this program, and
exits.
- <STRONG>-v</STRONG> <EM>n</EM> prints out tracing information on standard error as the program
+ <STRONG>-v</STRONG> <EM>n</EM> prints out tracing information on standard error as the program
runs.
- The optional parameter <EM>n</EM> is a number from 1 to 10, inclusive,
+ The optional parameter <EM>n</EM> 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.
- <STRONG>-W</STRONG> By itself, the <STRONG>-w</STRONG> option will not force long strings to be
+ <STRONG>-W</STRONG> By itself, the <STRONG>-w</STRONG> option will not force long strings to be
wrapped. Use the <STRONG>-W</STRONG> option to do this.
<STRONG>-w</STRONG> <EM>width</EM>
changes the output to <EM>width</EM> characters.
<STRONG>-x</STRONG> print information for user-defined capabilities. These are exten-
- sions to the terminfo repertoire which can be loaded using the <STRONG>-x</STRONG>
+ sions to the terminfo repertoire which can be loaded using the <STRONG>-x</STRONG>
option of <STRONG>tic</STRONG>.
</PRE><H2><a name="h2-EXTENSIONS">EXTENSIONS</a></H2><PRE>
- The <STRONG>-0</STRONG>, <STRONG>-1</STRONG>, <STRONG>-E</STRONG>, <STRONG>-F</STRONG>, <STRONG>-G</STRONG>, <STRONG>-Q</STRONG>, <STRONG>-R</STRONG>, <STRONG>-T</STRONG>, <STRONG>-V</STRONG>, <STRONG>-a</STRONG>, <STRONG>-e</STRONG>, <STRONG>-f</STRONG>, <STRONG>-g</STRONG>, <STRONG>-i</STRONG>, <STRONG>-l</STRONG>, <STRONG>-p</STRONG>, <STRONG>-q</STRONG>
+ The <STRONG>-0</STRONG>, <STRONG>-1</STRONG>, <STRONG>-E</STRONG>, <STRONG>-F</STRONG>, <STRONG>-G</STRONG>, <STRONG>-Q</STRONG>, <STRONG>-R</STRONG>, <STRONG>-T</STRONG>, <STRONG>-V</STRONG>, <STRONG>-a</STRONG>, <STRONG>-e</STRONG>, <STRONG>-f</STRONG>, <STRONG>-g</STRONG>, <STRONG>-i</STRONG>, <STRONG>-l</STRONG>, <STRONG>-p</STRONG>, <STRONG>-q</STRONG>
and <STRONG>-t</STRONG> 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 <STRONG>-1</STRONG> (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 <STRONG>-r</STRONG> option's notion of "termcap" capabilities is System V Release
- 4's. Actual BSD curses versions will have a more restricted set. To
+ The <STRONG>-r</STRONG> 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 <STRONG>-r</STRONG> <STRONG>-RBSD</STRONG>.
</PRE><H2><a name="h2-SEE-ALSO">SEE ALSO</a></H2><PRE>
- <STRONG><A HREF="captoinfo.1m.html">captoinfo(1m)</A></STRONG>, <STRONG><A HREF="infotocap.1m.html">infotocap(1m)</A></STRONG>, <STRONG><A HREF="tic.1m.html">tic(1m)</A></STRONG>, <STRONG><A HREF="toe.1m.html">toe(1m)</A></STRONG>, <STRONG><A HREF="ncurses.3x.html">curses(3x)</A></STRONG>, <STRONG>ter-</STRONG>
+ <STRONG><A HREF="captoinfo.1m.html">captoinfo(1m)</A></STRONG>, <STRONG><A HREF="infotocap.1m.html">infotocap(1m)</A></STRONG>, <STRONG><A HREF="tic.1m.html">tic(1m)</A></STRONG>, <STRONG><A HREF="toe.1m.html">toe(1m)</A></STRONG>, <STRONG><A HREF="ncurses.3x.html">curses(3x)</A></STRONG>, <STRONG>ter-</STRONG>
<STRONG><A HREF="terminfo.5.html">minfo(5)</A></STRONG>.
https://invisible-island.net/ncurses/tctest.html
- This describes <STRONG>ncurses</STRONG> version 6.0 (patch 20180106).
+ This describes <STRONG>ncurses</STRONG> version 6.1 (patch 20180127).
</PRE><H2><a name="h2-AUTHOR">AUTHOR</a></H2><PRE>
</PRE><H2><a name="h2-SEE-ALSO">SEE ALSO</a></H2><PRE>
<STRONG><A HREF="ncurses.3x.html">curses(3x)</A></STRONG>, <STRONG><A HREF="tic.1m.html">tic(1m)</A></STRONG>, <STRONG><A HREF="infocmp.1m.html">infocmp(1m)</A></STRONG>, <STRONG><A HREF="terminfo.5.html">terminfo(5)</A></STRONG>
- This describes <STRONG>ncurses</STRONG> version 6.0 (patch 20180106).
+ This describes <STRONG>ncurses</STRONG> version 6.1 (patch 20180127).
</PRE><H2><a name="h2-AUTHOR">AUTHOR</a></H2><PRE>
<STRONG><A HREF="ncurses.3x.html">curses(3x)</A></STRONG> and related pages whose names begin "menu_" for detailed
descriptions of the entry points.
- This describes <STRONG>ncurses</STRONG> version 6.0 (patch 20180106).
+ This describes <STRONG>ncurses</STRONG> version 6.1 (patch 20180127).
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 <STRONG>ncurses</STRONG> version 6.0 (patch 20180106).
+ This describes <STRONG>ncurses</STRONG> version 6.1 (patch 20180127).
The <STRONG>ncurses</STRONG> library emulates the curses library of System V Release 4
UNIX, and XPG4 (X/Open Portability Guide) curses (also known as XSI
</PRE><H2><a name="h2-SEE-ALSO">SEE ALSO</a></H2><PRE>
<STRONG><A HREF="ncurses.3x.html">curses(3x)</A></STRONG>
- This describes <STRONG>ncurses</STRONG> version 6.0 (patch 20180106).
+ This describes <STRONG>ncurses</STRONG> version 6.1 (patch 20180127).
</PRE><H2><a name="h2-SEE-ALSO">SEE ALSO</a></H2><PRE>
<STRONG><A HREF="ncurses.3x.html">curses(3x)</A></STRONG>, <STRONG><A HREF="curs_variables.3x.html">curs_variables(3x)</A></STRONG>,
- This describes <STRONG>ncurses</STRONG> version 6.0 (patch 20180106).
+ This describes <STRONG>ncurses</STRONG> version 6.1 (patch 20180127).
</PRE><H2><a name="h2-AUTHOR">AUTHOR</a></H2><PRE>
</PRE><H2><a name="h2-SEE-ALSO">SEE ALSO</a></H2><PRE>
<STRONG><A HREF="tset.1.html">tset(1)</A></STRONG>, <STRONG><A HREF="infocmp.1m.html">infocmp(1m)</A></STRONG>, <STRONG><A HREF="ncurses.3x.html">curses(3x)</A></STRONG>, <STRONG><A HREF="terminfo.5.html">terminfo(5)</A></STRONG>.
- This describes <STRONG>ncurses</STRONG> version 6.0 (patch 20180106).
+ This describes <STRONG>ncurses</STRONG> version 6.1 (patch 20180127).
* 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 @
-->
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN">
<HTML>
base otherwise.
-</PRE><H3><a name="h3-STORAGE-FORMAT">STORAGE FORMAT</a></H3><PRE>
+</PRE><H3><a name="h3-LEGACY-STORAGE-FORMAT">LEGACY STORAGE FORMAT</a></H3><PRE>
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.
extended capabilities in order, e.g., booleans, then numbers and
finally strings.
+ Applications which manipulate terminal data can use the definitions
+ described in <STRONG><A HREF="term_variables.3x.html">term_variables(3x)</A></STRONG> which associate the long capability
+ names with members of a <STRONG>TERMTYPE</STRONG> structure.
+
+
+</PRE><H3><a name="h3-EXTENDED-NUMBER-FORMAT">EXTENDED NUMBER FORMAT</a></H3><PRE>
+ 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:
+
+ <STRONG>o</STRONG> a different magic number (0542)
+
+ <STRONG>o</STRONG> changing the type for the <EM>number</EM> 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 <STRONG>TERMTYPE</STRONG> structure as in previous formats.
+ However, that cannot provide callers with the extended numbers. The
+ library uses a similar but hidden data structure <STRONG>TERMTYPE2</STRONG> to provide
+ data for the terminfo functions.
+
</PRE><H2><a name="h2-PORTABILITY">PORTABILITY</a></H2><PRE>
- Note that it is possible for <STRONG>setupterm</STRONG> to expect a different set of
- capabilities than are actually present in the file. Either the data-
+ Note that it is possible for <STRONG>setupterm</STRONG> to expect a different set of
+ capabilities than are actually present in the file. Either the data-
base may have been updated since <STRONG>setupterm</STRONG> 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 <STRONG>setupterm</STRONG> 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 <STRONG>setupterm</STRONG> 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
- <STRONG><A HREF="terminfo.5.html">terminfo(5)</A></STRONG> 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
+ <STRONG><A HREF="terminfo.5.html">terminfo(5)</A></STRONG> for detailed discussion of terminfo source compatibility
issues.
+ Direct access to the <STRONG>TERMTYPE</STRONG> structure is provided for legacy applica-
+ tions. Portable applications should use the <STRONG>tigetflag</STRONG> and related
+ functions described in <STRONG><A HREF="curs_terminfo.3x.html">curs_terminfo(3x)</A></STRONG> 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.
+
</PRE><H2><a name="h2-EXAMPLE">EXAMPLE</a></H2><PRE>
- 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 ........ .
</PRE><H2><a name="h2-LIMITS">LIMITS</a></H2><PRE>
- Some limitations: total compiled entries cannot exceed 4096 bytes. The
- name field cannot exceed 128 bytes.
+ Some limitations:
+
+ <STRONG>o</STRONG> total compiled entries cannot exceed 4096 bytes in the legacy for-
+ mat.
+
+ <STRONG>o</STRONG> total compiled entries cannot exceed 32768 bytes in the extended
+ format.
+
+ <STRONG>o</STRONG> the name field cannot exceed 128 bytes.
</PRE><H2><a name="h2-FILES">FILES</a></H2><PRE>
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.
<li><a href="#h2-DESCRIPTION">DESCRIPTION</a>
<ul>
<li><a href="#h3-STORAGE-LOCATION">STORAGE LOCATION</a></li>
-<li><a href="#h3-STORAGE-FORMAT">STORAGE FORMAT</a></li>
+<li><a href="#h3-LEGACY-STORAGE-FORMAT">LEGACY STORAGE FORMAT</a></li>
<li><a href="#h3-EXTENDED-STORAGE-FORMAT">EXTENDED STORAGE FORMAT</a></li>
+<li><a href="#h3-EXTENDED-NUMBER-FORMAT">EXTENDED NUMBER FORMAT</a></li>
</ul>
</li>
<li><a href="#h2-PORTABILITY">PORTABILITY</a></li>
<EM>Terminfo</EM> 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
- <STRONG>ncurses</STRONG> version 6.0 (patch 20180106).
+ <STRONG>ncurses</STRONG> version 6.1 (patch 20180127).
</PRE><H3><a name="h3-Terminfo-Entry-Syntax">Terminfo Entry Syntax</a></H3><PRE>
<STRONG><A HREF="infocmp.1m.html">infocmp(1m)</A></STRONG>, <STRONG><A HREF="captoinfo.1m.html">captoinfo(1m)</A></STRONG>, <STRONG><A HREF="infotocap.1m.html">infotocap(1m)</A></STRONG>, <STRONG><A HREF="toe.1m.html">toe(1m)</A></STRONG>, <STRONG><A HREF="ncurses.3x.html">curses(3x)</A></STRONG>,
<STRONG><A HREF="term.5.html">term(5)</A></STRONG>. <STRONG><A HREF="terminfo.5.html">terminfo(5)</A></STRONG>.
- This describes <STRONG>ncurses</STRONG> version 6.0 (patch 20180106).
+ This describes <STRONG>ncurses</STRONG> version 6.1 (patch 20180127).
</PRE><H2><a name="h2-AUTHOR">AUTHOR</a></H2><PRE>
<STRONG><A HREF="tic.1m.html">tic(1m)</A></STRONG>, <STRONG><A HREF="infocmp.1m.html">infocmp(1m)</A></STRONG>, <STRONG><A HREF="captoinfo.1m.html">captoinfo(1m)</A></STRONG>, <STRONG><A HREF="infotocap.1m.html">infotocap(1m)</A></STRONG>, <STRONG><A HREF="ncurses.3x.html">curses(3x)</A></STRONG>, <STRONG>ter-</STRONG>
<STRONG><A HREF="terminfo.5.html">minfo(5)</A></STRONG>.
- This describes <STRONG>ncurses</STRONG> version 6.0 (patch 20180106).
+ This describes <STRONG>ncurses</STRONG> version 6.1 (patch 20180127).
</PRE><H2><a name="h2-SEE-ALSO">SEE ALSO</a></H2><PRE>
<STRONG><A HREF="clear.1.html">clear(1)</A></STRONG>, <STRONG>stty(1)</STRONG>, <STRONG><A HREF="tabs.1.html">tabs(1)</A></STRONG>, <STRONG><A HREF="tset.1.html">tset(1)</A></STRONG>, <STRONG><A HREF="terminfo.5.html">terminfo(5)</A></STRONG>, <STRONG><A HREF="curs_termcap.3x.html">curs_termcap(3x)</A></STRONG>.
- This describes <STRONG>ncurses</STRONG> version 6.0 (patch 20180106).
+ This describes <STRONG>ncurses</STRONG> version 6.1 (patch 20180127).
<STRONG>csh(1)</STRONG>, <STRONG>sh(1)</STRONG>, <STRONG>stty(1)</STRONG>, <STRONG><A HREF="curs_terminfo.3x.html">curs_terminfo(3x)</A></STRONG>, <STRONG>tty(4)</STRONG>, <STRONG><A HREF="terminfo.5.html">terminfo(5)</A></STRONG>,
<STRONG>ttys(5)</STRONG>, <STRONG>environ(7)</STRONG>
- This describes <STRONG>ncurses</STRONG> version 6.0 (patch 20180106).
+ This describes <STRONG>ncurses</STRONG> version 6.1 (patch 20180127).
.\" 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
.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.
.\" 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 `` ``
.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
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:
# 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
# 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
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,
# + 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
# 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.
#
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,
%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
#
# 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,
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.
# 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,
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)
#
# 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
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
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
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
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
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,
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
# 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@,
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,
# 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,
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
#
# 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{{||}}~~,
# 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,
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
#### 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;
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
# 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,
# MorphOS on Genesi Pegasos
# By Pavel Fedin <sonic_amiga@rambler.ru>
-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~,
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,
\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@,
# "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
# 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.
# 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!
-ncurses6 (6.0+20180121) unstable; urgency=low
+ncurses6 (6.1+20180127) unstable; urgency=low
* latest weekly patch
- -- Thomas E. Dickey <dickey@invisible-island.net> Sat, 20 Jan 2018 19:48:08 -0500
+ -- Thomas E. Dickey <dickey@invisible-island.net> Mon, 22 Jan 2018 20:01:38 -0500
ncurses6 (5.9-20131005) unstable; urgency=low
-ncurses6 (6.0+20180121) unstable; urgency=low
+ncurses6 (6.1+20180127) unstable; urgency=low
* latest weekly patch
- -- Thomas E. Dickey <dickey@invisible-island.net> Sat, 20 Jan 2018 19:48:08 -0500
+ -- Thomas E. Dickey <dickey@invisible-island.net> Mon, 22 Jan 2018 20:01:38 -0500
ncurses6 (5.9-20131005) unstable; urgency=low
-ncurses6 (6.0+20180121) unstable; urgency=low
+ncurses6 (6.1+20180127) unstable; urgency=low
* latest weekly patch
- -- Thomas E. Dickey <dickey@invisible-island.net> Sat, 20 Jan 2018 19:48:08 -0500
+ -- Thomas E. Dickey <dickey@invisible-island.net> Mon, 22 Jan 2018 20:01:38 -0500
ncurses6 (5.9-20120608) unstable; urgency=low
-; $Id: mingw-ncurses.nsi,v 1.252 2018/01/21 00:48:08 tom Exp $\r
+; $Id: mingw-ncurses.nsi,v 1.254 2018/01/23 01:01:38 tom Exp $\r
\r
; TODO add examples\r
; TODO bump ABI to 6\r
!define EXENAME "ncurses.exe"\r
\r
!define VERSION_MAJOR "6"\r
-!define VERSION_MINOR "0"\r
+!define VERSION_MINOR "1"\r
!define VERSION_YYYY "2018"\r
-!define VERSION_MMDD "0121"\r
+!define VERSION_MMDD "0127"\r
!define VERSION_PATCH ${VERSION_YYYY}${VERSION_MMDD}\r
\r
!define MY_ABI "5"\r
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
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
/****************************************************************************
- * 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 *
#include <parametrized.h>
#include <transform.h>
-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 "<stdin>"
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;
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 {
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
/****************************************************************************
- * 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 *
/****************************************************************************
* 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
#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
#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