From d66080c21038ad4feb2e41a0c4e517d5b4a03ab2 Mon Sep 17 00:00:00 2001
From: "Thomas E. Dickey" The ncurses (new curses) library
- is a free software emulation of curses in System V Release 4.0
- (SVr4), and more. It uses terminfo format, supports pads and
- color and multiple highlights and forms characters and
+ The ncurses (new curses)
+ library is a free software emulation of curses in System V
+ Release 4.0 (SVr4), and more. It uses terminfo format, supports
+ pads and color and multiple highlights and forms characters and
function-key mapping, and has all the other SVr4-curses
- enhancements over BSD curses. SVr4 curses is better known today
- as X/Open Curses.Overview
-
In mid-June 1995, the maintainer of 4.4BSD curses declared that he considered 4.4BSD curses obsolete, and encouraged the - keepers of unix releases such as - BSD/OS, FreeBSD and NetBSD to switch over to ncurses.
+ keepers of unix releases such as + BSD/OS, FreeBSD and NetBSD to switch over to ncurses. -Since 1995, ncurses has been +
Since 1995, ncurses has been ported to many systems:
The distribution includes the library and support utilities, @@ -90,1743 +100,2252 @@ p,li { max-width:700px; }
Full manual pages are provided for the library and tools.
-The ncurses distribution is - available via anonymous FTP at the GNU distribution site
+The ncurses distribution is + available at ncurses' homepage:
-It is also available at + "ftp://ftp.invisible-island.net/ncurses/">ftp://ftp.invisible-island.net/ncurses/ + or
It is also available via anonymous FTP at the GNU distribution + site
+ "ftp://ftp.gnu.org/gnu/ncurses/">ftp://ftp.gnu.org/gnu/ncurses/ .
These notes are for ncurses - @VERSION@, released August 8, 2015.
+These notes are for ncurses + @VERSION@, released January 27, 2018.
This release is designed to be source-compatible with - ncurses 5.0 through 5.9; providing a - new application binary interface (ABI). Although the source can - still be configured to support the ncurses 5 ABI, the intent of the release is to - provide extensions which are generally useful, but - binary-incompatible with ncurses - 5:
+ ncurses 5.0 through 6.0; providing + extensions to the application binary interface (ABI). Although + the source can still be configured to support the ncurses 5 ABI, the intent of the release is to + provide extensions to the ncurses + 6 ABI:Extend the cchar_t
structure to allow more
- than 16 colors to be encoded.
improve integration of tput + and tset
Modify the encoding of mouse state to make room for a 5th - mouse button. That allows one to use ncurses with a wheel mouse with xterm or - similar X terminal emulators.
+provide support for extended numeric capabilities.
There are, of course, numerous other improvements, - including
+There are, of course, numerous other improvements, listed in + this announcement.
+ +The release notes also mention some bug-fixes, but are focused + on new features and improvements to existing features since + ncurses 6.0 release.
+ +The improved integration of tput and tset + made only small changes to the libraries. However, supporting + extended numeric capabilities required a few changes:
fixes made based on the Clang and Coverity static - analyzers.
+The TERMINAL
structure in
+ <term.h>
is now opaque. Doing that allowed
+ making the structure larger, to hold the extended numeric
+ data.
A few applications required changes during development of + ncurses 6.1 because those + applications misused the members of that structure, e.g., + directly modifying it rather than using + def_prog_mode.
memory leak fixes using Valgrind
-Having made TERMINAL
opaque (and because none
+ of the library functions use anything except a pointer to
+ TERMINAL
), it was possible to increase the size
+ of the structure, adding to the end.
The release notes mention some bug-fixes, but are focused on - new features and improvements to existing features log since - ncurses 5.9 release.
+Existing applications which were linked to the
+ ncurses 6.0 high-level
+ (ncurses, ncursesw) and low-level
+ (tinfo, tinfo) libraries should not require
+ re-linking since the binary interface did not change, nor did
+ the structure offsets with TERMINAL
change.
While the intent of the release is to provide a new stable - ABI, there are other development activities which are summarized - below.
+A few applications use the inner TERMTYPE
+ structure's offsets to refer to terminfo capabilities within
+ that structure. Again, those do not require modification
+ because their offsets within TERMINAL
did not
+ change.
The original release plan, e.g., for "5.10" was to improve
- the MinGW port. Ultimately that was completed (wide-character
- support, mouse, etc), but was deferred to focus on termcap
- support and performance issues. Also, pinpointing the
- problems with Console2
took a while.
When configured for wide-characters, i.e.,
+ “ncursesw” the TERMINAL
structure is
+ extended.
The new data in TERMINAL
holds the same
+ information as TERMTYPE
, but with larger numbers
+ (“int” versus “short”). It is named
+ TERMTYPE2
.
The library uses this structure internally in preference
+ to TERMTYPE
, referring to TERMTYPE
+ only to initialize it for applications that use the
+ capabilities defined in <term.h>
A review of termcap compatibility in 2011 led to several - minor fixes in the library and improvements to utilities. To - do this properly, a review of the various extent termcap - implementations was needed.
+When configured for 8-bit (narrow) characters, the
+ TERMTYPE2
structure is not used.
The termcap - library checker (tctest) (not part of ncurses) was one result. A followup review - of performance using ncurses-examples - in 2014 led to additional improvements.
+The motivation for making this extension came from noticing + that + termcap applications could (though not + realistically) use larger numbers than would fit in 16-bits, + and the fact that the number of color pairs for a 256-color xterm + could not be expressed in terminfo (i.e., 32767 versus 65536). + Also, a few terminals support direct-colors, which could use the + extension.
+ +Generally speaking, applications that use internal details of
+ a library are unsupported. There was exactly one exception for
+ ncurses: the tack program used the internal
+ details of TERMINAL
, because it provides an
+ ncurses-specific feature for interactively modifying a terminfo
+ description and writing the updated description to a text-file.
+ It was possible to not only separate tack from these internal
+ details of ncurses, but to
+ generalize it so that the program works with Unix curses
+ (omitting the ncurses-specific feature). That was released as
+
+ tack 1.08 in July
+ 2017.
While making changes to tack to + eliminate its dependency upon ncurses internals, the publicly-visible + details of those internals were reviewed, and some symbols were + moved to private header files, while others were marked + explicitly as ncurses internals. + Future releases of ncurses may + eliminate some of those symbols (such as those used by + tack 1.07) because they are + neither part of the API or the ABI.
+ +Using the TERMTYPE2
extended numeric
+ capabilities, it is possible to support both color pair values
+ and color values past 32767. Taking compatibility into account,
+ developers readily understand that neither function signatures
+ nor structure offsets change. Also, existing functions have to
+ operate with the extended numbers. Most of that work is internal
+ to the library. For the external interfaces, a hybrid approach
+ was used:
X/Open Curses defined function prototypes such as
+ wattr_set
with an unused parameter, for
+ “future” use. After 25 years, the future is here:
+ ncurses uses the parameter to
+ augment color pair values as described in the
+ manual page.
Output buffering provided a further, but worthwhile
- distraction. A bug report in 2012 regarding the use of signal
- handlers in ncurses) pointed out
-
- a problem with the use of unsafe functions for handling
- SIGTSTP
. Other signals could be addressed with
- workarounds; repairing SIGTSTP
required a
- different approach. The solution required changing internal
- behavior of the library: how it handles output buffering.
Now ncurses buffers its own - output, independently of the standard output. A few - applications relied upon the library's direct reuse of the - standard output buffering; however that is - unspecified behavior and has never been a - recommended practice. Identifying these applications as well - as refining the change to permit low-level applications to - work consistently took time.
-Since the introduction of the experimental support for 256 - colors early in 2005 - (released in ncurses - 5.5), there has been increased user interest. Almost all - packagers continue providing the ncurses ABI 5 which cannot - support 256 colors.
-Symbol versioning, or the lack of it in ncurses, is the - main reason why packagers would be reluctant to add a new - ncurses ABI.
- -This release provides the new ABI along with - script-generated lists of versioned symbols which can be used - for both ABI 5 and 6 (with distinct names to keep the two - separate). This took time to development, as reported in - Symbol - versioning in ncurses.
+Other functions such as those defining color pairs did not
+ have a corresponding reserved parameter. For those,
+ ncurses defines extended
+ versions such as init_extended_pair
(versus
+ init_pair
), init_extended_color
+ (versus init_color
).
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
.
X/Open curses provides more than one initialization - function:
+New "RGB" extension capability for direct-color support is
+ used to improve performance of
+ color_content
.
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.
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:
+These are new or revised features:
to get good performance, curses (not only ncurses, but SVr4 curses in general) set an
- output buffer using setbuf
or similar function.
- There is no standard (or portable) way to turn that output
- buffer off, and revert to line-buffering. The
- NCURSES_NO_SETBUF
environment variable did make it
- optional.
modify c++/etip.h.in
to accommodate
+ deprecation of throw and throws in c++17
to handle SIGTSTP
(the “stop”
- signal), ncurses relied upon
- unsafe functions. That is, due to the complexity of the
- feature, it relied upon reusing existing functions which
- should not have been called via the signal handler.
add new function unfocus_current_field
Conveniently, solving the second problem (by making ncurses do its own output buffering) - also fixed the first one. But there were special cases to - resolve: - low-level functions such as mvcur, putp, vidattr - explicitly use the standard output. Those functions were reused - internally, and required modification to distinguish whether they - were used by the high-level or low-level interfaces.
+add option to preserve leading whitespace in form + fields
+Finally, there may still be a few programs which should be - modified to improve their portability, e.g., adding an
+add a macro for is_linetouched
and adjust the
+ function's return value to make it possible for most
+ applications to check for an error-return.
-+-fflush(stdout); --
add build-time utility report_offsets
to help
+ show when the various configurations of tinfo library are
+ compatible or not.
when switching from “shell”
- mode to “program”
- (curses) mode. Those are fairly rare because most programmers
- have learned not to mix printf
and printw
.
This release introduces symbol-versioning to ncurses because without it, the change of ABI - would be less successful. A lengthy discussion will be presented - in Symbol - versioning in ncurses. These - notes summarize what has changed, and what can be done with the - new release.
- -Symbol-versioning allows the developers of a library to mark - each public symbol (both data and functions) with an identifier - denoting the library name and the version for which it was built. - By doing this, users of the library have a way to help ensure - that applications do not accidentally load an incompatible - library. In addition, private symbols can be hidden entirely.
- -This release provides sample files for the four principal
- configurations of ncurses libraries:
- ncurses
, ncursesw
,
- ncursest
and ncursestw
. Each sample is
- given in two forms:
These were done to limit or ultimately deprecate features:
--+-
-- “
+.map
”+
- +
-drop two symbols obsoleted in 2004: +
+_nc_check_termtype
, and +_nc_resolve_uses
- These list all public symbols, together with version - names.
+- +
-move
+_nc_tracebits
,_tracedump
+ and_tracemouse
tocurses.priv.h
, + since they are not part of the suggested ABI6.- “
+.sym
”- +
-mark some structs in form/menu/panel libraries as + potentially opaque without modifying API/ABI.
+- These list all public symbols, without version - names.
-
ifdef'd header-file definition of mouse_trafo
+ with NCURSES_NOMACROS
The sample files are generated by scripts which take
- into account a few special cases such as tack to omit
- many of the ncurses private symbols
- (beginning with “_nc_
”). Here are
- counts of globals versus locals:
remove initialization-check for calling napms
+ in the term-driver configuration; none is needed.
-+-
-- +Config ++ + -modify
+trace
to avoid overwriting existing + fileSymbols +These are improvements to existing features:
-Globals ++
- +
-modify
+make_hash
to allow building with + address-sanitizer, assuming that--disable-leaks
+ is configured.Locals +- +
-move
+SCREEN
field foruse_tioctl
+ data before the ncursesw fields, and limit that to the + sp-funcs configuration to improve termlib compatibility"_nc_" -+ modify db-iterator:
-- +ncurses ++
+ -- +
-ignore zero-length files in db-iterator; these are + useful for instance to suppress +
+$HOME/.terminfo
when not wanted.976 +- +
+modify
+update_getenv
to ensure that + environment variables which are not initially set will be + checked later if an application happens to set them796 ++ -modify
+_nc_outc_wrapper
to use the standard + output if the screen was not initialized, rather than + returning an error.180 ++ -improve checks for low-level terminfo functions when the + terminal has not been initialized.
+332 -+ -modify
+set_curterm
to update +ttytype[]
data used by longname/p>- +ncursesw ++ -modify
+_nc_get_screensize
to allow for +use_env
anduse_tioctl
state to be + per-screen when sp-funcs are configured, better matching the + behavior when using the term-driver configuration.1089 ++ -remove an early-return from
+_nc_do_color,
+ which can interfere with data needed bybkgd
+ when ncurses is configured + with extended colors905 ++ -incorporate
+A_COLOR
mask into +COLOR_PAIR
, in case user application provides an + out-of-range pair number184 ++ + -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 formvcur
, + e.g., in the sample program dots_mvcur for the term-driver + configuration.343 -These are corrections to existing features:
-- +ncursest ++
- +
-fixes for writing extended color pairs in +
+putwin
.979 +- +
-modify no-leaks code for
+lib_cur_term.c
to + account for thetgetent
cache.804 +- +
-amend handling of the
+repeat_char
capability + inEmitRange
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.175 +- +
-improve wide-character implementation of +
+myADDNSTR
infrm_driver.c
, which + was inconsistent with the normal implementation.358 -+ -modify
+winnstr
andwinchnstr
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.- -ncursestw ++ -modify
+setupterm
to save original tty-modes + so thaterasechar
works as expected. Also modify +_nc_setupscreen
to avoid redundant calls to get + original tty-modes.1098 ++ -modify
+wattr_set
andwattr_get
+ to returnERR
if win-parameter is null, + as documented.914 ++ -correct order of initialization for traces in +
+use_env
anduse_tioctl
versus first +_tracef
calls.184 ++ -correct parameters for
+copywin
call in +_nc_Synchronize_Attributes
372 -
flush the standard output in _nc_flush
for
+ the case where SP
is zero, e.g., when called via
+ putp
. This fixes a scenario where
+ “tput flash” did not work after changes in
+ 20130112.
Although only four sample configurations are presented, each - is formed by merging symbols from several combinations of - configure-script options, taking into account advice from - downstream packagers. Because they are formed by merging, the - sample files may list a symbol which is not in a given package. - That is expected. The samples have been tested and are working - with systems (such as Fedora, FreeBSD and Debian) which fully - support this feature. There are other systems which do - not support the feature, and a few (such as Solaris) - which provide incomplete support.
- -The version-naming convention used allows these sample files - to build distinct libraries for ABI 5 and 6. Version names - consist of
+amend internal use of tputs
to consistently
+ use the number of lines affected, e.g., for insert/delete
+ character operations. While merging terminfo source early in
+ 1995, several descriptions used the
+ “*
” proportional delay for these
+ operations, prompting a change in doupdate
.
configuration name, e.g.,
- “NCURSESW
” for the wide-character
- libraries
correct return-value of extended putwin
.
ABI version (if not 5)
+double-width multibyte characters were not counted
+ properly in winsnstr
and
+ wins_nwstr
.
library name for two special cases which have the same
- interface across configurations:
- “TINFO
” and
- “TIC
”
amend fix for _nc_ripoffline
from 20091031 to
+ make test/ditto.c
work in threaded
+ configuration.
release version
+modify _nc_viscbuf2
and
+ _tracecchar_t2
to trace wide-characters as a
+ whole rather than their multibyte equivalents.
patch date (for the release version)
+minor fix in wadd_wchnstr
to ensure that each
+ cell has nonzero width.
For example, running nm -D
on the libraries in
- the ncurses6 test package shows these symbol-versions:
move PUTC_INIT
calls next to
+ wcrtomb
calls, to avoid carry-over of error
+ status when processing Unicode values which are not
+ mapped.
-+-0000000000000000 A NCURSES6_TIC_5.0.19991023 -0000000000000000 A NCURSES6_TIC_5.1.20000708 -0000000000000000 A NCURSES6_TIC_5.5.20051010 -0000000000000000 A NCURSES6_TIC_5.7.20081102 -0000000000000000 A NCURSES6_TIC_5.9.20150530 -0000000000000000 A NCURSES6_TINFO_5.0.19991023 -0000000000000000 A NCURSES6_TINFO_5.1.20000708 -0000000000000000 A NCURSES6_TINFO_5.2.20001021 -0000000000000000 A NCURSES6_TINFO_5.3.20021019 -0000000000000000 A NCURSES6_TINFO_5.4.20040208 -0000000000000000 A NCURSES6_TINFO_5.5.20051010 -0000000000000000 A NCURSES6_TINFO_5.6.20061217 -0000000000000000 A NCURSES6_TINFO_5.7.20081102 -0000000000000000 A NCURSES6_TINFO_5.8.20110226 -0000000000000000 A NCURSES6_TINFO_5.9.20150530 -0000000000000000 A NCURSESW6_5.1.20000708 -0000000000000000 A NCURSESW6_5.3.20021019 -0000000000000000 A NCURSESW6_5.4.20040208 -0000000000000000 A NCURSESW6_5.5.20051010 -0000000000000000 A NCURSESW6_5.6.20061217 -0000000000000000 A NCURSESW6_5.7.20081102 -0000000000000000 A NCURSESW6_5.8.20110226 -0000000000000000 A NCURSESW6_5.9.20150530 --
add missing assignment in lib_getch.c
to make
+ notimeout
work
As a special case, this release (which makes the final change - for ABI 5) is marked with release version 5.9 and patch date - 20150530.
+While reviewing user feedback, it became apparent that the + differences between + reset (an alias for + tset) and “tput reset” were confusing:
-The new release has several improvements for performance and - building. For instance:
+On further investigation, it turned out that the differences + were largely an accident due to the way those programs had + evolved.
+ +This release eliminates the unnecessary differences, using the + same approach for tput's + init (initialization), reset and clear + operations as the separate + reset and + clear programs. Doing this does not change the + command-line options; existing scripts are unaffected.
+ +These are the user-visible changes for the three programs + (tput, tset and clear):
several files in ncurses- and progs-directories were
- modified to allow const
data used in internal
- tables to be put by the linker into the readonly text
- segment.
add the terminal-mode parts of “reset” (aka tset) to the “tput
+ reset
” command, making the two almost the same
+ except for window-size.
various improvements were made to building the Ada95
- binding, both in simplifying the generated files as well as
- improving the way it uses gnatmake
improve tput's check for + being called as “init” or “reset” to + allow for transformed names.
There are also new features in the libraries:
+add “clear” as a possible link/alias to + tput.
+amend changes for tput to + reset tty modes to “sane” if the program is run + as “reset”, like tset. Likewise, ensure that tset sends either reset- or + init-strings.
+added - wgetdelay to retrieve _delay member of WINDOW if it - happens to be opaque, e.g., in the pthread configuration.
+add -x
option to clear/tput
+ to make the E3
extension optional
added - A_ITALIC extension.
+add functionality of
+ “tset -w
” to tput, like the
+ “-c
” feature this is not optional in
+ tput.
added form library extension - O_DYNAMIC_JUSTIFY option which can be used to override - the different treatment of justification for static versus - dynamic fields .
+add options -T
and -V
to
+ clear command for
+ compatibility with tput.
rewrote - putwin and - getwin, making an extended version which is capable of - reading screen-dumps between the wide/normal ncurses configurations. These are text - files, except for a magic code at the beginning:
+drop long-obsolete “-n
” option
+ from tset.
-+-0 string \210\210 Screen-dump (ncurses) --
modify tset's assignment to
+ TERM
in its output to reflect the name by which
+ the terminal description is found, rather than the primary
+ name. That was an unnecessary part from the initial
+ conversion of tset from
+ termcap to terminfo. The termcap library in 4.3BSD did this
+ to avoid using the short 2-character name
several changes to mouse support include:
+remove a restriction in tput's support for termcap names which + omitted capabilities normally not shown in termcap + translations
+add usage message to clear + command
+improve usage messages for tset and tput.
+Other user-visible improvements and new features include:
+ +modify tic/infocmp display of numeric values to use + hexadecimal when they are "close" to a power of two, making + the result more readable.
+add “-W
” option to tic/infocmp
+ to force long strings to wrap.
This is in addition to the
+ “-w
” option which attempts to
+ fit capabilities into a given line-length.
%u
” format to terminfo.If “-f
” option splits line,
+ do not further split it with
+ “-W
”.
Begin a new line when adding
+ “use=
” after a wrapped line.
There are a few new configure options dealing with library - customization:
+add “-q
” option to infocmp to suppress the
+ “Reconstructed from
” comment from
+ the header, and a corresponding option to tic to suppress all comments from the
+ “tic -I
” output.
add “--enable-ext-putwin
”
- configure option to turn on the extended putwin/getwin. By
- default, this is enabled for ABI 6 and disabled with ABI
- 5.
Sorted options in usage message for infocmp, to make it simpler to see unused + letters.
add “--enable-string-hacks
”
- option to control whether strlcat and strlcpy may be used.
- Because ncurses already does the
- requisite buffer-limit checks, this feature is mainly of
- interest to quiet compiler-warnings on a few systems.
Updated usage message for tic, adding “-0
”
+ option.
add configure option
- “--with-tparm-arg
” to allow
- tparm's parameters to be something more likely to be the
- same size as a pointer, e.g., intptr_t
(again,
- the default is set for ABI 6).
add infocmp/tic “-Q
” option,
+ which allows one to dump the compiled form of the terminal
+ entry, in hexadecimal or base64:
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.hex:
” prefix tells the
+ terminfo reader to accept hexadecimal data as generated by
+ “infocmp -0qQ1
”.Most of the termcap-related changes based on development of
- tctest
- (termcap library checker) are implemented in the tic and
- infocmp programs rather than affecting the library. As noted in
- the
- discussion of tctest
, ncurses's ability to translate between terminfo
- and termcap formats has been improved at different times, but
- subject to feedback from "real" termcap users. There are very few
- of those. Nowadays, virtually all termcap users are
- using ncurses (or NetBSD, with its
- own terminfo library) and their programs are actually using
- terminfo rather than termcap data.
Still, there are a few. A comment about the translation of the
- ASCII NUL
character prompted a review:
Other less-visible improvements and new features include:
Both terminfo and termcap store string capabilities as
- NUL
-terminated strings.
modify utility headers such as tic.h
to make
+ it clearer which are externals that are used by tack.
In terminfo, a \0
in a terminal description
- is stored as \200
.
add “reset
” to list of programs
+ whose names might change in manpages due to
+ program-transformation configure options.
There are no (known) terminals which would behave
- differently when sent \0
or
- \200
.
modify “-T
” option of
+ clear and tput to call use_tioctl
to
+ obtain the operating system's notion of the screensize if
+ possible.
When translating to terminfo format (or displaying a
- printable version of an entry using infocmp), ncurses shows \200
as
- \0
.
add check in tput for + init/reset operands to ensure those use a terminal.
It has done this since 1998 (quoting from the NEWS - file):
- --+-980103 -... - + modify _nc_tic_expand() to generate \0 rather than \200. -... - + correct translation of terminfo "^@", to \200, like \0. --
modify programs clear, + tabs, tput and tset to pass the actual tty file + descriptor to setupterm rather than the standard output or + error, making padding work.
However, the _nc_tic_expand
function (which
- optionally produces terminfo or termcap format) did not
- address this special case for termcap. Even the later 4.4BSD
-
- cgetstr interprets a \0
literally, ending
- that string (rather than using the terminfo
- improvement).
change tset's
+ initialization to allow it to get settings from the standard
+ input as well as /dev/tty
, to be more effective
+ when output or error are redirected.
As a result of the review, several improvements were made to - ncurses translation to/from termcap - format — and improving the checks made in tic for - consistency of entries. Most of these are not of general - interest, except for two new command-line options for tic and - infocmp:
- -the “-0
” option generates
- termcap/terminfo source on a single line.
amend check in tput,
+ tabs and clear to allow those to use the
+ database-only features in cron
+ if a “-T
” option gives a suitable
+ terminal name.
the “-K
” option provides stricter
- BSD-compatibility for termcap output.
improve error message from tset/reset + when both stderr/stdout are redirected to a file or pipe.
Other user-visible improvements and new features include:
+Several of the less apparent features deal with translation of + terminfo to termcap (and the reverse), with corresponding checks + by tic:
added “-D
” option to tic and
- infocmp, to show the database locations that it could
- use.
modify check in fmt_entry
to handle a
+ cancelled reset string. Make similar fixes in other parts of
+ dump_entry.c
and tput.c
added “-s
” option to toe, to sort
- its output.
correct read of terminfo entry in which all strings are + absent or explicitly cancelled. Before this fix, the result + was that all were treated as only absent.
extended “-c
” and
- “-n
” options of infocmp to allow
- comparing more than two entries.
modify infocmp to suppress
+ mixture of absent/cancelled capabilities that would only show
+ as “NULL, NULL
”, unless the
+ “-q
” option is used, e.g., to show
+ “-, @
” or “@,
+ -
”.
modified toe's report when “-a
”
- and “-s
” options are combined, to
- add a column showing which entries belong to a given
- database.
correct a warning from tic + about keys which are the same, to skip over missing/cancelled + values.
modified the clear program to take into account the
- “E3
” extended capability to clear
- the terminal's scrollback buffer.
add check in tic for use of
+ bold, etc., video attributes in the color capabilities,
+ accounting whether the feature is listed in
+ ncv
.
add check in tic for
+ unnecessary use of “2
” to denote a
+ shifted special key.
Along with the library and utilities, many improvements were - made to the ncurses-examples. - Some were made to allow building (and comparison-testing) against - NetBSD curses and PDCurses. Both lack some of the X/Open Curses - features, necessitating customization. But this activity was - useful because it showed some remaining performance issues (which - have been resolved in this release).
+improve check in tic for + delays by also warning about beep/flash when a delay is not + embedded, or if those use the VT100 reverse video escape + without using a delay.
+These changes were made to verify compatibility or compare - performance of ncurses:
+improve checks in trim_sgr0
, comp_parse.c and
+ parse_entry.c, for cancelled string capabilities.
made workarounds for compiling test-programs with NetBSD - curses, though it lacks some common functions such as - - use_env.
+add check in tic for some + syntax errors of delays, as well as use of proportional + delays for non-line capabilities.
added dots_termcap test-program
+add check in tic for
+ conflict between ritm
, rmso
,
+ rmul
versus sgr0
.
added dots_curses test-program, for comparison with the - low-level examples.
+add check in _nc_parse_entry
for invalid
+ entry name, setting the name to
+ “invalid
” to avoid problems storing
+ entries.
added test_setupterm test-proram to demonstrate - normal/error returns from the setupterm and restartterm - functions.
+improve _nc_tparm_analyze
, using that to
+ extend the checks made by tic
+ for reporting inconsistencies between the expected number of
+ parameters for a capability and the actual.
added “-d
”,
- “-e
” and
- “-q
” options to the demo_terminfo
- and demo_termcap test-programs.
remove tic warning about
+ “^?
” in string capabilities, which
+ was marked as an extension; however all Unix implementations
+ support this and X/Open Curses does not address it. On the
+ other hand,
+ BSD termcap did not support this feature (until the
+
+ mid-1990s).
in _nc_infotocap
, added a check to ensure
+ that terminfo “^?
” is not written to
+ termcap.
added “-y
” option to demo_termcap
- and test/demo_terminfo test-programs to demonstrate behavior
- with/without extended capabilities.
modify sscanf
calls in
+ _nc_infotocap
for patterns
+ “%{number}%+%c
” and
+ “%'char'%+%c
” to check that the
+ final character is really “c
”,
+ avoiding a case in icl6404 which cannot be converted to
+ termcap.
modified demo_termcap and demo_terminfo test-programs to
- make their options more directly comparable, and add
- “-i
” option to specify a terminal
- description filename to parse for names to lookup.
in _nc_tic_expand
and
+ _nc_infotocap
, improved string-length check when
+ deciding whether to use “^X
” or
+ “\xxx
” format for control
+ characters, to make the output of tic/infocmp
+ more predictable.
rewrote the tests for - mvderwin and test for recursive - mvwin in the movewindow test-program.
+limited termcap “%d
” width to 2
+ digits on input, and use “%2
” in
+ preference to “%02
” on output.
correct terminfo/termcap conversion of
+ “%02
” and
+ “%03
” into
+ “%2
” and
+ “%3
”; the result repeated the last
+ character.
These changes were made to help with the MinGW port:
+Along with the library and utilities, many improvements were + made to the ncurses-examples.
+ +These changes were made to demonstrate new extensions in + ncurses:
added test-screens to the ncurses test-program to show - 256-characters at a time, to help with MinGW port.
+add demo_new_pair program,
+ to demonstrate
+ alloc_pair
,
+ find_pair
and
+ free_pair
functions.
This program iterates over the possible color + combinations, allocating or initializing color pairs. For + best results, choose screen-width dividing evenly into the + number of colors. e.g.,
+ +++
++ + ++ + 32x64,32x128
256 colors ++ + ++ + 24x44,24x88
88 colors ++ ++ + 32x64,24x128
16 colors +
modified the view test-program to load UTF-8 when built - with MinGW by using regular win32 API because the MinGW - functions mblen and mbtowc do not work.
+add extended_color program, + like the older color_set + program, but using the extended color functions, with and + without the SP-functions interface.
added “-s
” option to the view
- test-program to allow it to start in single-step mode,
- reducing size of trace files when it is used for debugging
- MinGW changes.
add picsmap program to fill + in some testing issues not met by dots, using this as the third example in a + comparison of the + ncurses versus slang libraries.
+ +The program can directly read X bitmap and pixmap files, + displaying a picture. It can read other image files using + ImageMagick's convert program to translate the image + into text.
+ +For 16-, 88- and 256-color terminal descriptions,
+ picsmap can load a palette
+ file which tells it which color palette entries to use. For
+ direct-colors, the terminal descriptions use the
+ RGB
extension capability.
These changes were made to verify new extensions in ncurses:
+There are other new example programs and a few scripts:
added - form_driver_w entrypoint to wide-character forms library, - as well as form_driver_w test-program.
+add dots_xcurses program to + illustrate a different approach used for extended colors + which can be contrasted with dots_curses.
modified ncurses test-program's b/B tests to display lines - only for the attributes which a given terminal supports, to - make room for an italics test.
+add list_keys program show + function keys for one or more terminal descriptions. It uses + ncurses's convention of + modifiers for special keys, based on xterm.
modified ncurses test-program, adding
- “-E
” and
- “-T
” options to demonstrate use_env
- versus use_tioctl.
add padview program, to + compare pads with direct updates in the view program.
modified ncurses test-program's c/C tests to cycle through - subsets of the total number of colors, to better illustrate - 8/16/88/256-colors by providing directly comparable - screens.
+add sp_tinfo program to + exercise the SP-functions extension of the low-level terminfo + library.
modified the ncurses test-program to also show position - reports in 'a' test.
+add test-programs for termattrs
and
+ term_attrs
functions.
These changes were made to make the examples more useful:
-added scripts for building dpkg and rpm test-packages
+add test_sgr program to + exercise all combinations of the sgr capability.
modified the hanoi test-program to show the minimum number - of moves possible for the given number of tiles.
+add tput-colorcube demo + script, imitating xterm's 88- and 256-color scripts using + tput.
modified the knight test-program to show the number of - choices possible for each position in automove option, e.g., - to allow user to follow Warnsdorff's rule to solve the - puzzle.
+add tput-initc script to + demonstrate how tput may be + used to initialize a color palette from a data file.
A variety of improvements were made to existing programs, both + new features as well as options added to make the set of programs + more consistent.
-This release provides improvements to tic's
- “-c
” checking option, which was used for
- example to
The ncurses program is the + largest; a proportionately large number of changes were made to + it:
make sgr
in several entries agree with other
- caps.
modify a/A screens to make exiting on an escape character + depend on the start of keypad and timeout modes, to allow + better testing of function-keys.
+ +add “t
” toggle for
+ notimeout
function.
correct padding in some entries where earlier versions had - miscounted the number of octal digits.
+modify layout of b/B screens to allow for additional + annotation on the right margin; some terminals with partial + support did not display well.
There are several new terminal descriptions:
- -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.
A few entries use extensions (user-defined terminal - capabilities):
+These changes were made to the other examples:
E3
, used in linux, putty and xterm-basic is
- tested in the clear
- program to erase a terminal's scrollback.
modify blue program to use + Unicode values for card-glyphs when available, as well as + improving the check for CP437 and CP850.
TS
is used in the
- xterm+sl building block to help deprecate the misuse of
- tsl
for xterm's title-string.
improve demo_menus program,
+ allowing mouse-click on the menu-headers to switch the active
+ menu. This requires a new extension option
+ O_MOUSE_MENU
to tell the menu driver to put
+ mouse events which do not apply to the active menu back into
+ the queue so that the application can handle the event.
XT
is used in some terminfo entries to
- improve usefulness for other applications than screen, which
- would like to pretend that xterm's title is a
- status-line.
correct logic in demo_terminfo program for
+ “-f
” option
xm
is used in examples
- xterm-1005 and
- xterm-1006 to illustrate a way to make mouse handling
- more general
modify ditto program to
+ allow $XTERM_PROG
environment variable to
+ override "xterm" as the name of the program to run in the
+ threaded configuration.
A few terminals support italics and/or dim capabilities. In
- particular, screen does not. Documented that, and accommodated
- the terminals where this feature works with the
- A_ITALIC
extension.
add several options to the “dots” + test-programs.
+modify filter program:
+ +getnstr
, that
+ polls for input while updating a clock on the right margin
+ as well as responding to window size-changes.--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:
-As usual, this release
+-n
” option by
+ simply reading the whole file.SIGWINCH
example; just
+ use KEY_RESIZE
.improves documentation by describing new features,
+improve animation in xmas
+ program by adding a time-delay in blinkit
.
attempts to improve the description of features which - users have found confusing
+modify several test-programs which call
+ use_default_colors
to consistently do this only
+ if the “-d
” option is given.
fills in overlooked descriptions of features which were - described in the NEWS file - but treated sketchily in manual pages.
+modify the install-rule for ncurses-examples to put the
+ data files in the data directory, e.g.,
+ /usr/share/ncurses-examples
.
In addition, the mechanism for producing HTML versions of the - documentation has been improved:
+modify several test programs to use new
+ popup_msgs
function, adapted from the
+ help-screen used in the edit_field
program.
use an improved version of man2html - to generate html manpages.
+modify test data for xterm palettes to use the newer + color4/color12 values.
regenerated - NCURSES-Programming-HOWTO.html to fix some of the broken - html emitted by docbook.
+improve the tracemunch + script:
+ +add_wch
,
+ color_content
and pair_content
to
+ dummy parameters.There are several new terminal descriptions:
+ +++ ++ +
dumb-emacs-ansi
,dvtm
, +dvtm-256color
,fbterm
, +iterm2
,linux-m1
minitel + entries,putty-noapp
,viewdata
, + andvt100+4bsd
building-block.+ +
xterm+noalt
,xterm+titlestack
, +xterm+alt1049
,xterm+alt+title
+ building blocks andxterm+direct
, +xterm+indirect
,xterm-direct
. from + xterm + patch #331.several other “
+-direct
” + descriptions to address the differences of other terminal + emulators versusxterm-direct
.
There are many changes to existing terminal descriptions. Some + were updates to several descriptions:
Ada95 binding:
+xterm+sm+1006
in several terminal
+ descriptions which were validated as supporting the extended
+ mouse feature for their respective terminal emulators.while others affected specific descriptions. These were + retested, to take into account new/undocumented changes by their + developers:
+ +++ ++
iterm
,minitel
,st
, +viewdata
,nsterm
while these are specific fixes based on user reports, or + warnings from tic:
+ +ansi
building blocksmodify makefile rules to ensure that the PIC option is - not used when building a static library
-ansi+idc
to better match original
+ ansiterm+idc
, add alias
+ ansiterm
make Ada95 build-fix for big-endian architectures such
- as sparc. This undoes one of the fixes from
- 20110319, which added an
- “Unused
” member to
- representation clauses, replacing that with pragmas to
- suppress warnings about unused bits.
icl6402
icl6402
and
+ m2-nam
Color and attributes:
+interix
parenthesize parameter of COLOR_PAIR
and
- PAIR_NUMBER
in curses.h in case it happens
- to be a comma-expression.
improve
- 20021221 workaround for broken acs, handling a case
- where that ACS_xxx character is not in the
- acsc
string but there is a known
- wide-character which can be used.
^?
for kdch1modify - init_pair to accept -1's for color value after - - assume_default_colors has been called.
-linux
add a check in - start_color to limit color-pairs to 256 when extended - colors are not supported.
-linux3.0
entry the default
+ linux
entrylinux2.6
entry to improve
+ line-drawing so that the linux3.0
entry can be
+ used in non-UTF-8 modelinux
+ and wyse
entries to put the delay between the
+ reverse/normal escapes rather than afterlinux-16color
to not mask dim,
+ standout or reverse with the ncv capabilityResizing the screen:
+pccon
entriespropagate error-returns from wresize, i.e., the - internal increase_size and decrease_size functions - through - resize_term.
-pccon*
entriesadd check for zero/negative dimensions for
- resizeterm
and resize_term
.
pccon+sgr+acs
and
+ pccon-base
modify resizeterm
to always push a
- KEY_RESIZE
onto the fifo, even if screensize
- is unchanged. Modify library to push a
- KEY_RESIZE
if there was a SIGWINCH, even if
- it does not call resizeterm
). These changes
- eliminate the case where a SIGWINCH is received, but ERR
- is returned from wgetch
or
- wgetnstr
because the screen dimensions did
- not change.
pccon+keys
Low-level interfaces
+tmux
fix an old bug in the termcap emulation;
- “%i
” was ignored in
- tparm
because the parameters to be
- incremented were already on the internal stack.
screen
's "standout" code rather than the
+ standard code.change “%l
” behavior in tparm
- to push the string length onto the stack rather than
- saving the formatted length into the output buffer.
xterm-keys
+ option to reflect upcoming change to make that option
+ "on" by defaultmodify name-comparison for tgetstr, etc., to - accommodate legacy applications as well as to improve - compatbility with BSD 4.2 termcap implementations (see - note for 980725).
-vt100
modify internal recursion in wgetch
which
- handles cooked mode to check if the call to
- wgetnstr
returned an error. This can happen
- when both nocbreak
and nodelay
- are set, for instance (see note for 960418).
vt100
rs2 string to reset
+ vt52 mode and scrolling regionsadd a check in internal function
- waddch_nosync
to ensure that tab characters
- are treated as control characters; some broken locales
- claim they are printable.
vt100-nam
modify menu library to ensure that a menu's top-row is - adjusted as needed to ensure that the current item is on - the screen
-vt100+4bsd
, e.g.,
+ delay in sgr for consistencyfix special case where double-width character - overwrites a single- width character in the first - column.
-vte
vte-2014
to
+ vte-2012
xterm
xterm-new
, available
+ since
+ late 1996.xterm+256color
and
+ xterm+256setaf
to use correct number of color
+ pairs.xterm-16color
,
+ xterm-88color
and xterm-256color
+ to reset palette using oc string as in
+ linux
entry.xterm-256color
xterm+256color
, allowing palette reset for
+ xtermxterm+256setaf
xterm-r5
, xterm-r6
and
+ xterm-xf86-v32
to use xterm+kbs
+ to match
+ xterm #272, reflecting packager's changesxterm-new
, to reflect vt220-style responses
+ that could be returned.xterm-pcolor
sgr consistent
+ with other capabilitiesA few entries use extensions (user-defined terminal + capabilities):
+ +tmux
and xterm-basic
As usual, this release
+ +improves documentation by describing new features,
+attempts to improve the description of features which + users have found confusing
+fills in overlooked descriptions of features which were + described in the NEWS + file but treated sketchily in manual pages.
In particular,
-Since the underlying features for + tset, + tput, and + clear have been better + integrated, the documentation now includes information on how + those tools evolved.
-The ncurses 6.0 configure script
- makes changes to the default value of several configure
- options, depending on the --with-abi-version
option
- (i.e., whether its value is “5” or
- “6”):
In addition to explaining the improved integration of the + tools, the manual pages made it easier to see how the tools + are similar and how they are different.
+--enable-const
The addch
manual page has additional
+ information on
+ portability and differences from other
+ implementations.
Feature introduced in 970405
- supports the use of const
where X/Open Curses
- should have, but did not. NetBSD curses does something
- similar with const
.
The discussion of color-pairs in the attributes + manual page is improved in its + history section.
+--enable-ext-colors
The documentation of the chtype
,
+ cchar_t
types and the attribute values which can
+ be stored in those types, in particular the
+ history and
+ portability sections of the attributes manual
+ page, has been improved.
Extends the cchar_t
structure to allow more
- than 16 colors to be encoded. This applies only to the
- wide-character (--enable-widec
)
- configuration.
improve discussion of + portability in the mouse manual.
+--enable-ext-mouse
The pad manual page has a section on the + origin and portability of pads.
+Modifies the encoding of mouse state to make room for a - 5th mouse button. That allows one to use ncurses with a wheel - mouse with xterm or similar X terminal emulators.
-Differences between SVr4 and X/Open Curses soft-keys are + discussed in a new section on + portability.
+--enable-ext-putwin
There are updated/improved notes on portability in the + + resizeterm and + wresize manual pages.
+Modifies the file-format written by putwin
to
- use printable text rather than binary files, allowing
- getwin
to read screen dumps written by
- differently-configured ncurses libraries. The extended
- getwin
can still read binary screen dumps from
- the same configuration of ncurses. This does not
- change the ABI (the binary interface seen by calling
- applications).
In addition to providing background information to explain + these features and show how they evolved, there are corrections, + clarifications, etc.:
---enable-interop
add note in the + addch manual about line-drawing when it depends + upon UTF-8.
+Modifies the FIELDTYPE
structure used for the
- form library to make it more generic.
improve discussion of line-drawing characters in the + + add_wch manual.
+--enable-lp64
explain in + clear's manual page that + it writes to the standard output.
+Allows an application to define _LP64
to
- declare chtype
and mmask_t
as
- simply “unsigned
” rather than the
- configured types using the --with-chtype
and
- --with-mmask_t
options.
improve description of + endwin.
+--enable-sp-funcs
improve discussion of field validation in the + form driver manual page.
+Compile-in support for extended functions which accept a - SCREEN pointer, reducing the need for juggling the global SP - value with - set_term and - delscreen.
-clarify the use of wint_t
vs
+ wchar_t
in
+ get_wstr manual page.
--with-chtype=uint32_t
clarify in the
+ getch manual that the keypad mode affects an
+ application's ability to read KEY_MOUSE
codes,
+ but does not affect KEY_RESIZE
.
Makes chtype
explicitly a 32-bit unsigned
- value.
trim some obsolete/incorrect wording about
+ EINTR
from the getch manual page
--with-mmask_t=uint32_t
improve manual pages for
+ getch and
+ get_wch to point out that they might return
+ user-defined values which have no predefined names in
+ <curses.h>
Makes mmask_t
explicitly a 32-bit unsigned
- value.
improve description of the -R
option in the
+
+ infocmp manual page
--with-tparm-arg=intptr_t
clarify in the
+ resizeterm manual page how
+ KEY_RESIZE
is pushed onto the input stream.
X/Open Curses declares
- tparm using long
for each of the parameters
- aside from the formatting string, presuming that
- long
and char*
are the same size.
- This configure option uses intptr_t
which
- provides a better guarantee of the sizes.
document return value of
+ use_extended_names
The configure script no longer checks for antique compilers;
- c89
is assumed as a minimum. There are a few
- features from later revisions which are used when available. The
- configure script makes checks to turn on useful warnings from
- clang, gcc and icc. You should be able to build ncurses 6.0 with any of the current (or not so
- current) C compilers available in 2015.
The configure script, by the way, makes changes which do not
- work with systems whose /bin/sh
is non-POSIX. This
- mainly affects Solaris (the other vendor unix systems have followed the POSIX guidelines
- for the past twenty years). If you must build on Solaris, its
- xpg4
- binaries suffice, e.g.,
- - -+- #!/bin/sh
-
- WHAT=`hostname|sed -e 's/\..*//'`
- - OUT=configure.out
- cat >>$OUT <<EOF/
- ** `date`
- ** node: $WHAT
- ** user: `id`
- ** conf: $*
- EOF/
-
- SHELL=/bin/sh
- if test -f /usr/xpg4/bin/sh
- - then
- CONFIG_SHELL=/usr/xpg4/bin/sh
- export CONFIG_SHELL
- - SHELL=$CONFIG_SHELL
- fi
-
- rm -f config.status config.cache
- TOP=$HOME/$WHAT
- $SHELL ./configure --verbose \
- - --disable-echo \
- - --disable-overwrite \
- - --enable-warnings \
- - --with-warnings \
- - --prefix=$TOP $* 2>&1 | tee -a $OUT
- -
document differences in
+ ESCDELAY
versus AIX's implementation in the
+ variables manual page.
Other major changes to the configure script include:
+The _nc_free_tinfo
function is now documented
+ in the
+ memory-leaks manual page, because it could be
+ used in tack for memory-leak
+ checking.
ABI 6 is now the default, intending that the existing ABI
- 5 should build as before using the
- “--with-abi-version=5
” option.
add a note to the + tic manual page about -W versus -f options.
added --with-extra-suffix
option to help with
- installing nonconflicting ncurses6 packages, e.g., avoiding
- header- and library-conflicts.
improve terminfo manual description of + terminfo syntax.
-NOTE: as a side-effect, this renames
+improve terminfo manual page discussion of + control- and graphics- characters.
--+-
adacurses-config
to -adacurses5-config
and
-adacursesw-config
to -adacursesw5-config
improve + color-handling section in terminfo manual page
+clarify description in + tput manual page regarding + support for termcap names
+ +update + tput manual page to + reflect changes to manipulate terminal modes by sharing + functions with tset.
+clarify in manual pages that the optional verbose option + level of + tic and + infocmp is available only + when ncurses is configured for + tracing.
the configure script looks for gnatgcc if the Ada95 - binding is built, in preference to the default gcc/cc. The - script also ensures that the Ada95 binding is built with the - level of optimization as the C libraries.
+improve manual page description of tset/reset + versus window-size.
the configure script captures define's related to - -D_XOPEN_SOURCE from the configure check and adds those to - the *-config and *.pc files, to simplify use for the - wide-character libraries.
+improve description of + tgoto parameters
There are new manual pages:
-There are several new (or extended) configure options:
+--disable-db-install
+ scr_dump documents the screen-dump format.
+Do not install the terminal database. This is used to omit
- features for packages, as done with
- --without-progs
. The option simplifies building
- cross-compile support packages.
Some of the improvements are more subtle, relating to the way + the information is presented:
---disable-gnat-projects
Made minor fixes to manpage NAME/SYNOPSIS + sections to consistently use rule that either all functions + which are prototyped in SYNOPSIS are listed in the + NAME section, or the manual-page name is the sole + item listed in the NAME section. The latter is used + to reduce clutter, e.g., for the top-level library manual + pages as well as for certain feature-pages such as + SP-funcs and + threading.
+This option is used for regression testing
-improve manual pages for utilities with respect to POSIX + versus X/Open Curses.
+--disable-lib-suffixes
improve organization of the + attributes and color manual + pages.
+Suppress the “w”, “t” or
- “tw” suffixes which normally would be added to
- the library names for the --enable-widec
and
- --with-pthread
options.
--with-cxx-shared
modify toe to not exit if + unable to read a terminal description, e.g., if there is a + permission problem.
+When --with-shared
is set, build libncurses++
- as a shared library. This implicitly relies upon building
- with gcc/g++, since other compiler suites may have
- differences in the way shared libraries are built. libtool by
- the way has similar limitations.
correct 20100515 change for weak signals versus + sigprocmask
+--with-hashed-db
gprconfig
to specify the C compiler to be
+ used by gnatmake
, and conditionally suppressing
+ Library_Options
line for static libraries.Extended this configure option to simplify building with - different versions of Berkeley database using FreeBSD - ports.
-There were, as well, several bug-fixes to handle illegal + input for tic. Because those + did not correspond to useful terminal descriptions, most + users are unaffected.
+--with-pc-suffix
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
This release provides a new binary format for terminal + descriptions that use extended numeric capabilities. Applications + built with the wide-character ncursesw library can use + these extended numbers.
-Configure xterm's terminfo entries to use either BS
- (^H
, i.e., ASCII backspace) or DEL
- (^?
, or 127).
This includes utilities such as tic and infocmp, because (as noted in New features), the feature + relies upon an extension to the low-level tinfo + library.
+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 + picsmap) give zero for these + out-of-range capabilities.
-Most of the portability-related work since - ncurses 5.9 extended and improved the MinGW port - introduced in - ncurses 5.8.
+The MinGW port can be readily cross-compiled:
+These changes provide support for tack 1.08, released in + July 2017:
modified configure script to allow creating dll's for - MinGW when cross-compiling.
+add --without-tack
configure option to refine
+ --with-progs
configure option. Normally
+ tack is built outside the
+ ncurses tree, but a few
+ packagers combine it during the build. If
+ term_entry.h
is installed, there is no advantage
+ to in-tree builds.
enforced Windows-style path-separator if - cross-compiling,
+adjust configure-script to define
+ HAVE_CURSES_DATA_BOOLNAMES
symbol needed for
+ tack 1.08 when built in-tree.
+ Rather than relying upon internal "_nc_" functions,
+ tack now uses the boolean,
+ number and string capability name-arrays provided by
+ ncurses and SVr4 Unix curses.
+ It still uses term_entry.h
for the definitions
+ of the extended capability arrays.
added scripts for test-builds of cross-compiled packages - for ncurses6 to MinGW.
+add dependency upon ncurses_cfg.h to tic's header-files; any program using + tic-library will have to + supply this file. Legacy tack + versions supply this file; ongoing tack development has dropped the + dependency upon tic-library + and new releases will not be affected.
Other changes to the configure-script and generated files + include
+added pc-files to the MinGW cross-compiling - test-packages.
+add configure options to disable checks for form, menu and + panel libraries so that ncurses-examples can be built with + non-SVr4 curses implementations.
added script for building test-packages of binaries - cross-compiled to MinGW using NSIS.
+add configure option --enable-opaque-curses
+ for ncurses library and similar options for the
+ other libraries.
added nc_mingw.h
to installed headers for
- MinGW port; this is needed for cross-compiling ncurses-examples.
add configure option --disable-wattr-macros
+ for use in cases where one wants to use the same headers for
+ ncurses5/ncurses6 development, by suppressing the
+ wattr* macros which differ due to the introduction
+ of extended colors
added test-packages for cross-compiling ncurses-examples - using the MinGW test-packages.
+modify configure macro for shared-library rules to use
+ -Wl,-rpath
rather than -rpath
to
+ work around a bug in scons
The MinGW-specific Windows driver accounts for several - changes:
- -wide-character display is made usable by replacing MinGW's
- non-working wcrtomb
and wctomb
- functions.
improve ncurses-examples' configure script to define as
+ needed NCURSES_WIDECHAR
for platforms where
+ _XOPEN_SOURCE_EXTENDED
does not work. Also
+ modified the test program to ensure that if building with
+ ncurses, that the
+ cchar_t
type is checked, since that is normally
+ (since 20111030)
+ ifdef'd depending on this test.
implemented some display features: beep, - flash, - - curs_set.
+modify configure script to handle the case where
+ tic-library is renamed, but
+ the --with-debug
option is used by itself
+ without normal or shared libraries
the driver handles repainting on endwin/refresh - combination.
+modify editing script which generates resulting.map to + work with the clang configuration on recent FreeBSD, which + gives an error on an empty "local" section.
modified treatment of TERM
variable for MinGW
- port to allow explicit use of the Windows console driver by
- checking if $TERM
is set to
- “#win32console
” or an abbreviation
- of that.
improve configure check for setting the
+ WILDCARD_SYMS
variable; on ppc64 the variable is
+ in the Data section rather than
+ Text.
the Windows driver also matches the special
- TERM
value “unknown”
correct result of configure option
+ --without-fallbacks
, which caused FALLBACK_LIST
+ to be set to "no"
the driver now returns characters for special keys, (like
- ansi.sys
does), when keypad mode is off, rather
- than returning nothing at all.
modify --with-pkg-config-libdir
option to
+ make it possible to install “.pc” files even if
+ pkg-config is not found. Limit
+ this change, to suppress the actual install if it is not
+ overridden to a valid directory at install time.
the driver checks a new environment variable
- NCURSES_CONSOLE2 to optionally work around a deficiency
- in Console2
(and its descendent
- ConsoleZ
) which hang when an application creates
- a console buffer.
disallow “no” as a possible value for
+ --with-shlib-version
option, overlooked in
+ cleanup-changes for 20000708.
Finally, there are other improvements:
+Many of the portability changes are implemented via the + configure script:
MinGW is one of the configurations where ncurses installs by default into /usr
+improve configure script's CF_CC_ENV_FLAGS
+ macro to allow for compiler wrappers such as ccache. This change moves only the
+ preprocessor, optimization and warning flags to
+ CPPFLAGS
and CFLAGS
, leaving the
+ residue in CC
. That happens to work for
+ gcc's various
+ “model” options, but may require tuning for other
+ compilers.
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.
isatty
calls with a macro, provide a
- corresponding set of support routines to address
- differences between MinGW and MSYS2.modify ncurses-examples' configure script to use + pkg-config for the extra + form/menu/panel libraries, to be more consistent with the + handling of the curses/ncurses library.
ensure WINVER
is defined in makefiles rather
- than using headers.
add configuration checks to build with NetBSD
+ curses, which for example lacks
+ use_env
.
add check for the gnatprep
- “-T
” option.
change ncurses-examples to use attr_t
vs
+ chtype
to follow X/Open documentation more
+ closely since Solaris xpg4-curses uses different values for
+ WA_xxx
vs A_xxx
+ that rely on attr_t being an unsigned short. Tru64 aka OSF1,
+ HPUX, AIX did as ncurses does,
+ equating the two sets.
work around a bug introduced by - gcc 4.8.1 in MinGW which breaks "trace" feature.
+modify several test programs to reflect that ncurses honors existing signal handlers in + initscr, while other implementations do not.
add a driver-name method to each of the drivers.
+add configure check for openpty
to
+ ncurses-examples' configure script, for ditto.
These changes affect certain platforms (ports):
+improve check for working poll
function by
+ using posix_openpt
as a fallback in case there
+ is no valid terminal on the standard input
the configure script knows how to build shared libraries - with DragonFlyBSD and Interix.
+modify ncurses-examples' configure script to check for + pthread dependency of + ncursest or ncursestw library when building + the ncurses examples, e.g., in + case weak symbols are used.
support for AIX shared libraries is improved, tested with - AIX 5.3, 6.1 and 7.1 with both gcc 4.2.4 and cc:
+add checks in ncurses-examples' configure script for some + functions neither in 4.3BSD curses, nor based on X/Open + Curses:
the shared-library suffix for AIX 5 and 6 is now - ".so"
+modify a loop limit in firework.c to work around + absense of limit checks in some libraries.
the -brtl
option is used with AIX 5-7; it
- is needed to link with the shared libraries.
fill the last row of a window with
+ “?
” in firstlast if waddch does
+ not return ERR
on the lower-right
+ corner.
the configure --enable-pc-files
option takes
- into account the PKG_CONFIG_PATH
- variable.
build-fixes for the Portland Group (PGI) compilers
-the configure option --with-pkg-config-libdir
- provides control over the actual directory into which
- pc-files are installed.
accept whitespace in sed expression for generating + expanded.c
+the build scripts add explicit -ltinfo, etc., to the
- generated ".pc" file when ld
option
- “--as-needed
” is used, or when
- ncurses and tinfo are installed without using rpath.
modify configure check that g++ compiler warnings are + not used.
+add configure check for -fPIC option needed for shared + libraries.
+the configure script disallows conflicting options
- “--with-termlib
” and
- “--enable-term-driver
”.
modify configure script for clang as used on FreeBSD, to + work around clang's differences in exit codes vs gcc.
the check for missing c++ compiler to work when no error - is reported, and no variables set is improved (see note for - 20021206).
+fixes for configure/build using clang on OSX
+ +do not redefine “inline” in
+ ncurses_cfg.h
; this was originally to solve
+ a problem with gcc/g++, but is aggravated by clang's
+ misuse of symbols to pretend it is gcc.
add braces to configure script to prevent unwanted
+ addition of “-lstdc++
” option to
+ the CXXLIBS
symbol.
improve/update test-program used for checking + existence of stdc++ library.
+if $CXXLIBS
is set, the linkage test uses
+ that in addition to $LIBS
.
the misc/gen_edit.sh script selects a "linux" entry which - works with the current kernel rather than assuming it is - always "linux3.0"
+fixes for OS/2:
+ +use button instead of kbuf[0]
in
+ EMX-specific part of lib_mouse.c
support building with libtool on OS/2
+use stdc++ library with OS/2 kLIBC
+clear configure script's cf_XOPEN_SOURCE
+ for OS/2, to work with its header files
the test/configure script makes it simpler to override - names of curses-related libraries, to help with linking with - pdcurses in MinGW environment.
+add “newer” baudrate symbols to the
+ baudrate
function in the ncurses library as
+ well as to a corresponding table in tset.
the configure-script/ifdef's allow the BSD OLD_TTY feature
- to be suppressed if the type of ospeed
is
- configured using the option --with-ospeed
to not
- be a short
. By default, it is a
- short
for termcap-compatibility.
modify ncurses-examples savescreen to work with AIX and HPUX.
the MKlib_gen.sh script works around a recent change in
- gcc 5 (released mid-2015) which essentially
- emits multiple #line
statements for the same
- position in a file.
define WIN32_LEAN_AND_MEAN
for MinGW port,
+ making builds faster.
the configure script works with Minix3.2 (see note - on portability)
+add a configure check for wcwidth versus the + ncurses line-drawing + characters, to use in special-casing systems such as Solaris. + Solaris, however, requires a special case that maps Unicode + line-drawing characters into the acsc string for non-Unicode + locales. Solaris also has a misconfigured wcwidth which marks + all of the line drawing characters as double-width.
OS/2 redux:
+string-hacks (non-standard):
the configure script supports OS/2 kLIBC.
+fix configure script to record when
+ strlcat
is found on OpenBSD.
add --enable-string-hacks
option to
+ ncurses-examples' configure script.
the --with-lib-prefix
option allows
- configuring for old/new flavors of OS/2 EMX.
completed string-hacks for sprintf, etc., + including the ncurses-examples programs.
+make --enable-string-hacks
option work
+ with Debian by checking for the "bsd" library and its
+ associated "<bsd/string.h>" header.
improved configure-script checks for
- _XOPEN_SOURCE
:
workaround for Debian's antique/unmaintained version of + mawk:
the definition works starting with Solaris 10.
+see Debian #65617, which was fixed in mawk's upstream releases in + 2009.
the definition is suppressed for IRIX64, since its
- header files have a conflict versus
- _SGI_SOURCE
.
related fixes when building link_test.
The ncurses package is fully +
The ncurses package is fully upward-compatible with SVr4 (System V Release 4) curses:
ncurses supports all of the +
ncurses supports all of the for SVr4 curses features including keyboard mapping, color, forms-drawing with ACS characters, and automatic recognition of keypad and function keys.
ncurses provides these SVr4 +
ncurses provides these SVr4 add-on libraries (not part of X/Open Curses):
ncurses's terminal database is - fully compatible with that used by SVr4 curses.
+ncurses's terminal database + is fully compatible with that used by SVr4 curses.
ncurses supports + user-defined capabilities which it can see, but which are + hidden from SVr4 curses applications using the + same terminal database.
+It can be optionally configured to match the format @@ -1880,23 +2401,23 @@ fflush(stdout);
Alternatively, ncurses can - be configured to use hashed databases rather than the +
Alternatively, ncurses + can be configured to use hashed databases rather than the directory of files used by SVr4 curses.
The ncurses utilities have +
The ncurses utilities have options to allow you to filter terminfo entries for use with less capable curses/terminfo versions such as the HP/UX and AIX ports.
The ncurses package also has many - useful extensions over SVr4:
+The ncurses package also has + many useful extensions over SVr4:
Unlike SVr3 curses, ncurses +
Unlike SVr3 curses, ncurses can write to the rightmost-bottommost corner of the screen if your terminal has an insert-character capability.
The functions keyok
and
define_key
allow you to better control the use
- of function keys, e.g., disabling the ncurses KEY_MOUSE, or by defining more than
- one control sequence to map to a given key code.
The tic/captoinfo - utility provided with ncurses has - the ability to translate many termcaps from the XENIX, IBM - and AT&T extension sets.
+ "https://invisible-island.net/ncurses/man/tic.1m.html"> + tic/captoinfo + utility provided with ncurses + has the ability to translate many termcaps from the XENIX, + IBM and AT&T extension sets.A BSD-like tset - utility is provided.
+ "https://invisible-island.net/ncurses/man/tset.1.html"> + tset utility is provided.The ncurses library and +
The ncurses library and utilities will automatically read terminfo entries from $HOME/.terminfo if it exists, and compile to that directory if it exists and the user has no write access to the system @@ -2030,9 +2553,9 @@ fflush(stdout);
The table-of-entries utility toe - makes it easy for users to see exactly what terminal types - are available on the system.
+ "https://invisible-island.net/ncurses/man/toe.1m.html"> + toe makes it easy for users to see exactly what + terminal types are available on the system.Extensive documentation is provided (see the + "https://invisible-island.net/ncurses/ncurses.faq.html#additional_reading"> Additional Reading section of the - ncurses FAQ for online documentation).
+ "https://invisible-island.net/ncurses/ncurses.faq.html"> + ncurses FAQ for online documentation).The ncurses distribution includes - a selection of test programs (including a few games). These are - available separately as ncurses-examples
+The ncurses distribution + includes a selection of test programs (including a few games). + These are available separately as ncurses-examples
The ncurses library has been tested with a wide variety of applications including:
--
- cdk
+- aptitude
+ +- +
+ +FrontEnd to Apt, the debian package manager
+ + +- cdk
- -
Curses Development Kit
http://invisible-island.net/cdk/
+ "https://invisible-island.net/cdk/">https://invisible-island.net/cdk/
- ded
+- ded
- -
directory-editor
+ "https://invisible-island.net/ded/">https://invisible-island.net/ded/- dialog
+- dialog
- -
the underlying application used in Slackware's setup, @@ -2091,56 +2623,57 @@ fflush(stdout); many systems.
+ "https://invisible-island.net/dialog/">https://invisible-island.net/dialog/- lynx
+- lynx
- -
the text WWW browser
+ "https://lynx.invisible-island.net/">https://lynx.invisible-island.net/- Midnight Commander
+- mutt
- -
-file manager
+mail utility
+ "http://www.mutt.org/">http://www.mutt.org/- mutt
+- ncftp
- -
-mail utility
+file-transfer utility
+ "https://www.ncftp.com/">https://www.ncftp.com/- ncftp
+- nvi
- -
-file-transfer utility
+New vi uses ncurses.
+ "https://sites.google.com/a/bostic.com/keithbostic/vi">https://sites.google.com/a/bostic.com/keithbostic/vi
+- nvi
+- ranger
- -
-New vi uses ncurses.
+A console file manager with VI key bindings in + Python.
+ "https://ranger.github.io/">https://ranger.github.io/- tin
+- tin
- + +
newsreader, supporting color, MIME
@@ -2148,24 +2681,32 @@ fflush(stdout);- vifm
+ +- +
File manager with vi like keybindings
+ + +
as well as some that use ncurses - for the terminfo support alone:
+as well as some that use ncurses for the terminfo support alone:
@@ -2208,31 +2749,41 @@ fflush(stdout);-
- minicom
+- minicom
- -
terminal emulator for serial modem connections
+ "https://alioth.debian.org/projects/minicom/">https://alioth.debian.org/projects/minicom/- mosh
+- mosh
- -
a replacement for
@@ -2174,32 +2715,32 @@ fflush(stdout); "https://mosh.mit.edu/">https://mosh.mit.edu/ssh
.- tack
+- tack
- -
terminfo action checker
+ "https://invisible-island.net/ncurses/tack.html">https://invisible-island.net/ncurses/tack.html- tmux
+- tmux
- -
terminal multiplexor
+ "https://github.com/tmux/tmux/wiki">https://github.com/tmux/tmux/wiki- vile
+- vile
vi-like-emacs may be built to use the terminfo, termcap or curses interfaces.
+ "https://invisible-island.net/vile/">https://invisible-island.net/vile/
@@ -2240,14 +2791,14 @@ fflush(stdout);-
- emacs
+- emacs
- + +
text editor
+ "https://www.gnu.org/software/emacs/">https://www.gnu.org/software/emacs/ +- less
+ +- +
-The most commonly used pager (a program that + displays text files).
+ +- screen
+- screen
- -
terminal multiplexor
+ "https://www.gnu.org/software/screen/">https://www.gnu.org/software/screen/- vim
+- vim
text editor
+ "https://www.vim.org/">https://www.vim.org/
Zeyd Ben-Halim started ncurses +
Zeyd Ben-Halim started ncurses from a previous package pcurses, written by Pavel Curtis. Eric S. Raymond continued development. Jürgen Pfeifer wrote most of the form and menu libraries. Ongoing development work is done by Thomas Dickey. Thomas Dickey also acts as the maintainer for the Free Software Foundation, which holds the copyright + "https://invisible-island.net/ncurses/ncurses-license.html">copyright on ncurses.
Contact the current maintainers at
@@ -2271,12 +2822,15 @@ fflush(stdout);This list is open to anyone interested in helping with the development and testing of this package.
-Beta versions of ncurses and +
Beta versions of ncurses and patches to the current release are made available at
ftp://invisible-island.net/ncurses/ .
+ "ftp://ftp.invisible-island.net/ncurses/">ftp://ftp.invisible-island.net/ncurses/ + and
+ https://invisible-mirror.net/archives/ncurses/ .
There is an archive of the mailing list here:
@@ -2296,34 +2850,28 @@ fflush(stdout);You can find lots of information on terminal-related topics not covered in the terminfo file at Library improvements
@@ -2392,23 +2938,15 @@ fflush(stdout);The ncurses (new curses) library - is a free software emulation of curses in System V Release 4.0 - (SVr4), and more. It uses terminfo format, supports pads and - color and multiple highlights and forms characters and +
The ncurses (new curses) + library is a free software emulation of curses in System V + Release 4.0 (SVr4), and more. It uses terminfo format, supports + pads and color and multiple highlights and forms characters and function-key mapping, and has all the other SVr4-curses - enhancements over BSD curses. SVr4 curses is better known today - as X/Open Curses.
+ enhancements over BSD curses. SVr4 curses became the basis of + X/Open Curses.In mid-June 1995, the maintainer of 4.4BSD curses declared that he considered 4.4BSD curses obsolete, and encouraged the - keepers of unix releases such as - BSD/OS, FreeBSD and NetBSD to switch over to ncurses.
+ keepers of unix releases such as + BSD/OS, FreeBSD and NetBSD to switch over to ncurses. -Since 1995, ncurses has been +
Since 1995, ncurses has been ported to many systems:
The distribution includes the library and support utilities, @@ -90,1743 +100,2252 @@ p,li { max-width:700px; }
Full manual pages are provided for the library and tools.
-The ncurses distribution is - available via anonymous FTP at the GNU distribution site
+The ncurses distribution is + available at ncurses' homepage:
-It is also available at + "ftp://ftp.invisible-island.net/ncurses/">ftp://ftp.invisible-island.net/ncurses/ + or
It is also available via anonymous FTP at the GNU distribution + site
+ "ftp://ftp.gnu.org/gnu/ncurses/">ftp://ftp.gnu.org/gnu/ncurses/ .
These notes are for ncurses - 6.0, released August 8, 2015.
+These notes are for ncurses + 6.1, released January 27, 2018.
This release is designed to be source-compatible with - ncurses 5.0 through 5.9; providing a - new application binary interface (ABI). Although the source can - still be configured to support the ncurses 5 ABI, the intent of the release is to - provide extensions which are generally useful, but - binary-incompatible with ncurses - 5:
+ ncurses 5.0 through 6.0; providing + extensions to the application binary interface (ABI). Although + the source can still be configured to support the ncurses 5 ABI, the intent of the release is to + provide extensions to the ncurses + 6 ABI:Extend the cchar_t
structure to allow more
- than 16 colors to be encoded.
improve integration of tput + and tset
Modify the encoding of mouse state to make room for a 5th - mouse button. That allows one to use ncurses with a wheel mouse with xterm or - similar X terminal emulators.
+provide support for extended numeric capabilities.
There are, of course, numerous other improvements, - including
+There are, of course, numerous other improvements, listed in + this announcement.
+ +The release notes also mention some bug-fixes, but are focused + on new features and improvements to existing features since + ncurses 6.0 release.
+ +The improved integration of tput and tset + made only small changes to the libraries. However, supporting + extended numeric capabilities required a few changes:
fixes made based on the Clang and Coverity static - analyzers.
+The TERMINAL
structure in
+ <term.h>
is now opaque. Doing that allowed
+ making the structure larger, to hold the extended numeric
+ data.
A few applications required changes during development of + ncurses 6.1 because those + applications misused the members of that structure, e.g., + directly modifying it rather than using + def_prog_mode.
memory leak fixes using Valgrind
-Having made TERMINAL
opaque (and because none
+ of the library functions use anything except a pointer to
+ TERMINAL
), it was possible to increase the size
+ of the structure, adding to the end.
The release notes mention some bug-fixes, but are focused on - new features and improvements to existing features log since - ncurses 5.9 release.
+Existing applications which were linked to the
+ ncurses 6.0 high-level
+ (ncurses, ncursesw) and low-level
+ (tinfo, tinfo) libraries should not require
+ re-linking since the binary interface did not change, nor did
+ the structure offsets with TERMINAL
change.
While the intent of the release is to provide a new stable - ABI, there are other development activities which are summarized - below.
+A few applications use the inner TERMTYPE
+ structure's offsets to refer to terminfo capabilities within
+ that structure. Again, those do not require modification
+ because their offsets within TERMINAL
did not
+ change.
The original release plan, e.g., for "5.10" was to improve
- the MinGW port. Ultimately that was completed (wide-character
- support, mouse, etc), but was deferred to focus on termcap
- support and performance issues. Also, pinpointing the
- problems with Console2
took a while.
When configured for wide-characters, i.e.,
+ “ncursesw” the TERMINAL
structure is
+ extended.
The new data in TERMINAL
holds the same
+ information as TERMTYPE
, but with larger numbers
+ (“int” versus “short”). It is named
+ TERMTYPE2
.
The library uses this structure internally in preference
+ to TERMTYPE
, referring to TERMTYPE
+ only to initialize it for applications that use the
+ capabilities defined in <term.h>
A review of termcap compatibility in 2011 led to several - minor fixes in the library and improvements to utilities. To - do this properly, a review of the various extent termcap - implementations was needed.
+When configured for 8-bit (narrow) characters, the
+ TERMTYPE2
structure is not used.
The termcap - library checker (tctest) (not part of ncurses) was one result. A followup review - of performance using ncurses-examples - in 2014 led to additional improvements.
+The motivation for making this extension came from noticing + that + termcap applications could (though not + realistically) use larger numbers than would fit in 16-bits, + and the fact that the number of color pairs for a 256-color xterm + could not be expressed in terminfo (i.e., 32767 versus 65536). + Also, a few terminals support direct-colors, which could use the + extension.
+ +Generally speaking, applications that use internal details of
+ a library are unsupported. There was exactly one exception for
+ ncurses: the tack program used the internal
+ details of TERMINAL
, because it provides an
+ ncurses-specific feature for interactively modifying a terminfo
+ description and writing the updated description to a text-file.
+ It was possible to not only separate tack from these internal
+ details of ncurses, but to
+ generalize it so that the program works with Unix curses
+ (omitting the ncurses-specific feature). That was released as
+
+ tack 1.08 in July
+ 2017.
While making changes to tack to + eliminate its dependency upon ncurses internals, the publicly-visible + details of those internals were reviewed, and some symbols were + moved to private header files, while others were marked + explicitly as ncurses internals. + Future releases of ncurses may + eliminate some of those symbols (such as those used by + tack 1.07) because they are + neither part of the API or the ABI.
+ +Using the TERMTYPE2
extended numeric
+ capabilities, it is possible to support both color pair values
+ and color values past 32767. Taking compatibility into account,
+ developers readily understand that neither function signatures
+ nor structure offsets change. Also, existing functions have to
+ operate with the extended numbers. Most of that work is internal
+ to the library. For the external interfaces, a hybrid approach
+ was used:
X/Open Curses defined function prototypes such as
+ wattr_set
with an unused parameter, for
+ “future” use. After 25 years, the future is here:
+ ncurses uses the parameter to
+ augment color pair values as described in the
+ manual page.
Output buffering provided a further, but worthwhile
- distraction. A bug report in 2012 regarding the use of signal
- handlers in ncurses) pointed out
-
- a problem with the use of unsafe functions for handling
- SIGTSTP
. Other signals could be addressed with
- workarounds; repairing SIGTSTP
required a
- different approach. The solution required changing internal
- behavior of the library: how it handles output buffering.
Now ncurses buffers its own - output, independently of the standard output. A few - applications relied upon the library's direct reuse of the - standard output buffering; however that is - unspecified behavior and has never been a - recommended practice. Identifying these applications as well - as refining the change to permit low-level applications to - work consistently took time.
-Since the introduction of the experimental support for 256 - colors early in 2005 - (released in ncurses - 5.5), there has been increased user interest. Almost all - packagers continue providing the ncurses ABI 5 which cannot - support 256 colors.
-Symbol versioning, or the lack of it in ncurses, is the - main reason why packagers would be reluctant to add a new - ncurses ABI.
- -This release provides the new ABI along with - script-generated lists of versioned symbols which can be used - for both ABI 5 and 6 (with distinct names to keep the two - separate). This took time to development, as reported in - Symbol - versioning in ncurses.
+Other functions such as those defining color pairs did not
+ have a corresponding reserved parameter. For those,
+ ncurses defines extended
+ versions such as init_extended_pair
(versus
+ init_pair
), init_extended_color
+ (versus init_color
).
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
.
X/Open curses provides more than one initialization - function:
+New "RGB" extension capability for direct-color support is
+ used to improve performance of
+ color_content
.
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.
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:
+These are new or revised features:
to get good performance, curses (not only ncurses, but SVr4 curses in general) set an
- output buffer using setbuf
or similar function.
- There is no standard (or portable) way to turn that output
- buffer off, and revert to line-buffering. The
- NCURSES_NO_SETBUF
environment variable did make it
- optional.
modify c++/etip.h.in
to accommodate
+ deprecation of throw and throws in c++17
to handle SIGTSTP
(the “stop”
- signal), ncurses relied upon
- unsafe functions. That is, due to the complexity of the
- feature, it relied upon reusing existing functions which
- should not have been called via the signal handler.
add new function unfocus_current_field
Conveniently, solving the second problem (by making ncurses do its own output buffering) - also fixed the first one. But there were special cases to - resolve: - low-level functions such as mvcur, putp, vidattr - explicitly use the standard output. Those functions were reused - internally, and required modification to distinguish whether they - were used by the high-level or low-level interfaces.
+add option to preserve leading whitespace in form + fields
+Finally, there may still be a few programs which should be - modified to improve their portability, e.g., adding an
+add a macro for is_linetouched
and adjust the
+ function's return value to make it possible for most
+ applications to check for an error-return.
-+-fflush(stdout); --
add build-time utility report_offsets
to help
+ show when the various configurations of tinfo library are
+ compatible or not.
when switching from “shell”
- mode to “program”
- (curses) mode. Those are fairly rare because most programmers
- have learned not to mix printf
and printw
.
This release introduces symbol-versioning to ncurses because without it, the change of ABI - would be less successful. A lengthy discussion will be presented - in Symbol - versioning in ncurses. These - notes summarize what has changed, and what can be done with the - new release.
- -Symbol-versioning allows the developers of a library to mark - each public symbol (both data and functions) with an identifier - denoting the library name and the version for which it was built. - By doing this, users of the library have a way to help ensure - that applications do not accidentally load an incompatible - library. In addition, private symbols can be hidden entirely.
- -This release provides sample files for the four principal
- configurations of ncurses libraries:
- ncurses
, ncursesw
,
- ncursest
and ncursestw
. Each sample is
- given in two forms:
These were done to limit or ultimately deprecate features:
--+-
-- “
+.map
”+
- +
-drop two symbols obsoleted in 2004: +
+_nc_check_termtype
, and +_nc_resolve_uses
- These list all public symbols, together with version - names.
+- +
-move
+_nc_tracebits
,_tracedump
+ and_tracemouse
tocurses.priv.h
, + since they are not part of the suggested ABI6.- “
+.sym
”- +
-mark some structs in form/menu/panel libraries as + potentially opaque without modifying API/ABI.
+- These list all public symbols, without version - names.
-
ifdef'd header-file definition of mouse_trafo
+ with NCURSES_NOMACROS
The sample files are generated by scripts which take
- into account a few special cases such as tack to omit
- many of the ncurses private symbols
- (beginning with “_nc_
”). Here are
- counts of globals versus locals:
remove initialization-check for calling napms
+ in the term-driver configuration; none is needed.
-+-
-- +Config ++ + -modify
+trace
to avoid overwriting existing + fileSymbols +These are improvements to existing features:
-Globals ++
- +
-modify
+make_hash
to allow building with + address-sanitizer, assuming that--disable-leaks
+ is configured.Locals +- +
-move
+SCREEN
field foruse_tioctl
+ data before the ncursesw fields, and limit that to the + sp-funcs configuration to improve termlib compatibility"_nc_" -+ modify db-iterator:
-- +ncurses ++
+ -- +
-ignore zero-length files in db-iterator; these are + useful for instance to suppress +
+$HOME/.terminfo
when not wanted.976 +- +
+modify
+update_getenv
to ensure that + environment variables which are not initially set will be + checked later if an application happens to set them796 ++ -modify
+_nc_outc_wrapper
to use the standard + output if the screen was not initialized, rather than + returning an error.180 ++ -improve checks for low-level terminfo functions when the + terminal has not been initialized.
+332 -+ -modify
+set_curterm
to update +ttytype[]
data used by longname/p>- +ncursesw ++ -modify
+_nc_get_screensize
to allow for +use_env
anduse_tioctl
state to be + per-screen when sp-funcs are configured, better matching the + behavior when using the term-driver configuration.1089 ++ -remove an early-return from
+_nc_do_color,
+ which can interfere with data needed bybkgd
+ when ncurses is configured + with extended colors905 ++ -incorporate
+A_COLOR
mask into +COLOR_PAIR
, in case user application provides an + out-of-range pair number184 ++ + -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 formvcur
, + e.g., in the sample program dots_mvcur for the term-driver + configuration.343 -These are corrections to existing features:
-- +ncursest ++
- +
-fixes for writing extended color pairs in +
+putwin
.979 +- +
-modify no-leaks code for
+lib_cur_term.c
to + account for thetgetent
cache.804 +- +
-amend handling of the
+repeat_char
capability + inEmitRange
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.175 +- +
-improve wide-character implementation of +
+myADDNSTR
infrm_driver.c
, which + was inconsistent with the normal implementation.358 -+ -modify
+winnstr
andwinchnstr
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.- -ncursestw ++ -modify
+setupterm
to save original tty-modes + so thaterasechar
works as expected. Also modify +_nc_setupscreen
to avoid redundant calls to get + original tty-modes.1098 ++ -modify
+wattr_set
andwattr_get
+ to returnERR
if win-parameter is null, + as documented.914 ++ -correct order of initialization for traces in +
+use_env
anduse_tioctl
versus first +_tracef
calls.184 ++ -correct parameters for
+copywin
call in +_nc_Synchronize_Attributes
372 -
flush the standard output in _nc_flush
for
+ the case where SP
is zero, e.g., when called via
+ putp
. This fixes a scenario where
+ “tput flash” did not work after changes in
+ 20130112.
Although only four sample configurations are presented, each - is formed by merging symbols from several combinations of - configure-script options, taking into account advice from - downstream packagers. Because they are formed by merging, the - sample files may list a symbol which is not in a given package. - That is expected. The samples have been tested and are working - with systems (such as Fedora, FreeBSD and Debian) which fully - support this feature. There are other systems which do - not support the feature, and a few (such as Solaris) - which provide incomplete support.
- -The version-naming convention used allows these sample files - to build distinct libraries for ABI 5 and 6. Version names - consist of
+amend internal use of tputs
to consistently
+ use the number of lines affected, e.g., for insert/delete
+ character operations. While merging terminfo source early in
+ 1995, several descriptions used the
+ “*
” proportional delay for these
+ operations, prompting a change in doupdate
.
configuration name, e.g.,
- “NCURSESW
” for the wide-character
- libraries
correct return-value of extended putwin
.
ABI version (if not 5)
+double-width multibyte characters were not counted
+ properly in winsnstr
and
+ wins_nwstr
.
library name for two special cases which have the same
- interface across configurations:
- “TINFO
” and
- “TIC
”
amend fix for _nc_ripoffline
from 20091031 to
+ make test/ditto.c
work in threaded
+ configuration.
release version
+modify _nc_viscbuf2
and
+ _tracecchar_t2
to trace wide-characters as a
+ whole rather than their multibyte equivalents.
patch date (for the release version)
+minor fix in wadd_wchnstr
to ensure that each
+ cell has nonzero width.
For example, running nm -D
on the libraries in
- the ncurses6 test package shows these symbol-versions:
move PUTC_INIT
calls next to
+ wcrtomb
calls, to avoid carry-over of error
+ status when processing Unicode values which are not
+ mapped.
-+-0000000000000000 A NCURSES6_TIC_5.0.19991023 -0000000000000000 A NCURSES6_TIC_5.1.20000708 -0000000000000000 A NCURSES6_TIC_5.5.20051010 -0000000000000000 A NCURSES6_TIC_5.7.20081102 -0000000000000000 A NCURSES6_TIC_5.9.20150530 -0000000000000000 A NCURSES6_TINFO_5.0.19991023 -0000000000000000 A NCURSES6_TINFO_5.1.20000708 -0000000000000000 A NCURSES6_TINFO_5.2.20001021 -0000000000000000 A NCURSES6_TINFO_5.3.20021019 -0000000000000000 A NCURSES6_TINFO_5.4.20040208 -0000000000000000 A NCURSES6_TINFO_5.5.20051010 -0000000000000000 A NCURSES6_TINFO_5.6.20061217 -0000000000000000 A NCURSES6_TINFO_5.7.20081102 -0000000000000000 A NCURSES6_TINFO_5.8.20110226 -0000000000000000 A NCURSES6_TINFO_5.9.20150530 -0000000000000000 A NCURSESW6_5.1.20000708 -0000000000000000 A NCURSESW6_5.3.20021019 -0000000000000000 A NCURSESW6_5.4.20040208 -0000000000000000 A NCURSESW6_5.5.20051010 -0000000000000000 A NCURSESW6_5.6.20061217 -0000000000000000 A NCURSESW6_5.7.20081102 -0000000000000000 A NCURSESW6_5.8.20110226 -0000000000000000 A NCURSESW6_5.9.20150530 --
add missing assignment in lib_getch.c
to make
+ notimeout
work
As a special case, this release (which makes the final change - for ABI 5) is marked with release version 5.9 and patch date - 20150530.
+While reviewing user feedback, it became apparent that the + differences between + reset (an alias for + tset) and “tput reset” were confusing:
-The new release has several improvements for performance and - building. For instance:
+On further investigation, it turned out that the differences + were largely an accident due to the way those programs had + evolved.
+ +This release eliminates the unnecessary differences, using the + same approach for tput's + init (initialization), reset and clear + operations as the separate + reset and + clear programs. Doing this does not change the + command-line options; existing scripts are unaffected.
+ +These are the user-visible changes for the three programs + (tput, tset and clear):
several files in ncurses- and progs-directories were
- modified to allow const
data used in internal
- tables to be put by the linker into the readonly text
- segment.
add the terminal-mode parts of “reset” (aka tset) to the “tput
+ reset
” command, making the two almost the same
+ except for window-size.
various improvements were made to building the Ada95
- binding, both in simplifying the generated files as well as
- improving the way it uses gnatmake
improve tput's check for + being called as “init” or “reset” to + allow for transformed names.
There are also new features in the libraries:
+add “clear” as a possible link/alias to + tput.
+amend changes for tput to + reset tty modes to “sane” if the program is run + as “reset”, like tset. Likewise, ensure that tset sends either reset- or + init-strings.
+added - wgetdelay to retrieve _delay member of WINDOW if it - happens to be opaque, e.g., in the pthread configuration.
+add -x
option to clear/tput
+ to make the E3
extension optional
added - A_ITALIC extension.
+add functionality of
+ “tset -w
” to tput, like the
+ “-c
” feature this is not optional in
+ tput.
added form library extension - O_DYNAMIC_JUSTIFY option which can be used to override - the different treatment of justification for static versus - dynamic fields .
+add options -T
and -V
to
+ clear command for
+ compatibility with tput.
rewrote - putwin and - getwin, making an extended version which is capable of - reading screen-dumps between the wide/normal ncurses configurations. These are text - files, except for a magic code at the beginning:
+drop long-obsolete “-n
” option
+ from tset.
-+-0 string \210\210 Screen-dump (ncurses) --
modify tset's assignment to
+ TERM
in its output to reflect the name by which
+ the terminal description is found, rather than the primary
+ name. That was an unnecessary part from the initial
+ conversion of tset from
+ termcap to terminfo. The termcap library in 4.3BSD did this
+ to avoid using the short 2-character name
several changes to mouse support include:
+remove a restriction in tput's support for termcap names which + omitted capabilities normally not shown in termcap + translations
+add usage message to clear + command
+improve usage messages for tset and tput.
+Other user-visible improvements and new features include:
+ +modify tic/infocmp display of numeric values to use + hexadecimal when they are "close" to a power of two, making + the result more readable.
+add “-W
” option to tic/infocmp
+ to force long strings to wrap.
This is in addition to the
+ “-w
” option which attempts to
+ fit capabilities into a given line-length.
%u
” format to terminfo.If “-f
” option splits line,
+ do not further split it with
+ “-W
”.
Begin a new line when adding
+ “use=
” after a wrapped line.
There are a few new configure options dealing with library - customization:
+add “-q
” option to infocmp to suppress the
+ “Reconstructed from
” comment from
+ the header, and a corresponding option to tic to suppress all comments from the
+ “tic -I
” output.
add “--enable-ext-putwin
”
- configure option to turn on the extended putwin/getwin. By
- default, this is enabled for ABI 6 and disabled with ABI
- 5.
Sorted options in usage message for infocmp, to make it simpler to see unused + letters.
add “--enable-string-hacks
”
- option to control whether strlcat and strlcpy may be used.
- Because ncurses already does the
- requisite buffer-limit checks, this feature is mainly of
- interest to quiet compiler-warnings on a few systems.
Updated usage message for tic, adding “-0
”
+ option.
add configure option
- “--with-tparm-arg
” to allow
- tparm's parameters to be something more likely to be the
- same size as a pointer, e.g., intptr_t
(again,
- the default is set for ABI 6).
add infocmp/tic “-Q
” option,
+ which allows one to dump the compiled form of the terminal
+ entry, in hexadecimal or base64:
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.hex:
” prefix tells the
+ terminfo reader to accept hexadecimal data as generated by
+ “infocmp -0qQ1
”.Most of the termcap-related changes based on development of
- tctest
- (termcap library checker) are implemented in the tic and
- infocmp programs rather than affecting the library. As noted in
- the
- discussion of tctest
, ncurses's ability to translate between terminfo
- and termcap formats has been improved at different times, but
- subject to feedback from "real" termcap users. There are very few
- of those. Nowadays, virtually all termcap users are
- using ncurses (or NetBSD, with its
- own terminfo library) and their programs are actually using
- terminfo rather than termcap data.
Still, there are a few. A comment about the translation of the
- ASCII NUL
character prompted a review:
Other less-visible improvements and new features include:
Both terminfo and termcap store string capabilities as
- NUL
-terminated strings.
modify utility headers such as tic.h
to make
+ it clearer which are externals that are used by tack.
In terminfo, a \0
in a terminal description
- is stored as \200
.
add “reset
” to list of programs
+ whose names might change in manpages due to
+ program-transformation configure options.
There are no (known) terminals which would behave
- differently when sent \0
or
- \200
.
modify “-T
” option of
+ clear and tput to call use_tioctl
to
+ obtain the operating system's notion of the screensize if
+ possible.
When translating to terminfo format (or displaying a
- printable version of an entry using infocmp), ncurses shows \200
as
- \0
.
add check in tput for + init/reset operands to ensure those use a terminal.
It has done this since 1998 (quoting from the NEWS - file):
- --+-980103 -... - + modify _nc_tic_expand() to generate \0 rather than \200. -... - + correct translation of terminfo "^@", to \200, like \0. --
modify programs clear, + tabs, tput and tset to pass the actual tty file + descriptor to setupterm rather than the standard output or + error, making padding work.
However, the _nc_tic_expand
function (which
- optionally produces terminfo or termcap format) did not
- address this special case for termcap. Even the later 4.4BSD
-
- cgetstr interprets a \0
literally, ending
- that string (rather than using the terminfo
- improvement).
change tset's
+ initialization to allow it to get settings from the standard
+ input as well as /dev/tty
, to be more effective
+ when output or error are redirected.
As a result of the review, several improvements were made to - ncurses translation to/from termcap - format — and improving the checks made in tic for - consistency of entries. Most of these are not of general - interest, except for two new command-line options for tic and - infocmp:
- -the “-0
” option generates
- termcap/terminfo source on a single line.
amend check in tput,
+ tabs and clear to allow those to use the
+ database-only features in cron
+ if a “-T
” option gives a suitable
+ terminal name.
the “-K
” option provides stricter
- BSD-compatibility for termcap output.
improve error message from tset/reset + when both stderr/stdout are redirected to a file or pipe.
Other user-visible improvements and new features include:
+Several of the less apparent features deal with translation of + terminfo to termcap (and the reverse), with corresponding checks + by tic:
added “-D
” option to tic and
- infocmp, to show the database locations that it could
- use.
modify check in fmt_entry
to handle a
+ cancelled reset string. Make similar fixes in other parts of
+ dump_entry.c
and tput.c
added “-s
” option to toe, to sort
- its output.
correct read of terminfo entry in which all strings are + absent or explicitly cancelled. Before this fix, the result + was that all were treated as only absent.
extended “-c
” and
- “-n
” options of infocmp to allow
- comparing more than two entries.
modify infocmp to suppress
+ mixture of absent/cancelled capabilities that would only show
+ as “NULL, NULL
”, unless the
+ “-q
” option is used, e.g., to show
+ “-, @
” or “@,
+ -
”.
modified toe's report when “-a
”
- and “-s
” options are combined, to
- add a column showing which entries belong to a given
- database.
correct a warning from tic + about keys which are the same, to skip over missing/cancelled + values.
modified the clear program to take into account the
- “E3
” extended capability to clear
- the terminal's scrollback buffer.
add check in tic for use of
+ bold, etc., video attributes in the color capabilities,
+ accounting whether the feature is listed in
+ ncv
.
add check in tic for
+ unnecessary use of “2
” to denote a
+ shifted special key.
Along with the library and utilities, many improvements were - made to the ncurses-examples. - Some were made to allow building (and comparison-testing) against - NetBSD curses and PDCurses. Both lack some of the X/Open Curses - features, necessitating customization. But this activity was - useful because it showed some remaining performance issues (which - have been resolved in this release).
+improve check in tic for + delays by also warning about beep/flash when a delay is not + embedded, or if those use the VT100 reverse video escape + without using a delay.
+These changes were made to verify compatibility or compare - performance of ncurses:
+improve checks in trim_sgr0
, comp_parse.c and
+ parse_entry.c, for cancelled string capabilities.
made workarounds for compiling test-programs with NetBSD - curses, though it lacks some common functions such as - - use_env.
+add check in tic for some + syntax errors of delays, as well as use of proportional + delays for non-line capabilities.
added dots_termcap test-program
+add check in tic for
+ conflict between ritm
, rmso
,
+ rmul
versus sgr0
.
added dots_curses test-program, for comparison with the - low-level examples.
+add check in _nc_parse_entry
for invalid
+ entry name, setting the name to
+ “invalid
” to avoid problems storing
+ entries.
added test_setupterm test-proram to demonstrate - normal/error returns from the setupterm and restartterm - functions.
+improve _nc_tparm_analyze
, using that to
+ extend the checks made by tic
+ for reporting inconsistencies between the expected number of
+ parameters for a capability and the actual.
added “-d
”,
- “-e
” and
- “-q
” options to the demo_terminfo
- and demo_termcap test-programs.
remove tic warning about
+ “^?
” in string capabilities, which
+ was marked as an extension; however all Unix implementations
+ support this and X/Open Curses does not address it. On the
+ other hand,
+ BSD termcap did not support this feature (until the
+
+ mid-1990s).
in _nc_infotocap
, added a check to ensure
+ that terminfo “^?
” is not written to
+ termcap.
added “-y
” option to demo_termcap
- and test/demo_terminfo test-programs to demonstrate behavior
- with/without extended capabilities.
modify sscanf
calls in
+ _nc_infotocap
for patterns
+ “%{number}%+%c
” and
+ “%'char'%+%c
” to check that the
+ final character is really “c
”,
+ avoiding a case in icl6404 which cannot be converted to
+ termcap.
modified demo_termcap and demo_terminfo test-programs to
- make their options more directly comparable, and add
- “-i
” option to specify a terminal
- description filename to parse for names to lookup.
in _nc_tic_expand
and
+ _nc_infotocap
, improved string-length check when
+ deciding whether to use “^X
” or
+ “\xxx
” format for control
+ characters, to make the output of tic/infocmp
+ more predictable.
rewrote the tests for - mvderwin and test for recursive - mvwin in the movewindow test-program.
+limited termcap “%d
” width to 2
+ digits on input, and use “%2
” in
+ preference to “%02
” on output.
correct terminfo/termcap conversion of
+ “%02
” and
+ “%03
” into
+ “%2
” and
+ “%3
”; the result repeated the last
+ character.
These changes were made to help with the MinGW port:
+Along with the library and utilities, many improvements were + made to the ncurses-examples.
+ +These changes were made to demonstrate new extensions in + ncurses:
added test-screens to the ncurses test-program to show - 256-characters at a time, to help with MinGW port.
+add demo_new_pair program,
+ to demonstrate
+ alloc_pair
,
+ find_pair
and
+ free_pair
functions.
This program iterates over the possible color + combinations, allocating or initializing color pairs. For + best results, choose screen-width dividing evenly into the + number of colors. e.g.,
+ +++
++ + ++ + 32x64,32x128
256 colors ++ + ++ + 24x44,24x88
88 colors ++ ++ + 32x64,24x128
16 colors +
modified the view test-program to load UTF-8 when built - with MinGW by using regular win32 API because the MinGW - functions mblen and mbtowc do not work.
+add extended_color program, + like the older color_set + program, but using the extended color functions, with and + without the SP-functions interface.
added “-s
” option to the view
- test-program to allow it to start in single-step mode,
- reducing size of trace files when it is used for debugging
- MinGW changes.
add picsmap program to fill + in some testing issues not met by dots, using this as the third example in a + comparison of the + ncurses versus slang libraries.
+ +The program can directly read X bitmap and pixmap files, + displaying a picture. It can read other image files using + ImageMagick's convert program to translate the image + into text.
+ +For 16-, 88- and 256-color terminal descriptions,
+ picsmap can load a palette
+ file which tells it which color palette entries to use. For
+ direct-colors, the terminal descriptions use the
+ RGB
extension capability.
These changes were made to verify new extensions in ncurses:
+There are other new example programs and a few scripts:
added - form_driver_w entrypoint to wide-character forms library, - as well as form_driver_w test-program.
+add dots_xcurses program to + illustrate a different approach used for extended colors + which can be contrasted with dots_curses.
modified ncurses test-program's b/B tests to display lines - only for the attributes which a given terminal supports, to - make room for an italics test.
+add list_keys program show + function keys for one or more terminal descriptions. It uses + ncurses's convention of + modifiers for special keys, based on xterm.
modified ncurses test-program, adding
- “-E
” and
- “-T
” options to demonstrate use_env
- versus use_tioctl.
add padview program, to + compare pads with direct updates in the view program.
modified ncurses test-program's c/C tests to cycle through - subsets of the total number of colors, to better illustrate - 8/16/88/256-colors by providing directly comparable - screens.
+add sp_tinfo program to + exercise the SP-functions extension of the low-level terminfo + library.
modified the ncurses test-program to also show position - reports in 'a' test.
+add test-programs for termattrs
and
+ term_attrs
functions.
These changes were made to make the examples more useful:
-added scripts for building dpkg and rpm test-packages
+add test_sgr program to + exercise all combinations of the sgr capability.
modified the hanoi test-program to show the minimum number - of moves possible for the given number of tiles.
+add tput-colorcube demo + script, imitating xterm's 88- and 256-color scripts using + tput.
modified the knight test-program to show the number of - choices possible for each position in automove option, e.g., - to allow user to follow Warnsdorff's rule to solve the - puzzle.
+add tput-initc script to + demonstrate how tput may be + used to initialize a color palette from a data file.
A variety of improvements were made to existing programs, both + new features as well as options added to make the set of programs + more consistent.
-This release provides improvements to tic's
- “-c
” checking option, which was used for
- example to
The ncurses program is the + largest; a proportionately large number of changes were made to + it:
make sgr
in several entries agree with other
- caps.
modify a/A screens to make exiting on an escape character + depend on the start of keypad and timeout modes, to allow + better testing of function-keys.
+ +add “t
” toggle for
+ notimeout
function.
correct padding in some entries where earlier versions had - miscounted the number of octal digits.
+modify layout of b/B screens to allow for additional + annotation on the right margin; some terminals with partial + support did not display well.
There are several new terminal descriptions:
- -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.
A few entries use extensions (user-defined terminal - capabilities):
+These changes were made to the other examples:
E3
, used in linux, putty and xterm-basic is
- tested in the clear
- program to erase a terminal's scrollback.
modify blue program to use + Unicode values for card-glyphs when available, as well as + improving the check for CP437 and CP850.
TS
is used in the
- xterm+sl building block to help deprecate the misuse of
- tsl
for xterm's title-string.
improve demo_menus program,
+ allowing mouse-click on the menu-headers to switch the active
+ menu. This requires a new extension option
+ O_MOUSE_MENU
to tell the menu driver to put
+ mouse events which do not apply to the active menu back into
+ the queue so that the application can handle the event.
XT
is used in some terminfo entries to
- improve usefulness for other applications than screen, which
- would like to pretend that xterm's title is a
- status-line.
correct logic in demo_terminfo program for
+ “-f
” option
xm
is used in examples
- xterm-1005 and
- xterm-1006 to illustrate a way to make mouse handling
- more general
modify ditto program to
+ allow $XTERM_PROG
environment variable to
+ override "xterm" as the name of the program to run in the
+ threaded configuration.
A few terminals support italics and/or dim capabilities. In
- particular, screen does not. Documented that, and accommodated
- the terminals where this feature works with the
- A_ITALIC
extension.
add several options to the “dots” + test-programs.
+modify filter program:
+ +getnstr
, that
+ polls for input while updating a clock on the right margin
+ as well as responding to window size-changes.--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:
-As usual, this release
+-n
” option by
+ simply reading the whole file.SIGWINCH
example; just
+ use KEY_RESIZE
.improves documentation by describing new features,
+improve animation in xmas
+ program by adding a time-delay in blinkit
.
attempts to improve the description of features which - users have found confusing
+modify several test-programs which call
+ use_default_colors
to consistently do this only
+ if the “-d
” option is given.
fills in overlooked descriptions of features which were - described in the NEWS file - but treated sketchily in manual pages.
+modify the install-rule for ncurses-examples to put the
+ data files in the data directory, e.g.,
+ /usr/share/ncurses-examples
.
In addition, the mechanism for producing HTML versions of the - documentation has been improved:
+modify several test programs to use new
+ popup_msgs
function, adapted from the
+ help-screen used in the edit_field
program.
use an improved version of man2html - to generate html manpages.
+modify test data for xterm palettes to use the newer + color4/color12 values.
regenerated - NCURSES-Programming-HOWTO.html to fix some of the broken - html emitted by docbook.
+improve the tracemunch + script:
+ +add_wch
,
+ color_content
and pair_content
to
+ dummy parameters.There are several new terminal descriptions:
+ +++ ++ +
dumb-emacs-ansi
,dvtm
, +dvtm-256color
,fbterm
, +iterm2
,linux-m1
minitel + entries,putty-noapp
,viewdata
, + andvt100+4bsd
building-block.+ +
xterm+noalt
,xterm+titlestack
, +xterm+alt1049
,xterm+alt+title
+ building blocks andxterm+direct
, +xterm+indirect
,xterm-direct
. from + xterm + patch #331.several other “
+-direct
” + descriptions to address the differences of other terminal + emulators versusxterm-direct
.
There are many changes to existing terminal descriptions. Some + were updates to several descriptions:
Ada95 binding:
+xterm+sm+1006
in several terminal
+ descriptions which were validated as supporting the extended
+ mouse feature for their respective terminal emulators.while others affected specific descriptions. These were + retested, to take into account new/undocumented changes by their + developers:
+ +++ ++
iterm
,minitel
,st
, +viewdata
,nsterm
while these are specific fixes based on user reports, or + warnings from tic:
+ +ansi
building blocksmodify makefile rules to ensure that the PIC option is - not used when building a static library
-ansi+idc
to better match original
+ ansiterm+idc
, add alias
+ ansiterm
make Ada95 build-fix for big-endian architectures such
- as sparc. This undoes one of the fixes from
- 20110319, which added an
- “Unused
” member to
- representation clauses, replacing that with pragmas to
- suppress warnings about unused bits.
icl6402
icl6402
and
+ m2-nam
Color and attributes:
+interix
parenthesize parameter of COLOR_PAIR
and
- PAIR_NUMBER
in curses.h in case it happens
- to be a comma-expression.
improve
- 20021221 workaround for broken acs, handling a case
- where that ACS_xxx character is not in the
- acsc
string but there is a known
- wide-character which can be used.
^?
for kdch1modify - init_pair to accept -1's for color value after - - assume_default_colors has been called.
-linux
add a check in - start_color to limit color-pairs to 256 when extended - colors are not supported.
-linux3.0
entry the default
+ linux
entrylinux2.6
entry to improve
+ line-drawing so that the linux3.0
entry can be
+ used in non-UTF-8 modelinux
+ and wyse
entries to put the delay between the
+ reverse/normal escapes rather than afterlinux-16color
to not mask dim,
+ standout or reverse with the ncv capabilityResizing the screen:
+pccon
entriespropagate error-returns from wresize, i.e., the - internal increase_size and decrease_size functions - through - resize_term.
-pccon*
entriesadd check for zero/negative dimensions for
- resizeterm
and resize_term
.
pccon+sgr+acs
and
+ pccon-base
modify resizeterm
to always push a
- KEY_RESIZE
onto the fifo, even if screensize
- is unchanged. Modify library to push a
- KEY_RESIZE
if there was a SIGWINCH, even if
- it does not call resizeterm
). These changes
- eliminate the case where a SIGWINCH is received, but ERR
- is returned from wgetch
or
- wgetnstr
because the screen dimensions did
- not change.
pccon+keys
Low-level interfaces
+tmux
fix an old bug in the termcap emulation;
- “%i
” was ignored in
- tparm
because the parameters to be
- incremented were already on the internal stack.
screen
's "standout" code rather than the
+ standard code.change “%l
” behavior in tparm
- to push the string length onto the stack rather than
- saving the formatted length into the output buffer.
xterm-keys
+ option to reflect upcoming change to make that option
+ "on" by defaultmodify name-comparison for tgetstr, etc., to - accommodate legacy applications as well as to improve - compatbility with BSD 4.2 termcap implementations (see - note for 980725).
-vt100
modify internal recursion in wgetch
which
- handles cooked mode to check if the call to
- wgetnstr
returned an error. This can happen
- when both nocbreak
and nodelay
- are set, for instance (see note for 960418).
vt100
rs2 string to reset
+ vt52 mode and scrolling regionsadd a check in internal function
- waddch_nosync
to ensure that tab characters
- are treated as control characters; some broken locales
- claim they are printable.
vt100-nam
modify menu library to ensure that a menu's top-row is - adjusted as needed to ensure that the current item is on - the screen
-vt100+4bsd
, e.g.,
+ delay in sgr for consistencyfix special case where double-width character - overwrites a single- width character in the first - column.
-vte
vte-2014
to
+ vte-2012
xterm
xterm-new
, available
+ since
+ late 1996.xterm+256color
and
+ xterm+256setaf
to use correct number of color
+ pairs.xterm-16color
,
+ xterm-88color
and xterm-256color
+ to reset palette using oc string as in
+ linux
entry.xterm-256color
xterm+256color
, allowing palette reset for
+ xtermxterm+256setaf
xterm-r5
, xterm-r6
and
+ xterm-xf86-v32
to use xterm+kbs
+ to match
+ xterm #272, reflecting packager's changesxterm-new
, to reflect vt220-style responses
+ that could be returned.xterm-pcolor
sgr consistent
+ with other capabilitiesA few entries use extensions (user-defined terminal + capabilities):
+ +tmux
and xterm-basic
As usual, this release
+ +improves documentation by describing new features,
+attempts to improve the description of features which + users have found confusing
+fills in overlooked descriptions of features which were + described in the NEWS + file but treated sketchily in manual pages.
In particular,
-Since the underlying features for + tset, + tput, and + clear have been better + integrated, the documentation now includes information on how + those tools evolved.
-The ncurses 6.0 configure script
- makes changes to the default value of several configure
- options, depending on the --with-abi-version
option
- (i.e., whether its value is “5” or
- “6”):
In addition to explaining the improved integration of the + tools, the manual pages made it easier to see how the tools + are similar and how they are different.
+--enable-const
The addch
manual page has additional
+ information on
+ portability and differences from other
+ implementations.
Feature introduced in 970405
- supports the use of const
where X/Open Curses
- should have, but did not. NetBSD curses does something
- similar with const
.
The discussion of color-pairs in the attributes + manual page is improved in its + history section.
+--enable-ext-colors
The documentation of the chtype
,
+ cchar_t
types and the attribute values which can
+ be stored in those types, in particular the
+ history and
+ portability sections of the attributes manual
+ page, has been improved.
Extends the cchar_t
structure to allow more
- than 16 colors to be encoded. This applies only to the
- wide-character (--enable-widec
)
- configuration.
improve discussion of + portability in the mouse manual.
+--enable-ext-mouse
The pad manual page has a section on the + origin and portability of pads.
+Modifies the encoding of mouse state to make room for a - 5th mouse button. That allows one to use ncurses with a wheel - mouse with xterm or similar X terminal emulators.
-Differences between SVr4 and X/Open Curses soft-keys are + discussed in a new section on + portability.
+--enable-ext-putwin
There are updated/improved notes on portability in the + + resizeterm and + wresize manual pages.
+Modifies the file-format written by putwin
to
- use printable text rather than binary files, allowing
- getwin
to read screen dumps written by
- differently-configured ncurses libraries. The extended
- getwin
can still read binary screen dumps from
- the same configuration of ncurses. This does not
- change the ABI (the binary interface seen by calling
- applications).
In addition to providing background information to explain + these features and show how they evolved, there are corrections, + clarifications, etc.:
---enable-interop
add note in the + addch manual about line-drawing when it depends + upon UTF-8.
+Modifies the FIELDTYPE
structure used for the
- form library to make it more generic.
improve discussion of line-drawing characters in the + + add_wch manual.
+--enable-lp64
explain in + clear's manual page that + it writes to the standard output.
+Allows an application to define _LP64
to
- declare chtype
and mmask_t
as
- simply “unsigned
” rather than the
- configured types using the --with-chtype
and
- --with-mmask_t
options.
improve description of + endwin.
+--enable-sp-funcs
improve discussion of field validation in the + form driver manual page.
+Compile-in support for extended functions which accept a - SCREEN pointer, reducing the need for juggling the global SP - value with - set_term and - delscreen.
-clarify the use of wint_t
vs
+ wchar_t
in
+ get_wstr manual page.
--with-chtype=uint32_t
clarify in the
+ getch manual that the keypad mode affects an
+ application's ability to read KEY_MOUSE
codes,
+ but does not affect KEY_RESIZE
.
Makes chtype
explicitly a 32-bit unsigned
- value.
trim some obsolete/incorrect wording about
+ EINTR
from the getch manual page
--with-mmask_t=uint32_t
improve manual pages for
+ getch and
+ get_wch to point out that they might return
+ user-defined values which have no predefined names in
+ <curses.h>
Makes mmask_t
explicitly a 32-bit unsigned
- value.
improve description of the -R
option in the
+
+ infocmp manual page
--with-tparm-arg=intptr_t
clarify in the
+ resizeterm manual page how
+ KEY_RESIZE
is pushed onto the input stream.
X/Open Curses declares
- tparm using long
for each of the parameters
- aside from the formatting string, presuming that
- long
and char*
are the same size.
- This configure option uses intptr_t
which
- provides a better guarantee of the sizes.
document return value of
+ use_extended_names
The configure script no longer checks for antique compilers;
- c89
is assumed as a minimum. There are a few
- features from later revisions which are used when available. The
- configure script makes checks to turn on useful warnings from
- clang, gcc and icc. You should be able to build ncurses 6.0 with any of the current (or not so
- current) C compilers available in 2015.
The configure script, by the way, makes changes which do not
- work with systems whose /bin/sh
is non-POSIX. This
- mainly affects Solaris (the other vendor unix systems have followed the POSIX guidelines
- for the past twenty years). If you must build on Solaris, its
- xpg4
- binaries suffice, e.g.,
- - -+- #!/bin/sh
-
- WHAT=`hostname|sed -e 's/\..*//'`
- - OUT=configure.out
- cat >>$OUT <<EOF/
- ** `date`
- ** node: $WHAT
- ** user: `id`
- ** conf: $*
- EOF/
-
- SHELL=/bin/sh
- if test -f /usr/xpg4/bin/sh
- - then
- CONFIG_SHELL=/usr/xpg4/bin/sh
- export CONFIG_SHELL
- - SHELL=$CONFIG_SHELL
- fi
-
- rm -f config.status config.cache
- TOP=$HOME/$WHAT
- $SHELL ./configure --verbose \
- - --disable-echo \
- - --disable-overwrite \
- - --enable-warnings \
- - --with-warnings \
- - --prefix=$TOP $* 2>&1 | tee -a $OUT
- -
document differences in
+ ESCDELAY
versus AIX's implementation in the
+ variables manual page.
Other major changes to the configure script include:
+The _nc_free_tinfo
function is now documented
+ in the
+ memory-leaks manual page, because it could be
+ used in tack for memory-leak
+ checking.
ABI 6 is now the default, intending that the existing ABI
- 5 should build as before using the
- “--with-abi-version=5
” option.
add a note to the + tic manual page about -W versus -f options.
added --with-extra-suffix
option to help with
- installing nonconflicting ncurses6 packages, e.g., avoiding
- header- and library-conflicts.
improve terminfo manual description of + terminfo syntax.
-NOTE: as a side-effect, this renames
+improve terminfo manual page discussion of + control- and graphics- characters.
--+-
adacurses-config
to -adacurses5-config
and
-adacursesw-config
to -adacursesw5-config
improve + color-handling section in terminfo manual page
+clarify description in + tput manual page regarding + support for termcap names
+ +update + tput manual page to + reflect changes to manipulate terminal modes by sharing + functions with tset.
+clarify in manual pages that the optional verbose option + level of + tic and + infocmp is available only + when ncurses is configured for + tracing.
the configure script looks for gnatgcc if the Ada95 - binding is built, in preference to the default gcc/cc. The - script also ensures that the Ada95 binding is built with the - level of optimization as the C libraries.
+improve manual page description of tset/reset + versus window-size.
the configure script captures define's related to - -D_XOPEN_SOURCE from the configure check and adds those to - the *-config and *.pc files, to simplify use for the - wide-character libraries.
+improve description of + tgoto parameters
There are new manual pages:
-There are several new (or extended) configure options:
+--disable-db-install
+ scr_dump documents the screen-dump format.
+Do not install the terminal database. This is used to omit
- features for packages, as done with
- --without-progs
. The option simplifies building
- cross-compile support packages.
Some of the improvements are more subtle, relating to the way + the information is presented:
---disable-gnat-projects
Made minor fixes to manpage NAME/SYNOPSIS + sections to consistently use rule that either all functions + which are prototyped in SYNOPSIS are listed in the + NAME section, or the manual-page name is the sole + item listed in the NAME section. The latter is used + to reduce clutter, e.g., for the top-level library manual + pages as well as for certain feature-pages such as + SP-funcs and + threading.
+This option is used for regression testing
-improve manual pages for utilities with respect to POSIX + versus X/Open Curses.
+--disable-lib-suffixes
improve organization of the + attributes and color manual + pages.
+Suppress the “w”, “t” or
- “tw” suffixes which normally would be added to
- the library names for the --enable-widec
and
- --with-pthread
options.
--with-cxx-shared
modify toe to not exit if + unable to read a terminal description, e.g., if there is a + permission problem.
+When --with-shared
is set, build libncurses++
- as a shared library. This implicitly relies upon building
- with gcc/g++, since other compiler suites may have
- differences in the way shared libraries are built. libtool by
- the way has similar limitations.
correct 20100515 change for weak signals versus + sigprocmask
+--with-hashed-db
gprconfig
to specify the C compiler to be
+ used by gnatmake
, and conditionally suppressing
+ Library_Options
line for static libraries.Extended this configure option to simplify building with - different versions of Berkeley database using FreeBSD - ports.
-There were, as well, several bug-fixes to handle illegal + input for tic. Because those + did not correspond to useful terminal descriptions, most + users are unaffected.
+--with-pc-suffix
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
This release provides a new binary format for terminal + descriptions that use extended numeric capabilities. Applications + built with the wide-character ncursesw library can use + these extended numbers.
-Configure xterm's terminfo entries to use either BS
- (^H
, i.e., ASCII backspace) or DEL
- (^?
, or 127).
This includes utilities such as tic and infocmp, because (as noted in New features), the feature + relies upon an extension to the low-level tinfo + library.
+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 + picsmap) give zero for these + out-of-range capabilities.
-Most of the portability-related work since - ncurses 5.9 extended and improved the MinGW port - introduced in - ncurses 5.8.
+The MinGW port can be readily cross-compiled:
+These changes provide support for tack 1.08, released in + July 2017:
modified configure script to allow creating dll's for - MinGW when cross-compiling.
+add --without-tack
configure option to refine
+ --with-progs
configure option. Normally
+ tack is built outside the
+ ncurses tree, but a few
+ packagers combine it during the build. If
+ term_entry.h
is installed, there is no advantage
+ to in-tree builds.
enforced Windows-style path-separator if - cross-compiling,
+adjust configure-script to define
+ HAVE_CURSES_DATA_BOOLNAMES
symbol needed for
+ tack 1.08 when built in-tree.
+ Rather than relying upon internal "_nc_" functions,
+ tack now uses the boolean,
+ number and string capability name-arrays provided by
+ ncurses and SVr4 Unix curses.
+ It still uses term_entry.h
for the definitions
+ of the extended capability arrays.
added scripts for test-builds of cross-compiled packages - for ncurses6 to MinGW.
+add dependency upon ncurses_cfg.h to tic's header-files; any program using + tic-library will have to + supply this file. Legacy tack + versions supply this file; ongoing tack development has dropped the + dependency upon tic-library + and new releases will not be affected.
Other changes to the configure-script and generated files + include
+added pc-files to the MinGW cross-compiling - test-packages.
+add configure options to disable checks for form, menu and + panel libraries so that ncurses-examples can be built with + non-SVr4 curses implementations.
added script for building test-packages of binaries - cross-compiled to MinGW using NSIS.
+add configure option --enable-opaque-curses
+ for ncurses library and similar options for the
+ other libraries.
added nc_mingw.h
to installed headers for
- MinGW port; this is needed for cross-compiling ncurses-examples.
add configure option --disable-wattr-macros
+ for use in cases where one wants to use the same headers for
+ ncurses5/ncurses6 development, by suppressing the
+ wattr* macros which differ due to the introduction
+ of extended colors
added test-packages for cross-compiling ncurses-examples - using the MinGW test-packages.
+modify configure macro for shared-library rules to use
+ -Wl,-rpath
rather than -rpath
to
+ work around a bug in scons
The MinGW-specific Windows driver accounts for several - changes:
- -wide-character display is made usable by replacing MinGW's
- non-working wcrtomb
and wctomb
- functions.
improve ncurses-examples' configure script to define as
+ needed NCURSES_WIDECHAR
for platforms where
+ _XOPEN_SOURCE_EXTENDED
does not work. Also
+ modified the test program to ensure that if building with
+ ncurses, that the
+ cchar_t
type is checked, since that is normally
+ (since 20111030)
+ ifdef'd depending on this test.
implemented some display features: beep, - flash, - - curs_set.
+modify configure script to handle the case where
+ tic-library is renamed, but
+ the --with-debug
option is used by itself
+ without normal or shared libraries
the driver handles repainting on endwin/refresh - combination.
+modify editing script which generates resulting.map to + work with the clang configuration on recent FreeBSD, which + gives an error on an empty "local" section.
modified treatment of TERM
variable for MinGW
- port to allow explicit use of the Windows console driver by
- checking if $TERM
is set to
- “#win32console
” or an abbreviation
- of that.
improve configure check for setting the
+ WILDCARD_SYMS
variable; on ppc64 the variable is
+ in the Data section rather than
+ Text.
the Windows driver also matches the special
- TERM
value “unknown”
correct result of configure option
+ --without-fallbacks
, which caused FALLBACK_LIST
+ to be set to "no"
the driver now returns characters for special keys, (like
- ansi.sys
does), when keypad mode is off, rather
- than returning nothing at all.
modify --with-pkg-config-libdir
option to
+ make it possible to install “.pc” files even if
+ pkg-config is not found. Limit
+ this change, to suppress the actual install if it is not
+ overridden to a valid directory at install time.
the driver checks a new environment variable
- NCURSES_CONSOLE2 to optionally work around a deficiency
- in Console2
(and its descendent
- ConsoleZ
) which hang when an application creates
- a console buffer.
disallow “no” as a possible value for
+ --with-shlib-version
option, overlooked in
+ cleanup-changes for 20000708.
Finally, there are other improvements:
+Many of the portability changes are implemented via the + configure script:
MinGW is one of the configurations where ncurses installs by default into /usr
+improve configure script's CF_CC_ENV_FLAGS
+ macro to allow for compiler wrappers such as ccache. This change moves only the
+ preprocessor, optimization and warning flags to
+ CPPFLAGS
and CFLAGS
, leaving the
+ residue in CC
. That happens to work for
+ gcc's various
+ “model” options, but may require tuning for other
+ compilers.
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.
isatty
calls with a macro, provide a
- corresponding set of support routines to address
- differences between MinGW and MSYS2.modify ncurses-examples' configure script to use + pkg-config for the extra + form/menu/panel libraries, to be more consistent with the + handling of the curses/ncurses library.
ensure WINVER
is defined in makefiles rather
- than using headers.
add configuration checks to build with NetBSD
+ curses, which for example lacks
+ use_env
.
add check for the gnatprep
- “-T
” option.
change ncurses-examples to use attr_t
vs
+ chtype
to follow X/Open documentation more
+ closely since Solaris xpg4-curses uses different values for
+ WA_xxx
vs A_xxx
+ that rely on attr_t being an unsigned short. Tru64 aka OSF1,
+ HPUX, AIX did as ncurses does,
+ equating the two sets.
work around a bug introduced by - gcc 4.8.1 in MinGW which breaks "trace" feature.
+modify several test programs to reflect that ncurses honors existing signal handlers in + initscr, while other implementations do not.
add a driver-name method to each of the drivers.
+add configure check for openpty
to
+ ncurses-examples' configure script, for ditto.
These changes affect certain platforms (ports):
+improve check for working poll
function by
+ using posix_openpt
as a fallback in case there
+ is no valid terminal on the standard input
the configure script knows how to build shared libraries - with DragonFlyBSD and Interix.
+modify ncurses-examples' configure script to check for + pthread dependency of + ncursest or ncursestw library when building + the ncurses examples, e.g., in + case weak symbols are used.
support for AIX shared libraries is improved, tested with - AIX 5.3, 6.1 and 7.1 with both gcc 4.2.4 and cc:
+add checks in ncurses-examples' configure script for some + functions neither in 4.3BSD curses, nor based on X/Open + Curses:
the shared-library suffix for AIX 5 and 6 is now - ".so"
+modify a loop limit in firework.c to work around + absense of limit checks in some libraries.
the -brtl
option is used with AIX 5-7; it
- is needed to link with the shared libraries.
fill the last row of a window with
+ “?
” in firstlast if waddch does
+ not return ERR
on the lower-right
+ corner.
the configure --enable-pc-files
option takes
- into account the PKG_CONFIG_PATH
- variable.
build-fixes for the Portland Group (PGI) compilers
-the configure option --with-pkg-config-libdir
- provides control over the actual directory into which
- pc-files are installed.
accept whitespace in sed expression for generating + expanded.c
+the build scripts add explicit -ltinfo, etc., to the
- generated ".pc" file when ld
option
- “--as-needed
” is used, or when
- ncurses and tinfo are installed without using rpath.
modify configure check that g++ compiler warnings are + not used.
+add configure check for -fPIC option needed for shared + libraries.
+the configure script disallows conflicting options
- “--with-termlib
” and
- “--enable-term-driver
”.
modify configure script for clang as used on FreeBSD, to + work around clang's differences in exit codes vs gcc.
the check for missing c++ compiler to work when no error - is reported, and no variables set is improved (see note for - 20021206).
+fixes for configure/build using clang on OSX
+ +do not redefine “inline” in
+ ncurses_cfg.h
; this was originally to solve
+ a problem with gcc/g++, but is aggravated by clang's
+ misuse of symbols to pretend it is gcc.
add braces to configure script to prevent unwanted
+ addition of “-lstdc++
” option to
+ the CXXLIBS
symbol.
improve/update test-program used for checking + existence of stdc++ library.
+if $CXXLIBS
is set, the linkage test uses
+ that in addition to $LIBS
.
the misc/gen_edit.sh script selects a "linux" entry which - works with the current kernel rather than assuming it is - always "linux3.0"
+fixes for OS/2:
+ +use button instead of kbuf[0]
in
+ EMX-specific part of lib_mouse.c
support building with libtool on OS/2
+use stdc++ library with OS/2 kLIBC
+clear configure script's cf_XOPEN_SOURCE
+ for OS/2, to work with its header files
the test/configure script makes it simpler to override - names of curses-related libraries, to help with linking with - pdcurses in MinGW environment.
+add “newer” baudrate symbols to the
+ baudrate
function in the ncurses library as
+ well as to a corresponding table in tset.
the configure-script/ifdef's allow the BSD OLD_TTY feature
- to be suppressed if the type of ospeed
is
- configured using the option --with-ospeed
to not
- be a short
. By default, it is a
- short
for termcap-compatibility.
modify ncurses-examples savescreen to work with AIX and HPUX.
the MKlib_gen.sh script works around a recent change in
- gcc 5 (released mid-2015) which essentially
- emits multiple #line
statements for the same
- position in a file.
define WIN32_LEAN_AND_MEAN
for MinGW port,
+ making builds faster.
the configure script works with Minix3.2 (see note - on portability)
+add a configure check for wcwidth versus the + ncurses line-drawing + characters, to use in special-casing systems such as Solaris. + Solaris, however, requires a special case that maps Unicode + line-drawing characters into the acsc string for non-Unicode + locales. Solaris also has a misconfigured wcwidth which marks + all of the line drawing characters as double-width.
OS/2 redux:
+string-hacks (non-standard):
the configure script supports OS/2 kLIBC.
+fix configure script to record when
+ strlcat
is found on OpenBSD.
add --enable-string-hacks
option to
+ ncurses-examples' configure script.
the --with-lib-prefix
option allows
- configuring for old/new flavors of OS/2 EMX.
completed string-hacks for sprintf, etc., + including the ncurses-examples programs.
+make --enable-string-hacks
option work
+ with Debian by checking for the "bsd" library and its
+ associated "<bsd/string.h>" header.
improved configure-script checks for
- _XOPEN_SOURCE
:
workaround for Debian's antique/unmaintained version of + mawk:
the definition works starting with Solaris 10.
+see Debian #65617, which was fixed in mawk's upstream releases in + 2009.
the definition is suppressed for IRIX64, since its
- header files have a conflict versus
- _SGI_SOURCE
.
related fixes when building link_test.
The ncurses package is fully +
The ncurses package is fully upward-compatible with SVr4 (System V Release 4) curses:
ncurses supports all of the +
ncurses supports all of the for SVr4 curses features including keyboard mapping, color, forms-drawing with ACS characters, and automatic recognition of keypad and function keys.
ncurses provides these SVr4 +
ncurses provides these SVr4 add-on libraries (not part of X/Open Curses):
ncurses's terminal database is - fully compatible with that used by SVr4 curses.
+ncurses's terminal database + is fully compatible with that used by SVr4 curses.
ncurses supports + user-defined capabilities which it can see, but which are + hidden from SVr4 curses applications using the + same terminal database.
+It can be optionally configured to match the format @@ -1880,23 +2401,23 @@ fflush(stdout);
Alternatively, ncurses can - be configured to use hashed databases rather than the +
Alternatively, ncurses + can be configured to use hashed databases rather than the directory of files used by SVr4 curses.
The ncurses utilities have +
The ncurses utilities have options to allow you to filter terminfo entries for use with less capable curses/terminfo versions such as the HP/UX and AIX ports.
The ncurses package also has many - useful extensions over SVr4:
+The ncurses package also has + many useful extensions over SVr4:
Unlike SVr3 curses, ncurses +
Unlike SVr3 curses, ncurses can write to the rightmost-bottommost corner of the screen if your terminal has an insert-character capability.
The functions keyok
and
define_key
allow you to better control the use
- of function keys, e.g., disabling the ncurses KEY_MOUSE, or by defining more than
- one control sequence to map to a given key code.
The tic/captoinfo - utility provided with ncurses has - the ability to translate many termcaps from the XENIX, IBM - and AT&T extension sets.
+ "https://invisible-island.net/ncurses/man/tic.1m.html"> + tic/captoinfo + utility provided with ncurses + has the ability to translate many termcaps from the XENIX, + IBM and AT&T extension sets.A BSD-like tset - utility is provided.
+ "https://invisible-island.net/ncurses/man/tset.1.html"> + tset utility is provided.The ncurses library and +
The ncurses library and utilities will automatically read terminfo entries from $HOME/.terminfo if it exists, and compile to that directory if it exists and the user has no write access to the system @@ -2030,9 +2553,9 @@ fflush(stdout);
The table-of-entries utility toe - makes it easy for users to see exactly what terminal types - are available on the system.
+ "https://invisible-island.net/ncurses/man/toe.1m.html"> + toe makes it easy for users to see exactly what + terminal types are available on the system.Extensive documentation is provided (see the + "https://invisible-island.net/ncurses/ncurses.faq.html#additional_reading"> Additional Reading section of the - ncurses FAQ for online documentation).
+ "https://invisible-island.net/ncurses/ncurses.faq.html"> + ncurses FAQ for online documentation).The ncurses distribution includes - a selection of test programs (including a few games). These are - available separately as ncurses-examples
+The ncurses distribution + includes a selection of test programs (including a few games). + These are available separately as ncurses-examples
The ncurses library has been tested with a wide variety of applications including:
--
- cdk
+- aptitude
+ +- +
+ +FrontEnd to Apt, the debian package manager
+ + +- cdk
- -
Curses Development Kit
http://invisible-island.net/cdk/
+ "https://invisible-island.net/cdk/">https://invisible-island.net/cdk/
- ded
+- ded
- -
directory-editor
+ "https://invisible-island.net/ded/">https://invisible-island.net/ded/- dialog
+- dialog
- -
the underlying application used in Slackware's setup, @@ -2091,56 +2623,57 @@ fflush(stdout); many systems.
+ "https://invisible-island.net/dialog/">https://invisible-island.net/dialog/- lynx
+- lynx
- -
the text WWW browser
+ "https://lynx.invisible-island.net/">https://lynx.invisible-island.net/- Midnight Commander
+- mutt
- -
-file manager
+mail utility
+ "http://www.mutt.org/">http://www.mutt.org/- mutt
+- ncftp
- -
-mail utility
+file-transfer utility
+ "https://www.ncftp.com/">https://www.ncftp.com/- ncftp
+- nvi
- -
-file-transfer utility
+New vi uses ncurses.
+ "https://sites.google.com/a/bostic.com/keithbostic/vi">https://sites.google.com/a/bostic.com/keithbostic/vi
+- nvi
+- ranger
- -
-New vi uses ncurses.
+A console file manager with VI key bindings in + Python.
+ "https://ranger.github.io/">https://ranger.github.io/- tin
+- tin
- + +
newsreader, supporting color, MIME
@@ -2148,24 +2681,32 @@ fflush(stdout);- vifm
+ +- +
File manager with vi like keybindings
+ + +
as well as some that use ncurses - for the terminfo support alone:
+as well as some that use ncurses for the terminfo support alone:
@@ -2208,31 +2749,41 @@ fflush(stdout);-
- minicom
+- minicom
- -
terminal emulator for serial modem connections
+ "https://alioth.debian.org/projects/minicom/">https://alioth.debian.org/projects/minicom/- mosh
+- mosh
- -
a replacement for
@@ -2174,32 +2715,32 @@ fflush(stdout); "https://mosh.mit.edu/">https://mosh.mit.edu/ssh
.- tack
+- tack
- -
terminfo action checker
+ "https://invisible-island.net/ncurses/tack.html">https://invisible-island.net/ncurses/tack.html- tmux
+- tmux
- -
terminal multiplexor
+ "https://github.com/tmux/tmux/wiki">https://github.com/tmux/tmux/wiki- vile
+- vile
vi-like-emacs may be built to use the terminfo, termcap or curses interfaces.
+ "https://invisible-island.net/vile/">https://invisible-island.net/vile/
@@ -2240,14 +2791,14 @@ fflush(stdout);-
- emacs
+- emacs
- + +
text editor
+ "https://www.gnu.org/software/emacs/">https://www.gnu.org/software/emacs/ +- less
+ +- +
-The most commonly used pager (a program that + displays text files).
+ +- screen
+- screen
- -
terminal multiplexor
+ "https://www.gnu.org/software/screen/">https://www.gnu.org/software/screen/- vim
+- vim
text editor
+ "https://www.vim.org/">https://www.vim.org/
Zeyd Ben-Halim started ncurses +
Zeyd Ben-Halim started ncurses from a previous package pcurses, written by Pavel Curtis. Eric S. Raymond continued development. Jürgen Pfeifer wrote most of the form and menu libraries. Ongoing development work is done by Thomas Dickey. Thomas Dickey also acts as the maintainer for the Free Software Foundation, which holds the copyright + "https://invisible-island.net/ncurses/ncurses-license.html">copyright on ncurses.
Contact the current maintainers at
@@ -2271,12 +2822,15 @@ fflush(stdout);This list is open to anyone interested in helping with the development and testing of this package.
-Beta versions of ncurses and +
Beta versions of ncurses and patches to the current release are made available at
ftp://invisible-island.net/ncurses/ .
+ "ftp://ftp.invisible-island.net/ncurses/">ftp://ftp.invisible-island.net/ncurses/ + and
+ https://invisible-mirror.net/archives/ncurses/ .
There is an archive of the mailing list here:
@@ -2296,34 +2850,28 @@ fflush(stdout);You can find lots of information on terminal-related topics not covered in the terminfo file at Library improvements
@@ -2392,23 +2938,15 @@ fflush(stdout);curses(3x) - This describes ncurses version 6.0 (patch 20180106). + This describes ncurses version 6.1 (patch 20180127). diff --git a/doc/html/man/captoinfo.1m.html b/doc/html/man/captoinfo.1m.html index a79bdcce..bdff8230 100644 --- a/doc/html/man/captoinfo.1m.html +++ b/doc/html/man/captoinfo.1m.html @@ -190,7 +190,7 @@
infocmp(1m), curses(3x), terminfo(5) - This describes ncurses version 6.0 (patch 20180106). + This describes ncurses version 6.1 (patch 20180127).
diff --git a/doc/html/man/clear.1.html b/doc/html/man/clear.1.html index a43e788d..66563a05 100644 --- a/doc/html/man/clear.1.html +++ b/doc/html/man/clear.1.html @@ -148,7 +148,7 @@
tput(1), terminfo(5) - This describes ncurses version 6.0 (patch 20180106). + This describes ncurses version 6.1 (patch 20180127). diff --git a/doc/html/man/curs_termcap.3x.html b/doc/html/man/curs_termcap.3x.html index 42436ac6..55b21c16 100644 --- a/doc/html/man/curs_termcap.3x.html +++ b/doc/html/man/curs_termcap.3x.html @@ -26,7 +26,7 @@ * sale, use or other dealings in this Software without prior written * * authorization. * **************************************************************************** - * @Id: curs_termcap.3x,v 1.36 2018/01/01 15:13:16 tom Exp @ + * @Id: curs_termcap.3x,v 1.37 2018/01/23 10:14:38 tom Exp @ --> @@ -149,80 +149,83 @@ o Normally the ncurses library is compiled with terminfo support. In that case, tgoto uses tparm(3x) (a more capable formatter). - The tputs routine is described on the curs_terminfo(3x) manual page. + However, tparm is not a termcap feature, and portable termcap ap- + plications should not rely upon its availability. + + The tputs routine is described on the curs_terminfo(3x) manual page. It can retrieve capabilities by either termcap or terminfo name.
- The variables PC, UP and BC are set by tgetent to the terminfo entry's + The variables PC, UP and BC are set by tgetent to the terminfo entry's data for pad_char, cursor_up and backspace_if_not_bs, respectively. UP - is not used by ncurses. PC is used in the tdelay_output function. BC - is used in the tgoto emulation. The variable ospeed is set by ncurses + is not used by ncurses. PC is used in the tdelay_output function. BC + is used in the tgoto emulation. The variable ospeed is set by ncurses in a system-specific coding to reflect the terminal speed.
- Except where explicitly noted, routines that return an integer return - ERR upon failure and OK (SVr4 only specifies "an integer value other + Except where explicitly noted, routines that return an integer return + ERR upon failure and OK (SVr4 only specifies "an integer value other than ERR") upon successful completion. Routines that return pointers return NULL on error.
- If you call tgetstr to fetch ca or any other parameterized string, be - aware that it will be returned in terminfo notation, not the older and + If you call tgetstr to fetch ca or any other parameterized string, be + aware that it will be returned in terminfo notation, not the older and not-quite-compatible termcap notation. This will not cause problems if - all you do with it is call tgoto or tparm, which both expand terminfo- - style strings as terminfo. (The tgoto function, if configured to sup- - port termcap, will check if the string is indeed terminfo-style by - looking for "%p" parameters or "$<..>" delays, and invoke a termcap- + all you do with it is call tgoto or tparm, which both expand terminfo- + style strings as terminfo. (The tgoto function, if configured to sup- + port termcap, will check if the string is indeed terminfo-style by + looking for "%p" parameters or "$<..>" delays, and invoke a termcap- style parser if the string does not appear to be terminfo). - Because terminfo conventions for representing padding in string capa- - bilities differ from termcap's, tputs("50"); will put out a literal + Because terminfo conventions for representing padding in string capa- + bilities differ from termcap's, tputs("50"); will put out a literal "50" rather than busy-waiting for 50 milliseconds. Cope with it. - Note that termcap has nothing analogous to terminfo's sgr string. One - consequence of this is that termcap applications assume me (terminfo - sgr0) does not reset the alternate character set. This implementation + Note that termcap has nothing analogous to terminfo's sgr string. One + consequence of this is that termcap applications assume me (terminfo + sgr0) does not reset the alternate character set. This implementation checks for, and modifies the data shown to the termcap interface to ac- commodate termcap's limitation in this respect.
- The XSI Curses standard, Issue 4 describes these functions. However, + The XSI Curses standard, Issue 4 describes these functions. However, they are marked TO BE WITHDRAWN and may be removed in future versions. - Neither the XSI Curses standard nor the SVr4 man pages documented the - return values of tgetent correctly, though all three were in fact re- - turned ever since SVr1. In particular, an omission in the XSI Curses - documentation has been misinterpreted to mean that tgetent returns OK - or ERR. Because the purpose of these functions is to provide compati- - bility with the termcap library, that is a defect in XCurses, Issue 4, + Neither the XSI Curses standard nor the SVr4 man pages documented the + return values of tgetent correctly, though all three were in fact re- + turned ever since SVr1. In particular, an omission in the XSI Curses + documentation has been misinterpreted to mean that tgetent returns OK + or ERR. Because the purpose of these functions is to provide compati- + bility with the termcap library, that is a defect in XCurses, Issue 4, Version 2 rather than in ncurses. External variables are provided for support of certain termcap applica- tions. However, termcap applications' use of those variables is poorly documented, e.g., not distinguishing between input and output. In par- - ticular, some applications are reported to declare and/or modify os- + ticular, some applications are reported to declare and/or modify os- peed. - The comment that only the first two characters of the id parameter are + The comment that only the first two characters of the id parameter are used escapes many application developers. The original BSD 4.2 termcap library (and historical relics thereof) did not require a trailing null - NUL on the parameter name passed to tgetstr, tgetnum and tgetflag. - Some applications assume that the termcap interface does not require + NUL on the parameter name passed to tgetstr, tgetnum and tgetflag. + Some applications assume that the termcap interface does not require the trailing NUL for the parameter name. Taking into account these is- sues: - o As a special case, tgetflag matched against a single-character - identifier provided that was at the end of the terminal descrip- + o As a special case, tgetflag matched against a single-character + identifier provided that was at the end of the terminal descrip- tion. You should not rely upon this behavior in portable programs. - This implementation disallows matches against single-character ca- + This implementation disallows matches against single-character ca- pability names. - o This implementation disallows matches by the termcap interface + o This implementation disallows matches by the termcap interface against extended capability names which are longer than two charac- ters. diff --git a/doc/html/man/form.3x.html b/doc/html/man/form.3x.html index 04c255bc..48ebfd41 100644 --- a/doc/html/man/form.3x.html +++ b/doc/html/man/form.3x.html @@ -246,7 +246,7 @@ curses(3x) and related pages whose names begin "form_" for detailed descriptions of the entry points. - This describes ncurses version 6.0 (patch 20180106). + This describes ncurses version 6.1 (patch 20180127). diff --git a/doc/html/man/infocmp.1m.html b/doc/html/man/infocmp.1m.html index dbf8e17e..dfafeedb 100644 --- a/doc/html/man/infocmp.1m.html +++ b/doc/html/man/infocmp.1m.html @@ -27,7 +27,7 @@ * sale, use or other dealings in this Software without prior written * * authorization. * **************************************************************************** - * @Id: infocmp.1m,v 1.69 2018/01/01 15:12:48 tom Exp @ + * @Id: infocmp.1m,v 1.70 2018/01/23 10:10:17 tom Exp @ --> @@ -364,40 +364,45 @@ 3 hexadecimal and base64 + For example, this prints the compiled terminfo value as a string + which could be assigned to the TERMINFO environment variable: + + infocmp -0 -q -Q2 + -q This makes the output a little shorter: - o Make the comparison listing shorter by omitting subheadings, + o Make the comparison listing shorter by omitting subheadings, and using "-" for absent capabilities, "@" for canceled rather than "NULL". - o However, show differences between absent and cancelled capa- + o However, show differences between absent and cancelled capa- bilities. o Omit the "Reconstructed from" comment for source listings. -Rsubset - Restrict output to a given subset. This option is for use with - archaic versions of terminfo like those on SVr1, Ultrix, or HP/UX - that do not support the full set of SVR4/XSI Curses terminfo; and - variants such as AIX that have their own extensions incompatible + Restrict output to a given subset. This option is for use with + archaic versions of terminfo like those on SVr1, Ultrix, or HP/UX + that do not support the full set of SVR4/XSI Curses terminfo; and + variants such as AIX that have their own extensions incompatible with SVr4/XSI. - o Available terminfo subsets are "SVr1", "Ultrix", "HP", and + o Available terminfo subsets are "SVr1", "Ultrix", "HP", and "AIX"; see terminfo(5) for details. - o You can also choose the subset "BSD" which selects only capa- - bilities with termcap equivalents recognized by 4.4BSD. The + o You can also choose the subset "BSD" which selects only capa- + bilities with termcap equivalents recognized by 4.4BSD. The -C option sets the "BSD" subset as a side-effect. - o If you select any other value for -R, it is the same as no - subset, i.e., all capabilities are used. The -I option like- + o If you select any other value for -R, it is the same as no + subset, i.e., all capabilities are used. The -I option like- wise selects no subset as a side-effect. -s [d|i|l|c] - The -s option sorts the fields within each type according to the + The -s option sorts the fields within each type according to the argument below: - d leave fields in the order that they are stored in the ter- + d leave fields in the order that they are stored in the ter- minfo database. i sort by terminfo name. @@ -406,45 +411,45 @@ c sort by the termcap name. - If the -s option is not given, the fields printed out will be - sorted alphabetically by the terminfo name within each type, - except in the case of the -C or the -L options, which cause the - sorting to be done by the termcap name or the long C variable + If the -s option is not given, the fields printed out will be + sorted alphabetically by the terminfo name within each type, + except in the case of the -C or the -L options, which cause the + sorting to be done by the termcap name or the long C variable name, respectively. - -T eliminates size-restrictions on the generated text. This is + -T eliminates size-restrictions on the generated text. This is mainly useful for testing and analysis, since the compiled - descriptions are limited (e.g., 1023 for termcap, 4096 for ter- + descriptions are limited (e.g., 1023 for termcap, 4096 for ter- minfo). - -t tells tic to discard commented-out capabilities. Normally when - translating from terminfo to termcap, untranslatable capabilities + -t tells tic to discard commented-out capabilities. Normally when + translating from terminfo to termcap, untranslatable capabilities are commented-out. - -U tells infocmp to not post-process the data after parsing the - source file. This feature helps when comparing the actual con- - tents of two source files, since it excludes the inferences that + -U tells infocmp to not post-process the data after parsing the + source file. This feature helps when comparing the actual con- + tents of two source files, since it excludes the inferences that infocmp makes to fill in missing data. -V reports the version of ncurses which was used in this program, and exits. - -v n prints out tracing information on standard error as the program + -v n prints out tracing information on standard error as the program runs. - The optional parameter n is a number from 1 to 10, inclusive, + The optional parameter n is a number from 1 to 10, inclusive, indicating the desired level of detail of information. If ncurses - is built without tracing support, the optional parameter is + is built without tracing support, the optional parameter is ignored. - -W By itself, the -w option will not force long strings to be + -W By itself, the -w option will not force long strings to be wrapped. Use the -W option to do this. -w width changes the output to width characters. -x print information for user-defined capabilities. These are exten- - sions to the terminfo repertoire which can be loaded using the -x + sions to the terminfo repertoire which can be loaded using the -x option of tic. @@ -453,16 +458,16 @@
- The -0, -1, -E, -F, -G, -Q, -R, -T, -V, -a, -e, -f, -g, -i, -l, -p, -q + The -0, -1, -E, -F, -G, -Q, -R, -T, -V, -a, -e, -f, -g, -i, -l, -p, -q and -t options are not supported in SVr4 curses. SVr4 infocmp does not distinguish between absent and cancelled capabil- ities. Also, it shows missing integer capabilities as -1 (the internal - value used to represent missing integers). This implementation shows + value used to represent missing integers). This implementation shows those as "NULL", for consistency with missing strings. - The -r option's notion of "termcap" capabilities is System V Release - 4's. Actual BSD curses versions will have a more restricted set. To + The -r option's notion of "termcap" capabilities is System V Release + 4's. Actual BSD curses versions will have a more restricted set. To see only the 4.4BSD set, use -r -RBSD. @@ -471,12 +476,12 @@
- captoinfo(1m), infotocap(1m), tic(1m), toe(1m), curses(3x), ter- + captoinfo(1m), infotocap(1m), tic(1m), toe(1m), curses(3x), ter- minfo(5). https://invisible-island.net/ncurses/tctest.html - This describes ncurses version 6.0 (patch 20180106). + This describes ncurses version 6.1 (patch 20180127).
diff --git a/doc/html/man/infotocap.1m.html b/doc/html/man/infotocap.1m.html index 146807a2..ff52c19f 100644 --- a/doc/html/man/infotocap.1m.html +++ b/doc/html/man/infotocap.1m.html @@ -85,7 +85,7 @@
curses(3x), tic(1m), infocmp(1m), terminfo(5) - This describes ncurses version 6.0 (patch 20180106). + This describes ncurses version 6.1 (patch 20180127).
diff --git a/doc/html/man/menu.3x.html b/doc/html/man/menu.3x.html index 9d9c1296..b51a2601 100644 --- a/doc/html/man/menu.3x.html +++ b/doc/html/man/menu.3x.html @@ -221,7 +221,7 @@ curses(3x) and related pages whose names begin "menu_" for detailed descriptions of the entry points. - This describes ncurses version 6.0 (patch 20180106). + This describes ncurses version 6.1 (patch 20180127). diff --git a/doc/html/man/ncurses.3x.html b/doc/html/man/ncurses.3x.html index 3b069992..1e1a8af6 100644 --- a/doc/html/man/ncurses.3x.html +++ b/doc/html/man/ncurses.3x.html @@ -59,7 +59,7 @@ method of updating character screens with reasonable optimization. This implementation is "new curses" (ncurses) and is the approved replacement for 4.4BSD classic curses, which has been discontinued. - This describes ncurses version 6.0 (patch 20180106). + This describes ncurses version 6.1 (patch 20180127). The ncurses library emulates the curses library of System V Release 4 UNIX, and XPG4 (X/Open Portability Guide) curses (also known as XSI diff --git a/doc/html/man/ncurses6-config.1.html b/doc/html/man/ncurses6-config.1.html index d469eb7b..3ae08423 100644 --- a/doc/html/man/ncurses6-config.1.html +++ b/doc/html/man/ncurses6-config.1.html @@ -112,7 +112,7 @@
curses(3x) - This describes ncurses version 6.0 (patch 20180106). + This describes ncurses version 6.1 (patch 20180127). diff --git a/doc/html/man/panel.3x.html b/doc/html/man/panel.3x.html index 73bb61cc..30b3ef05 100644 --- a/doc/html/man/panel.3x.html +++ b/doc/html/man/panel.3x.html @@ -204,7 +204,7 @@
curses(3x), curs_variables(3x), - This describes ncurses version 6.0 (patch 20180106). + This describes ncurses version 6.1 (patch 20180127).
diff --git a/doc/html/man/tabs.1.html b/doc/html/man/tabs.1.html index 54ae4fc1..f957805c 100644 --- a/doc/html/man/tabs.1.html +++ b/doc/html/man/tabs.1.html @@ -164,7 +164,7 @@
tset(1), infocmp(1m), curses(3x), terminfo(5). - This describes ncurses version 6.0 (patch 20180106). + This describes ncurses version 6.1 (patch 20180127). diff --git a/doc/html/man/term.5.html b/doc/html/man/term.5.html index 2659fc47..1b1dfd50 100644 --- a/doc/html/man/term.5.html +++ b/doc/html/man/term.5.html @@ -26,7 +26,7 @@ * sale, use or other dealings in this Software without prior written * * authorization. * **************************************************************************** - * @Id: term.5,v 1.26 2017/02/18 16:58:21 tom Exp @ + * @Id: term.5,v 1.27 2017/12/16 21:27:20 tom Exp @ --> @@ -85,7 +85,7 @@ base otherwise. -
+
The format has been chosen so that it will be the same on all hardware. An 8 or more bit byte is assumed, but no assumptions about byte order- ing or sign extension are made. @@ -187,68 +187,110 @@ extended capabilities in order, e.g., booleans, then numbers and finally strings. + Applications which manipulate terminal data can use the definitions + described in term_variables(3x) which associate the long capability + names with members of a TERMTYPE structure. + + +
+ On occasion, 16-bit signed integers are not large enough. With ncurses + 6.1, a new format is introduced by making a few changes to the legacy + format: + + o a different magic number (0542) + + o changing the type for the number array from signed 16-bit integers + to signed 32-bit integers. + + To maintain compatibility, the library presents the same data struc- + tures to direct users of the TERMTYPE structure as in previous formats. + However, that cannot provide callers with the extended numbers. The + library uses a similar but hidden data structure TERMTYPE2 to provide + data for the terminfo functions. +
- Note that it is possible for setupterm to expect a different set of - capabilities than are actually present in the file. Either the data- + Note that it is possible for setupterm to expect a different set of + capabilities than are actually present in the file. Either the data- base may have been updated since setupterm has been recompiled (result- - ing in extra unrecognized entries in the file) or the program may have - been recompiled more recently than the database was updated (resulting - in missing entries). The routine setupterm must be prepared for both - possibilities - this is why the numbers and sizes are included. Also, - new capabilities must always be added at the end of the lists of bool- + ing in extra unrecognized entries in the file) or the program may have + been recompiled more recently than the database was updated (resulting + in missing entries). The routine setupterm must be prepared for both + possibilities - this is why the numbers and sizes are included. Also, + new capabilities must always be added at the end of the lists of bool- ean, number, and string capabilities. - Despite the consistent use of little-endian for numbers and the other- - wise self-describing format, it is not wise to count on portability of - binary terminfo entries between commercial UNIX versions. The problem - is that there are at least three versions of terminfo (under HP-UX, - AIX, and OSF/1) which diverged from System V terminfo after SVr1, and - have added extension capabilities to the string table that (in the - binary format) collide with System V and XSI Curses extensions. See - terminfo(5) for detailed discussion of terminfo source compatibility + Despite the consistent use of little-endian for numbers and the other- + wise self-describing format, it is not wise to count on portability of + binary terminfo entries between commercial UNIX versions. The problem + is that there are at least three versions of terminfo (under HP-UX, + AIX, and OSF/1) which diverged from System V terminfo after SVr1, and + have added extension capabilities to the string table that (in the + binary format) collide with System V and XSI Curses extensions. See + terminfo(5) for detailed discussion of terminfo source compatibility issues. + Direct access to the TERMTYPE structure is provided for legacy applica- + tions. Portable applications should use the tigetflag and related + functions described in curs_terminfo(3x) for reading terminal capabili- + ties. + + A small number of terminal descriptions use uppercase characters in + their names. If the underlying filesystem ignores the difference + between uppercase and lowercase, ncurses represents the "first charac- + ter" of the terminal name used as the intermediate level of a directory + tree in (two-character) hexadecimal form. +
- 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 ........ .
- Some limitations: total compiled entries cannot exceed 4096 bytes. The - name field cannot exceed 128 bytes. + Some limitations: + + o total compiled entries cannot exceed 4096 bytes in the legacy for- + mat. + + o total compiled entries cannot exceed 32768 bytes in the extended + format. + + o the name field cannot exceed 128 bytes.
@@ -263,8 +305,10 @@ Thomas E. Dickey extended terminfo format for ncurses 5.0 hashed database support for ncurses 5.6 + extended number support for ncurses 6.1 Eric S. Raymond + documented legacy terminfo format, e.g., from pcurses. @@ -277,8 +321,9 @@
diff --git a/doc/html/man/tic.1m.html b/doc/html/man/tic.1m.html index d466faa3..686ab158 100644 --- a/doc/html/man/tic.1m.html +++ b/doc/html/man/tic.1m.html @@ -364,7 +364,7 @@ infocmp(1m), captoinfo(1m), infotocap(1m), toe(1m), curses(3x), term(5). terminfo(5). - This describes ncurses version 6.0 (patch 20180106). + This describes ncurses version 6.1 (patch 20180127).
diff --git a/doc/html/man/toe.1m.html b/doc/html/man/toe.1m.html index 36aa8061..37012457 100644 --- a/doc/html/man/toe.1m.html +++ b/doc/html/man/toe.1m.html @@ -113,7 +113,7 @@ tic(1m), infocmp(1m), captoinfo(1m), infotocap(1m), curses(3x), ter- minfo(5). - This describes ncurses version 6.0 (patch 20180106). + This describes ncurses version 6.1 (patch 20180127). diff --git a/doc/html/man/tput.1.html b/doc/html/man/tput.1.html index d7be3531..f28f36af 100644 --- a/doc/html/man/tput.1.html +++ b/doc/html/man/tput.1.html @@ -482,7 +482,7 @@
clear(1), stty(1), tabs(1), tset(1), terminfo(5), curs_termcap(3x). - This describes ncurses version 6.0 (patch 20180106). + This describes ncurses version 6.1 (patch 20180127). diff --git a/doc/html/man/tset.1.html b/doc/html/man/tset.1.html index 33a1aa8e..36882224 100644 --- a/doc/html/man/tset.1.html +++ b/doc/html/man/tset.1.html @@ -389,7 +389,7 @@ csh(1), sh(1), stty(1), curs_terminfo(3x), tty(4), terminfo(5), ttys(5), environ(7) - This describes ncurses version 6.0 (patch 20180106). + This describes ncurses version 6.1 (patch 20180127). diff --git a/man/curs_termcap.3x b/man/curs_termcap.3x index 7696ee9a..cdec18d6 100644 --- a/man/curs_termcap.3x +++ b/man/curs_termcap.3x @@ -26,7 +26,7 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_termcap.3x,v 1.36 2018/01/01 15:13:16 tom Exp $ +.\" $Id: curs_termcap.3x,v 1.37 2018/01/23 10:14:38 tom Exp $ .TH curs_termcap 3X "" .de bP .ie n .IP \(bu 4 @@ -167,6 +167,9 @@ In that case, the first parameter is merely a placeholder. .bP Normally the ncurses library is compiled with terminfo support. In that case, \fBtgoto\fP uses \fBtparm\fP(3X) (a more capable formatter). +.IP +However, \fBtparm\fP is not a \fItermcap\fP feature, +and portable \fItermcap\fP applications should not rely upon its availability. .PP The \fBtputs\fR routine is described on the \fBcurs_terminfo\fR(3X) manual page. It can retrieve capabilities by either termcap or terminfo name. diff --git a/man/infocmp.1m b/man/infocmp.1m index 6062ab98..34efbf63 100644 --- a/man/infocmp.1m +++ b/man/infocmp.1m @@ -27,7 +27,7 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: infocmp.1m,v 1.69 2018/01/01 15:12:48 tom Exp $ +.\" $Id: infocmp.1m,v 1.70 2018/01/23 10:10:17 tom Exp $ .TH @INFOCMP@ 1M "" .ie \n(.g .ds `` \(lq .el .ds `` `` @@ -38,6 +38,19 @@ .ie n .IP \(bu 4 .el .IP \(bu 2 .. +.de NS +.ie n .sp +.el .sp .5 +.ie n .in +4 +.el .in +2 +.nf +.ft C \" Courier +.. +.de NE +.fi +.ft R +.in -4 +.. .ds d @TERMINFO@ .SH NAME \fB@INFOCMP@\fR \- compare or print out \fIterminfo\fR descriptions @@ -436,6 +449,12 @@ base64 3 hexadecimal and base64 .RE +.IP +For example, this prints the compiled terminfo value as a string +which could be assigned to the \fBTERMINFO\fP environment variable: +.NS +@INFOCMP@ -0 -q -Q2 +.NE .TP 5 \fB\-q\fR This makes the output a little shorter: diff --git a/misc/terminfo.src b/misc/terminfo.src index fd69ceb3..84f48108 100644 --- a/misc/terminfo.src +++ b/misc/terminfo.src @@ -6,8 +6,8 @@ # Report bugs and new terminal descriptions to # bug-ncurses@gnu.org # -# $Revision: 1.650 $ -# $Date: 2018/01/22 01:14:23 $ +# $Revision: 1.675 $ +# $Date: 2018/01/27 15:14:08 $ # # The original header is preserved below for reference. It is noted that there # is a "newer" version which differs in some cosmetic details (but actually @@ -334,52 +334,53 @@ vanilla|dumb tty, # ANSI capabilities are broken up into pieces, so that a terminal # implementing some ANSI subset can use many of them. -ansi+local1, +ansi+local1|ANSI normal-mode cursor-keys, cub1=\E[D, cud1=\E[B, cuf1=\E[C, cuu1=\E[A, -ansi+local, +ansi+local|ANSI normal-mode parameterized cursor-keys, cub=\E[%p1%dD, cud=\E[%p1%dB, cuf=\E[%p1%dC, cuu=\E[%p1%dA, use=ansi+local1, -ansi+tabs, +ansi+tabs|ANSI tab-stops, cbt=\E[Z, ht=^I, hts=\EH, tbc=\E[3g, -ansi+inittabs, +ansi+inittabs|ANSI initial tab-stops, it#8, use=ansi+tabs, -ansi+erase, +ansi+erase|ANSI clear screen/line, clear=\E[H\E[J, ed=\E[J, el=\E[K, -ansi+rca, +ansi+rca|ANSI relative cursor-addressing, hpa=\E[%p1%{1}%+%dG, vpa=\E[%p1%{1}%+%dd, -ansi+cup, +ansi+cup|ANSI absolute cursor-addressing, cup=\E[%i%p1%d;%p2%dH, home=\E[H, -ansi+rep, +ansi+rep|ANSI repeat-character, rep=%p1%c\E[%p2%{1}%-%db, -ansi+idl1, +ansi+idl1|ANSI insert/delete one line, dl1=\E[M, il1=\E[L, -ansi+idl, +ansi+idl|ANSI insert/delete lines, dl=\E[%p1%dM, il=\E[%p1%dL, use=ansi+idl1, -ansi+idc, - dch1=\E[P, ich=\E[%p1%d@, ich1=\E[@, rmir=\E[4l, - smir=\E[4h, -ansi+arrows, +ansi+idc1|ANSI insert/delete one character, + dch1=\E[P, ich1=\E[@, rmir=\E[4l, smir=\E[4h, +ansi+idc|ANSI insert/delete characters, + dch=\E[%p1%dP, ich=\E[%p1%d@, use=ansi+idc1, +ansi+arrows|ANSI normal-mode cursor-keys, kbs=^H, kcub1=\E[D, kcud1=\E[B, kcuf1=\E[C, kcuu1=\E[A, khome=\E[H, -ansi+sgr|ansi graphic renditions, +ansi+sgr|ANSI graphic renditions, blink=\E[5m, invis=\E[8m, rev=\E[7m, sgr=\E[0%?%p3%t;7%;%?%p4%t;5%;%?%p7%t;8%;m, sgr0=\E[0m, -ansi+sgrso|ansi standout only, +ansi+sgrso|ANSI standout only, rmso=\E[m, smso=\E[7m, ansi+sgrul|ansi underline only, rmul=\E[m, smul=\E[4m, -ansi+sgrbold|ansi graphic renditions; assuming terminal has bold; not dim, +ansi+sgrbold|ANSI graphic renditions; assuming terminal has bold; not dim, bold=\E[1m, sgr=\E[%?%p1%t7;%;%?%p2%t4;%;%?%p3%t7;%;%?%p4%t5;%;%?%p6%t1; %;%?%p7%t8;%;m, use=ansi+sgr, use=ansi+sgrso, use=ansi+sgrul, -ansi+sgrdim|ansi graphic renditions; assuming terminal has dim; not bold, +ansi+sgrdim|ANSI graphic renditions; assuming terminal has dim; not bold, dim=\E[2m, sgr=\E[%?%p1%t7;%;%?%p2%t4;%;%?%p3%t7;%;%?%p4%t5;%;%?%p5%t2; %;%?%p7%t8;%;m, use=ansi+sgr, use=ansi+sgrso, use=ansi+sgrul, -ansi+csr|ansi scroll-region plus cursor save & restore, +ansi+csr|ANSI scroll-region plus cursor save & restore, csr=\E[%i%p1%d;%p2%dr, rc=\E8, sc=\E7, # The normal (ANSI) flavor of "media copy" building block asserts that @@ -1292,11 +1293,11 @@ nsterm-bce|AppKit Terminal.app v71+/v100.1.8+ with Mac OS X version 10.3/10.4 (b nsterm-256color|Terminal.app in OS X 10.8, use=xterm+256setaf, use=nsterm-bce, +# removed bogus kDC7 -TD nsterm-build326|Terminal.app in OS X 10.9, kDC=\E[3;2~, kLFT=\E[1;2D, kRIT=\E[1;2C, kcbt=\E[Z, - kf18=\E[32~, kDC5=\E[3;5~, kDC7=\E[3;5~, kLFT3=\Eb, - kLFT5=\E[1;5D, kRIT3=\Ef, kRIT5=\E[1;5C, - use=nsterm-256color, + kf18=\E[32~, kDC5=\E[3;5~, kLFT3=\Eb, kLFT5=\E[1;5D, + kRIT3=\Ef, kRIT5=\E[1;5C, use=nsterm-256color, # actually "343.7" nsterm-build343|Terminal.app in OS X 10.10, @@ -1341,11 +1342,21 @@ nsterm-build343|Terminal.app in OS X 10.10, # + no support for "dynamic colors" # + no support for tcap-query. nsterm-build361|Terminal.app in OS X 10.11, + XT, kmous=\E[M, use=nsterm-build343, +# reviewed Terminal.app in High Sierra (version 2.8 build 400) -TD +# Comparing with build361, little has changed, except that italics work. +# Direct-color is not supported, by the way. +# +# Improved rmso/rmul -TD +nsterm-build400|Terminal.app in OS X 10.13, + rmso=\E[27m, rmul=\E[24m, use=xterm+sm+1006, + use=ecma+italics, use=nsterm-build361, + # This is an alias which should always point to the "current" version nsterm|Apple_Terminal|AppKit Terminal.app, - use=nsterm-build361, + use=nsterm-build400, ######## iTerm, iTerm2 @@ -1361,7 +1372,7 @@ nsterm|Apple_Terminal|AppKit Terminal.app, # According to its documentation, iTerm uses terminfo to obtain function key # definitions. For example, if it is started with TERM=xterm, it uses key # definitons from that terminal description from the local OSX machine. Those -# $TERM settings may be augmented using the bookmark and profile dialogs. +# $TERM settings may be augmented using the bookmark and profile dialogs. # However, the behavior seen with tack does not agree with either the terminfo # description or the function keys in its "xterm" profile. # @@ -1392,17 +1403,17 @@ iTerm.app|iterm|iTerm.app terminal emulator for Mac OS X, csr=\E[%i%p1%d;%p2%dr, cub=\E[%p1%dD, cub1=^H, cud=\E[%p1%dB, cud1=\n, cuf=\E[%p1%dC, cuf1=\E[C, cup=\E[%i%p1%d;%p2%dH, cuu=\E[%p1%dA, cuu1=\E[A, - dch=\E[%p1%dP, dch1=\E[P, dl=\E[%p1%dM, dl1=\E[M, - dsl=\E]2;\007, ed=\E[J, el=\E[K, el1=\E[1K, enacs=\E(B\E)0, - flash=\E[?5h$<200/>\E[?5l, fsl=^G, home=\E[H, - hpa=\E[%i%p1%dG, ht=^I, hts=\EH, ich=\E[%p1%d@, ich1=\E[@, - il=\E[%p1%dL, il1=\E[L, ind=\n, kLFT=\E[1;2D, kRIT=\E[1;2C, - kbs=^?, kcbt=\E[Z, kcub1=\EOD, kcud1=\EOB, kcuf1=\EOC, - kcuu1=\EOA, kdch1=\E[3~, kend=\EOF, kent=\EOM, kf1=\EOP, - kf10=\E[21~, kf11=\E[23~, kf12=\E[24~, kf2=\EOQ, kf3=\EOR, - kf4=\EOS, kf5=\E[15~, kf6=\E[17~, kf7=\E[18~, kf8=\E[19~, - kf9=\E[20~, khome=\EOH, knp=\E[6~, kpp=\E[5~, op=\E[0m, - rc=\E8, rev=\E[7m, ri=\EM, rmacs=^O, rmam=\E[?7l, + dch=\E[%p1%dP, dch1=\E[P, dl=\E[%p1%dM, dl1=\E[M, ed=\E[J, + el=\E[K, el1=\E[1K, enacs=\E(B\E)0, + flash=\E[?5h$<200/>\E[?5l, home=\E[H, hpa=\E[%i%p1%dG, + ht=^I, hts=\EH, ich=\E[%p1%d@, ich1=\E[@, il=\E[%p1%dL, + il1=\E[L, ind=\n, kLFT=\E[1;2D, kRIT=\E[1;2C, kbs=^?, + kcbt=\E[Z, kcub1=\EOD, kcud1=\EOB, kcuf1=\EOC, kcuu1=\EOA, + kdch1=\E[3~, kend=\EOF, kent=\EOM, kf1=\EOP, kf10=\E[21~, + kf11=\E[23~, kf12=\E[24~, kf2=\EOQ, kf3=\EOR, kf4=\EOS, + kf5=\E[15~, kf6=\E[17~, kf7=\E[18~, kf8=\E[19~, kf9=\E[20~, + khome=\EOH, knp=\E[6~, kpp=\E[5~, op=\E[0m, rc=\E8, + rev=\E[7m, ri=\EM, rmacs=^O, rmam=\E[?7l, rmcup=\E[2J\E[?47l\E8, rmir=\E[4l, rmkx=\E[?1l\E>, rmso=\E[m, rmul=\E[m, rs2=\E>\E[?3l\E[?4l\E[?5l\E[?7h\E[?8h, sc=\E7, @@ -1410,10 +1421,10 @@ iTerm.app|iterm|iTerm.app terminal emulator for Mac OS X, %p9%t\016%e\017%;, sgr0=\E[m\017, smacs=^N, smam=\E[?7h, smcup=\E7\E[?47h, smir=\E[4h, smkx=\E[?1h\E=, smso=\E[7m, smul=\E[4m, - tbc=\E[3g, tsl=\E]2;, u6=\E[%i%d;%dR, u7=\E[6n, - u8=\E[?1;2c, u9=\E[c, vpa=\E[%i%p1%dd, TS=\E]2;, - kEND5=\E[1;5F, kHOM5=\E[1;5H, use=vt100+keypad, - use=xterm+x11mouse, use=xterm+256setaf, + tbc=\E[3g, u6=\E[%i%d;%dR, u7=\E[6n, u8=\E[?1;2c, u9=\E[c, + vpa=\E[%i%p1%dd, kEND5=\E[1;5F, kHOM5=\E[1;5H, + use=xterm+sl-twm, use=vt100+keypad, use=xterm+x11mouse, + use=xterm+256setaf, # iTerm2 3.0.15 # @@ -2716,7 +2727,7 @@ rcons-color|BSD rasterconsole with ANSI color, # for PocketBSD,PocketLinux,NetBSD/{hpcmips,mac68k} # -- the setf/setb are probably incorrect, more likely setaf/setab -TD # -- compare with cons25w -mgterm, +mgterm|MGL/MGL2 MobileGear Graphic Library, OTbs, OTpt, am, bce, bw, eo, km, msgr, npc, colors#8, cols#80, it#8, lines#18, pairs#64, bel=^G, blink=\E[5m, bold=\E[1m, cbt=\E[Z, clear=\E[H\E[J, @@ -4017,8 +4028,37 @@ teraterm4.59|Tera Term Pro, acsc=``aaffggjjkkllmmnnooppqqrrssttuuvvwwxxyyzz{{||}}~~, kmous=\E[M, use=teraterm2.3, +# Version 4.97 +# +# Testing with tack: +# - no bell (flash works) +# - bold is yellow, blink is red. +# - default keyboard sends ^? for Delete, can be configured for kdch1 +# - no meta mode +# Testing with vttest: +# + autowrap has problems... +# + color-tests for bce feature match xterm's behavior +# + handles most of xterm's mouse-controls other than highlight-tracking. +# xterm's SGR 1006 works. +# + partial support for DEC locator-events +# + implements ECMA-48 SD/SU, but not REP, SL/SR. +# + has a "Tek" window, but does not work with vttest's examples +# + supports the dtterm window modify/report controls +# + responds to DECRQM and DECRQSS controls, but not consistent with DSR +# e.g., for VT220 +# + VT220 screen-display tests are ok +# + no VT52 support +# Other tests: +# + recognizes xterm's original direct-colors sequences, but result is +# poor. +# + no UTF-8 apparent when UTF-8 is set, with font Lucida Control +teraterm4.97|Tera Term Pro, + XT, use=ecma+color, use=xterm+sm+1006, use=teraterm4.59, +teraterm-256color|TeraTerm with xterm 256-colors, + use=xterm+256setaf, use=teraterm, + teraterm|Tera Term, - use=teraterm4.59, + use=teraterm4.97, # Tested with WinNT 4.0, the telnet application assumes the screensize is # 25x80. This entry uses the 'Terminal' font, to get line-drawing characters. @@ -4343,6 +4383,18 @@ xterm+app|fragment with cursor keys in application mode, # compatibility reasons, they are still available as a setting of xterm's # modifyCursorKeys resource. These fragments list the modified cursor-keys # that might apply to xterm+pcfkeys with different values of that resource. +# +# These entries will have warnings when checking with tic because the kri/kind +# capabilities duplicate the kUP/kDN extensions. This is intentional, though +# not part of the original plan. The changes for xterm patch #206 (2005/11/3) +# show that kri/kind were seen much later as part of a set including kLFT/kRIT: +# +# * modify xterm-new terminfo entry to use capabilities for shifted +# scroll forward/reverse as shifted cursor up/down. +# +# In the 1980s when terminfo was defined, the developers made more of +# a distinction between shifted up/down versus shifted left/right since most +# terminals can index (scroll up/down), while few can scroll left/right. xterm+pcc3|fragment with modifyCursorKeys:3, kLFT=\E[>1;2D, kRIT=\E[>1;2C, kind=\E[>1;2B, kri=\E[>1;2A, kDN=\E[>1;2B, kDN3=\E[>1;3B, kDN4=\E[>1;4B, @@ -4510,6 +4562,8 @@ xterm-basic|modern xterm terminal emulator - common, xterm-xi|xterm on XI Graphics Accelerated X under BSD/OS 3.1, rmso=\E[m, rmul=\E[m, use=xterm-xf86-v33, +#### XTERM Colors + # 16-colors is one of the variants of XFree86 3.3 xterm, updated for 4.0 # (T.Dickey) # @@ -4575,7 +4629,7 @@ xterm-88color|xterm with 88 colors, # Emacs 26.1 and later support direct color mode in terminals, using a # combination of user-defined capabilities and ncurses-dependent function -# calls. We will not include that here. +# calls. We will not include that here. # # Here is a first revision, which (disregarding the reuse of colors 1-7 which # is of interest only to the numerically illiterate), is compatible with other @@ -4608,6 +4662,12 @@ xterm+direct|xterm with direct-color indexing, xterm-direct|xterm with direct-color indexing, use=xterm+direct, use=xterm, +# Here are corresponding flavors for terminals which could use the feature: +iterm2-direct|iTerm2 with direct-color indexing, + use=xterm+direct, use=iterm2, +mlterm-direct|mlterm with direct-color indexing, + use=xterm+direct, use=mlterm, + # Meanwhile, in KDE #107487, the patch submitter and the developer both saw # that xterm's original implementation should have used colons for the # subparameter separators, but chose not to correct this in konsole. As of @@ -4626,7 +4686,21 @@ konsole-direct|konsole with direct-color indexing, st-direct|st with direct-color indexing, use=xterm+indirect, use=st, vte-direct|vte with direct-color indexing, - use=xterm+direct, use=vte, + use=xterm+indirect, use=vte, + +# As for others: +# + Apple's Terminal.app does not recognize either form of the direct-color +# sequences. +# + Cygwin's mintty recognizes xterm's original implementation, does okay with +# the colors. Like vte, it is a subset of xterm, although different +# omissions/reservations of modified-keys are seen in testing. +# + PuTTY 0.70 seems to recognize xterm's original implementation but does +# nothing useful with the colors. +# + Teraterm 4.97, like PuTTY (no good). +# + terminology 0.91 recognizes xterm's original implementation, but does +# nothing useful with it. + +#### XTERM Features # This chunk is based on suggestions by Ailin Nemui and Nicholas Marriott, who # asked for some of xterm's advanced features to be added to its terminfo @@ -4983,6 +5057,7 @@ kterm-color|kterm-co|kterm with ANSI colors, ncv@, use=kterm, use=ecma+color, #### Other XTERM + # These (xtermc and xtermm) are distributed with Solaris. They refer to a # variant of xterm which is apparently no longer supported, but are interesting # because they illustrate SVr4 curses mouse controls - T.Dickey @@ -5214,12 +5289,12 @@ vte-2012|VTE 0.34.1, gnome-2012|GNOME Terminal 3.6.0, use=vte-2012, -# GNOME terminal may automatically use the contents of the "xterm" terminfo to -# supply key information which is not built into the program. With 2.22.3, -# this list is built into the program (which addresses the inadvertent use of -# random terminfo data, though using a set of values which does not correspond -# to any that xterm produces - still not solving the problem that GNOME -# terminal hardcodes the $TERM variable as "xterm"). +# Before 2008, GNOME terminal could automatically use the contents of the +# "xterm" terminfo to supply key information which is not built into the +# program. With 2.22.3, this list was built into the program (which addressed +# the inadvertent use of random terminfo data, though using a set of values +# which did not correspond to any that xterm produced - still not solving the +# problem that GNOME terminal hardcoded the $TERM variable as "xterm"). # # terminfo modifier code keys # kf13-kf24 shift 2 F1 to F12 @@ -5246,14 +5321,35 @@ gnome|GNOME Terminal, use=vte-2012, # relevant changes were made in January 2014, and later. +# +# Originally VTE was promoted as a library able to emulate any terminal by +# reading its terminal description. In practice, that never got beyond the +# ability to read definitions of special keys (function-, editing-, cursor). +# +# Before 2014, VTE had a termcap reader (originally pointing to a private copy +# of a termcap file derived from xterm). That was incomplete because it did +# not have any of the modifier-key information used for xterm's function-, +# editing-, and cursor-keys. Having its own reader was unnecessary since +# ncurses provides that information; used since xterm patch #225 in 2007. +# +# During April/May 2014, a few bug reports (e.g., gnome #169295, gnome #728900, +# gnome #730137) dealt with attempts to recast that termcap reader as library +# calls, then attempting to adapt a chunk of code from ncurses (src/vteti.c), +# abandoning that and finally constructing a table to match xterm's default +# behavior, e.g., for "xterm+pcfkeys". vte-2014|VTE 0.35.1, ncv@, cbt=\E[Z, el1=\E[1K, flash=\E[?5h$<100/>\E[?5l, ich=\E[%p1%d@, indn=\E[%p1%dS, kent=\EOM, rin=\E[%p1%dT, use=xterm+sm+1006, use=xterm+pcfkeys, use=vte-2012, +# As of January 2018, this is the most recent release, +# e.g., with gnome-terminal 3.26.2 +vte-2017|VTE 0.50.2, + use=ecma+strikeout, use=vte-2014, + vte|VTE aka GNOME Terminal, - use=vte-2014, + use=vte-2017, vte-256color|VTE with xterm 256-colors, use=xterm+256color, use=vte, @@ -5330,7 +5426,7 @@ kvt|KDE terminal, bce, km@, kdch1=^?, kend=\E[F, khome=\E[H, use=xterm-color, -# Konsole 1.0.1 +# Konsole 1.0.1 (2001/11/25) # (formerly known as kvt) # # This program hardcodes $TERM to 'xterm', which is not accurate. However, to @@ -5364,27 +5460,91 @@ kvt|KDE terminal, # Updated for konsole 1.6.6: # add control-key modifiers for function-keys, etc. # -# Updated for konsole 2.12.4: +# Updated for konsole 2.3 (October 2008): +# vttest menu 1 shows that both konsole and gnome terminal do wrapping +# different from xterm (and vt100's). They have the same behavior in +# this detail, but it is unclear which copies the other. +# +# Updated for konsole 2.12.4 (late 2013): # add sitm/ritm # -# vttest menu 1 shows that both konsole and gnome terminal do wrapping -# different from xterm (and vt100's). They have the same behavior in this -# detail, but it is unclear which copies the other. +# Updated for konsole 16.07 (mid 2016): +# add dim, invis, strikeout +# (also overline, which is too rarely used to provide as an extension) +# +# Updated for konsole 17.12.0 (late 2017): konsole-base|KDE console window, bce, km@, npc, XT, ncv@, - bel@, blink=\E[5m, civis=\E[?25l, cnorm=\E[?25h, + bel@, blink=\E[5m, civis=\E[?25l, cnorm=\E[?25h, dim=\E[2m, ech=\E[%p1%dX, flash=\E[?5h$<100/>\E[?5l, - hpa=\E[%i%p1%dG, indn=\E[%p1%dS, kbs=^?, kdch1=\E[3~, - kend=\E[4~, kf1@, kf10@, kf11@, kf12@, kf13@, kf14@, kf15@, kf16@, - kf17@, kf18@, kf19@, kf2@, kf20@, kf3@, kf4@, kf5@, kf6@, kf7@, kf8@, - kf9@, kfnd@, khome=\E[1~, kslt@, rin=\E[%p1%dT, rmam=\E[?7l, - rmso=\E[27m, rmul=\E[24m, + hpa=\E[%i%p1%dG, indn=\E[%p1%dS, invis=\E[8m, kbs=^?, + kdch1=\E[3~, kend=\E[4~, kf1@, kf10@, kf11@, kf12@, kf13@, kf14@, + kf15@, kf16@, kf17@, kf18@, kf19@, kf2@, kf20@, kf3@, kf4@, kf5@, kf6@, + kf7@, kf8@, kf9@, kfnd@, khome=\E[1~, kslt@, rin=\E[%p1%dT, + rmam=\E[?7l, rmso=\E[27m, rmul=\E[24m, rs2=\E7\E[r\E8\E[m\E[?7h\E[?1;3;4;6l\E[4l\E>\E[?1000l\E[?25h, - sgr=\E[0%?%p6%t;1%;%?%p2%t;4%;%?%p1%p3%|%t;7%;%?%p4%t;5%;m%? - %p9%t\016%e\017%;, + sgr=\E[0%?%p6%t;1%;%?%p2%t;4%;%?%p1%p3%|%t;7%;%?%p4%t;5%;%? + %p5%t;2%;%?%p7%t;8%;m%?%p9%t\016%e\017%;, sgr0=\E[0m\017, smam=\E[?7h, vpa=\E[%i%p1%dd, - use=ecma+italics, use=ecma+color, use=xterm-r6, + use=ecma+strikeout, use=ecma+italics, use=ecma+color, + use=xterm-r6, + +# The keytab feature was introduced in 0.9.12 (February 2000) with "linux" and +# "vt100" key-table files along with a compiled-in default key-table. +# +# The main difference between the two keytabs was that the developer equated +# "vt100" with xterm, and noticed that the Linux console's F1-F5 differed from +# that. For the same reason, the home/end keys differ. A VT100 had none of +# that. The otherwise identical keytabs have definitions to model the VT52 +# cursor-keys and the VT100 cursor-keys with application versus normal modes. +# +# An "x11r5" keytab (displayed in the menu as "X11 R5") was added in January +# 2001, and shortly after retitled to "XFree 3.x.x". Both it and "vt100" were +# dropped from the install in June 2008. +# +# The default keytab added in January 2000 was originally titled "X11 R6", +# and likewise retitled to "XFree 4". +# +# A "solaris" keytab was added in Febrary 2005, copying the "vt100" keytab +# and changing backspace to ^H, removing that keytab's attempt to model the +# VT100 keypad and VT52 (KDE #20459). +# +# The developers made changes to the default and linux keytabs. Comparing +# the original and 2018 versions using diffstat: +# default: 119 added, 147 deleted, 28 unchanged +# linux: 47 added, 28 deleted, 104 unchanged +# +# Most of the change for the default keytab was to make konsole act more like +# xterm. That was a feature named AnyMod which came in May 2005 for KDE #92749 +# (see also Redhat #122815). Later, in June 2007 the compiled-in keytab was +# made an external file (like "linux" and "solaris"), and some further +# refinement made. But there are still flaws in the scheme. +# +# Essentially AnyMod maps the xterm "PC-style" modifier codes such as 2 for +# Shift into a placeholder in the table entries. That works well if all of the +# modified keys are modified in the same way. But xterm does not do that. The +# first 4 function keys are used in xterm to support the VT100 PF1-PF4 keypad +# keys. For example, F2 sends \EOQ in both terminals because of this feature. +# But a shifted F2 (F14=F2+12) differs like this, in infocmp's listing: +# kf14: '\E[1;2Q', '\EO2Q'. +# +# In effect, a quarter of konsole's function-keys are different from xterm. +# +# It is not a simple blunder: +# a) xterm patch #121 (November 1999), providing the first version of the +# PC-style modifiers would send \EO2Q +# b) xterm patch #216 (July 2006) amended this and other details, provided +# better documentation for the modifiers and made the behavior configurable, +# e.g., using the modifyFunctionKeys resource. The reason why it sends +# \E[1;2Q is that \E[O2Q is not a legal ECMA-48 control sequence. The +# changelog points this out as "avoid sending SS3 with parameters". +# c) That came after AnyMod was introduced, but still early enough that one +# might expect konsole's developers to followup. Twelve years later that +# has yet to happen. +# +# As of 2018, konsole still provides 3 keyboard profiles ("XFree 4", "linux", +# "solaris"). konsole-linux|KDE console window with linux keyboard, kf1=\E[[A, kf10=\E[21~, kf11=\E[23~, kf12=\E[24~, kf13@, kf14@, kf15@, kf16@, kf17@, kf18@, kf19@, kf2=\E[[B, kf20@, @@ -5392,35 +5552,47 @@ konsole-linux|KDE console window with linux keyboard, kf8=\E[19~, kf9=\E[20~, use=konsole-base, konsole-solaris|KDE console window with Solaris keyboard, kbs=^H, kend=\E[4~, khome=\E[1~, use=konsole-vt100, -# KDE's "XFree86 3.x.x" keyboard is based on reading the xterm terminfo rather -# than testing the code. + +# Obsolete: x11r5.keymap +# KDE's "XFree86 3.x.x" keyboard was obviously based on reading the xterm +# terminfo at the time rather than testing the code. konsole-xf3x|KDE console window with keyboard for XFree86 3.x xterm, kend=\E[4~, khome=\E[1~, use=konsole-vt100, -# The value for kbs reflects local customization rather than the settings used -# for XFree86 xterm. + +# The value for kbs (see konsole-vt100) reflects local customization rather +# than the settings used for XFree86 xterm. konsole-xf4x|KDE console window with keyboard for XFree86 4.x xterm, kend=\EOF, khome=\EOH, use=konsole+pcfkeys, use=konsole-vt100, -# Konsole does not implement shifted cursor-keys. + konsole+pcfkeys|konsole subset of xterm+pcfkeys, - kLFT@, kRIT@, kcbt=\E[Z, kind@, kri@, kDN@, kUP@, use=xterm+pcc2, - use=xterm+pcf0, + kcbt=\E[Z, use=xterm+pcc2, use=xterm+pcf0, + use=xterm+pce2, + +# Obsolete: vt100.keymap # KDE's "vt100" keyboard has no relationship to any terminal that DEC made, but -# it is still useful for deriving the other entries. +# it is still useful for deriving the other entries, since the developer +# provided function-keys based on xterm. konsole-vt100|KDE console window with vt100 (sic) keyboard, kbs=^?, kdch1=\E[3~, kend=\E[F, kf1=\E[11~, kf10=\E[21~, kf11=\E[23~, kf12=\E[24~, kf13@, kf14@, kf15@, kf16@, kf17@, kf18@, kf19@, kf2=\E[12~, kf20@, kf3=\E[13~, kf4=\E[14~, kf5=\E[15~, kf6=\E[17~, kf7=\E[18~, kf8=\E[19~, kf9=\E[20~, khome=\E[H, use=konsole-base, + +# Obsolete: vt420pc.keytab was added in June 2000, dropped from the install in +# September 2008 and removed in June 2016. The developer who removed it stated +# that it was never installed. konsole-vt420pc|KDE console window with vt420 pc keyboard, kbs=^H, kdch1=^?, use=konsole-vt100, -konsole-16color|klone of xterm-16color, - ncv#32, use=ibm+16color, use=konsole, + # make a default entry for konsole konsole|KDE console window, use=konsole-xf4x, +# These were written for ncurses: +konsole-16color|klone of xterm-16color, + ncv#32, use=ibm+16color, use=konsole, konsole-256color|KDE console window with xterm 256-colors, use=xterm+256setaf, use=konsole, @@ -6073,7 +6245,7 @@ st|stterm| simpleterm, # Reviewed 0.7: # dim is intermittent, sometimes works, sometimes does not -# italics may show up with yellow color +# italics may show up with yellow color # has control cursor-keys, alt cursor-keys, still no combinations # has control pageup/down st-0.7|simpleterm 0.7, @@ -6092,7 +6264,7 @@ st-0.7|simpleterm 0.7, kLFT3=\E[1;3D, kLFT5=\E[1;5D, kNXT3=\E[6;3~, kNXT5=\E[6;5~, kPRV3=\E[5;3~, kPRV5=\E[5;5~, kRIT3=\E[1;3C, kRIT5=\E[1;5C, kUP3=\E[1;3A, kUP5=\E[1;5A, - rmxx=\E[29m, smxx=\E[9m, use=st-0.6, + use=ecma+strikeout, use=st-0.6, # st-0.4.1 # @@ -6543,7 +6715,7 @@ dumb-emacs-ansi|Emacs dumb terminal with ANSI color codes, # sgr are not impacted (because that usually resets all capabilities before # setting any), but termcap applications do not use sgr -TD screen|VT 100/ANSI X3.64 virtual terminal, - OTbs, OTpt, am, km, mir, msgr, xenl, G0, XT, + OTbs, OTpt, am, km, mir, msgr, xenl, G0, colors#8, cols#80, it#8, lines#24, ncv@, pairs#64, U8#1, acsc=++\,\,--..00``aaffgghhiijjkkllmmnnooppqqrrssttuuvvwwxxy yzz{{||}}~~, @@ -6680,7 +6852,7 @@ screen.xterm-xfree86|screen.xterm-new|screen customized for modern xterm, # xterm-r6 does not really support khome/kend unless it is propped up by # the translations resource. screen.xterm-r6|screen customized for X11R6 xterm, - bw, use=screen+fkeys, use=xterm-r6, + bw, use=xterm+x11mouse, use=screen+fkeys, use=xterm-r6, # Color applications running in screen and TeraTerm do not play well together # on Solaris because Sun's curses implementation gets confused. screen.teraterm|disable ncv in teraterm, @@ -6688,31 +6860,36 @@ screen.teraterm|disable ncv in teraterm, acsc=+\020\,\021-\030.^Y0\333`\004a\261f\370g\361h\260i \316j\331k\277l\332m\300n\305o~p\304q\304r\304s_t\303u \264v\301w\302x\263y\363z\362{\343|\330}\234~\376, - use=screen+fkeys, use=screen, + use=screen+fkeys, use=xterm+x11mouse, use=screen, # Other terminals screen.rxvt|screen in rxvt, bw, XT, cvvis@, flash@, kcub1=\EOD, kcud1=\EOB, kcuf1=\EOC, kcuu1=\EOA, use=screen+fkeys, use=vt100+enq, - use=rxvt+pcfkeys, use=vt220+keypad, use=screen, + use=rxvt+pcfkeys, use=xterm+x11mouse, use=vt220+keypad, + use=screen, screen.Eterm|screen in Eterm, - use=screen+fkeys, use=Eterm, + use=xterm+x11mouse, use=screen+fkeys, use=Eterm, screen.mrxvt|screen in mrxvt, - use=screen+fkeys, use=mrxvt, + use=xterm+x11mouse, use=screen+fkeys, use=mrxvt, screen.vte|screen in any VTE-based terminal, - use=screen+italics, use=screen+fkeys, use=vte, + use=xterm+x11mouse, use=screen+italics, + use=screen+fkeys, use=vte, screen.gnome|screen in GNOME Terminal, - use=screen+italics, use=screen+fkeys, use=gnome, + use=xterm+x11mouse, use=screen+italics, + use=screen+fkeys, use=gnome, screen.konsole|screen in KDE console window, - use=screen+italics, use=screen+fkeys, use=konsole, + use=xterm+x11mouse, use=screen+italics, + use=screen+fkeys, use=konsole, # fix the backspace key screen.linux|screen in linux console, bw, - kbs=^?, kcbt@, use=screen+fkeys, use=screen, + kbs=^?, kcbt@, use=xterm+x11mouse, use=screen+fkeys, + use=screen, screen.mlterm|screen in mlterm, - use=screen+fkeys, use=mlterm, + use=xterm+x11mouse, use=screen+fkeys, use=mlterm, screen.putty|screen in putty, - use=screen+fkeys, use=putty, + use=xterm+x11mouse, use=screen+fkeys, use=putty, # The default "screen" entry is reasonably portable, but not optimal for the # most widely-used terminal emulators. The "bce" capability is supported in @@ -6784,8 +6961,14 @@ screen3|older VT 100/ANSI X3.64 virtual terminal, #### Tmux -# tmux is compatible with screen, but has support for italics, and some of the -# xterm cursor bits. +# tmux is mostly compatible with screen, but has support for italics, and some +# of the xterm cursor bits. +# +# However, unlike screen, tmux has no provision for using derived terminal +# descriptions. When screen starts, it looks for a suitable "inner" terminal +# such as "screen.$TERM" to correspond to the outer terminal's quirks. The +# various entries such as screen.xterm-new provide a way to more closely +# match the terminal. tmux|tmux terminal multiplexer, invis=\E[8m, rmso=\E[27m, sgr=\E[0%?%p6%t;1%;%?%p1%t;7%;%?%p2%t;4%;%?%p3%t;7%;%?%p4%t; @@ -7231,33 +7414,33 @@ news-unk|SONY NEWS vt100 emulator common entry, sgr0=\E[m, smkx=\E[?1h\E=, smso=\E[7m, smul=\E[4m, # # (news-29: this had :TY=ascii: --esr) -news-29, +news-29|SONY NEWS vt100 emulator with 29 lines, lines#29, use=news-unk, # (news-29-euc: this had :TY=euc: --esr) -news-29-euc, +news-29-euc|SONY NEWS vt100 emulator with 29 lines and EUC, use=news-29, # (news-29-sjis: this had :TY=sjis: --esr) -news-29-sjis, +news-29-sjis|SONY NEWS vt100 emulator with 29 lines and SJIS, use=news-29, # # (news-33: this had :TY=ascii: --esr) -news-33, +news-33|SONY NEWS vt100 with 33 lines, lines#33, use=news-unk, # (news-33-euc: this had :TY=euc: --esr) -news-33-euc, +news-33-euc|SONY NEWS vt100 with 33 lines and EUC, use=news-33, # (news-33-sjis: this had :TY=sjis: --esr) -news-33-sjis, +news-33-sjis|SONY NEWS vt100 with 33 lines and SJIS, use=news-33, # # (news-42: this had :TY=ascii: --esr) -news-42, +news-42|SONY NEWS vt100 with 42 lines, lines#42, use=news-unk, # (news-42-euc: this had :TY=euc: --esr) -news-42-euc, +news-42-euc|SONY NEWS vt100 with 42 lines and EUC, use=news-42, # (news-42-sjis: this had :TY=sjis: --esr) -news-42-sjis, +news-42-sjis|SONY NEWS vt100 with 42 lines and SJIS, use=news-42, # # NEWS-OS old termcap entry @@ -7861,16 +8044,16 @@ pcmw|PC running Microsoft Works, # the documentation dated from 1.9.9e) -TD # # For a US keyboard, with 12 function-kecbt=\E[Z, ys, -# kf1-kf12 are unmodifiedcbt=\E[Z, cbt=\E[Z, +# kf1-kf12 are unmodifiedcbt=\E[Z, cbt=\E[Z, # kf13-kf24 use the shift-key # kf25-kf36 use the left alt-key # kf37-kf38 use the control-key # kf49-kf60 use the shift- and control-keys # The shifted cursor keys send the sequences originally used for kf61-kf64: # down=\EF+ (kf61) -# up=\EF- (kf62) +# up=\EF- (kf62) # left=\EF^ (unassigned) -# right=\EF$ (kf64) +# right=\EF$ (kf64) interix|opennt|opennt-25|ntconsole|ntconsole-25|OpenNT-term compatible with color, am, bce, msgr, @@ -19448,7 +19631,7 @@ amiga-vnc|Amiga using VNC console (black on light gray), # MorphOS on Genesi Pegasos # By Pavel Fedin-morphos, +morphos|MorphOS on Genesi Pegasos, acsc=, dl=\233%p1%dM, dl1=\233M, il=\233%p1%dL, il1=\233L, ind=\204, indn@, kend=\23345~, kf11=\23320~, kf12=\23321~, khome=\23344~, kich1=\23340~, knp=\23342~, kpp=\23341~, @@ -19945,7 +20128,7 @@ screen.minitel1|Screen specific for minitel1, yzz||}}~~, bel=\007\E\^ \E\\, bold@, csr@, flash=\Eg\E\^ \E\\, kmous@, rmul@, smul@, u6=\E[%i%d;%dR, u7=\E[6n, u8=\E[?1;2c, u9=\EZ, - use=screen, + use=xterm+x11mouse, use=screen, screen.minitel1b|Screen specific for minitel1b, kclr=\E[2J, kdl1=\E[M, kf13=^Y{1, kf14=^Y{2, kf15=^Y{3, @@ -20073,7 +20256,7 @@ screen.linux-m1|Linux m1 specific for screen, \n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n \n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n \n\n\n\n\n\n\n\n\n\n, - use=screen, + use=xterm+x11mouse, use=screen, screen.linux-m1b|Linux m1b specific for screen, colors@, pairs@, @@ -23616,7 +23799,8 @@ v3220|LANPAR Vision II model 3220/3221/3222, # "default". # # XT is harder, since screen's manpage does not give more details. For that, -# we must read screen's source-code. When XT is set, screen assumes +# we must read screen's source-code. For example, when XT is set, screen +# assumes # # a) OSC 1 sets the title string, e.g., for the icon. Recent versions of # screen may also set the terminal's name, which is (for xterm) distinct @@ -23631,8 +23815,16 @@ v3220|LANPAR Vision II model 3220/3221/3222, # sequence. However, because screen uses only termcap, the values returned # by Af/Ab are not usable because they rely on expressions that termcap # does not support. Therefore, screen uses a hardcoded string to work -# around the limitation. +# around the limitation. In a few cases, screen also uses tparm, which +# is a terminfo function rather than termcap. # f) all entries named "*xterm*" or "*rxvt*" have the bce flag set. +# g) screen also uses the feature to decide whether to pay attention to other +# xterm-related features which are unrelated to the description in the +# manual page. +# +# Since XT is useful only when the outer terminal matches screen's assumptions, +# it is appropriate to use it in the derived terminal descriptions such as +# "screen.xterm", but not in the generic "screen", "screen-bce" entries. # # The other ISO-2022 features are rarely used, but provided here to make # screen's termcap features available. @@ -25487,4 +25679,22 @@ v3220|LANPAR Vision II model 3220/3221/3222, # mode does not work with those programs. konsole is debatable -TD # + add "termite" entry (report by Markus Pfeiffer) -TD # +# 2017-01-27 +# + trim "XT" from screen entry -TD +# + modify iterm to use xterm+sl-twm building block -TD +# + mark konsole-420pc, konsole-vt100, konsole-xf3x obsolete reflecting +# konsole's removal in 2008 -TD +# + expanded the history section of konsole to explain its flawed +# imitation of xterm's keyboard -TD +# + use xterm+x11mouse in screen.* entries because screen does not yet +# support xterm's 1006 mode -TD +# + add nsterm-build400 for macOS 10.13 -TD +# + add ansi+idc1, use that in ansi+idc adding dch for consistency -TD +# + update vte to vte-2017 -TD +# + add ecma+strikeout to vte-2017 -TD +# + add iterm2-direct -TD +# + updated teraterm, added teraterm-256color -TD +# + add mlterm-direct -TD +# + add descriptions for ANSI building-blocks -TD +# ######## SHANTIH! SHANTIH! SHANTIH! diff --git a/package/debian-mingw/changelog b/package/debian-mingw/changelog index 8b790c7a..0042a6a2 100644 --- a/package/debian-mingw/changelog +++ b/package/debian-mingw/changelog @@ -1,8 +1,8 @@ -ncurses6 (6.0+20180121) unstable; urgency=low +ncurses6 (6.1+20180127) unstable; urgency=low * latest weekly patch - -- Thomas E. Dickey Sat, 20 Jan 2018 19:48:08 -0500 + -- Thomas E. Dickey Mon, 22 Jan 2018 20:01:38 -0500 ncurses6 (5.9-20131005) unstable; urgency=low diff --git a/package/debian-mingw64/changelog b/package/debian-mingw64/changelog index 8b790c7a..0042a6a2 100644 --- a/package/debian-mingw64/changelog +++ b/package/debian-mingw64/changelog @@ -1,8 +1,8 @@ -ncurses6 (6.0+20180121) unstable; urgency=low +ncurses6 (6.1+20180127) unstable; urgency=low * latest weekly patch - -- Thomas E. Dickey Sat, 20 Jan 2018 19:48:08 -0500 + -- Thomas E. Dickey Mon, 22 Jan 2018 20:01:38 -0500 ncurses6 (5.9-20131005) unstable; urgency=low diff --git a/package/debian/changelog b/package/debian/changelog index b623363e..42570c59 100644 --- a/package/debian/changelog +++ b/package/debian/changelog @@ -1,8 +1,8 @@ -ncurses6 (6.0+20180121) unstable; urgency=low +ncurses6 (6.1+20180127) unstable; urgency=low * latest weekly patch - -- Thomas E. Dickey Sat, 20 Jan 2018 19:48:08 -0500 + -- Thomas E. Dickey Mon, 22 Jan 2018 20:01:38 -0500 ncurses6 (5.9-20120608) unstable; urgency=low diff --git a/package/mingw-ncurses.nsi b/package/mingw-ncurses.nsi index c07042c6..bc6eaa2b 100644 --- a/package/mingw-ncurses.nsi +++ b/package/mingw-ncurses.nsi @@ -1,4 +1,4 @@ -; $Id: mingw-ncurses.nsi,v 1.252 2018/01/21 00:48:08 tom Exp $ +; $Id: mingw-ncurses.nsi,v 1.254 2018/01/23 01:01:38 tom Exp $ ; TODO add examples ; TODO bump ABI to 6 @@ -8,9 +8,9 @@ !define EXENAME "ncurses.exe" !define VERSION_MAJOR "6" -!define VERSION_MINOR "0" +!define VERSION_MINOR "1" !define VERSION_YYYY "2018" -!define VERSION_MMDD "0121" +!define VERSION_MMDD "0127" !define VERSION_PATCH ${VERSION_YYYY}${VERSION_MMDD} !define MY_ABI "5" diff --git a/package/mingw-ncurses.spec b/package/mingw-ncurses.spec index 58019b98..645db618 100644 --- a/package/mingw-ncurses.spec +++ b/package/mingw-ncurses.spec @@ -2,8 +2,8 @@ Summary: shared libraries for terminal handling Name: mingw32-ncurses6 -Version: 6.0 -Release: 20180121 +Version: 6.1 +Release: 20180127 License: X11 Group: Development/Libraries Source: ncurses-%{version}-%{release}.tgz diff --git a/package/ncurses.spec b/package/ncurses.spec index ce293127..3066d784 100644 --- a/package/ncurses.spec +++ b/package/ncurses.spec @@ -1,7 +1,7 @@ Summary: shared libraries for terminal handling Name: ncurses6 -Version: 6.0 -Release: 20180121 +Version: 6.1 +Release: 20180127 License: X11 Group: Development/Libraries Source: ncurses-%{version}-%{release}.tgz diff --git a/progs/tic.c b/progs/tic.c index 478da6c4..da227c32 100644 --- a/progs/tic.c +++ b/progs/tic.c @@ -1,5 +1,5 @@ /**************************************************************************** - * Copyright (c) 1998-2016,2017 Free Software Foundation, Inc. * + * Copyright (c) 1998-2017,2018 Free Software Foundation, Inc. * * * * Permission is hereby granted, free of charge, to any person obtaining a * * copy of this software and associated documentation files (the * @@ -48,7 +48,7 @@ #include #include -MODULE_ID("$Id: tic.c,v 1.248 2017/12/16 23:05:21 tom Exp $") +MODULE_ID("$Id: tic.c,v 1.252 2018/01/25 19:16:50 tom Exp $") #define STDIN_NAME " " @@ -1614,6 +1614,9 @@ check_screen(TERMTYPE2 *tp) bool have_kmouse = FALSE; bool use_sgr_39_49 = FALSE; char *name = _nc_first_name(tp->term_names); + bool is_screen = !strncmp(name, "screen", 6); + bool screen_base = (is_screen + && strchr(name, '.') == 0); if (!VALID_BOOLEAN(have_bce)) { have_bce = FALSE; @@ -1635,12 +1638,10 @@ check_screen(TERMTYPE2 *tp) if (have_XM && have_XT) { _nc_warning("Screen's XT capability conflicts with XM"); - } else if (have_XT - && strstr(name, "screen") != 0 - && strchr(name, '.') != 0) { + } else if (have_XT && screen_base) { _nc_warning("Screen's \"screen\" entries should not have XT set"); } else if (have_XT) { - if (!have_kmouse && have_bce) { + if (!have_kmouse && is_screen) { if (VALID_STRING(key_mouse)) { _nc_warning("Value of kmous inconsistent with screen's usage"); } else { @@ -1654,8 +1655,11 @@ check_screen(TERMTYPE2 *tp) if (VALID_STRING(to_status_line)) _nc_warning("\"tsl\" capability is redundant, given XT"); } else { - if (have_kmouse && !have_XM) + if (have_kmouse + && !have_XM + && !screen_base && strchr(name, '+') == 0) { _nc_warning("Expected XT to be set, given kmous"); + } } } #endif diff --git a/test/test.priv.h b/test/test.priv.h index f0a68c2e..e9966129 100644 --- a/test/test.priv.h +++ b/test/test.priv.h @@ -1,5 +1,5 @@ /**************************************************************************** - * Copyright (c) 1998-2016,2017 Free Software Foundation, Inc. * + * Copyright (c) 1998-2017,2018 Free Software Foundation, Inc. * * * * Permission is hereby granted, free of charge, to any person obtaining a * * copy of this software and associated documentation files (the * @@ -29,7 +29,7 @@ /**************************************************************************** * Author: Thomas E. Dickey 1996-on * ****************************************************************************/ -/* $Id: test.priv.h,v 1.162 2017/12/26 22:20:42 tom Exp $ */ +/* $Id: test.priv.h,v 1.164 2018/01/27 20:27:16 tom Exp $ */ #ifndef __TEST_PRIV_H #define __TEST_PRIV_H 1 @@ -442,6 +442,9 @@ extern int optind; #ifndef GCC_PRINTFLIKE #define GCC_PRINTFLIKE(a,b) /* nothing */ #endif +#ifndef GCC_SCANFLIKE +#define GCC_SCANFLIKE(a,b) /* nothing */ +#endif #ifndef GCC_UNUSED #define GCC_UNUSED /* nothing */ #endif @@ -611,9 +614,17 @@ extern int optind; #ifndef WA_NORMAL #define WA_NORMAL A_NORMAL +#endif +#ifndef WA_BOLD #define WA_BOLD A_BOLD +#endif +#ifndef WA_REVERSE #define WA_REVERSE A_REVERSE +#endif +#ifndef WA_UNDERLINE #define WA_UNDERLINE A_UNDERLINE +#endif +#ifndef WA_BLINK #define WA_BLINK A_BLINK #endif -- 2.45.2