1999-10-24 12:32:42 +08:00
|
|
|
<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 3.0//EN">
|
1997-05-15 12:00:00 +08:00
|
|
|
<!--
|
2008-11-03 10:13:51 +08:00
|
|
|
$Id: announce.html.in,v 1.70 2008/11/02 01:03:05 tom Exp $
|
2006-12-18 12:32:42 +08:00
|
|
|
****************************************************************************
|
2008-11-03 10:13:51 +08:00
|
|
|
* Copyright (c) 1998-2006,2008 Free Software Foundation, Inc. *
|
2006-12-18 12:32:42 +08:00
|
|
|
* *
|
|
|
|
|
* Permission is hereby granted, free of charge, to any person obtaining a *
|
|
|
|
|
* copy of this software and associated documentation files (the *
|
|
|
|
|
* "Software"), to deal in the Software without restriction, including *
|
|
|
|
|
* without limitation the rights to use, copy, modify, merge, publish, *
|
|
|
|
|
* distribute, distribute with modifications, sublicense, and/or sell *
|
|
|
|
|
* copies of the Software, and to permit persons to whom the Software is *
|
|
|
|
|
* furnished to do so, subject to the following conditions: *
|
|
|
|
|
* *
|
|
|
|
|
* The above copyright notice and this permission notice shall be included *
|
|
|
|
|
* in all copies or substantial portions of the Software. *
|
|
|
|
|
* *
|
|
|
|
|
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS *
|
|
|
|
|
* OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF *
|
|
|
|
|
* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. *
|
|
|
|
|
* IN NO EVENT SHALL THE ABOVE COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, *
|
|
|
|
|
* DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR *
|
|
|
|
|
* OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR *
|
|
|
|
|
* THE USE OR OTHER DEALINGS IN THE SOFTWARE. *
|
|
|
|
|
* *
|
|
|
|
|
* Except as contained in this notice, the name(s) of the above copyright *
|
|
|
|
|
* holders shall not be used in advertising or otherwise to promote the *
|
|
|
|
|
* sale, use or other dealings in this Software without prior written *
|
|
|
|
|
* authorization. *
|
|
|
|
|
****************************************************************************
|
1997-05-15 12:00:00 +08:00
|
|
|
-->
|
|
|
|
|
<HTML>
|
|
|
|
|
<HEAD>
|
2004-02-09 10:15:26 +08:00
|
|
|
<TITLE>Announcing ncurses @VERSION@</TITLE>
|
1998-03-01 12:21:12 +08:00
|
|
|
<link rev=made href="mailto:bug-ncurses@gnu.org">
|
2004-02-09 10:15:26 +08:00
|
|
|
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
|
1997-05-15 12:00:00 +08:00
|
|
|
</HEAD>
|
|
|
|
|
<BODY>
|
|
|
|
|
|
|
|
|
|
<H1>Announcing ncurses @VERSION@</H1>
|
|
|
|
|
|
1999-10-24 12:32:42 +08:00
|
|
|
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
|
1997-05-15 12:00:00 +08:00
|
|
|
and multiple highlights and forms characters and function-key mapping,
|
1998-03-01 12:21:12 +08:00
|
|
|
and has all the other SYSV-curses enhancements over BSD curses.<P>
|
1997-05-15 12:00:00 +08:00
|
|
|
|
|
|
|
|
In mid-June 1995, the maintainer of 4.4BSD curses declared that he
|
2005-10-10 02:41:57 +08:00
|
|
|
considered 4.4BSD curses obsolete, and encouraged the keepers of
|
|
|
|
|
Unix releases such as BSD/OS, FreeBSD and NetBSD to switch over to
|
1998-03-01 12:21:12 +08:00
|
|
|
ncurses.<P>
|
1997-05-15 12:00:00 +08:00
|
|
|
|
2002-10-13 11:35:53 +08:00
|
|
|
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!<P>
|
1997-05-15 12:00:00 +08:00
|
|
|
|
|
|
|
|
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 manual pages are provided for
|
1998-03-01 12:21:12 +08:00
|
|
|
the library and tools.<P>
|
1997-05-15 12:00:00 +08:00
|
|
|
|
1998-03-01 12:21:12 +08:00
|
|
|
The ncurses distribution is available via anonymous FTP at
|
|
|
|
|
the GNU distribution site
|
2004-02-09 10:15:26 +08:00
|
|
|
<A HREF="ftp://ftp.gnu.org/gnu/ncurses/">ftp://ftp.gnu.org/gnu/ncurses/</A> .
|
2000-07-09 10:46:08 +08:00
|
|
|
<br>It is also available at
|
2004-02-09 10:15:26 +08:00
|
|
|
<A HREF="ftp://invisible-island.net/ncurses/">ftp://invisible-island.net/ncurses/</A> .
|
1997-05-15 12:00:00 +08:00
|
|
|
|
1999-10-24 12:32:42 +08:00
|
|
|
<H1>Release Notes</H1>
|
1997-05-15 12:00:00 +08:00
|
|
|
|
2008-11-03 10:13:51 +08:00
|
|
|
This release is designed to be upward compatible from ncurses 5.0 through 5.6;
|
2000-10-21 12:42:11 +08:00
|
|
|
very few applications will require recompilation, depending on the platform.
|
2008-11-03 10:13:51 +08:00
|
|
|
These are the highlights from the change-log since ncurses 5.6 release.
|
1999-10-24 12:32:42 +08:00
|
|
|
<p>
|
|
|
|
|
Interface changes:
|
|
|
|
|
<ul>
|
2006-12-18 12:32:42 +08:00
|
|
|
<li>generate linkable stubs for some macros:
|
|
|
|
|
<br>
|
2008-11-03 10:13:51 +08:00
|
|
|
getattrs
|
2005-10-10 02:41:57 +08:00
|
|
|
|
2002-10-13 11:35:53 +08:00
|
|
|
</ul>
|
|
|
|
|
New features and improvements:
|
|
|
|
|
<ul>
|
2004-02-09 10:15:26 +08:00
|
|
|
<li>library
|
2006-12-18 12:32:42 +08:00
|
|
|
<ul>
|
2008-11-03 10:13:51 +08:00
|
|
|
<li>new flavor of the ncurses library provides rudimentary
|
|
|
|
|
support for POSIX threads. Several functions are
|
|
|
|
|
reentrant, but most require either a window-level or
|
|
|
|
|
screen-level mutex.<br>
|
|
|
|
|
(This is <em>API</em>-compatible,
|
|
|
|
|
but not <em>ABI</em>-compatible with the normal library).
|
|
|
|
|
|
|
|
|
|
<li>add <code>NCURSES_OPAQUE</code> symbol to curses.h, will
|
|
|
|
|
use to make structs opaque in selected configurations.
|
|
|
|
|
|
|
|
|
|
<li>add <code>NCURSES_EXT_FUNCS</code> and
|
|
|
|
|
<code>NCURSES_EXT_COLORS</code> symbols to curses.h to make
|
|
|
|
|
it simpler to tell if the extended functions and/or colors
|
|
|
|
|
are declared.
|
|
|
|
|
|
|
|
|
|
<li>add wresize() to C++ binding
|
|
|
|
|
|
|
|
|
|
<li>eliminate fixed-buffer vsprintf() calls in C++ binding.
|
|
|
|
|
|
|
|
|
|
<li>add several functions to C++ binding which wrap C functions
|
|
|
|
|
that pass a WINDOW* parameter.
|
|
|
|
|
|
|
|
|
|
<li>adapt mouse-handling code from menu library in form-library
|
|
|
|
|
|
|
|
|
|
<li>improve tracing for form library, showing created forms,
|
|
|
|
|
fields, etc.
|
|
|
|
|
|
|
|
|
|
<li>make $NCURSES_NO_PADDING feature work for termcap interface .
|
|
|
|
|
|
|
|
|
|
<li>add check to trace-file open, if the given name is a
|
|
|
|
|
directory, add ".log" to the name and try again.
|
|
|
|
|
|
|
|
|
|
<li>several new manpages: curs_legacy.3x, curs_memleaks.3x,
|
|
|
|
|
curs_opaque.3x and curs_threads.3x
|
2006-12-18 12:32:42 +08:00
|
|
|
</ul>
|
2005-10-10 02:41:57 +08:00
|
|
|
|
2006-12-18 12:32:42 +08:00
|
|
|
<li>programs:
|
|
|
|
|
<ul>
|
2008-11-03 10:13:51 +08:00
|
|
|
<li>modified three test-programs to demonstrate the threading
|
|
|
|
|
support in this version: ditto, rain, worm.
|
2006-12-18 12:32:42 +08:00
|
|
|
|
2008-11-03 10:13:51 +08:00
|
|
|
<li>several new test-programs: demo_panels, dots_mvcur,
|
|
|
|
|
inch_wide, inchs, key_name, key_names, savescreen,
|
|
|
|
|
savescreen.sh test_arrays, test_get_wstr, test_getstr,
|
|
|
|
|
test_instr, test_inwstr and test_opaque.
|
2006-12-18 12:32:42 +08:00
|
|
|
|
2008-11-03 10:13:51 +08:00
|
|
|
<li>add <code>adacurses-config</code> to the Ada95 install.
|
2006-12-18 12:32:42 +08:00
|
|
|
|
2008-11-03 10:13:51 +08:00
|
|
|
<li>modify tic <code>-f</code> option to format spaces as
|
|
|
|
|
<code>\s</code> to prevent them from being lost when that
|
|
|
|
|
is read back in unformatted strings.
|
2006-12-18 12:32:42 +08:00
|
|
|
|
2008-11-03 10:13:51 +08:00
|
|
|
<li>The <code>tack</code> program is now distributed separately
|
|
|
|
|
from ncurses.
|
2006-12-18 12:32:42 +08:00
|
|
|
</ul>
|
|
|
|
|
|
|
|
|
|
<li>terminal database
|
|
|
|
|
<ul>
|
2008-11-03 10:13:51 +08:00
|
|
|
<li>added entries:
|
|
|
|
|
<ul>
|
|
|
|
|
<li><code>Eterm-256color</code>,
|
|
|
|
|
<code>Eterm-88color</code> and
|
|
|
|
|
<code>rxvt-88color</code>
|
|
|
|
|
<li><code>aterm</code>
|
|
|
|
|
<li><code>konsole-256color</code>
|
|
|
|
|
<li><code>mrxvt</code>
|
|
|
|
|
<li><code>screen.mlterm</code>
|
|
|
|
|
<li><code>screen.rxvt</code>
|
|
|
|
|
<li><code>teraterm4.59</code> is now the primary primary
|
|
|
|
|
teraterm entry, renamed original to
|
|
|
|
|
<code>teraterm2.3</code>
|
|
|
|
|
<li><code>9term</code> terminal
|
|
|
|
|
<li>Newbury Data entries
|
|
|
|
|
</ul>
|
|
|
|
|
<li>updated/improved entries:
|
|
|
|
|
<ul>
|
|
|
|
|
<li><code>gnome</code> to version 2.22.3
|
|
|
|
|
<li><code>h19</code>, <code>z100</code>
|
|
|
|
|
<li><code>konsole</code> to version 1.6.6
|
|
|
|
|
<li><code>mlterm</code>, <code>mlterm+pcfkeys</code>
|
|
|
|
|
<li><code>xterm</code>, and building-blocks for function-keys
|
|
|
|
|
to <a href="http://invisible-island.net/xterm/xterm.log.html#xterm_230">xterm patch #230</a>.
|
|
|
|
|
</ul>
|
2006-12-18 12:32:42 +08:00
|
|
|
</ul>
|
|
|
|
|
</ul>
|
|
|
|
|
Major bug fixes:
|
|
|
|
|
<ul>
|
2008-11-03 10:13:51 +08:00
|
|
|
<li>add logic to tic for cancelling strings in user-defined
|
|
|
|
|
capabilities
|
|
|
|
|
(this is <em>needed</em> for
|
|
|
|
|
current <code>konsole</code> terminfo entry).
|
|
|
|
|
|
|
|
|
|
<li>modify <code>mk-1st.awk</code> so the generated makefile rules for
|
|
|
|
|
linking or installing shared libraries do not first remove the
|
|
|
|
|
library, in case it is in use, e.g., <code>libncurses.so</code> by
|
|
|
|
|
<code>/bin/sh</code>.
|
|
|
|
|
|
|
|
|
|
<li>correct check for notimeout() in wgetch().
|
|
|
|
|
|
|
|
|
|
<li>fix a sign-extension bug in infocmp's repair_acsc() function.
|
2004-02-09 10:15:26 +08:00
|
|
|
|
2008-11-03 10:13:51 +08:00
|
|
|
<li>change winnstr() to stop at the end of the line.
|
2004-02-09 10:15:26 +08:00
|
|
|
|
2008-11-03 10:13:51 +08:00
|
|
|
<li>make Ada95 demo_panels() example work.
|
2004-02-09 10:15:26 +08:00
|
|
|
|
2008-11-03 10:13:51 +08:00
|
|
|
<li>fix for adding a non-spacing character at the beginning of a line.
|
2005-10-10 02:41:57 +08:00
|
|
|
|
2008-11-03 10:13:51 +08:00
|
|
|
<li>fill in extended-color pair to make colors work
|
|
|
|
|
for wide-characters using extended-colors.
|
2005-10-10 02:41:57 +08:00
|
|
|
|
2008-11-03 10:13:51 +08:00
|
|
|
<li>improve refresh of window on top of multi-column characters,
|
|
|
|
|
taking into account split characters on left/right window
|
|
|
|
|
boundaries.
|
2004-02-09 10:15:26 +08:00
|
|
|
|
2008-11-03 10:13:51 +08:00
|
|
|
<li>modify <code>win_wchnstr()</code> to ensure that only a base cell
|
|
|
|
|
is returned for each multi-column character.
|
2004-02-09 10:15:26 +08:00
|
|
|
|
2008-11-03 10:13:51 +08:00
|
|
|
<li>improve <code>waddch()</code> and <code>winsch()</code> handling of
|
|
|
|
|
EILSEQ from <code>mbrtowc()</code> by using <code>unctrl()</code>
|
|
|
|
|
to display illegal bytes rather than trying to append further bytes
|
|
|
|
|
to make up a valid sequence.
|
2004-02-09 10:15:26 +08:00
|
|
|
|
2008-11-03 10:13:51 +08:00
|
|
|
<li>restore <code>curs_set()</code> state after
|
|
|
|
|
<code>endwin()</code>/<code>refresh()</code>
|
2005-10-10 02:41:57 +08:00
|
|
|
|
2008-11-03 10:13:51 +08:00
|
|
|
<li>modify <code>keyname()</code> to use "^X" form only if
|
|
|
|
|
<code>meta()</code> has been called, or if <code>keyname()</code>
|
|
|
|
|
is called without initializing curses, e.g., via
|
|
|
|
|
<code>initscr()</code> or <code>newterm()</code>.
|
2005-10-10 02:41:57 +08:00
|
|
|
|
2008-11-03 10:13:51 +08:00
|
|
|
<li>modify <code>unctrl()</code> to check codes in 128-255 range versus
|
|
|
|
|
<code>isprint()</code>.
|
|
|
|
|
If they are not printable, and locale was set, use a "M-" or "~"
|
|
|
|
|
sequence.
|
2005-10-10 02:41:57 +08:00
|
|
|
|
2008-11-03 10:13:51 +08:00
|
|
|
<li>improve <code>resizeterm()</code> by moving ripped-off lines, and
|
|
|
|
|
repainting the soft-keys.
|
2005-10-10 02:41:57 +08:00
|
|
|
|
2008-11-03 10:13:51 +08:00
|
|
|
<li>modify form library to accept control characters such as newline
|
|
|
|
|
in set_field_buffer(), which is compatible with Solaris.
|
2005-10-10 02:41:57 +08:00
|
|
|
|
2008-11-03 10:13:51 +08:00
|
|
|
<li>use <code>NCURSES_MOUSE_MASK()</code> in definition of
|
|
|
|
|
<code>BUTTON_RELEASE()</code>, etc., to make those work properly
|
|
|
|
|
with the <code>--enable-ext-mouse</code> configuration
|
2005-10-10 02:41:57 +08:00
|
|
|
|
2008-11-03 10:13:51 +08:00
|
|
|
<li>correct some functions in Ada95 binding which were using return
|
|
|
|
|
value from C where none was returned.
|
|
|
|
|
|
|
|
|
|
<li>reviewed/fixed issues reported by Coverity and Klocwork tools.
|
2006-12-18 12:32:42 +08:00
|
|
|
</ul>
|
2005-10-10 02:41:57 +08:00
|
|
|
|
2006-12-18 12:32:42 +08:00
|
|
|
Portability:
|
|
|
|
|
<ul>
|
|
|
|
|
<li>configure script:
|
|
|
|
|
<ul>
|
|
|
|
|
<li>new options:
|
|
|
|
|
<dl>
|
2004-02-09 10:15:26 +08:00
|
|
|
|
2008-11-03 10:13:51 +08:00
|
|
|
<dt>--disable-big-strings
|
|
|
|
|
<dd>control whether static string tables are generated as single
|
|
|
|
|
large strings (to improve startup performance), or as array
|
|
|
|
|
of individual strings.
|
|
|
|
|
|
|
|
|
|
<dt>--disable-relink
|
|
|
|
|
<dd>control whether shared libraries are relinked (during install)
|
|
|
|
|
when rpath is enabled.
|
|
|
|
|
|
|
|
|
|
<dt>--disable-tic-depends
|
|
|
|
|
<dd>make explicit whether tic library depends on ncurses/ncursesw
|
|
|
|
|
library.
|
|
|
|
|
|
|
|
|
|
<dt>--enable-mixed-case
|
|
|
|
|
<dd>override the configure script's check if the filesystem
|
|
|
|
|
supports mixed-case filenames.
|
|
|
|
|
This allows one to control how the terminal database
|
|
|
|
|
maps to the filesystem.
|
|
|
|
|
For filesystems that do not support mixed-case, the library
|
|
|
|
|
uses generate 2-character (hexadecimal) codes for the
|
|
|
|
|
lower-level of the filesystem terminfo database
|
|
|
|
|
|
|
|
|
|
<dt>--enable-reentrant
|
|
|
|
|
<dd>builds a different flavor of the ncurses library (ncursest)
|
|
|
|
|
which improves reentrant use of the
|
|
|
|
|
library by reducing global and static variables
|
|
|
|
|
(see the "--with-pthread" option for the threaded support).
|
|
|
|
|
|
|
|
|
|
<dt>--enable-weak-symbols
|
|
|
|
|
<dd>use weak-symbols for linking to the POSIX thread library,
|
|
|
|
|
and use the same soname for the ncurses shared library
|
|
|
|
|
as the normal library (caveat: the ABI is for the threaded
|
|
|
|
|
library, which makes global data accessed via functions).
|
|
|
|
|
|
|
|
|
|
<dt>--with-pthread
|
|
|
|
|
<dd>build with the POSIX thread library (tested with AIX,
|
|
|
|
|
Linux, FreeBSD, OpenBSD, HPUX, IRIX64, Solaris, Tru64).
|
|
|
|
|
|
|
|
|
|
<dt>--with-ticlib
|
|
|
|
|
<dd>build/install the tic-support functions in a separate library
|
2004-02-09 10:15:26 +08:00
|
|
|
|
2006-12-18 12:32:42 +08:00
|
|
|
</dl>
|
2004-02-09 10:15:26 +08:00
|
|
|
|
2006-12-18 12:32:42 +08:00
|
|
|
<li>improved options:
|
|
|
|
|
<dl>
|
2004-02-09 10:15:26 +08:00
|
|
|
|
2008-11-03 10:13:51 +08:00
|
|
|
<dt>--enable-ext-colors
|
|
|
|
|
<dd>requires the wide-character configuration.
|
2004-02-09 10:15:26 +08:00
|
|
|
|
2008-11-03 10:13:51 +08:00
|
|
|
<dt>--with-chtype
|
|
|
|
|
<dd>ignore option value "unsigned" is always added to
|
|
|
|
|
the type in curses.h; do the same for --with-mmask-t.
|
2000-10-21 12:42:11 +08:00
|
|
|
|
2008-11-03 10:13:51 +08:00
|
|
|
<dt>--with-dmalloc
|
|
|
|
|
<dd>build-fix for redefinition of <code>strndup</code>.
|
2005-10-10 02:41:57 +08:00
|
|
|
|
2008-11-03 10:13:51 +08:00
|
|
|
<dt>--with-hashed-db
|
|
|
|
|
<dd>accepts a parameter which is the install-prefix of a given
|
|
|
|
|
Berkeley Database.
|
2005-10-10 02:41:57 +08:00
|
|
|
|
2008-11-03 10:13:51 +08:00
|
|
|
<dt>--with-hashed-db
|
|
|
|
|
<dd>the $LIBS environment variable overrides the search for the db
|
|
|
|
|
library.
|
2005-10-10 02:41:57 +08:00
|
|
|
|
2008-11-03 10:13:51 +08:00
|
|
|
<dt>--without-hashed-db
|
|
|
|
|
<dd>assumed when "--disable-database" is used.
|
2005-10-10 02:41:57 +08:00
|
|
|
|
2008-11-03 10:13:51 +08:00
|
|
|
</dl>
|
2005-10-10 02:41:57 +08:00
|
|
|
|
2008-11-03 10:13:51 +08:00
|
|
|
</ul>
|
2005-10-10 02:41:57 +08:00
|
|
|
|
2008-11-03 10:13:51 +08:00
|
|
|
<li>other configure/build issues:
|
|
|
|
|
<ul>
|
|
|
|
|
<li>build-fixes for LynxOS
|
|
|
|
|
<li>modify shared-library rules to allow FreeBSD 3.x to use rpath.
|
|
|
|
|
<li>build-fix for FreeBSD "contemporary" TTY interface.
|
|
|
|
|
<li>build-fixes for AIX with libtool.
|
|
|
|
|
<li>build-fixes for Darwin and libtool.
|
|
|
|
|
<li>modify BeOS-specific ifdef's to build on Haiku.
|
|
|
|
|
<li>corrected gcc options for building shared libraries on Solaris
|
|
|
|
|
and IRIX64.
|
|
|
|
|
<li>change shared-library configuration for OpenBSD, make rpath work.
|
|
|
|
|
<li>build-fixes for using libutf8, e.g., on OpenBSD 3.7
|
|
|
|
|
<li>add "-e" option in ncurses/Makefile.in when generating source-files
|
|
|
|
|
to force earlier exit if the build environment fails unexpectedly.
|
|
|
|
|
<li>add support for shared libraries for QNX.
|
|
|
|
|
<li>change delimiter in <code>MKlib_gen.sh</code> from '%' to '@', to
|
|
|
|
|
avoid substitution by IBM xlc to '#' as part of its extensions to
|
|
|
|
|
digraphs.
|
2006-12-18 12:32:42 +08:00
|
|
|
</ul>
|
2005-10-10 02:41:57 +08:00
|
|
|
|
2006-12-18 12:32:42 +08:00
|
|
|
<li>library:
|
|
|
|
|
<ul>
|
2008-11-03 10:13:51 +08:00
|
|
|
<li>rewrite wrapper for <code>wcrtomb()</code>, making it work on
|
|
|
|
|
Solaris. This is used in the form library to determine the length
|
|
|
|
|
of the buffer needed by <code>field_buffer</code>.
|
|
|
|
|
<li>add/use configure script macro CF_SIG_ATOMIC_T, use the corresponding
|
|
|
|
|
type for data manipulated by signal handlers.
|
|
|
|
|
<li>set locale in misc/ncurses-config.in since it uses a range
|
|
|
|
|
<li>disable GPM mouse support when $TERM does not happen to contain
|
|
|
|
|
"linux", since Gpm_Open() no longer limits its assertion to terminals
|
|
|
|
|
that it might handle, e.g., within "screen" in xterm.
|
|
|
|
|
<li>reset mouse file-descriptor when unloading GPM library.
|
2006-12-18 12:32:42 +08:00
|
|
|
</ul>
|
2005-10-10 02:41:57 +08:00
|
|
|
|
2008-11-03 10:13:51 +08:00
|
|
|
<li>test programs:
|
|
|
|
|
<ul>
|
|
|
|
|
<li>update test programs to build/work with various UNIX curses for
|
|
|
|
|
comparisons.
|
2006-12-18 12:32:42 +08:00
|
|
|
</ul>
|
1999-10-24 12:32:42 +08:00
|
|
|
</ul>
|
|
|
|
|
|
|
|
|
|
<H1>Features of Ncurses</H1>
|
|
|
|
|
|
|
|
|
|
The ncurses package is fully compatible with SVr4 (System V Release 4) curses:
|
1997-05-15 12:00:00 +08:00
|
|
|
|
|
|
|
|
<UL>
|
1998-03-01 12:21:12 +08:00
|
|
|
<LI>All 257 of the SVr4 calls have been implemented (and are documented).
|
1997-05-15 12:00:00 +08:00
|
|
|
<LI>Full support for SVr4 curses features including keyboard mapping, color,
|
|
|
|
|
forms-drawing with ACS characters, and automatic recognition of keypad
|
1998-03-01 12:21:12 +08:00
|
|
|
and function keys.
|
1999-10-24 12:32:42 +08:00
|
|
|
<LI>An emulation of the SVr4 panels library, supporting
|
1998-03-01 12:21:12 +08:00
|
|
|
a stack of windows with backing store, is included.
|
1999-10-24 12:32:42 +08:00
|
|
|
<LI>An emulation of the SVr4 menus library, supporting
|
1998-03-01 12:21:12 +08:00
|
|
|
a uniform but flexible interface for menu programming, is included.
|
1999-10-24 12:32:42 +08:00
|
|
|
<LI>An emulation of the SVr4 form library, supporting
|
1998-03-01 12:21:12 +08:00
|
|
|
data collection through on-screen forms, is included.
|
1997-05-15 12:00:00 +08:00
|
|
|
<LI>Binary terminfo entries generated by the ncurses tic(1) implementation
|
1998-03-01 12:21:12 +08:00
|
|
|
are bit-for-bit-compatible with the entry format SVr4 curses uses.
|
1997-05-15 12:00:00 +08:00
|
|
|
<LI>The utilities have options to allow you to filter terminfo
|
|
|
|
|
entries for use with less capable <STRONG>curses</STRONG>/<STRONG>terminfo</STRONG>
|
1998-03-01 12:21:12 +08:00
|
|
|
versions such as the HP/UX and AIX ports.</UL>
|
1997-05-15 12:00:00 +08:00
|
|
|
|
1999-10-24 12:32:42 +08:00
|
|
|
The ncurses package also has many useful extensions over SVr4:
|
1997-05-15 12:00:00 +08:00
|
|
|
|
|
|
|
|
<UL>
|
|
|
|
|
<LI>The API is 8-bit clean and base-level conformant with the X/OPEN curses
|
1999-10-24 12:32:42 +08:00
|
|
|
specification, XSI curses (that is, it implements all BASE level features,
|
2006-12-18 12:32:42 +08:00
|
|
|
and most EXTENDED features).
|
|
|
|
|
It includes many function calls not supported under SVr4 curses
|
|
|
|
|
(but portability of all
|
1998-03-01 12:21:12 +08:00
|
|
|
calls is documented so you can use the SVr4 subset only).
|
1999-10-24 12:32:42 +08:00
|
|
|
<LI>Unlike SVr3 curses, ncurses can write to the rightmost-bottommost corner
|
1998-03-01 12:21:12 +08:00
|
|
|
of the screen if your terminal has an insert-character capability.
|
|
|
|
|
<LI>Ada95 and C++ bindings.
|
2006-12-18 12:32:42 +08:00
|
|
|
<LI>Support for mouse event reporting with X Window xterm
|
|
|
|
|
and FreeBSD and OS/2 console windows.
|
1998-03-01 12:21:12 +08:00
|
|
|
<LI>Extended mouse support via Alessandro Rubini's gpm package.
|
1997-05-15 12:00:00 +08:00
|
|
|
<LI>The function <CODE>wresize()</CODE> allows you to resize windows, preserving
|
|
|
|
|
their data.
|
1998-03-01 12:21:12 +08:00
|
|
|
<LI>The function <CODE>use_default_colors()</CODE> allows you to
|
|
|
|
|
use the terminal's default colors for the default color pair,
|
|
|
|
|
achieving the effect of transparent colors.
|
|
|
|
|
<LI>The functions <CODE>keyok()</CODE>
|
|
|
|
|
and <CODE>define_key()</CODE> 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.
|
2008-11-03 10:13:51 +08:00
|
|
|
<LI>Support for 256-color terminals, such as modern xterm, when configured
|
|
|
|
|
using the <code>--enable-ext-colors</code> option.
|
2006-12-18 12:32:42 +08:00
|
|
|
<LI>Support for 16-color terminals, such as aixterm and modern xterm.
|
1997-05-15 12:00:00 +08:00
|
|
|
<LI>Better cursor-movement optimization. The package now features a
|
|
|
|
|
cursor-local-movement computation more efficient than either BSD's
|
1998-03-01 12:21:12 +08:00
|
|
|
or System V's.
|
1997-05-15 12:00:00 +08:00
|
|
|
<LI>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
|
1998-03-01 12:21:12 +08:00
|
|
|
the 4.4BSD curses quickch() routine.
|
1997-05-15 12:00:00 +08:00
|
|
|
<LI>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.
|
1999-10-24 12:32:42 +08:00
|
|
|
<LI>It is possible to generate the library with a list of pre-loaded
|
1997-05-15 12:00:00 +08:00
|
|
|
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
|
1998-03-01 12:21:12 +08:00
|
|
|
for support of screen-oriented programs that must run in single-user mode).
|
1997-05-15 12:00:00 +08:00
|
|
|
<LI>The tic(1)/captoinfo utility provided with ncurses has the
|
|
|
|
|
ability to translate many termcaps from the XENIX, IBM and
|
1998-03-01 12:21:12 +08:00
|
|
|
AT&T extension sets.
|
|
|
|
|
<LI>A BSD-like tset(1) utility is provided.
|
1997-05-15 12:00:00 +08:00
|
|
|
<LI>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
|
1998-03-01 12:21:12 +08:00
|
|
|
without giving up access to the system terminfo directory.
|
1999-10-24 12:32:42 +08:00
|
|
|
<LI>You may specify a path of directories to search for compiled
|
1997-05-15 12:00:00 +08:00
|
|
|
descriptions with the environment variable TERMINFO_DIRS (this
|
1998-03-01 12:21:12 +08:00
|
|
|
generalizes the feature provided by TERMINFO under stock System V.)
|
1997-05-15 12:00:00 +08:00
|
|
|
<LI>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 user's
|
1998-03-01 12:21:12 +08:00
|
|
|
$HOME/.terminfo directory.
|
1997-05-15 12:00:00 +08:00
|
|
|
<LI>A script (<STRONG>capconvert</STRONG>) 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
|
1998-03-01 12:21:12 +08:00
|
|
|
and converts it to an equivalent local terminfo tree under $HOME/.terminfo.
|
1997-05-15 12:00:00 +08:00
|
|
|
<LI>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,
|
1998-03-01 12:21:12 +08:00
|
|
|
but it's there.
|
1997-05-15 12:00:00 +08:00
|
|
|
<LI>The table-of-entries utility <STRONG>toe</STRONG> makes it easy for users to
|
1998-03-01 12:21:12 +08:00
|
|
|
see exactly what terminal types are available on the system.
|
1997-05-15 12:00:00 +08:00
|
|
|
<LI>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
|
1998-03-01 12:21:12 +08:00
|
|
|
<CODE>#undef</CODE>.
|
1997-05-15 12:00:00 +08:00
|
|
|
<LI>An HTML "Introduction to Programming with NCURSES" document provides
|
|
|
|
|
a narrative introduction to the curses programming interface.
|
|
|
|
|
</UL>
|
|
|
|
|
|
|
|
|
|
<H1>State of the Package</H1>
|
|
|
|
|
|
|
|
|
|
Numerous bugs present in earlier versions have been fixed; the
|
1999-10-24 12:32:42 +08:00
|
|
|
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
|
1997-05-15 12:00:00 +08:00
|
|
|
according to gcc -Wall. The library has been checked for malloc leaks and
|
1998-03-01 12:21:12 +08:00
|
|
|
arena corruption by the Purify memory-allocation tester.<P>
|
1997-05-15 12:00:00 +08:00
|
|
|
|
|
|
|
|
The ncurses code has been tested with a wide variety of applications
|
1999-10-24 12:32:42 +08:00
|
|
|
including (versions starting with those noted):
|
1997-05-15 12:00:00 +08:00
|
|
|
<DL>
|
1999-10-24 12:32:42 +08:00
|
|
|
<DT> cdk
|
|
|
|
|
<DD> Curses Development Kit
|
2000-07-09 10:46:08 +08:00
|
|
|
<br>
|
2004-02-09 10:15:26 +08:00
|
|
|
<A HREF="http://invisible-island.net/cdk/">http://invisible-island.net/cdk/</A>
|
2000-07-09 10:46:08 +08:00
|
|
|
<br>
|
2004-02-09 10:15:26 +08:00
|
|
|
<A HREF="http://www.vexus.ca/products/CDK/">http://www.vexus.ca/products/CDK/</a>
|
1997-05-15 12:00:00 +08:00
|
|
|
<DT> ded
|
|
|
|
|
<DD> directory-editor
|
2000-07-09 10:46:08 +08:00
|
|
|
<br>
|
2004-02-09 10:15:26 +08:00
|
|
|
<A HREF="http://invisible-island.net/ded/">http://invisible-island.net/ded/</A>
|
1997-05-15 12:00:00 +08:00
|
|
|
<DT> dialog
|
|
|
|
|
<DD> the underlying application used in Slackware's setup, and the basis
|
1999-10-24 12:32:42 +08:00
|
|
|
for similar applications on GNU/Linux.
|
2000-07-09 10:46:08 +08:00
|
|
|
<br>
|
2004-02-09 10:15:26 +08:00
|
|
|
<A HREF="http://invisible-island.net/dialog/">http://invisible-island.net/dialog/</A>
|
1999-10-24 12:32:42 +08:00
|
|
|
<DT> lynx
|
1997-05-15 12:00:00 +08:00
|
|
|
<DD> the character-screen WWW browser
|
2000-07-09 10:46:08 +08:00
|
|
|
<br>
|
2004-02-09 10:15:26 +08:00
|
|
|
<A HREF="http://lynx.isc.org/release/">http://lynx.isc.org/release/</A>
|
2002-10-13 11:35:53 +08:00
|
|
|
<DT> Midnight Commander
|
1998-03-01 12:21:12 +08:00
|
|
|
<DD> file manager
|
2000-07-09 10:46:08 +08:00
|
|
|
<br>
|
2004-02-09 10:15:26 +08:00
|
|
|
<A HREF="http://www.ibiblio.org/mc/">http://www.ibiblio.org/mc/</A>
|
1999-10-24 12:32:42 +08:00
|
|
|
<DT> mutt
|
1998-03-01 12:21:12 +08:00
|
|
|
<DD> mail utility
|
2000-07-09 10:46:08 +08:00
|
|
|
<br>
|
2004-02-09 10:15:26 +08:00
|
|
|
<A HREF="http://www.mutt.org/">http://www.mutt.org/</A>
|
1999-10-24 12:32:42 +08:00
|
|
|
<DT> ncftp
|
1997-05-15 12:00:00 +08:00
|
|
|
<DD> file-transfer utility
|
2000-07-09 10:46:08 +08:00
|
|
|
<br>
|
2004-02-09 10:15:26 +08:00
|
|
|
<A HREF="http://www.ncftp.com/">http://www.ncftp.com/</A>
|
1997-05-15 12:00:00 +08:00
|
|
|
<DT> nvi
|
|
|
|
|
<DD> New vi versions 1.50 are able to use ncurses versions 1.9.7 and later.
|
2000-07-09 10:46:08 +08:00
|
|
|
<br>
|
2004-02-09 10:15:26 +08:00
|
|
|
<A HREF="http://www.bostic.com/vi/">http://www.bostic.com/vi/</A>
|
|
|
|
|
<br>
|
|
|
|
|
<DT> pinfo
|
|
|
|
|
<DD> Lynx-like info browser.
|
2008-11-03 10:13:51 +08:00
|
|
|
<A HREF="https://alioth.debian.org/projects/pinfo/">https://alioth.debian.org/projects/pinfo/</A>
|
1999-10-24 12:32:42 +08:00
|
|
|
<DT> tin
|
|
|
|
|
<DD> newsreader, supporting color, MIME
|
2004-02-09 10:15:26 +08:00
|
|
|
<A HREF="http://www.tin.org/">http://www.tin.org/</A>
|
1997-05-15 12:00:00 +08:00
|
|
|
</DL>
|
|
|
|
|
as well as some that use ncurses for the terminfo support alone:
|
|
|
|
|
<DL>
|
1999-10-24 12:32:42 +08:00
|
|
|
<DT> minicom
|
1997-05-15 12:00:00 +08:00
|
|
|
<DD> terminal emulator
|
2000-07-09 10:46:08 +08:00
|
|
|
<br>
|
2006-12-18 12:32:42 +08:00
|
|
|
<A HREF="http://alioth.debian.org/projects/minicom/">
|
|
|
|
|
http://alioth.debian.org/projects/minicom/</A>
|
1997-05-15 12:00:00 +08:00
|
|
|
<DT> vile
|
|
|
|
|
<DD> vi-like-emacs
|
2000-07-09 10:46:08 +08:00
|
|
|
<br>
|
2004-02-09 10:15:26 +08:00
|
|
|
<A HREF="http://invisible-island.net/vile/">http://invisible-island.net/vile/</A>
|
1997-05-15 12:00:00 +08:00
|
|
|
</DL>
|
|
|
|
|
<P>
|
|
|
|
|
|
|
|
|
|
The ncurses distribution includes a selection of test programs (including
|
|
|
|
|
a few games).
|
|
|
|
|
|
|
|
|
|
<H2>Who's Who and What's What</H2>
|
|
|
|
|
|
2004-02-09 10:15:26 +08:00
|
|
|
Zeyd Ben-Halim
|
|
|
|
|
started it 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.
|
1998-03-01 12:21:12 +08:00
|
|
|
Ongoing work is being done by
|
2004-02-09 10:15:26 +08:00
|
|
|
<A HREF="mailto:dickey@invisible-island.net">Thomas Dickey</A>.
|
|
|
|
|
Thomas Dickey
|
|
|
|
|
acts as the maintainer for the Free Software Foundation,
|
|
|
|
|
which holds the copyright on ncurses.
|
1998-03-01 12:21:12 +08:00
|
|
|
Contact the current maintainers at
|
|
|
|
|
<A HREF="mailto:bug-ncurses@gnu.org">bug-ncurses@gnu.org</A>.
|
1997-05-15 12:00:00 +08:00
|
|
|
<P>
|
|
|
|
|
|
1998-03-01 12:21:12 +08:00
|
|
|
To join the ncurses mailing list, please write email to
|
|
|
|
|
<CODE>bug-ncurses-request@gnu.org</CODE> containing the line:
|
1997-05-15 12:00:00 +08:00
|
|
|
<PRE>
|
|
|
|
|
subscribe <name>@<host.domain>
|
|
|
|
|
</PRE>
|
|
|
|
|
|
|
|
|
|
This list is open to anyone interested in helping with the development and
|
1998-03-01 12:21:12 +08:00
|
|
|
testing of this package.<P>
|
1997-05-15 12:00:00 +08:00
|
|
|
|
|
|
|
|
Beta versions of ncurses and patches to the current release are made available at
|
2004-02-09 10:15:26 +08:00
|
|
|
<A HREF="ftp://invisible-island.net/ncurses/">ftp://invisible-island.net/ncurses/</A> .
|
1997-05-15 12:00:00 +08:00
|
|
|
|
|
|
|
|
<H2>Future Plans</H2>
|
|
|
|
|
<UL>
|
1998-03-01 12:21:12 +08:00
|
|
|
<LI>Extended-level XPG4 conformance, with internationalization support.
|
1997-05-15 12:00:00 +08:00
|
|
|
<LI>Ports to more systems, including DOS and Windows.
|
|
|
|
|
</UL>
|
1999-10-24 12:32:42 +08:00
|
|
|
We need people to help with these projects. If you are interested in working
|
1997-05-15 12:00:00 +08:00
|
|
|
on them, please join the ncurses list.
|
|
|
|
|
|
1998-03-01 12:21:12 +08:00
|
|
|
<H2>Other Related Resources</H2>
|
1997-05-15 12:00:00 +08:00
|
|
|
|
2004-02-09 10:15:26 +08:00
|
|
|
The distribution provides a newer version of the terminfo-format
|
2006-12-18 12:32:42 +08:00
|
|
|
terminal description file once maintained by
|
2004-02-09 10:15:26 +08:00
|
|
|
<A HREF="http://www.catb.org/~esr/terminfo/">Eric Raymond</A> .
|
|
|
|
|
Unlike the older version, the termcap and terminfo data are provided
|
2006-12-18 12:32:42 +08:00
|
|
|
in the same file, and provides several user-definable extensions
|
|
|
|
|
beyond the X/Open specification.<P>
|
1997-05-15 12:00:00 +08:00
|
|
|
|
|
|
|
|
You can find lots of information on terminal-related topics
|
|
|
|
|
not covered in the terminfo file at
|
|
|
|
|
<A HREF="http://www.cs.utk.edu/~shuford/terminal_index.html">Richard Shuford's
|
2004-02-09 10:15:26 +08:00
|
|
|
archive</A> .
|
1997-05-15 12:00:00 +08:00
|
|
|
</BODY>
|
|
|
|
|
</HTML>
|
1999-10-24 12:32:42 +08:00
|
|
|
<!--
|
1997-05-15 12:00:00 +08:00
|
|
|
# The following sets edit modes for GNU EMACS
|
|
|
|
|
# Local Variables:
|
|
|
|
|
# mode:html
|
|
|
|
|
# case-fold-search:nil
|
|
|
|
|
# fill-column:70
|
|
|
|
|
# End:
|
|
|
|
|
-->
|
