+ Announcing ncurses 5.8
- Announcing ncurses 5.1
-
- The ncurses (new curses) library is a free software emulation of
- curses in System V Release 4.0, 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 SYSV-curses
+ The ncurses (new curses) library is a free software emulation of
+ curses in System V Release 4.0, 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 SYSV-curses
enhancements over BSD curses.
- In mid-June 1995, the maintainer of 4.4BSD curses declared that he
- considered 4.4BSD curses obsolete, and is encouraging the keepers of
- Unix releases such as BSD/OS, freeBSD and netBSD to switch over to
- ncurses.
+ 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.
- The ncurses code was developed under GNU/Linux. It should port easily
- to any ANSI/POSIX-conforming UNIX. It has even been ported to OS/2
- Warp!
+ The ncurses code was developed under GNU/Linux. It has been in use for
+ some time with OpenBSD as the system curses library, and on FreeBSD
+ and NetBSD as an external package. It should port easily to any
+ ANSI/POSIX-conforming UNIX. It has even been ported to OS/2 Warp!
The distribution includes the library and support utilities, including
- a terminfo compiler tic(1), a decompiler infocmp(1), clear(1),
- tput(1), tset(1), and a termcap conversion tool captoinfo(1). Full
+ a terminfo compiler tic(1), a decompiler infocmp(1), clear(1),
+ tput(1), tset(1), and a termcap conversion tool captoinfo(1). Full
manual pages are provided for the library and tools.
- The ncurses distribution is available via anonymous FTP at the GNU
- distribution site [1]ftp://ftp.gnu.org/pub/gnu/ncurses.
- It is also available at [2]ftp://dickey.his.com/ncurses.
+ The ncurses distribution is available via anonymous FTP at the GNU
+ distribution site [1]ftp://ftp.gnu.org/gnu/ncurses/ .
+ It is also available at [2]ftp://invisible-island.net/ncurses/ .
Release Notes
- This release is designed to be upward compatible from ncurses 5.0;
- very few applications will require recompilation, depending on the
- platform. These are the highlights from the change-log since ncurses
- 5.0 release.
-
- Interface changes:
- * made the extended terminal capabilities
- (configure --enable-tcap-names) a standard feature (though the
- configure script can disable it, it is built by default).
- * removed the trace() function and related trace support from the
- production library. This is the only interface change that may
- cause problems with existing applications linked to shared
- libraries, since not all platforms use the minor version number.
- * explicitly initialized to zero several data items which were
- implicitly initialized, e.g., cur_term. If not explicitly
- initialized, their storage type is C (common), and causes problems
- linking on some platforms.
- * modified curses.h.in, undef'ing some symbols to avoid conflict
- with C++ STL.
-
- New features:
- * added a new extension, assume_default_colors() to provide better
- control over the use of default colors. This is the principal
- visible difference between ncurses 5.1 and preceding versions. The
- new extension allows an application to specify what colors pair 0
- uses.
- NOTE: Pair 0 defaults to white on black unless you have invoked
- use_default_colors() or set it via assume_default_colors(). An
- application that calls start_colors() without setting the
- background color will consistently have a black background no
- matter what color your terminal's background actually is.
- * made several fixes to the terminfo-to-termcap conversion, and have
- been using the generated termcaps without further hand-tuning.
- This builds on the extension use_extended_names() by adding
- "obsolete" termcap strings to terminfo.src
- + modified tic so that if extended names (i.e.,
- configure --enable-tcap-names) are active, then tic -x will
- also write "obsolete" capabilities that are present in the
- terminfo source.
- + added screen's AX capability (for ECMA SGR 39 and 49) to
- applicable terminfo entries, use presence of this as a check
- for a small improvement in setting default colors.
- + add -a option to tic and infocmp, which retains commented-out
- capabilities during source translation/comparison, e.g.,
- captoinfo and infotocap.
- * implemented limited support for UTF-8, useful with XFree86 xterm:
- + if the configure --enable-widec option is given, append 'w'
- to names of the generated libraries (e.g., libncursesw.so) to
- avoid conflict with existing ncurses libraries.
- + add a simple UTF-8 output driver to the experimental
- wide-character support. If any of the environment variables
- LC_ALL, LC_CTYPE or LANG contain the string "UTF-8", this
- driver will be used to translate the output to UTF-8.
- + modified view.c to make a rudimentary viewer of UTF-8 text.
- * modify raw() and noraw() to clear/restore IEXTEN flag which
- affects stty lnext on systems such as FreeBSD
- * reordered tests during mouse initialization to allow for gpm to
- run in xterm, or for xterm to be used under OS/2 EMX. Also dropped
- test for $DISPLAY in favor of the terminfo capability kmous=\E[M
- or if $TERM environment variable contains "xterm".
- * added configure option --with-manpage-symlinks, which provides for
- fully indexing manpage entries by making symbolic links for the
- aliases.
- * changed unctrl() to render C1 characters (128-159) as ~@, ~A, etc.
- * add experimental configure option --enable-colorfgbg to check for
- $COLORTERM variable as set by rxvt/aterm/Eterm.
- * made the infocmp -F option less verbose.
- * dropped support for gnat 3.10 (gnat 3.12 is current).
-
- Major bug fixes:
- * modified infocmp -e, -E options to ensure that generated
- fallback.c type for Booleans agrees with term.h
- * documented a special case of incompatiblity between ncurses 4.2
- and 5.0, added a section for this in INSTALL.
- * corrected tests for file-descriptors in OS/2 EMX mouse support. A
- negative value could be used by FD_SET, causing the select() call
- to wait indefinitely.
- * made 'tput flash' work properly for xterm by flushing output in
- delay_output() when using napms(), and modifying xterm's terminfo
- to specify no padding character. Otherwise, xterm's reported baud
- rate could mislead ncurses into producing too few padding
- characters.
- * modified lib_addch.c to allow repeated update to the lower-right
- corner, rather than displaying only the first character written
- until the cursor is moved. Recent versions of SVr4 curses can
- update the lower-right corner, and behave this way.
- * modified echo() behavior of getch() to match Solaris curses for
- carriage return and backspace (reported by Neil Zanella).
- * corrected offsets used for subwindows in wresize()
- * modified configure script so AC_MSG_ERROR is temporarily defined
- to a warning in AC_PROG_CXX to make it recover from a missing C++
- compiler without requiring user to add --without-cxx option
- * corrected logic in lib_twait.c as used by lib_mouse.c for GPM
- mouse support when poll() is used rather than select().
- * made several fixes for buffer overflows, unchecked recursion,
- improvements in performance, etc. See the NEWS file for details.
+ This release is designed to be upward compatible from ncurses 5.0
+ through 5.7; very few applications will require recompilation,
+ depending on the platform. These are the highlights from the
+ change-log since ncurses 5.7 release.
+
+Interface changes
+
+ * turn on _XOPEN_CURSES definition in curses.h.
+ * change _nc_has_mouse to has_mouse, reflect its use in C++ and
+ Ada95.
+ * add is_pad and is_subwin functions for opaque access to the WINDOW
+ structure.
+ * add tiparm, based on review of X/Open Curses Issue 7.
+
+New features and improvements
+
+ Library Improvements
+
+ * add a terminal driver for Windows console, which supports a MinGW
+ port to Windows.
+ * add extended functions which specify the SCREEN pointer for
+ several curses functions which use the global SP.
+ * improve the NCURSES_NO_UTF8_ACS feature by adding a check for an
+ extended terminfo capability U8.
+ * improve performance of tigetstr, etc., by using hashing code from
+ tic.
+ * add WACS_xxx definitions to wide-character configuration for
+ thick- and double-lines.
+ * modify init_pair to allow caller to create extra color pairs
+ beyond the color_pairs limit, which use default colors.
+
+ Improvements to Programs
+
+ * add tabs program.
+ * modify tic's -I/-C dump to reformat acsc strings into canonical
+ form (sorted, unique mapping).
+ * add checks in tic for inconsistent cursor-movement controls, and
+ for inconsistent printer-controls.
+ * add special case to _nc_infotocap (used by tic and infocmp) to
+ recognize the setaf/setab strings from xterm+256color and
+ xterm+88color, and provide a reduced version which works with
+ termcap.
+
+ Terminal Database
+
+ * added entries:
+ + bterm terminfo entry, based on bogl 0.1.18
+ + cons25-debian entry
+ + eterm-color entry
+ + linux-16color
+ + mlterm+256color entry, for mlterm 3.0.0
+ + several screen-bce.xxx entries
+ + screen.Eterm terminfo entry
+ + vwmterm entry
+ + xterm-utf8 entry as a demo of the U8 feature
+ * updated/improved entries:
+ + use extended capabilities:
+ o add U8 feature to denote entries for terminal emulators
+ which do not support VT100 SI/SO when processing UTF-8
+ encoding
+ o add XT capability to entries for terminals that support
+ both xterm-style mouse- and title-controls, for screen
+ which special-cases TERM beginning with xterm or rxvt
+ + improvements based on new checks in tic:
+ +
+ o fill in no-parameter forms of cursor-movement where a
+ parameterized form is available
+ o fill in missing cursor controls where the form of the
+ controls is ANSI
+ o add parameterized cursor-controls to linux-basic
+ o modify nsterm, xnuppc and tek4115 to make sgr/sgr0
+ consistent
+ o change several terminfo entries to make consistent use
+ of ANSI clear-all-tabs
+ + extend ansi.sys pfkey capability from kf1-kf10 to kf1-kf48,
+ moving function key definitions from emx-base for
+ consistency.
+ + correct missing final 'p' in pfkey capability of
+ ansi.sys-old.
+ + rename atari and st52 terminfo entries to atari-old,
+ st52-old, use newer entries from FreeMiNT.
+ + repurpose gnome terminfo entries as vte, retaining gnome
+ variants for compatibility, but generally deprecating those
+ since the VTE library is what actually defines the behavior
+ of "gnome", etc., since 2003.
+ + improve interix smso terminfo capability by using reverse
+ rather than bold.
+ + correct initc capability of linux-c-nc end-of-range, make
+ similar change for dg+ccc and dgunix+ccc.
+ + update minix terminfo entry.
+ + updated nsterm* entries.
+ + remove unnecessary kcan assignment to ^C from putty.
+ + suppress ncv in screen and konsole-base entries, allowing
+ underline.
+ + change ncv and op capabilities in sun-color terminfo entry to
+ match Sun's entry for this.
+ + fix typo in rmso for tek4106 entry.
+ + improve acsc string for vt52, show arrow keys.
+ + add hard-reset for rs2 to wsvt25 to help ensure that reset
+ ends the alternate character set.
+ + add ccc and initc capabilities to xterm-16color.
+
+Major bug fixes
+
+ * ncurses library
+ + wide character support
+ o modify length returned by getcchar to count the trailing
+ null which is documented in X/Open.
+ o fix an infinite recursion when adding a legacy-coding
+ 8-bit value using insch.
+ o improve a workaround in adding wide-characters, when a
+ control character is found. The library uses unctrl to
+ obtain a printable version of the control character, but
+ was not passing color or video attributes.
+ o modify waddch_literal, updating line-pointer after a
+ multicolumn character is found to not fit on the current
+ row, and wrapping is done. Since the line-pointer was
+ not updated, the wrapped multicolumn character was
+ written to the beginning of the current row.
+ o fixes in wins_nwstr and related functions to ensure that
+ special characters, i.e., control characters are handled
+ properly with the wide-character configuration.
+ o correct internal _nc_insert_ch to use _nc_insert_wch
+ when inserting wide characters, since the wins_wch
+ function that it used did not update the cursor
+ position.
+ + mouse
+ o add check if Gpm_Open returns a -2, e.g., for "xterm".
+ This is normally suppressed but can be overridden using
+ $NCURSES_GPM_TERMS. Ensure that Gpm_Close is called in
+ this case.
+ o add check in mouse-driver to disable connection if GPM
+ returns a zero, indicating that the connection is
+ closed.
+ o modify getmouse to act as its documentation implied,
+ returning on each call the preceding event until none
+ are left. When no more events remain, it will return
+ ERR.
+ + miscellaneous
+ o improve handling of color-pairs embedded in attributes
+ for the extended-colors configuration.
+ o add check for failure to open hashed-database needed for
+ db4.6.
+ o modify use of $CC environment variable which is defined
+ by X/Open as a curses feature, to ignore it if it is not
+ a single character.
+ o modify declaration of cur_term when broken-linker is
+ used, but enable-reentrant is not, to match pre-5.7.
+ o correct limit-checks in derwin.
+ o remove old check in mvderwin which prevented moving a
+ derived window whose origin happened to coincide with
+ its parent's origin.
+ o correct limit-checks in newwin, to ensure that windows
+ have nonzero size.
+ o modify set_curterm to make broken-linker configuration
+ work with changes from 20090228.
+ o modify wgetch to ensure it checks SIGWINCH when it gets
+ an error in non-blocking mode.
+ o correct limit-check in wredrawln, accounting for
+ begy/begx values.
+ o fix a null-pointer check in _nc_format_slks in
+ lib_slk.c, from 20070704 changes.
+ o correct translation of "^" in _nc_infotocap, used to
+ transform terminfo to termcap strings.
+ o modify _nc_wgetch to check for a -1 in the fifo, e.g.,
+ after a SIGWINCH, and discard that value, to avoid
+ confusing application.
+ * other libraries
+ + correct transfer of multicolumn characters in multirow
+ field_buffer, which stopped at the end of the first row due
+ to filling of unused entries in a cchar_t array with nulls.
+ + correct buffer-size after internal resizing of wide-character
+ set_field_buffer, broken in 20081018 changes.
+ + correct layout of working window used to extract data in
+ wide-character configured by set_field_buffer
+
+Portability
+
+ * configure script:
+ + new options:
+
+ --disable-libtool-version
+ use the "-version-number" feature which was added
+ in libtool 1.5. The default value for the option
+ uses the newer feature, which makes libraries
+ generated using libtool compatible with the
+ standard builds of ncurses.
+
+ --disable-rpath-hack
+ disable a feature which adds rpath options for
+ libraries in unusual places.
+
+ --enable-interop
+ integrate changes for generic/interop support to
+ form-library.
+
+ --enable-pc-files
+ generate ".pc" files for each of the libraries, and
+ install them in pkg-config's library directory.
+
+ --enable-pthreads-eintr
+ control whether to allow EINTR to interrupt a read
+ operation in wgetch. This applies only to the
+ pthread configuration
+
+ --enable-sp-funcs
+ compile-in support for extended functions which
+ accept a SCREEN pointer, reducing the need for
+ juggling the global SP value with set_term and
+ delscreen.
+
+ --enable-term-driver
+ compile with terminal-driver. That is used in the
+ MinGW port, and (being somewhat more complicated)
+ is an experimental alternative to the conventional
+ termlib internals. Currently, it requires the
+ sp-funcs feature to be enabled.
+
+ --with-ncurses-wrap-prefix
+ allows setting the prefix for functions used to
+ wrap global variables to something other than
+ "_nc_".
+
+ --with-pkg-config=[DIR]
+ check for pkg-config, optionally specifying its
+ path.
+
+ --without-manpages
+ tells the configure script to suppress the install
+ of ncurses' manpages.
+
+ --without-tests
+ suppress building test programs.
+
+ + improved options:
+ o correct logic for --with-database, which was coded as an
+ enable-type switch.
+ o omit the opaque-functions from lib_gen.o when
+ --disable-ext-funcs is used.
+ * packaging:
+ + *-config scripts:
+ o modify adacurses-config to look for ".ali" files in the
+ adalib directory.
+ o correct install for the Ada95 tree, which omitted
+ libAdaCurses.a used in adacurses-config.
+ o change install for adacurses-config to provide
+ additional flavors such as adacursesw-config, for
+ ncursesw.
+ o modify scripts to generate ncurses*-config and pc-files
+ to add dependency for tinfo library.
+ o use ncurses*-config scripts if available for
+ test/configure.
+ o correct name for termlib in ncurses*-config, e.g., if it
+ is renamed to provide a single file for ncurses/ncursesw
+ libraries.
+ o generate manpages for the *-config scripts, adapted from
+ help2man.
+ o modify install-rule for manpages so that *-config
+ manpages will install when building with --srcdir.
+ o build-fixes for OpenSolaris aka Solaris 11, for
+ wide-character configuration as well as for rpath
+ feature in *-config scripts.
+ o use $includedir symbol in misc/ncurses-config.in, add
+ --includedir option.
+ o improve install-rules for pc-files.
+ o create the pkg-config library directory if needed.
+ o fix typo "==" where "=" is needed in ncurses-config.in
+ and gen-pkgconfig.in files.
+ o modify gen-pkgconfig.in to eliminate a dependency on
+ rpath when deciding whether to add $LIBS to --libs
+ output; that should be shown for the ncurses and tinfo
+ libraries without taking rpath into account.
+ o modify handling of $PKG_CONFIG_LIBDIR to use only the
+ first item in a possibly colon-separated list.
+ + other packaging issues
+ o add make-tar.sh scripts to Ada95 and test subdirectories
+ to help with making those separately distributable.
+ o add Ada95/configure script, to use in tar-file created
+ by Ada95/make-tar.sh.
+ o remove tar-copy.sh and related configure/Makefile
+ chunks, since the Ada95 binding is now installed using
+ rules in Ada95/src.
+ * cross-compiling:
+ + improve configure checks for location of tic and infocmp
+ programs used for installing database and for generating
+ fallback data, e.g., for cross-compiling.
+ + modify #define's for build-compiler to suppress cchar_t
+ symbol from compile of make_hash and make_keys, improving
+ cross-compilation of ncursesw.
+ + simplify include-dependencies of make_hash and make_keys, to
+ reduce the need for setting BUILD_CPPFLAGS in cross-compiling
+ when the build- and target-machines differ.
+ + correct cross-compiling configure check for CF_MKSTEMP macro,
+ by adding a check cache variable set by AC_CHECK_FUNC.
+ * library dependencies:
+ + revise wadd_wch and wecho_wchar to eliminate dependency on
+ unctrl.
+ + adjust configure script so that "t" is not added to library
+ suffix when weak-symbols are used, allowing the pthread
+ configuration to more closely match the non-thread naming.
+ * building the Ada95 tree:
+ + changes to use gnatmake project files in the Ada95 tree.
+ + add/use configure check to turn on project rules for
+ Ada95/src.
+ + old gnatmake (3.15) does not produce libraries using
+ project-file; work around by adding script to generate
+ alternate makefile.
+ + add configure --with-ada-sharedlib option, for the test_make
+ rule.
+ + move Ada95-related logic into aclocal.m4, since additional
+ checks will be needed to distinguish old/new implementations
+ of gnat.
+ + add test_make / test_clean / test_install rules in Ada95/src
+ + change install-path for adainclude directory to
+ /usr/share/ada (was /usr/lib/ada).
+ * other configure/build issues:
+ + make CCHARW_MAX value configurable, noting that changing this
+ would change the size of cchar_t, and would be
+ ABI-incompatible.
+ + improve comparison of program-names when checking for linked
+ flavors such as "reset" by ignoring the executable suffix.
+ + drop mkdirs.sh, use "mkdir -p".
+ + drop misc/ncu-indent and misc/jpf-indent; they are provided
+ by an external package [3]cindent.
+ + change makefiles to use $ARFLAGS rather than $AR_OPTS,
+ provide a configure check to detect whether a "-" is needed
+ before "ar" options.
+ + modify CF_DISABLE_LEAKS configure macro so that the
+ --enable-leaks option is not the same as --disable-leaks.
+ + improve configure script macros CF_HEADER_PATH and
+ CF_LIBRARY_PATH by adding CFLAGS, CPPFLAGS and LDFLAGS, LIBS
+ values to the search-lists.
+ + improve configure macros CF_GCC_VERSION and CF_GCC_WARNINGS
+ to work with gcc 4.x's c89 alias, which gives warning
+ messages for cases where older versions would produce an
+ error.
+ + modify CF_WITH_LIBTOOL configure check to allow unreleased
+ libtool version numbers (e.g. which include alphabetic chars,
+ as well as digits, after the final '.').
+ + improve use of symbolic links in makefiles by using "-f"
+ option if it is supported, to eliminate temporary removal of
+ the target
+ + add a configure-time check to pick a suitable value for
+ CC_SHARED_OPTS for Solaris.
+ + add -shared option to MK_SHARED_LIB when -Bsharable is used,
+ for *BSD's, without which "main" might be one of the shared
+ library's dependencies.
+ + modify configure script to allow building shared libraries
+ with gcc on AIX 5 or 6.
+ + suppress configure check for static/dynamic linker flags for
+ gcc on Solaris 10, since gcc is confused by absence of static
+ libc, and does not switch back to dynamic mode before
+ finishing the libraries.
+ + suppress configure check for static/dynamic linker flags for
+ gcc on Darwin.
+ + modify misc/run_tic.in to create parent directory, in case
+ this is a new install of hashed database.
+ + modify configure check for tic program, used for fallbacks,
+ to a warning if not found. This makes it simpler to use
+ additonal scripts to bootstrap the fallbacks code using tic
+ from the build tree.
+ * test programs:
+ + add test/demo_terminfo, for comparison with demo_termcap.
+ + improve test/ncurses.c 'F' test, show combining characters in
+ color.
+ + fix logic for 'V' in test/ncurses.c tests f/F.
+ + improve test/ncurses.c 'a test to put mouse droppings in the
+ proper window.
+ + modify ncurses 'F' test to demo wborder_set with colored
+ lines.
+ + modify ncurses 'f' test to demo wborder with colored lines.
+ + improve test/ncurses.c 'a' test, using unctrl more
+ consistently to display meta-characters.
+ + correct use of key_name in test/ncurses.c 'A' test, which
+ only displays wide-characters, not key-codes since 20070612.
+ + add test/clip_printw.c to illustrate how to use printw
+ without wrapping.
+ + modify test-programs, e.g,. test/view.c, to address subtle
+ differences between Tru64/Solaris and HPUX/AIX getcchar
+ return values.
+ + add some test programs (and make these use the same special
+ keys by sharing linedata.h functions): test/test_addstr.c
+ test/test_addwstr.c test/test_addchstr.c
+ test/test_add_wchstr.c
+ + add test/xterm-256color.dat
+ + modify test programs to allow them to be built with NetBSD
+ curses.
+ + fixes for test programs to build/work on HPUX and AIX, etc.
Features of Ncurses
The ncurses package is fully compatible with SVr4 (System V Release 4)
curses:
- * All 257 of the SVr4 calls have been implemented (and are
+ * All 257 of the SVr4 calls have been implemented (and are
documented).
- * Full support for SVr4 curses features including keyboard mapping,
- color, forms-drawing with ACS characters, and automatic
+ * Full support for SVr4 curses features including keyboard mapping,
+ color, forms-drawing with ACS characters, and automatic
recognition of keypad and function keys.
- * An emulation of the SVr4 panels library, supporting a stack of
+ * An emulation of the SVr4 panels library, supporting a stack of
windows with backing store, is included.
- * An emulation of the SVr4 menus library, supporting a uniform but
+ * An emulation of the SVr4 menus library, supporting a uniform but
flexible interface for menu programming, is included.
- * An emulation of the SVr4 form library, supporting data collection
+ * An emulation of the SVr4 form library, supporting data collection
through on-screen forms, is included.
- * Binary terminfo entries generated by the ncurses tic(1)
- implementation are bit-for-bit-compatible with the entry format
+ * Binary terminfo entries generated by the ncurses tic(1)
+ implementation are bit-for-bit-compatible with the entry format
SVr4 curses uses.
* The utilities have options to allow you to filter terminfo entries
- for use with less capable curses/terminfo versions such as the
+ 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 API is 8-bit clean and base-level conformant with the X/OPEN
- curses specification, XSI curses (that is, it implements all BASE
- level features, but not all EXTENDED features). Most
- EXTENDED-level features not directly concerned with wide-character
- support are implemented, including many function calls not
- supported under SVr4 curses (but portability of all calls is
- documented so you can use the SVr4 subset only).
- * Unlike SVr3 curses, ncurses can write to the rightmost-bottommost
- corner of the screen if your terminal has an insert-character
+ * The API is 8-bit clean and base-level conformant with the X/OPEN
+ curses specification, XSI curses (that is, it implements all BASE
+ level features, and most EXTENDED features). It includes many
+ function calls not supported under SVr4 curses (but portability of
+ all calls is documented so you can use the SVr4 subset only).
+ * Unlike SVr3 curses, ncurses can write to the rightmost-bottommost
+ corner of the screen if your terminal has an insert-character
capability.
* Ada95 and C++ bindings.
- * Support for mouse event reporting with X Window xterm and OS/2
- console windows.
+ * Support for mouse event reporting with X Window xterm and FreeBSD
+ and OS/2 console windows.
* Extended mouse support via Alessandro Rubini's gpm package.
- * The function wresize() allows you to resize windows, preserving
+ * The function wresize allows you to resize windows, preserving
their data.
- * The function use_default_colors() allows you to use the terminal's
+ * The function use_default_colors allows you to use the terminal's
default colors for the default color pair, achieving the effect of
transparent colors.
- * 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.
- * Support for 16-color terminals, such as aixterm and XFree86 xterm.
- * Better cursor-movement optimization. The package now features a
+ * 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.
+ * Support for 256-color terminals, such as modern xterm, when
+ configured using the --enable-ext-colors option.
+ * Support for 16-color terminals, such as aixterm and modern xterm.
+ * Better cursor-movement optimization. The package now features a
cursor-local-movement computation more efficient than either BSD's
or System V's.
- * Super hardware scrolling support. The screen-update code
- incorporates a novel, simple, and cheap algorithm that enables it
- to make optimal use of hardware scrolling, line-insertion, and
- line-deletion for screen-line movements. This algorithm is more
- powerful than the 4.4BSD curses quickch() routine.
- * Real support for terminals with the magic-cookie glitch. The
- screen-update code will refrain from drawing a highlight if the
- magic- cookie unattributed spaces required just before the
- beginning and after the end would step on a non-space character.
- It will automatically shift highlight boundaries when doing so
- would make it possible to draw the highlight without changing the
+ * Super hardware scrolling support. The screen-update code
+ incorporates a novel, simple, and cheap algorithm that enables it
+ to make optimal use of hardware scrolling, line-insertion, and
+ line-deletion for screen-line movements. This algorithm is more
+ powerful than the 4.4BSD curses quickch routine.
+ * Real support for terminals with the magic-cookie glitch. The
+ screen-update code will refrain from drawing a highlight if the
+ magic- cookie unattributed spaces required just before the
+ beginning and after the end would step on a non-space character.
+ It will automatically shift highlight boundaries when doing so
+ would make it possible to draw the highlight without changing the
visual appearance of the screen.
- * It is possible to generate the library with a list of pre-loaded
- fallback entries linked to it so that it can serve those terminal
- types even when no terminfo tree or termcap file is accessible
- (this may be useful for support of screen-oriented programs that
+ * It is possible to generate the library with a list of pre-loaded
+ fallback entries linked to it so that it can serve those terminal
+ types even when no terminfo tree or termcap file is accessible
+ (this may be useful for support of screen-oriented programs that
must run in single-user mode).
* The tic(1)/captoinfo utility provided with ncurses has the ability
- to translate many termcaps from the XENIX, IBM and AT&T extension
+ to translate many termcaps from the XENIX, IBM and AT&T extension
sets.
* A BSD-like tset(1) utility is provided.
* The ncurses library and utilities will automatically read terminfo
- entries from $HOME/.terminfo if it exists, and compile to that
- directory if it exists and the user has no write access to the
- system directory. This feature makes it easier for users to have
- personal terminfo entries without giving up access to the system
+ 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 directory. This feature makes it easier for users to have
+ personal terminfo entries without giving up access to the system
terminfo directory.
- * You may specify a path of directories to search for compiled
- descriptions with the environment variable TERMINFO_DIRS (this
- generalizes the feature provided by TERMINFO under stock System
+ * You may specify a path of directories to search for compiled
+ descriptions with the environment variable TERMINFO_DIRS (this
+ generalizes the feature provided by TERMINFO under stock System
V.)
- * In terminfo source files, use capabilities may refer not just to
+ * In terminfo source files, use capabilities may refer not just to
other entries in the same source file (as in System V) but also to
- compiled entries in either the system terminfo directory or the
+ compiled entries in either the system terminfo directory or the
user's $HOME/.terminfo directory.
- * A script (capconvert) is provided to help BSD users transition
- from termcap to terminfo. It gathers the information in a TERMCAP
- environment variable and/or a ~/.termcap local entries file and
- converts it to an equivalent local terminfo tree under
+ * A script (capconvert) is provided to help BSD users transition
+ from termcap to terminfo. It gathers the information in a TERMCAP
+ environment variable and/or a ~/.termcap local entries file and
+ converts it to an equivalent local terminfo tree under
$HOME/.terminfo.
- * Automatic fallback to the /etc/termcap file can be compiled in
- when it is not possible to build a terminfo tree. This feature is
- neither fast nor cheap, you don't want to use it unless you have
+ * Automatic fallback to the /etc/termcap file can be compiled in
+ when it is not possible to build a terminfo tree. This feature is
+ neither fast nor cheap, you don't want to use it unless you have
to, but it's there.
- * The table-of-entries utility toe makes it easy for users to see
+ * The table-of-entries utility toe makes it easy for users to see
exactly what terminal types are available on the system.
* The library meets the XSI requirement that every macro entry point
- have a corresponding function which may be linked (and will be
- prototype-checked) if the macro definition is disabled with
+ have a corresponding function which may be linked (and will be
+ prototype-checked) if the macro definition is disabled with
#undef.
- * An HTML "Introduction to Programming with NCURSES" document
- provides a narrative introduction to the curses programming
+ * An HTML "Introduction to Programming with NCURSES" document
+ provides a narrative introduction to the curses programming
interface.
State of the Package
Numerous bugs present in earlier versions have been fixed; the library
- is far more reliable than it used to be. Bounds checking in many
- `dangerous' entry points has been improved. The code is now type-safe
- according to gcc -Wall. The library has been checked for malloc leaks
+ is far more reliable than it used to be. Bounds checking in many
+ `dangerous' entry points has been improved. The code is now type-safe
+ according to gcc -Wall. The library has been checked for malloc leaks
and arena corruption by the Purify memory-allocation tester.
- The ncurses code has been tested with a wide variety of applications
+ The ncurses code has been tested with a wide variety of applications
including (versions starting with those noted):
cdk
Curses Development Kit
- [3]http://www.vexus.ca/CDK.html
- [4]http://dickey.his.com/cdk.
+ [4]http://invisible-island.net/cdk/
+ [5]http://www.vexus.ca/products/CDK/
ded
directory-editor
- [5]http://dickey.his.com/ded.
+ [6]http://invisible-island.net/ded/
dialog
- the underlying application used in Slackware's setup, and the
+ the underlying application used in Slackware's setup, and the
basis for similar applications on GNU/Linux.
- [6]http://dickey.his.com/dialog.
+ [7]http://invisible-island.net/dialog/
lynx
the character-screen WWW browser
- [7]http://lynx.isc.org/release.
+ [8]http://lynx.isc.org/release/
- Midnight Commander 4.1
+ Midnight Commander
file manager
- [8]www.gnome.org/mc/.
+ [9]http://www.midnight-commander.org/
mutt
mail utility
- [9]http://www.mutt.org.
+ [10]http://www.mutt.org/
ncftp
file-transfer utility
- [10]http://www.ncftp.com.
+ [11]http://www.ncftp.com/
nvi
New vi versions 1.50 are able to use ncurses versions 1.9.7 and
later.
- [11]http://www.bostic.com/vi/.
-
- tin
- newsreader, supporting color, MIME
- [12]http://www.tin.org.
+ [12]https://sites.google.com/a/bostic.com/keithbostic/nvi
- taper
- tape archive utility
- [13]http://members.iinet.net.au/~yusuf/taper/.
+ pinfo
+ Lynx-like info browser.
+ [13]https://alioth.debian.org/projects/pinfo/
- vh-1.6
- Volks-Hypertext browser for the Jargon File
- [14]http://www.bg.debian.org/Packages/unstable/text/vh.html.
+ tin
+ newsreader, supporting color, MIME [14]http://www.tin.org/
as well as some that use ncurses for the terminfo support alone:
minicom
terminal emulator
- [15]http://www.pp.clinet.fi/~walker/minicom.html.
+ [15]http://alioth.debian.org/projects/minicom/
vile
vi-like-emacs
- [16]http://dickey.his.com/vile.
+ [16]http://invisible-island.net/vile/
- The ncurses distribution includes a selection of test programs
+ The ncurses distribution includes a selection of test programs
(including a few games).
Who's Who and What's What
- The original developers of ncurses are [17]Zeyd Ben-Halim and [18]Eric
- S. Raymond. Ongoing work is being done by [19]Thomas Dickey and
- [20]Jürgen Pfeifer. [21]Thomas Dickey acts as the maintainer for the
- Free Software Foundation, which holds the copyright on ncurses.
- Contact the current maintainers at [22]bug-ncurses@gnu.org.
+ Zeyd Ben-Halim started it from a previous package pcurses, written by
+ Pavel Curtis. Eric S. Raymond continued development. Juergen Pfeifer
+ wrote most of the form and menu libraries. Ongoing work is being done
+ by [17]Thomas Dickey. Thomas Dickey acts as the maintainer for the
+ Free Software Foundation, which holds the copyright on ncurses.
+ Contact the current maintainers at [18]bug-ncurses@gnu.org.
- To join the ncurses mailing list, please write email to
+ To join the ncurses mailing list, please write email to
bug-ncurses-request@gnu.org containing the line:
subscribe <name>@<host.domain>
This list is open to anyone interested in helping with the development
and testing of this package.
- Beta versions of ncurses and patches to the current release are made
- available at [23]ftp://dickey.his.com/ncurses.
+ Beta versions of ncurses and patches to the current release are made
+ available at [19]ftp://invisible-island.net/ncurses/ .
Future Plans
- * Extended-level XPG4 conformance, with internationalization
+ * Extended-level XPG4 conformance, with internationalization
support.
* Ports to more systems, including DOS and Windows.
- We need people to help with these projects. If you are interested in
+ We need people to help with these projects. If you are interested in
working on them, please join the ncurses list.
Other Related Resources
- The distribution includes and uses a version of the terminfo-format
- terminal description file maintained by Eric Raymond.
- [24]http://earthspace.net/~esr/terminfo.
+ The distribution provides a newer version of the terminfo-format
+ terminal description file once maintained by [20]Eric Raymond . Unlike
+ the older version, the termcap and terminfo data are provided in the
+ same file, and provides several user-definable extensions beyond the
+ X/Open specification.
- You can find lots of information on terminal-related topics not
- covered in the terminfo file at [25]Richard Shuford's archive.
+ You can find lots of information on terminal-related topics not
+ covered in the terminfo file at [21]Richard Shuford's archive .
References
- 1. ftp://ftp.gnu.org/pub/gnu/ncurses
- 2. ftp://dickey.his.com/ncurses
- 3. http://www.vexus.ca/CDK.html
- 4. http://dickey.his.com/cdk/cdk.html
- 5. http://dickey.his.com/ded/ded.html
- 6. http://dickey.his.com/dialog/dialog.html
- 7. http://lynx.isc.org/release/
- 8. file://localhost/usr/build/ncurses/ncurses-5.1-20000704/doc/html/www.gnome.org/mc/
- 9. http://www.mutt.org/
- 10. http://www.ncftp.com/
- 11. http://www.bostic.com/vi/
- 12. http://www.tin.org/
- 13. http://members.iinet.net.au/~yusuf/taper/
- 14. http://www.bg.debian.org/Packages/unstable/text/vh.html
- 15. http://www.pp.clinet.fi/~walker/minicom.html
- 16. http://dickey.his.com/vile/vile.html
- 17. mailto:zmbenhal@netcom.com
- 18. http://www.ccil.org/~esr/home.html
- 19. mailto:dickey@herndon4.his.com
- 20. mailto:juergen.pfeifer@gmx.net
- 21. mailto:dickey@herndon4.his.com
- 22. mailto:bug-ncurses@gnu.org
- 23. ftp://dickey.his.com/ncurses
- 24. http://earthspace.net/~esr/terminfo
- 25. http://www.cs.utk.edu/~shuford/terminal_index.html
+ 1. ftp://ftp.gnu.org/gnu/ncurses/
+ 2. ftp://invisible-island.net/ncurses/
+ 3. http://invisible-island.net/cindent/cindent.html
+ 4. http://invisible-island.net/cdk/
+ 5. http://www.vexus.ca/products/CDK/
+ 6. http://invisible-island.net/ded/
+ 7. http://invisible-island.net/dialog/
+ 8. http://lynx.isc.org/release/
+ 9. http://www.midnight-commander.org/
+ 10. http://www.mutt.org/
+ 11. http://www.ncftp.com/
+ 12. https://sites.google.com/a/bostic.com/keithbostic/nvi
+ 13. https://alioth.debian.org/projects/pinfo/
+ 14. http://www.tin.org/
+ 15. http://alioth.debian.org/projects/minicom/
+ 16. http://invisible-island.net/vile/
+ 17. mailto:dickey@invisible-island.net
+ 18. mailto:bug-ncurses@gnu.org
+ 19. ftp://invisible-island.net/ncurses/
+ 20. http://www.catb.org/~esr/terminfo/
+ 21. http://web.archive.org/web/*/http://www.cs.utk.edu/~shuford/terminal