+ <h3><a name="h3-portability" id="h3-portability">Portability</a></h3>
+
+ <p>Many of the portability changes are implemented via the
+ configure script:</p>
+
+ <ul>
+ <li>
+ <p>amend configure option's auto-search to account for
+ systems where none of the directories known to
+ <em>pkg-config</em> exist</p>
+ </li>
+
+ <li>
+ <p>corrected regex needed for older <em>pkg-config</em> used
+ in Solaris 10</p>
+ </li>
+
+ <li>
+ <p>improve handling of <tt>--with-pkg-config-libdir</tt>
+ option, allowing for the case where either
+ <tt>$PKG_CONFIG_LIBDIR</tt> or the option value has a
+ colon-separated list of directories</p>
+ </li>
+
+ <li>
+ <p>if the <tt>--with-pkg-config-libdir</tt> option is not
+ given, use <tt>${libdir}/pkgconfig</tt> as a default</p>
+ </li>
+
+ <li>
+ <p>improve search-path check for <em>pkg-config</em>, e.g.,
+ for Debian testing which installs <em>pkg-config</em> with
+ architecture-prefixes.</p>
+ </li>
+
+ <li>
+ <p>build-fix for cross-compiling to MingW, conditionally add
+ <tt>-lssp</tt></p>
+ </li>
+
+ <li>
+ <p>improve configure check for <tt>getttynam</tt></p>
+ </li>
+
+ <li>
+ <p>fixes to build with <em>dietlibc</em>:</p>
+
+ <ul>
+ <li>add configure check for <tt>fpathconf</tt></li>
+
+ <li>add configure check for math sine/cosine, needed in
+ test/tclock, and eliminate <tt>pow()</tt> from
+ test/hanoi</li>
+
+ <li>use <tt>wcsnlen</tt> as an alternative to
+ <tt>wmemchr</tt> if it is not found</li>
+ </ul>
+ </li>
+
+ <li>
+ <p>modify configure macro <tt>CF_BUILD_CC</tt> to check if
+ the build-compiler works, rather than that it is different
+ from the cross-compiler, e.g., to accommodate a compiler
+ which can be used for either purpose with different flags</p>
+ </li>
+
+ <li>
+ <p>modify configure/scripts to work around interference by
+ GNU grep 3.8</p>
+ </li>
+ </ul>
+
+ <p>Here are some of the other portability fixes:</p>
+
+ <ul>
+ <li>
+ <p>change <tt>man_db.renames</tt> to template, to handle
+ <em>ncurses*-config</em> script with the
+ <tt>--extra-suffix</tt> configure option.</p>
+ </li>
+
+ <li>
+ <p>update <tt>CF_XOPEN_SOURCE</tt> macro, adding variants
+ “gnueabi" and “gnueabihf" to get
+ <tt>_DEFAULT_SOURCE</tt> special case, as well as adding GNU
+ libc suffixes for “abi64”, “abin32”,
+ “x32” to distinguish it from other libc
+ flavors.</p>
+ </li>
+
+ <li>
+ <p>work around <em>musl</em>'s nonstandard use of feature
+ test macros by adding a definition for
+ <tt>NCURSES_WIDECHAR</tt> to the generated “.pc”
+ and <em><tt>*-config</tt></em> files.</p>
+ </li>
+
+ <li>
+ <p>use “<tt>command -v</tt>” rather than
+ “<tt>type</tt>” in <tt>Ada95/gen/Makefile.in</tt>
+ to fix a portability issue.</p>
+ </li>
+ </ul>
+
+ <hr>
+
+ <h2><a name="h2-features" id="h2-features">Features of
+ <span class="main-name">ncurses</span></a></h2>
+
+ <p>The <span class="main-name">ncurses</span> package is fully
+ upward-compatible with SVr4 (System V Release 4) curses:</p>
+
+ <ul>
+ <li>
+ <p>All of the SVr4 calls have been implemented (and are
+ documented).</p>
+ </li>
+
+ <li>
+ <p><span class="main-name">ncurses</span> supports all of the
+ for SVr4 curses features including keyboard mapping, color,
+ forms-drawing with ACS characters, and automatic recognition
+ of keypad and function keys.</p>
+ </li>
+
+ <li>
+ <p><span class="main-name">ncurses</span> provides these SVr4
+ add-on libraries (not part of X/Open Curses):</p>
+
+ <ul>
+ <li>
+ <p>the panels library, supporting a stack of windows with
+ backing store.</p>
+ </li>
+
+ <li>
+ <p>the menus library, supporting a uniform but flexible
+ interface for menu programming.</p>
+ </li>
+
+ <li>
+ <p>the form library, supporting data collection through
+ on-screen forms.</p>
+ </li>
+ </ul>
+ </li>
+
+ <li>
+ <p><span class="main-name">ncurses</span>'s terminal database
+ is fully compatible with that used by SVr4 curses.</p>
+
+ <ul>
+ <li>
+ <p><span class="main-name">ncurses</span> supports
+ user-defined capabilities which it can see, but which are
+ hidden from SVr4 curses applications using the
+ <em>same</em> terminal database.</p>
+ </li>
+
+ <li>
+ <p>It can be optionally configured to match the format
+ used in related systems such as AIX and Tru64.</p>
+ </li>
+
+ <li>
+ <p>Alternatively, <span class="main-name">ncurses</span>
+ can be configured to use hashed databases rather than the
+ directory of files used by SVr4 curses.</p>
+ </li>
+ </ul>
+ </li>
+
+ <li>
+ <p>The <span class="main-name">ncurses</span> utilities have
+ options to allow you to filter terminfo entries for use with
+ less capable <em>curses</em>/<em>terminfo</em> versions such
+ as the HP-UX and AIX ports.</p>
+ </li>
+ </ul>
+
+ <p>The <span class="main-name">ncurses</span> package also has
+ many useful extensions over SVr4:</p>
+
+ <ul>
+ <li>
+ <p>The API is 8-bit clean and base-level conformant with the
+ X/OPEN curses specification, XSI curses (that is, it
+ implements all <em>BASE</em> level features, and most
+ <em>EXTENDED</em> 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).</p>
+ </li>
+
+ <li>
+ <p>Unlike SVr3 curses, <span class="main-name">ncurses</span>
+ can write to the rightmost-bottommost corner of the screen if
+ your terminal has an insert-character capability.</p>
+ </li>
+
+ <li>
+ <p>Ada95 and C++ bindings.</p>
+ </li>
+
+ <li>
+ <p>Support for mouse event reporting with X Window xterm and
+ FreeBSD and OS/2 console windows.</p>
+ </li>
+
+ <li>
+ <p>Extended mouse support via Alessandro Rubini's gpm
+ package.</p>
+ </li>
+
+ <li>
+ <p>The function <code>wresize</code> allows you to resize
+ windows, preserving their data.</p>
+ </li>
+
+ <li>
+ <p>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.</p>
+ </li>
+
+ <li>
+ <p>The functions <code>keyok</code> and
+ <code>define_key</code> allow you to better control the use
+ of function keys, e.g., disabling the <span class=
+ "main-name">ncurses</span> KEY_MOUSE, or by defining more
+ than one control sequence to map to a given key code.</p>
+ </li>
+
+ <li>
+ <p>Support for direct-color terminals, such as modern
+ xterm.</p>
+ </li>
+
+ <li>
+ <p>Support for 256-color terminals, such as modern xterm.</p>
+ </li>
+
+ <li>
+ <p>Support for 16-color terminals, such as <em>aixterm</em>
+ and <em>modern xterm</em>.</p>
+ </li>
+
+ <li>
+ <p>Better cursor-movement optimization. The package now
+ features a cursor-local-movement computation more efficient
+ than either BSD's or System V's.</p>
+ </li>
+
+ <li>
+ <p>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
+ <code>quickch</code> routine.</p>
+ </li>
+
+ <li>
+ <p>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.</p>
+ </li>
+
+ <li>
+ <p>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).</p>
+ </li>
+
+ <li>
+ <p>The <a href="@HOMEPAGE@/man/tic.1m.html"><span class=
+ "part-name">tic</span></a>/<a href=
+ "@HOMEPAGE@/man/captoinfo.1m.html">captoinfo</a> utility
+ provided with <span class="main-name">ncurses</span> has the
+ ability to translate many termcaps from the XENIX, IBM and
+ AT&T extension sets.</p>
+ </li>
+
+ <li>
+ <p>A BSD-like <a href=
+ "@HOMEPAGE@/man/tset.1.html"><span class=
+ "part-name">tset</span></a> utility is provided.</p>
+ </li>
+
+ <li>
+ <p>The <span class="main-name">ncurses</span> library and
+ utilities will automatically read terminfo entries from
+ $HOME/.terminfo if it exists, and compile to that directory
+ if it exists and the user has no write access to the system
+ directory. This feature makes it easier for users to have
+ personal terminfo entries without giving up access to the
+ system terminfo directory.</p>
+ </li>
+
+ <li>
+ <p>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.)</p>
+ </li>
+
+ <li>
+ <p>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 $HOME/.terminfo directory.</p>
+ </li>
+
+ <li>
+ <p>The table-of-entries utility <a href=
+ "@HOMEPAGE@/man/toe.1m.html"><span class=
+ "part-name">toe</span></a> makes it easy for users to see
+ exactly what terminal types are available on the system.</p>
+ </li>
+
+ <li>
+ <p>The library meets the XSI requirement that every macro
+ entry point has a corresponding function which may be linked
+ (and will be prototype-checked) if the macro definition is
+ disabled with <code>#undef</code>.</p>
+ </li>
+
+ <li>
+ <p>Extensive documentation is provided (see the <em><a href=
+ "@HOMEPAGE@/ncurses.faq.html#additional_reading">Additional
+ Reading</a></em> section of the <em><a href=
+ "@HOMEPAGE@/ncurses.faq.html"><span class=
+ "main-name">ncurses</span> FAQ</a></em> for online
+ documentation).</p>
+ </li>
+ </ul>
+
+ <h2><a name="h2-who-uses" id="h2-who-uses">Applications using
+ <span class="main-name">ncurses</span></a></h2>
+
+ <p>The <span class="main-name">ncurses</span> distribution
+ includes a selection of test programs (including a few games).
+ These are available separately as <a href=
+ "@HOMEPAGE@/ncurses-examples.html">ncurses-examples</a></p>
+
+ <p>The ncurses library has been tested with a wide variety of
+ applications including:</p>
+
+ <blockquote>
+ <dl>
+ <dt><span class="part-name">aptitude</span>
+ </dt>
+
+ <dd>
+ <p>FrontEnd to Apt, the debian package manager</p>
+
+ <p><a href=
+ "https://wiki.debian.org/Aptitude">https://wiki.debian.org/Aptitude</a></p>
+ </dd>
+
+ <dt><span class="part-name">cdk</span>
+ </dt>
+
+ <dd>
+ <p>Curses Development Kit</p>
+
+ <p><a href="@WEBSITE@/cdk/">@WEBSITE@/cdk/</a><br>
+ </p>
+ </dd>
+
+ <dt><span class="part-name">ded</span>
+ </dt>
+
+ <dd>
+ <p>directory-editor</p>
+
+ <p><a href="@WEBSITE@/ded/">@WEBSITE@/ded/</a></p>
+ </dd>
+
+ <dt><span class="part-name">dialog</span>
+ </dt>
+
+ <dd>
+ <p>the underlying application used in Slackware's setup,
+ and the basis for similar install/configure applications on
+ many systems.</p>
+
+ <p><a href="@WEBSITE@/dialog/">@WEBSITE@/dialog/</a></p>
+ </dd>
+
+ <dt><span class="part-name">lynx</span>
+ </dt>
+
+ <dd>
+ <p>the text WWW browser</p>
+
+ <p><a href=
+ "https://lynx.invisible-island.net/">https://lynx.invisible-island.net/</a></p>
+ </dd>
+
+ <dt><span class="part-name">mutt</span>
+ </dt>
+
+ <dd>
+ <p>mail utility</p>
+
+ <p><a href="http://www.mutt.org/">http://www.mutt.org/</a></p>
+ </dd>
+
+ <dt><span class="part-name">ncftp</span>
+ </dt>
+
+ <dd>
+ <p>file-transfer utility</p>
+
+ <p><a href=
+ "https://www.ncftp.com/">https://www.ncftp.com/</a></p>
+ </dd>
+
+ <dt><span class="part-name">nvi</span>
+ </dt>
+
+ <dd>
+ <p>New vi uses ncurses.</p>
+
+ <p><a href=
+ "https://sites.google.com/a/bostic.com/keithbostic/vi">https://sites.google.com/a/bostic.com/keithbostic/vi</a><br>
+
+ </p>
+ </dd>
+
+ <dt><span class="part-name">ranger</span>
+ </dt>
+
+ <dd>
+ <p>A console file manager with VI key bindings in
+ <em>Python</em>.</p>
+
+ <p><a href=
+ "https://ranger.github.io/">https://ranger.github.io/</a></p>
+ </dd>
+
+ <dt><span class="part-name">tin</span>
+ </dt>
+
+ <dd>
+ <p>newsreader, supporting color, MIME</p>
+
+ <p><a href="http://www.tin.org/">http://www.tin.org/</a></p>
+ </dd>
+
+ <dt><span class="part-name">vifm</span>
+ </dt>
+
+ <dd>
+ <p>File manager with vi like keybindings</p>
+
+ <p><a href="https://vifm.info/">https://vifm.info/</a></p>
+ </dd>
+ </dl>
+ </blockquote>
+
+ <p>as well as some that use <span class=
+ "main-name">ncurses</span> for the terminfo support alone:</p>
+
+ <blockquote>
+ <dl>
+ <dt><span class="part-name">minicom</span>
+ </dt>
+
+ <dd>
+ <p>terminal emulator for serial modem connections</p>
+
+ <p><a href=
+ "https://alioth.debian.org/projects/minicom/">https://alioth.debian.org/projects/minicom/</a></p>
+ </dd>
+
+ <dt><span class="part-name">mosh</span>
+ </dt>