ncurses 6.0 - patch 20170527
[ncurses.git] / announce.html.in
index da9298a298deb6b14bedb468b8cb23c3d706b3da..89fb3ebeb4622d3121cdf68190348d4c95538c1a 100644 (file)
@@ -1,8 +1,7 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
 <!--
-  $Id: announce.html.in,v 1.83 2011/02/25 11:50:46 tom Exp $
+  $Id: announce.html.in,v 1.91 2015/08/08 19:27:17 tom Exp $
   ****************************************************************************
-  * Copyright (c) 1998-2010,2011 Free Software Foundation, Inc.              *
+  * Copyright (c) 1998-2013,2015 Free Software Foundation, Inc.              *
   *                                                                          *
   * Permission is hereby granted, free of charge, to any person obtaining a  *
   * copy of this software and associated documentation files (the            *
   * authorization.                                                           *
   ****************************************************************************
 -->
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
 
 <html>
 <head>
   <meta name="generator" content=
-  "HTML Tidy for Linux/x86 (vers 6 November 2007), see www.w3.org">
+  "HTML Tidy for Linux (vers 25 March 2009), see www.w3.org">
 
   <title>Announcing ncurses @VERSION@</title>
   <link rev="made" href="mailto:bug-ncurses@gnu.org">
   <meta http-equiv="Content-Type" content=
   "text/html; charset=us-ascii">
+  <style type="text/css">
+p,li { max-width:700px; }
+  dd { max-width:630px; }
+  </style>
 </head>
 
 <body>
-  <h1>Announcing ncurses @VERSION@</h1>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
+  <h1 class="no-header">Announcing ncurses @VERSION@</h1>
+
+  <h2><a name="h2-overview" id="h2-overview">Overview</a></h2>
+
+  <p>The <em class="small-caps">ncurses</em> (new curses) library
+  is a free software emulation of curses in System V Release 4.0
+  (SVr4), and more. It uses terminfo format, supports pads and
   color and multiple highlights and forms characters and
-  function-key mapping, and has all the other SYSV-curses
-  enhancements over BSD curses.
+  function-key mapping, and has all the other SVr4-curses
+  enhancements over BSD curses. SVr4 curses is better known today
+  as X/Open Curses.</p>
 
   <p>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.</p>
+  keepers of <em class="small-caps">unix</em> releases such as
+  BSD/OS, FreeBSD and NetBSD to switch over to <em class=
+  "small-caps">ncurses</em>.</p>
+
+  <p>Since 1995, <em class="small-caps">ncurses</em> has been
+  ported to many systems:</p>
+
+  <ul>
+    <li>It is used in almost every system based on the Linux kernel
+    (aside from some embedded applications).</li>
+
+    <li>It is used as the system curses library on OpenBSD, FreeBSD
+    and OSX.</li>
+
+    <li>It is used in environments such as Cygwin and MinGW. The
+    first of these was EMX on OS/2 Warp.</li>
+
+    <li>It is used (though usually not as the <em>system</em>
+    curses) on all of the vendor <em class="small-caps">unix</em>
+    systems, e.g., AIX, HP-UX, IRIX64, SCO, Solaris, Tru64.</li>
 
-  <p>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>
+    <li>It should work readily on any ANSI/POSIX-conforming
+    <em class="small-caps">unix</em>.</li>
+  </ul>
 
   <p>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 the library and
-  tools.</p>
+  including</p>
+
+  <ul>
+    <li><a href=
+    "http://invisible-island.net/ncurses/man/captoinfo.1m.html">captoinfo</a>,
+    a termcap conversion tool</li>
+
+    <li><a href=
+    "http://invisible-island.net/ncurses/man/clear.1.html">clear</a>,
+    utility for clearing the screen</li>
+
+    <li><a href=
+    "http://invisible-island.net/ncurses/man/infocmp.1m.html">infocmp</a>,
+    the terminfo decompiler</li>
+
+    <li><a href=
+    "http://invisible-island.net/ncurses/man/tabs.1.html">tabs</a>,
+    set tabs on a terminal</li>
+
+    <li><a href=
+    "http://invisible-island.net/ncurses/man/tic.1m.html">tic</a>,
+    the terminfo compiler</li>
+
+    <li><a href=
+    "http://invisible-island.net/ncurses/man/toe.1m.html">toe</a>,
+    list (table of) terminfo entries</li>
+
+    <li><a href=
+    "http://invisible-island.net/ncurses/man/tput.1.html">tput</a>,
+    utility for retrieving terminal capabilities in shell
+    scripts</li>
+
+    <li><a href=
+    "http://invisible-island.net/ncurses/man/tset.1.html">tset</a>,
+    to initialize the terminal</li>
+  </ul>
 
-  <p>The ncurses distribution is available via anonymous FTP at the
-  GNU distribution site <a href=
-  "ftp://ftp.gnu.org/gnu/ncurses/">ftp://ftp.gnu.org/gnu/ncurses/</a>&nbsp;.<br>
+  <p>Full manual pages are provided for the library and tools.</p>
 
-  It is also available at <a href=
-  "ftp://invisible-island.net/ncurses/">ftp://invisible-island.net/ncurses/</a>&nbsp;.</p>
+  <p>The <em class="small-caps">ncurses</em> distribution is
+  available via anonymous FTP at the GNU distribution site</p>
 
-  <h1>Release Notes</h1>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.
+  <blockquote>
+    <p><a href=
+    "ftp://ftp.gnu.org/gnu/ncurses/">ftp://ftp.gnu.org/gnu/ncurses/</a>&nbsp;.</p>
+  </blockquote>It is also available at
 
-  <h2>Interface changes</h2>
+  <blockquote>
+    <p><a href=
+    "ftp://invisible-island.net/ncurses/">ftp://invisible-island.net/ncurses/</a>&nbsp;.</p>
+  </blockquote>
+
+  <h2><a name="h2-release-notes" id="h2-release-notes">Release
+  Notes</a></h2>
+
+  <p>These notes are for <em class="small-caps">ncurses</em>
+  @VERSION@, released <strong>August 8, 2015</strong>.</p>
+
+  <p>This release is designed to be source-compatible with
+  <em class="small-caps">ncurses</em> 5.0 through 5.9; providing a
+  new application binary interface (ABI). Although the source can
+  still be configured to support the <em class=
+  "small-caps">ncurses</em> 5 ABI, the intent of the release is to
+  provide extensions which are generally useful, but
+  binary-incompatible with <em class="small-caps">ncurses</em>
+  5:</p>
 
   <ul>
-    <li>turn on <code>_XOPEN_CURSES</code> definition in
-    <code>curses.h</code>.</li>
+    <li>
+      <p>Extend the <code>cchar_t</code> structure to allow more
+      than 16 colors to be encoded.</p>
+    </li>
 
-    <li>change <code>_nc_has_mouse</code> to
-    <code>has_mouse</code>, reflect its use in C++ and Ada95.</li>
+    <li>
+      <p>Modify the encoding of mouse state to make room for a 5th
+      mouse button. That allows one to use <em class=
+      "small-caps">ncurses</em> with a wheel mouse with xterm or
+      similar X terminal emulators.</p>
+    </li>
+  </ul>
 
-    <li>add <code>is_pad</code> and <code>is_subwin</code>
-    functions for opaque access to the WINDOW structure.</li>
+  <p>There are, of course, numerous other improvements,
+  including</p>
+
+  <ul>
+    <li>
+      <p>fixes made based on the Clang and Coverity static
+      analyzers.</p>
+    </li>
 
-    <li>add <code>tiparm</code>, based on review of X/Open Curses
-    Issue 7.</li>
+    <li>
+      <p>memory leak fixes using Valgrind</p>
+    </li>
   </ul>
 
-  <h2>New features and improvements</h2>
+  <p>The release notes mention some bug-fixes, but are focused on
+  new features and improvements to existing features log since
+  <em class="small-caps">ncurses</em> 5.9 release.</p>
 
-  <h3>Library Improvements</h3>
+  <p>While the intent of the release is to provide a new stable
+  ABI, there are other development activities which are summarized
+  below.</p>
 
   <ul>
-    <li>add a terminal driver for Windows console, which supports a
-    MinGW port to Windows.</li>
+    <li>
+      <p>The original release plan, e.g., for "5.10" was to improve
+      the MinGW port. Ultimately that was completed (wide-character
+      support, mouse, etc), but was deferred to focus on termcap
+      support and performance issues. Also, pinpointing the
+      problems with <code>Console2</code> took a while.</p>
+    </li>
+
+    <li>
+      <p>A review of termcap compatibility in 2011 led to several
+      minor fixes in the library and improvements to utilities. To
+      do this properly, a review of the various extent termcap
+      implementations was needed.</p>
+
+      <p>The <a href=
+      "http://invisible-island.net/ncurses/tctest.html">termcap
+      library checker (tctest)</a> (not part of <em class=
+      "small-caps">ncurses</em>) was one result. A followup review
+      of performance using <a href=
+      "http://invisible-island.net/ncurses/ncurses-examples.html">ncurses-examples</a>
+      in 2014 led to additional improvements.</p>
+    </li>
+
+    <li>
+      <p>Output buffering provided a further, but worthwhile
+      distraction. A bug report in 2012 regarding the use of signal
+      handlers in <em class="small-caps">ncurses</em>) pointed out
+      <a href=
+      "http://lists.gnu.org/archive/html/bug-ncurses/2012-07/msg00029.html">
+      a problem</a> with the use of unsafe functions for handling
+      <code>SIGTSTP</code>. Other signals could be addressed with
+      workarounds; repairing <code>SIGTSTP</code> required a
+      different approach. The solution required changing internal
+      behavior of the library: how it handles output buffering.</p>
+
+      <p>Now <em class="small-caps">ncurses</em> buffers its own
+      output, independently of the standard output. A few
+      applications relied upon the library's direct reuse of the
+      standard output buffering; however that is
+      <em>unspecified</em> behavior and has never been a
+      recommended practice. Identifying these applications as well
+      as refining the change to permit low-level applications to
+      work consistently took time.</p>
+    </li>
+
+    <li>
+      <p>Since the introduction of the experimental support for 256
+      colors early in <a href=
+      "http://invisible-island.net/ncurses/NEWS.html#t20050101">2005</a>
+      (released in <a href=
+      "http://invisible-island.net/ncurses/announce-5.5.html">ncurses
+      5.5</a>), there has been increased user interest. Almost all
+      packagers continue providing the ncurses ABI 5 which cannot
+      support 256 colors.</p>
+    </li>
 
-    <li>add extended functions which specify the
-    <code>SCREEN</code> pointer for several curses functions which
-    use the global <code>SP</code>.</li>
+    <li>
+      <p>Symbol versioning, or the lack of it in ncurses, is the
+      main reason why packagers would be reluctant to add a new
+      ncurses ABI.</p>
+
+      <p>This release provides the new ABI along with
+      script-generated lists of versioned symbols which can be used
+      for both ABI 5 and 6 (with distinct names to keep the two
+      separate). This took time to development, as reported in
+      <a href=
+      "http://invisible-island.net/ncurses/ncurses-mapsyms.html">Symbol
+      versioning in <em class="small-caps">ncurses</em></a>.</p>
+    </li>
+  </ul>
 
-    <li>improve the <code>NCURSES_NO_UTF8_ACS</code> feature by
-    adding a check for an extended terminfo capability
-    <code>U8</code>.</li>
+  <h3><a name="h3-library" id="h3-library">Library
+  improvements</a></h3>
 
-    <li>improve performance of <code>tigetstr</code>, etc., by
-    using hashing code from tic.</li>
+  <h3><a name="h3-lib-setbuf" id="h3-lib-setbuf">Output
+  buffering</a></h3>
 
-    <li>add WACS_<em>xxx</em> definitions to wide-character
-    configuration for thick- and double-lines.</li>
+  <p>X/Open curses provides more than one initialization
+  function:</p>
 
-    <li>modify init_pair to allow caller to create extra color
-    pairs beyond the color_pairs limit, which use default
-    colors.</li>
+  <ul>
+    <li><a href=
+    "http://invisible-island.net/ncurses/man/curs_initscr.3x.html#h3-initscr">
+    initscr</a> (the simplest) accepts no parameters.</li>
+
+    <li><a href=
+    "http://invisible-island.net/ncurses/man/curs_initscr.3x.html#h3-newterm">
+    newterm</a> accepts parameters for the stream input and
+    output</li>
+
+    <li><a href=
+    "http://invisible-island.net/ncurses/man/curs_terminfo.3x.html#h3-Initialization">
+    setupterm</a> (the low-level function) accepts a parameter for
+    the <em>file descriptor</em> of the output.</li>
   </ul>
 
-  <h3>Improvements to Programs</h3>
+  <p>They are documented in X/Open <em>as if</em>
+  <code>initscr</code> calls <code>newterm</code> using
+  <code>stdout</code> for output stream, and in turn
+  <code>newterm</code> calls <code>setupterm</code> using
+  <code>fileno(stdout)</code> for the file descriptor. As long as
+  an implementation acts <em>as if</em> it does this, it conforms.
+  In practice, implementations do what is implied. This creates a
+  problem: the low-level <code>setupterm</code> function's file
+  descriptor is unbuffered, while <code>newterm</code> implies
+  buffered output. X/Open Curses says that all output is done
+  through the file descriptor, and does not say how the output
+  stream is actually used.</p>
+
+  <p>Initially, <em class="small-caps">ncurses</em> used the file
+  descriptor (obtained from the output stream passed to
+  <code>newterm</code>) for changing the terminal modes, and relied
+  upon the output parameter of <code>newterm</code> for buffered
+  output. Later (to avoid using unsafe buffered I/O in signal
+  handlers), <em class="small-caps">ncurses</em> was modified to
+  use the file descriptor (unbuffered output) when cleaning up on
+  receipt of a signal. Otherwise (when not handling a signal), it
+  continued to use the buffered output.</p>
+
+  <p>That approach worked reasonably well and as a side effect,
+  using the same buffered output as an application might use for
+  <code>printf</code> meant that no flushing was needed when
+  switching between normal- and screen-modes.</p>
+
+  <p>There were a couple of problems:</p>
+
+  <ul>
+    <li>
+      <p>to get good performance, curses (not only <em class=
+      "small-caps">ncurses</em>, but SVr4 curses in general) set an
+      output buffer using <code>setbuf</code> or similar function.
+      There is no standard (or portable) way to turn that output
+      buffer off, and revert to line-buffering. The <code><a href=
+      "http://invisible-island.net/ncurses/man/ncurses.3x.html#h3-NCURSES_NO_SETBUF">
+      NCURSES_NO_SETBUF</a></code> environment variable did make it
+      optional.</p>
+    </li>
+
+    <li>
+      <p>to handle <code>SIGTSTP</code> (the &ldquo;stop&rdquo;
+      signal), <em class="small-caps">ncurses</em> relied upon
+      unsafe functions. That is, due to the complexity of the
+      feature, it relied upon reusing existing functions which
+      should not have been called via the signal handler.</p>
+    </li>
+  </ul>
+
+  <p>Conveniently, solving the second problem (by making <em class=
+  "small-caps">ncurses</em> do its <em>own</em> output buffering)
+  also fixed the first one. But there were special cases to
+  resolve: <a href=
+  "http://invisible-island.net/ncurses/man/curs_terminfo.3x.html"><em>
+  low-level</em></a> functions such as mvcur, putp, vidattr
+  explicitly use the standard output. Those functions were reused
+  internally, and required modification to distinguish whether they
+  were used by the high-level or low-level interfaces.</p>
+
+  <p>Finally, there may still be a few programs which should be
+  modified to improve their portability, e.g., adding an</p>
+
+  <blockquote>
+    <pre class="code-block">
+fflush(stdout);
+</pre>
+  </blockquote>
+
+  <p>when switching from &ldquo;<a href=
+  "http://invisible-island.net/ncurses/man/curs_kernel.3x.html#h3-reset_prog_mode_-reset_shell_mode">shell</a>&rdquo;
+  mode to &ldquo;<a href=
+  "http://invisible-island.net/ncurses/man/curs_kernel.3x.html#h3-reset_prog_mode_-reset_shell_mode">program</a>&rdquo;
+  (curses) mode. Those are fairly rare because most programmers
+  have learned not to mix <code>printf</code> and <code><a href=
+  "http://invisible-island.net/ncurses/man/curs_printw.3x.html">printw</a></code>.</p>
+
+  <h3><a name="h3-lib-versioning" id="h3-lib-versioning">Symbol
+  versioning</a></h3>
+
+  <p>This release introduces symbol-versioning to <em class=
+  "small-caps">ncurses</em> because without it, the change of ABI
+  would be less successful. A lengthy discussion will be presented
+  in <a href=
+  "http://invisible-island.net/ncurses/ncurses-mapsyms.html">Symbol
+  versioning in <em class="small-caps">ncurses</em></a>. These
+  notes summarize what has changed, and what can be done with the
+  new release.</p>
+
+  <p>Symbol-versioning allows the developers of a library to mark
+  each public symbol (both data and functions) with an identifier
+  denoting the library name and the version for which it was built.
+  By doing this, users of the library have a way to help ensure
+  that applications do not accidentally load an incompatible
+  library. In addition, private symbols can be hidden entirely.</p>
+
+  <p>This release provides sample files for the four principal
+  configurations of <em class="small-caps">ncurses</em> libraries:
+  <code>ncurses</code>, <code>ncursesw</code>,
+  <code>ncursest</code> and <code>ncursestw</code>. Each sample is
+  given in two forms:</p>
+
+  <blockquote>
+    <dl>
+      <dt>&ldquo;<code>.map</code>&rdquo;</dt>
+
+      <dd>These list all public symbols, together with version
+      names.</dd>
+
+      <dt>&ldquo;<code>.sym</code>&rdquo;</dt>
+
+      <dd>These list all public symbols, without version
+      names.</dd>
+    </dl>
+  </blockquote>
+
+  <p>The sample files are <em>generated</em> by scripts which take
+  into account a few special cases such as <a href=
+  "http://invisible-island.net/ncurses/tack.html">tack</a> to omit
+  many of the <em class="small-caps">ncurses</em> private symbols
+  (beginning with &ldquo;<code>_nc_</code>&rdquo;). Here are
+  counts of globals versus locals:</p>
+
+  <blockquote>
+    <table border="1" summary="Total global and local symbols">
+      <tr>
+        <th>Config</th>
+
+        <th>Symbols</th>
+
+        <th>Globals</th>
+
+        <th>Locals</th>
+
+        <th>"_nc_"</th>
+      </tr>
+
+      <tr>
+        <td>ncurses</td>
+
+        <td align="right">976</td>
+
+        <td align="right">796</td>
+
+        <td align="right">180</td>
+
+        <td align="right">332</td>
+      </tr>
+
+      <tr>
+        <td>ncursesw</td>
+
+        <td align="right">1089</td>
+
+        <td align="right">905</td>
+
+        <td align="right">184</td>
+
+        <td align="right">343</td>
+      </tr>
+
+      <tr>
+        <td>ncursest</td>
+
+        <td align="right">979</td>
+
+        <td align="right">804</td>
+
+        <td align="right">175</td>
+
+        <td align="right">358</td>
+      </tr>
+
+      <tr>
+        <td>ncursestw</td>
+
+        <td align="right">1098</td>
+
+        <td align="right">914</td>
+
+        <td align="right">184</td>
+
+        <td align="right">372</td>
+      </tr>
+    </table>
+  </blockquote>
+
+  <p>Although only four sample configurations are presented, each
+  is formed by merging symbols from several combinations of
+  configure-script options, taking into account advice from
+  downstream packagers. Because they are formed by merging, the
+  sample files may list a symbol which is not in a given package.
+  That is expected. The samples have been tested and are working
+  with systems (such as Fedora, FreeBSD and Debian) which fully
+  support this feature. There are other systems which do
+  <em>not</em> support the feature, and a few (such as Solaris)
+  which provide incomplete support.</p>
+
+  <p>The version-naming convention used allows these sample files
+  to build distinct libraries for ABI 5 and 6. Version names
+  consist of</p>
 
   <ul>
-    <li>add <code>tabs</code> program.</li>
+    <li>
+      <p>configuration name, e.g.,
+      &ldquo;<code>NCURSESW</code>&rdquo; for the wide-character
+      libraries</p>
+    </li>
+
+    <li>
+      <p>ABI version (if not 5)</p>
+    </li>
 
-    <li>modify tic's -I/-C dump to reformat acsc strings into
-    canonical form (sorted, unique mapping).</li>
+    <li>
+      <p>library name for two special cases which have the same
+      interface across configurations:
+      &ldquo;<code>TINFO</code>&rdquo; and
+      &ldquo;<code>TIC</code>&rdquo;</p>
+    </li>
 
-    <li>add checks in tic for inconsistent cursor-movement
-    controls, and for inconsistent printer-controls.</li>
+    <li>
+      <p>release version</p>
+    </li>
 
-    <li>add special case to <code>_nc_infotocap</code> (used by tic
-    and infocmp) to recognize the
-    <code>setaf</code>/<code>setab</code> strings from
-    <code>xterm+256color</code> and <code>xterm+88color,</code> and
-    provide a reduced version which works with termcap.</li>
+    <li>
+      <p>patch date (for the release version)</p>
+    </li>
   </ul>
 
-  <h3>Terminal Database</h3>
+  <p>For example, running <code>nm -D</code> on the libraries in
+  the ncurses6 test package shows these symbol-versions:</p>
+
+  <blockquote>
+    <pre class="code-block">
+0000000000000000 A NCURSES6_TIC_5.0.19991023
+0000000000000000 A NCURSES6_TIC_5.1.20000708
+0000000000000000 A NCURSES6_TIC_5.5.20051010
+0000000000000000 A NCURSES6_TIC_5.7.20081102
+0000000000000000 A NCURSES6_TIC_5.9.20150530
+0000000000000000 A NCURSES6_TINFO_5.0.19991023
+0000000000000000 A NCURSES6_TINFO_5.1.20000708
+0000000000000000 A NCURSES6_TINFO_5.2.20001021
+0000000000000000 A NCURSES6_TINFO_5.3.20021019
+0000000000000000 A NCURSES6_TINFO_5.4.20040208
+0000000000000000 A NCURSES6_TINFO_5.5.20051010
+0000000000000000 A NCURSES6_TINFO_5.6.20061217
+0000000000000000 A NCURSES6_TINFO_5.7.20081102
+0000000000000000 A NCURSES6_TINFO_5.8.20110226
+0000000000000000 A NCURSES6_TINFO_5.9.20150530
+0000000000000000 A NCURSESW6_5.1.20000708
+0000000000000000 A NCURSESW6_5.3.20021019
+0000000000000000 A NCURSESW6_5.4.20040208
+0000000000000000 A NCURSESW6_5.5.20051010
+0000000000000000 A NCURSESW6_5.6.20061217
+0000000000000000 A NCURSESW6_5.7.20081102
+0000000000000000 A NCURSESW6_5.8.20110226
+0000000000000000 A NCURSESW6_5.9.20150530
+</pre>
+  </blockquote>
+
+  <p>As a special case, this release (which makes the final change
+  for ABI 5) is marked with release version 5.9 and patch date
+  20150530.</p>
+
+  <h3><a name="h3-lib-other" id=
+  "h3-lib-other">Miscellaneous</a></h3>
+
+  <p>The new release has several improvements for performance and
+  building. For instance:</p>
 
   <ul>
-    <li>added entries:
+    <li>
+      <p>several files in ncurses- and progs-directories were
+      modified to allow <code>const</code> data used in internal
+      tables to be put by the linker into the readonly text
+      segment.</p>
+    </li>
 
-      <ul>
-        <li><code>bterm</code> terminfo entry, based on bogl
-        0.1.18</li>
+    <li>
+      <p>various improvements were made to building the Ada95
+      binding, both in simplifying the generated files as well as
+      improving the way it uses <code>gnatmake</code></p>
+    </li>
+  </ul>
 
-        <li><code>cons25-debian</code> entry</li>
+  <p>There are also new features in the libraries:</p>
 
-        <li><code>eterm-color</code> entry</li>
+  <ul>
+    <li>added <a href=
+    "http://invisible-island.net/ncurses/man/curs_util.3x.html#h3-use_tioctl">
+    use_tioctl</a> function</li>
+
+    <li>
+      <p>added <a href=
+      "http://invisible-island.net/ncurses/man/curs_opaque.3x.html">
+      wgetdelay</a> to retrieve _delay member of WINDOW if it
+      happens to be opaque, e.g., in the pthread configuration.</p>
+    </li>
 
-        <li><code>linux-16color</code></li>
+    <li>
+      <p>added <a href=
+      "http://invisible-island.net/ncurses/man/curs_attr.3x.html#h2-PORTABILITY">
+      A_ITALIC</a> extension.</p>
+    </li>
 
-        <li><code>mlterm+256color</code> entry, for mlterm
-        3.0.0</li>
+    <li>
+      <p>added form library extension <a href=
+      "http://invisible-island.net/ncurses/man/form_field_opts.3x.html">
+      O_DYNAMIC_JUSTIFY</a> option which can be used to override
+      the different treatment of justification for static versus
+      dynamic fields .</p>
+    </li>
 
-        <li>several screen-bce.<em>xxx</em> entries</li>
+    <li>
+      <p>rewrote <a href=
+      "http://invisible-island.net/ncurses/man/curs_util.3x.html#h3-putwin_getwin">
+      putwin</a> and <a href=
+      "http://invisible-island.net/ncurses/man/curs_util.3x.html#h3-putwin_getwin">
+      getwin</a>, making an extended version which is capable of
+      reading screen-dumps between the wide/normal <em class=
+      "small-caps">ncurses</em> configurations. These are text
+      files, except for a <em>magic</em> code at the beginning:</p>
+
+      <blockquote>
+        <pre class="code-block">
+0       string          \210\210        Screen-dump (ncurses)
+</pre>
+      </blockquote>
+    </li>
 
-        <li><code>screen.Eterm</code> terminfo entry</li>
+    <li>
+      <p>several changes to mouse support include:</p>
+
+      <ul>
+        <li>added decoder for xterm SGR 1006 mouse mode.</li>
 
-        <li><code>vwmterm</code> entry</li>
+        <li>added experimental support for
+        &ldquo;<code>%u</code>&rdquo; format to terminfo.</li>
 
-        <li><code>xterm-utf8</code> entry as a demo of the
-        <code>U8</code> feature</li>
+        <li>improved behavior of wheel-mice for xterm protocol:
+        noting that there are only button-presses for buttons
+        &ldquo;4&rdquo; and &ldquo;5&rdquo;, so there is no need to
+        wait to combine events into double-clicks .</li>
       </ul>
     </li>
+  </ul>
 
-    <li>updated/improved entries:
+  <p>There are a few new configure options dealing with library
+  customization:</p>
 
-      <ul>
-        <li>use extended capabilities:
-
-          <ul>
-            <li>add <code>U8</code> feature to denote entries for
-            terminal emulators which do not support VT100 SI/SO
-            when processing UTF-8 encoding</li>
-
-            <li>add <code>XT</code> capability to entries for
-            terminals that support both xterm-style mouse- and
-            title-controls, for <code>screen</code> which
-            special-cases TERM beginning with <code>xterm</code> or
-            <code>rxvt</code></li>
-          </ul>
-        </li>
+  <ul>
+    <li>
+      <p>add &ldquo;<code>--enable-ext-putwin</code>&rdquo;
+      configure option to turn on the extended putwin/getwin. By
+      default, this is enabled for ABI 6 and disabled with ABI
+      5.</p>
+    </li>
 
-        <li>improvements based on new checks in tic:</li>
+    <li>
+      <p>add &ldquo;<code>--enable-string-hacks</code>&rdquo;
+      option to control whether strlcat and strlcpy may be used.
+      Because <em class="small-caps">ncurses</em> already does the
+      requisite buffer-limit checks, this feature is mainly of
+      interest to quiet compiler-warnings on a few systems.</p>
+    </li>
 
-        <li style="list-style: none; display: inline">
-          <ul>
-            <li>fill in no-parameter forms of cursor-movement where
-            a parameterized form is available</li>
+    <li>
+      <p>add configure option
+      &ldquo;<code>--with-tparm-arg</code>&rdquo; to allow <a href=
+      "http://invisible-island.net/ncurses/man/curs_terminfo.3x.html#h3-Formatting-Output">
+      tparm</a>'s parameters to be something more likely to be the
+      same size as a pointer, e.g., <code>intptr_t</code> (again,
+      the default is set for ABI 6).</p>
+    </li>
+  </ul>
 
-            <li>fill in missing cursor controls where the form of
-            the controls is ANSI</li>
+  <h3><a name="h3-programs" id="h3-programs">Program
+  improvements</a></h3>
+
+  <h4><a name="h4-utilities" id="h4-utilities">Utilities</a></h4>
+
+  <p>Most of the termcap-related changes based on development of
+  <a href="http://invisible-island.net/ncurses/tctest.html">tctest
+  (termcap library checker)</a> are implemented in the tic and
+  infocmp programs rather than affecting the library. As noted in
+  the <a href=
+  "http://invisible-island.net/ncurses/tctest.html#my-better-translation">
+  discussion</a> of <code>tctest</code>, <em class=
+  "small-caps">ncurses</em>'s ability to translate between terminfo
+  and termcap formats has been improved at different times, but
+  subject to feedback from "real" termcap users. There are very few
+  of those. Nowadays, virtually all <em>termcap</em> users are
+  using <em class="small-caps">ncurses</em> (or NetBSD, with its
+  own terminfo library) and their programs are actually using
+  terminfo rather than termcap data.</p>
+
+  <p>Still, there are a few. A comment about the translation of the
+  ASCII <code>NUL</code> character prompted a review:</p>
 
-            <li>add parameterized cursor-controls to
-            linux-basic</li>
+  <ul>
+    <li>
+      <p>Both terminfo and termcap store string capabilities as
+      <code>NUL</code>-terminated strings.</p>
+    </li>
 
-            <li>modify <code>nsterm,</code> <code>xnuppc</code> and
-            <code>tek4115</code> to make
-            <code>sgr</code>/<code>sgr0</code> consistent</li>
+    <li>
+      <p>In terminfo, a <code>\0</code> in a terminal description
+      is stored as <code>\200</code>.</p>
+    </li>
 
-            <li>change several terminfo entries to make consistent
-            use of ANSI clear-all-tabs</li>
-          </ul>
-        </li>
+    <li>
+      <p>There are no (known) terminals which would behave
+      differently when sent <code>\0</code> or
+      <code>\200</code>.</p>
+    </li>
 
-        <li>extend <code>ansi.sys</code> <code>pfkey</code>
-        capability from kf1-kf10 to kf1-kf48, moving function key
-        definitions from <code>emx-base</code> for
-        consistency.</li>
+    <li>
+      <p>When translating to terminfo format (or displaying a
+      printable version of an entry using infocmp), <em class=
+      "small-caps">ncurses</em> shows <code>\200</code> as
+      <code>\0</code>.</p>
+    </li>
 
-        <li>correct missing final 'p' in <code>pfkey</code>
-        capability of <code>ansi.sys-old</code>.</li>
+    <li>
+      <p>It has done this since 1998 (quoting from the NEWS
+      file):</p>
+
+      <blockquote>
+        <pre class="code-block">
+<a href=
+"http://invisible-island.net/ncurses/NEWS.html#t980103">980103</a>
+...
+        + modify _nc_tic_expand() to generate \0 rather than \200.
+...
+        + correct translation of terminfo "^@", to \200, like \0.
+</pre>
+      </blockquote>
+    </li>
 
-        <li>rename <code>atari</code> and <code>st52</code>
-        terminfo entries to atari-old, st52-old, use newer entries
-        from FreeMiNT.</li>
+    <li>
+      <p>However, the <code>_nc_tic_expand</code> function (which
+      optionally produces terminfo or termcap format) did not
+      address this special case for termcap. Even the later 4.4BSD
+      <a href=
+      "https://svnweb.freebsd.org/base/head/lib/libc/gen/getcap.c?revision=244092&amp;view=markup#l784">
+      cgetstr</a> interprets a <code>\0</code> literally, ending
+      <em>that</em> string (rather than using the terminfo
+      improvement).</p>
+    </li>
+  </ul>
 
-        <li>repurpose <code>gnome</code> terminfo entries as
-        <code>vte</code>, retaining <code>gnome</code> variants for
-        compatibility, but generally deprecating those since the
-        VTE library is what actually defines the behavior of
-        "gnome", etc., since 2003.</li>
+  <p>As a result of the review, several improvements were made to
+  <em class="small-caps">ncurses</em> translation to/from termcap
+  format &mdash; and improving the checks made in tic for
+  consistency of entries. Most of these are not of general
+  interest, except for two new command-line options for tic and
+  infocmp:</p>
 
-        <li>improve <code>interix</code> <code>smso</code> terminfo
-        capability by using reverse rather than bold.</li>
+  <ul>
+    <li>
+      <p>the &ldquo;<code>-0</code>&rdquo; option generates
+      termcap/terminfo source on a single line.</p>
+    </li>
 
-        <li>correct <code>initc</code> capability of
-        <code>linux-c-nc</code> end-of-range, make similar change
-        for <code>dg+ccc</code> and <code>dgunix+ccc</code>.</li>
+    <li>
+      <p>the &ldquo;<code>-K</code>&rdquo; option provides stricter
+      BSD-compatibility for termcap output.</p>
+    </li>
+  </ul>
 
-        <li>update <code>minix</code> terminfo entry.</li>
+  <p>Other user-visible improvements and new features include:</p>
 
-        <li>updated <code>nsterm*</code> entries.</li>
+  <ul>
+    <li>
+      <p>added &ldquo;<code>-D</code>&rdquo; option to tic and
+      infocmp, to show the database locations that it could
+      use.</p>
+    </li>
 
-        <li>remove unnecessary <code>kcan</code> assignment to
-        <code>^C</code> from <code>putty</code>.</li>
+    <li>
+      <p>added &ldquo;<code>-s</code>&rdquo; option to toe, to sort
+      its output.</p>
+    </li>
 
-        <li>suppress <code>ncv</code> in <code>screen</code> and
-        <code>konsole-base</code> entries, allowing underline.</li>
+    <li>
+      <p>extended &ldquo;<code>-c</code>&rdquo; and
+      &ldquo;<code>-n</code>&rdquo; options of infocmp to allow
+      comparing more than two entries.</p>
+    </li>
 
-        <li>change ncv and op capabilities in
-        <code>sun-color</code> terminfo entry to match Sun's entry
-        for this.</li>
+    <li>
+      <p>modified toe's report when &ldquo;<code>-a</code>&rdquo;
+      and &ldquo;<code>-s</code>&rdquo; options are combined, to
+      add a column showing which entries belong to a given
+      database.</p>
+    </li>
 
-        <li>fix typo in <code>rmso</code> for <code>tek4106</code>
-        entry.</li>
+    <li>
+      <p>modified the clear program to take into account the
+      &ldquo;<code>E3</code>&rdquo; extended capability to clear
+      the terminal's scrollback buffer.</p>
+    </li>
+  </ul>
 
-        <li>improve <code>acsc</code> string for <code>vt52</code>,
-        show arrow keys.</li>
+  <h4><a name="h4-examples" id="h4-examples">Examples</a></h4>
 
-        <li>add hard-reset for <code>rs2</code> to
-        <code>wsvt25</code> to help ensure that reset ends the
-        alternate character set.</li>
+  <p>Along with the library and utilities, many improvements were
+  made to the <a href=
+  "http://invisible-island.net/ncurses/ncurses-examples.html">ncurses-examples</a>.
+  Some were made to allow building (and comparison-testing) against
+  NetBSD curses and PDCurses. Both lack some of the X/Open Curses
+  features, necessitating customization. But this activity was
+  useful because it showed some remaining performance issues (which
+  have been resolved in this release).</p>
 
-        <li>add <code>ccc</code> and <code>initc</code>
-        capabilities to <code>xterm-16color</code>.</li>
-      </ul>
+  <p>These changes were made to verify compatibility or compare
+  performance of <em class="small-caps">ncurses</em>:</p>
+
+  <ul>
+    <li>
+      <p>made workarounds for compiling test-programs with NetBSD
+      curses, though it lacks some common functions such as
+      <a href="http://invisible-island.net/ncurses/man/curs_util.3x.html#h3-use_env">
+      use_env</a>.</p>
+    </li>
+
+    <li>
+      <p>added dots_termcap test-program</p>
+    </li>
+
+    <li>
+      <p>added dots_curses test-program, for comparison with the
+      low-level examples.</p>
+    </li>
+
+    <li>
+      <p>added test_setupterm test-proram to demonstrate
+      normal/error returns from the setupterm and restartterm
+      functions.</p>
+    </li>
+
+    <li>
+      <p>added &ldquo;<code>-d</code>&rdquo;,
+      &ldquo;<code>-e</code>&rdquo; and
+      &ldquo;<code>-q</code>&rdquo; options to the demo_terminfo
+      and demo_termcap test-programs.</p>
+    </li>
+
+    <li>
+      <p>added &ldquo;<code>-y</code>&rdquo; option to demo_termcap
+      and test/demo_terminfo test-programs to demonstrate behavior
+      with/without extended capabilities.</p>
+    </li>
+
+    <li>
+      <p>modified demo_termcap and demo_terminfo test-programs to
+      make their options more directly comparable, and add
+      &ldquo;<code>-i</code>&rdquo; option to specify a terminal
+      description filename to parse for names to lookup.</p>
+    </li>
+
+    <li>
+      <p>rewrote the tests for <a href=
+      "http://invisible-island.net/ncurses/man/curs_window.3x.html#h3-derwin">
+      mvderwin</a> and test for recursive <a href=
+      "http://invisible-island.net/ncurses/man/curs_window.3x.html#h3-mvwin">
+      mvwin</a> in the movewindow test-program.</p>
     </li>
   </ul>
 
-  <h2>Major bug fixes</h2>
+  <p>These changes were made to help with the MinGW port:</p>
 
   <ul>
-    <li>ncurses library
+    <li>
+      <p>added test-screens to the ncurses test-program to show
+      256-characters at a time, to help with MinGW port.</p>
+    </li>
 
-      <ul>
-        <li>wide character support
-
-          <ul>
-            <li>modify length returned by <code>getcchar</code> to
-            count the trailing null which is documented in
-            X/Open.</li>
-
-            <li>fix an infinite recursion when adding a
-            legacy-coding 8-bit value using
-            <code>insch</code>.</li>
-
-            <li>improve a workaround in adding wide-characters,
-            when a control character is found. The library uses
-            <code>unctrl</code> to obtain a printable version of
-            the control character, but was not passing color or
-            video attributes.</li>
-
-            <li>modify <code>waddch_literal</code>, 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.</li>
-
-            <li>fixes in <code>wins_nwstr</code> and related
-            functions to ensure that special characters, i.e.,
-            control characters are handled properly with the
-            wide-character configuration.</li>
-
-            <li>correct internal <code>_nc_insert_ch</code> to use
-            <code>_nc_insert_wch</code> when inserting wide
-            characters, since the <code>wins_wch</code> function
-            that it used did not update the cursor position.</li>
-          </ul>
-        </li>
+    <li>
+      <p>modified the view test-program to load UTF-8 when built
+      with MinGW by using regular win32 API because the MinGW
+      functions mblen and mbtowc do not work.</p>
+    </li>
+
+    <li>
+      <p>added &ldquo;<code>-s</code>&rdquo; option to the view
+      test-program to allow it to start in single-step mode,
+      reducing size of trace files when it is used for debugging
+      MinGW changes.</p>
+    </li>
+  </ul>
+
+  <p>These changes were made to verify new extensions in <em class=
+  "small-caps">ncurses</em>:</p>
+
+  <ul>
+    <li>
+      <p>added <a href=
+      "http://invisible-island.net/ncurses/man/form_driver.3x.html#h3-form_driver_w">
+      form_driver_w</a> entrypoint to wide-character forms library,
+      as well as form_driver_w test-program.</p>
+    </li>
+
+    <li>
+      <p>modified ncurses test-program's b/B tests to display lines
+      only for the attributes which a given terminal supports, to
+      make room for an italics test.</p>
+    </li>
+
+    <li>
+      <p>modified ncurses test-program, adding
+      &ldquo;<code>-E</code>&rdquo; and
+      &ldquo;<code>-T</code>&rdquo; options to demonstrate use_env
+      versus use_tioctl.</p>
+    </li>
+
+    <li>
+      <p>modified ncurses test-program's c/C tests to cycle through
+      subsets of the total number of colors, to better illustrate
+      8/16/88/256-colors by providing directly comparable
+      screens.</p>
+    </li>
+
+    <li>
+      <p>modified the ncurses test-program to also show position
+      reports in 'a' test.</p>
+    </li>
+  </ul>
+
+  <p>These changes were made to make the examples more useful:</p>
+
+  <ul>
+    <li>
+      <p>added scripts for building dpkg and rpm test-packages</p>
+    </li>
+
+    <li>
+      <p>modified the hanoi test-program to show the minimum number
+      of moves possible for the given number of tiles.</p>
+    </li>
+
+    <li>
+      <p>modified the knight test-program to show the number of
+      choices possible for each position in automove option, e.g.,
+      to allow user to follow Warnsdorff's rule to solve the
+      puzzle.</p>
+    </li>
+  </ul>
+
+  <h3><a name="h3-database" id="h3-database">Terminal
+  database</a></h3>
+
+  <p>This release provides improvements to tic's
+  &ldquo;<code>-c</code>&rdquo; checking option, which was used for
+  example to</p>
+
+  <ul>
+    <li>
+      <p>make <code>sgr</code> in several entries agree with other
+      caps.</p>
+    </li>
+
+    <li>
+      <p>correct padding in some entries where earlier versions had
+      miscounted the number of octal digits.</p>
+    </li>
+  </ul>
+
+  <p>There are several new terminal descriptions:</p>
+
+  <ul>
+    <li><a href=
+    "http://invisible-island.net/ncurses/terminfo.src.html#toc-_M_L_T_E_R_M">
+    mlterm</a> is now aliased to mlterm3</li>
+
+    <li><a href=
+    "http://invisible-island.net/ncurses/terminfo.src.html#tic-nsterm">
+    nsterm</a> is now derived from nsterm-256color</li>
+
+    <li><a href=
+    "http://invisible-island.net/ncurses/terminfo.src.html#tic-putty-sco">
+    putty-sco</a></li>
+
+    <li><a href=
+    "http://invisible-island.net/ncurses/terminfo.src.html#tic-teken">
+    teken</a> is FreeBSD's "xterm" console.</li>
+
+    <li><a href=
+    "http://invisible-island.net/ncurses/terminfo.src.html#toc-_T_E_R_M_I_N_A_T_O_R">
+    terminator</a></li>
 
-        <li>mouse
+    <li><a href=
+    "http://invisible-island.net/ncurses/terminfo.src.html#toc-_T_E_R_M_I_N_O_L_O_G_Y">
+    terminology</a></li>
 
-          <ul>
-            <li>add check if <code>Gpm_Open</code> returns a -2,
-            e.g., for "xterm". This is normally suppressed but can
-            be overridden using <code>$NCURSES_GPM_TERMS</code>.
-            Ensure that <code>Gpm_Close</code> is called in this
-            case.</li>
+    <li><a href=
+    "http://invisible-island.net/ncurses/terminfo.src.html#tic-tmux">
+    tmux</a> is derived from screen.</li>
 
-            <li>add check in mouse-driver to disable connection if
-            GPM returns a zero, indicating that the connection is
-            closed.</li>
+    <li>several screen.XXX entries support the respective
+    variations for 256 colors.</li>
 
-            <li>modify <code>getmouse</code> 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 <code>ERR</code>.</li>
-          </ul>
+    <li><a href=
+    "http://invisible-island.net/ncurses/terminfo.src.html#toc-_S_I_M_P_L_E_T_E_R_M">
+    simpleterm</a> is now 0.5</li>
+
+    <li><a href=
+    "http://invisible-island.net/ncurses/terminfo.src.html#tic-vte">
+    vte</a> is aliased to vte-2012</li>
+
+    <li><a href=
+    "http://invisible-island.net/ncurses/terminfo.src.html#tic-vt520ansi">
+    vt520ansi</a></li>
+  </ul>
+
+  <p>A few entries use extensions (user-defined terminal
+  capabilities):</p>
+
+  <ul>
+    <li>
+      <p><code>E3</code>, used in linux, putty and xterm-basic is
+      tested in the <a href=
+      "http://aerie.jexium-island.net/ncurses/man/clear.1.html">clear</a>
+      program to erase a terminal's scrollback.</p>
+    </li>
+
+    <li>
+      <p><code>TS</code> is used in the <a href=
+      "http://invisible-island.net/ncurses/terminfo.src.html#tic-xterm_sl">
+      xterm+sl</a> building block to help deprecate the misuse of
+      <code>tsl</code> for xterm's title-string.</p>
+    </li>
+
+    <li>
+      <p><code>XT</code> is used in some terminfo entries to
+      improve usefulness for other applications than screen, which
+      would like to pretend that xterm's title is a
+      status-line.</p>
+    </li>
+
+    <li>
+      <p><code>xm</code> is used in examples <a href=
+      "http://invisible-island.net/ncurses/terminfo.src.html#tic-xterm-1005">
+      xterm-1005</a> and <a href=
+      "http://invisible-island.net/ncurses/terminfo.src.html#tic-xterm-1006">
+      xterm-1006</a> to illustrate a way to make mouse handling
+      more general</p>
+    </li>
+  </ul>
+
+  <p>A few terminals support italics and/or dim capabilities. In
+  particular, screen does not. Documented that, and accommodated
+  the terminals where this feature works with the
+  <code>A_ITALIC</code> extension.</p>
+
+  <ul>
+    <li>konsole, mlterm3 (italics)</li>
+
+    <li>nsterm (dim)</li>
+
+    <li>screen (dim)</li>
+
+    <li>vte (dim, italics)</li>
+
+    <li>xterm (dim, italics)</li>
+  </ul>
+
+  <h3><a name="h3-documentation" id=
+  "h3-documentation">Documentation</a></h3>
+
+  <p>As usual, this release</p>
+
+  <ul>
+    <li>
+      <p>improves documentation by describing new features,</p>
+    </li>
+
+    <li>
+      <p>attempts to improve the description of features which
+      users have found confusing</p>
+    </li>
+
+    <li>
+      <p>fills in overlooked descriptions of features which were
+      described in the <a href=
+      "http://invisible-island.net/ncurses/NEWS.html">NEWS</a> file
+      but treated sketchily in manual pages.</p>
+    </li>
+  </ul>
+
+  <p>In addition, the mechanism for producing HTML versions of the
+  documentation has been improved:</p>
+
+  <ul>
+    <li>
+      <p>use an improved version of <a href=
+      "http://invisible-island.net/scripts/man2html.html">man2html</a>
+      to generate html manpages.</p>
+    </li>
+
+    <li>
+      <p>regenerated <a href=
+      "http://invisible-island.net/ncurses/NCURSES-Programming-HOWTO.html">
+      NCURSES-Programming-HOWTO.html</a> to fix some of the broken
+      html emitted by docbook.</p>
+    </li>
+  </ul>
+
+  <h3><a name="h3-bug-fixes" id="h3-bug-fixes">Interesting
+  bug-fixes</a></h3>
+
+  <ul>
+    <li>
+      <p>Ada95 binding:</p>
+
+      <ul>
+        <li>
+          <p>modify makefile rules to ensure that the PIC option is
+          not used when building a static library</p>
         </li>
 
-        <li>miscellaneous
+        <li>
+          <p>make Ada95 build-fix for big-endian architectures such
+          as sparc. This undoes one of the fixes from <a href=
+          "http://invisible-island.net/ncurses/NEWS.html#t20110319">
+          20110319</a>, which added an
+          &ldquo;<code>Unused</code>&rdquo; member to
+          representation clauses, replacing that with pragmas to
+          suppress warnings about unused bits.</p>
+        </li>
+      </ul>
+    </li>
 
-          <ul>
-            <li>improve handling of color-pairs embedded in
-            attributes for the extended-colors configuration.</li>
+    <li>
+      <p>Color and attributes:</p>
 
-            <li>add check for failure to open hashed-database
-            needed for db4.6.</li>
+      <ul>
+        <li>
+          <p>parenthesize parameter of <code>COLOR_PAIR</code> and
+          <code>PAIR_NUMBER</code> in curses.h in case it happens
+          to be a comma-expression.</p>
+        </li>
 
-            <li>modify use of <code>$CC</code> environment variable
-            which is defined by X/Open as a curses feature, to
-            ignore it if it is not a single character.</li>
+        <li>
+          <p>improve <a href=
+          "http://invisible-island.net/ncurses/NEWS.html#t20021221">
+          20021221</a> workaround for broken acs, handling a case
+          where that ACS_<em>xxx</em> character is not in the
+          <code>acsc</code> string but there is a known
+          wide-character which can be used.</p>
+        </li>
 
-            <li>modify declaration of <code>cur_term</code> when
-            broken-linker is used, but enable-reentrant is not, to
-            match pre-5.7.</li>
+        <li>
+          <p>modify <a href=
+          "http://invisible-island.net/ncurses/man/curs_color.3x.html#h3-Routine-Descriptions">
+          init_pair</a> to accept -1's for color value after
+          <a href=
+          "http://invisible-island.net/ncurses/man/default_colors.3x.html">
+          assume_default_colors</a> has been called.</p>
+        </li>
 
-            <li>correct limit-checks in <code>derwin</code>.</li>
+        <li>
+          <p>add a check in <a href=
+          "http://invisible-island.net/ncurses/man/curs_color.3x.html#h3-Routine-Descriptions">
+          start_color</a> to limit color-pairs to 256 when extended
+          colors are not supported.</p>
+        </li>
+      </ul>
+    </li>
 
-            <li>remove old check in <code>mvderwin</code> which
-            prevented moving a derived window whose origin happened
-            to coincide with its parent's origin.</li>
+    <li>
+      <p>Resizing the screen:</p>
 
-            <li>correct limit-checks in <code>newwin</code>, to
-            ensure that windows have nonzero size.</li>
+      <ul>
+        <li>
+          <p>propagate error-returns from wresize, i.e., the
+          internal increase_size and decrease_size functions
+          through <a href=
+          "http://invisible-island.net/ncurses/man/resizeterm.3x.html">
+          resize_term</a>.</p>
+        </li>
 
-            <li>modify <code>set_curterm</code> to make
-            broken-linker configuration work with changes from
-            20090228.</li>
+        <li>
+          <p>add check for zero/negative dimensions for
+          <code>resizeterm</code> and <code>resize_term</code>.</p>
+        </li>
 
-            <li>modify <code>wgetch</code> to ensure it checks
-            <code>SIGWINCH</code> when it gets an error in
-            non-blocking mode.</li>
+        <li>
+          <p>modify <code>resizeterm</code> to always push a
+          <code>KEY_RESIZE</code> onto the fifo, even if screensize
+          is unchanged. Modify library to push a
+          <code>KEY_RESIZE</code> if there was a SIGWINCH, even if
+          it does not call <code>resizeterm</code>). These changes
+          eliminate the case where a SIGWINCH is received, but ERR
+          is returned from <code>wgetch</code> or
+          <code>wgetnstr</code> because the screen dimensions did
+          not change.</p>
+        </li>
+      </ul>
+    </li>
 
-            <li>correct limit-check in <code>wredrawln</code>,
-            accounting for <code>begy</code>/<code>begx</code>
-            values.</li>
+    <li>
+      <p>Low-level interfaces</p>
 
-            <li>fix a null-pointer check in
-            <code>_nc_format_slks</code> in lib_slk.c, from
-            20070704 changes.</li>
+      <ul>
+        <li>
+          <p>fix an old bug in the termcap emulation;
+          &ldquo;<code>%i</code>&rdquo; was ignored in
+          <code>tparm</code> because the parameters to be
+          incremented were already on the internal stack.</p>
+        </li>
 
-            <li>correct translation of "^" in
-            <code>_nc_infotocap</code>, used to transform terminfo
-            to termcap strings.</li>
+        <li>
+          <p>change &ldquo;<code>%l</code>&rdquo; behavior in tparm
+          to push the string length onto the stack rather than
+          saving the formatted length into the output buffer.</p>
+        </li>
 
-            <li>modify <code>_nc_wgetch</code> to check for a -1 in
-            the fifo, e.g., after a <code>SIGWINCH</code>, and
-            discard that value, to avoid confusing
-            application.</li>
-          </ul>
+        <li>
+          <p>modify name-comparison for tgetstr, etc., to
+          accommodate legacy applications as well as to improve
+          compatbility with BSD 4.2 termcap implementations (see
+          note for <a href=
+          "http://invisible-island.net/ncurses/NEWS.html#t980725">980725</a>).</p>
         </li>
       </ul>
     </li>
 
-    <li>other libraries
+    <li>High-level interfaces
 
       <ul>
-        <li>correct transfer of multicolumn characters in multirow
-        <code>field_buffer</code>, which stopped at the end of the
-        first row due to filling of unused entries in a cchar_t
-        array with nulls.</li>
-
-        <li>correct buffer-size after internal resizing of
-        wide-character <code>set_field_buffer</code>, broken in
-        20081018 changes.</li>
-
-        <li>correct layout of working window used to extract data
-        in wide-character configured by
-        <code>set_field_buffer</code></li>
+        <li>
+          <p>modify internal recursion in <code>wgetch</code> which
+          handles cooked mode to check if the call to
+          <code>wgetnstr</code> returned an error. This can happen
+          when both <code>nocbreak</code> and <code>nodelay</code>
+          are set, for instance (see note for <a href=
+          "http://invisible-island.net/ncurses/NEWS.html#t960418">960418</a>).</p>
+        </li>
+
+        <li>
+          <p>add a check in internal function
+          <code>waddch_nosync</code> to ensure that tab characters
+          are treated as control characters; some broken locales
+          claim they are printable.</p>
+        </li>
+
+        <li>
+          <p>modify menu library to ensure that a menu's top-row is
+          adjusted as needed to ensure that the current item is on
+          the screen</p>
+        </li>
+
+        <li>
+          <p>fix special case where double-width character
+          overwrites a single- width character in the first
+          column.</p>
+        </li>
       </ul>
     </li>
   </ul>
 
-  <h2>Portability</h2>
+  <h3><a name="h3-config-config" id=
+  "h3-config-config">Configuration changes</a></h3>
+
+  <h4><a name="h4-config-major" id="h4-config-major">Major
+  changes</a></h4>
+
+  <p>The <em class="small-caps">ncurses</em> 6.0 configure script
+  makes changes to the <em>default</em> value of several configure
+  options, depending on the <code>--with-abi-version</code> option
+  (i.e., whether its value is &ldquo;5&rdquo; or
+  &ldquo;6&rdquo;):</p>
+
+  <dl>
+    <dt><code>--enable-const</code></dt>
+
+    <dd>
+      <p>Feature introduced in <a href=
+      "http://invisible-island.net/ncurses/NEWS.html#t970405">970405</a>
+      supports the use of <code>const</code> where X/Open Curses
+      should have, but did not. NetBSD curses does something
+      similar with <code>const</code>.</p>
+    </dd>
+
+    <dt><code>--enable-ext-colors</code></dt>
+
+    <dd>
+      <p>Extends the <code>cchar_t</code> structure to allow more
+      than 16 colors to be encoded. This applies only to the
+      wide-character (<code>--enable-widec</code>)
+      configuration.</p>
+    </dd>
+
+    <dt><code>--enable-ext-mouse</code></dt>
+
+    <dd>
+      <p>Modifies the encoding of mouse state to make room for a
+      5th mouse button. That allows one to use ncurses with a wheel
+      mouse with xterm or similar X terminal emulators.</p>
+    </dd>
+
+    <dt><code>--enable-ext-putwin</code></dt>
+
+    <dd>
+      <p>Modifies the file-format written by <code>putwin</code> to
+      use printable text rather than binary files, allowing
+      <code>getwin</code> to read screen dumps written by
+      differently-configured ncurses libraries. The extended
+      <code>getwin</code> can still read binary screen dumps from
+      the <em>same</em> configuration of ncurses. This does not
+      change the ABI (the binary interface seen by calling
+      applications).</p>
+    </dd>
+
+    <dt><code>--enable-interop</code></dt>
+
+    <dd>
+      <p>Modifies the <code>FIELDTYPE</code> structure used for the
+      form library to make it more generic.</p>
+    </dd>
+
+    <dt><code>--enable-lp64</code></dt>
+
+    <dd>
+      <p>Allows an application to define <code>_LP64</code> to
+      declare <code>chtype</code> and <code>mmask_t</code> as
+      simply &ldquo;<code>unsigned</code>&rdquo; rather than the
+      configured types using the <code>--with-chtype</code> and
+      <code>--with-mmask_t</code> options.</p>
+    </dd>
+
+    <dt><code>--enable-sp-funcs</code></dt>
+
+    <dd>
+      <p>Compile-in support for extended functions which accept a
+      SCREEN pointer, reducing the need for juggling the global SP
+      value with <a href=
+      "http://invisible-island.net/ncurses/man/curs_initscr.3x.html#h3-set_term">
+      set_term</a> and <a href=
+      "http://invisible-island.net/ncurses/man/curs_initscr.3x.html#h3-delscreen">
+      delscreen</a>.</p>
+    </dd>
+
+    <dt><code>--with-chtype=uint32_t</code></dt>
+
+    <dd>
+      <p>Makes <code>chtype</code> explicitly a 32-bit unsigned
+      value.</p>
+    </dd>
+
+    <dt><code>--with-mmask_t=uint32_t</code></dt>
+
+    <dd>
+      <p>Makes <code>mmask_t</code> explicitly a 32-bit unsigned
+      value.</p>
+    </dd>
+
+    <dt><code>--with-tparm-arg=intptr_t</code></dt>
+
+    <dd>
+      <p>X/Open Curses declares <a href=
+      "http://invisible-island.net/ncurses/man/curs_terminfo.3x.html#h3-Formatting-Output">
+      tparm</a> using <code>long</code> for each of the parameters
+      aside from the formatting string, presuming that
+      <code>long</code> and <code>char*</code> are the same size.
+      This configure option uses <code>intptr_t</code> which
+      provides a better guarantee of the sizes.</p>
+    </dd>
+  </dl>
+
+  <p>The configure script no longer checks for antique compilers;
+  <code>c89</code> is assumed as a minimum. There are a few
+  features from later revisions which are used when available. The
+  configure script makes checks to turn on useful warnings from
+  clang, gcc and icc. You should be able to build <em class=
+  "small-caps">ncurses</em> 6.0 with any of the current (or not so
+  current) C compilers available in 2015.</p>
+
+  <p>The configure script, by the way, makes changes which do not
+  work with systems whose <code>/bin/sh</code> is non-POSIX. This
+  mainly affects Solaris (the other vendor <em class=
+  "small-caps">unix</em> systems have followed the POSIX guidelines
+  for the past twenty years). If you must build on Solaris, its
+  <a href=
+  "http://docs.oracle.com/cd/E19253-01/html/817-0552/fhkpy.html">xpg4</a>
+  binaries suffice, e.g.,</p>
+
+  <blockquote class="code-block">
+    <!--{{atr2html-->
+
+    <p style="font-family: monospace; font-size: 10pt;">
+    <font color="#800000">#!/bin/sh</font><br>
+    <font color="#008080">WHAT</font>=<strong><em><font color=
+    "#800000">`</font></em></strong>hostname|sed&nbsp;-e&nbsp;<font color="#800080">'s/\..*//'</font><strong><em><font color="#800000">`</font></em></strong><br>
+
+    <font color="#008080">OUT</font>=configure.out<br>
+    <strong><font color=
+    "#000080">cat</font></strong>&nbsp;&gt;&gt;<font color=
+    "#008080">$OUT</font>&nbsp;<font color=
+    "#800080">&lt;&lt;EOF/</font><font color="#800080"><br>
+    **&nbsp;</font><strong><em><font color=
+    "#800000">`</font></em></strong>date<strong><em><font color=
+    "#800000">`</font></em></strong><font color="#800080"><br>
+    **&nbsp;node:&nbsp;</font><font color=
+    "#008080">$WHAT</font><font color="#800080"><br>
+    **&nbsp;user:&nbsp;</font><strong><em><font color=
+    "#800000">`</font></em></strong>id<strong><em><font color=
+    "#800000">`</font></em></strong><font color="#800080"><br>
+    **&nbsp;conf:&nbsp;$*<br>
+    EOF/</font><br>
+    &nbsp;<br>
+    <font color="#008080">SHELL</font>=/bin/sh<br>
+    <strong><font color=
+    "#000080">if</font></strong>&nbsp;<strong><font color=
+    "#000080">test</font></strong>&nbsp;-f&nbsp;/usr/xpg4/bin/sh<br>
+
+    <strong><font color="#000080">then</font></strong><br>
+    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<font color=
+    "#008080">CONFIG_SHELL</font>=/usr/xpg4/bin/sh<br>
+    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<strong><font color="#000080">export</font></strong>&nbsp;CONFIG_SHELL<br>
+
+    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<font color=
+    "#008080">SHELL</font>=<font color=
+    "#008080">$CONFIG_SHELL</font><br>
+    <strong><font color="#000080">fi</font></strong><br>
+    &nbsp;<br>
+    rm&nbsp;-f&nbsp;config.status&nbsp;config.cache<br>
+    <font color="#008080">TOP</font>=<font color=
+    "#008080">$HOME</font>/<font color="#008080">$WHAT</font><br>
+    <font color=
+    "#008080">$SHELL</font>&nbsp;./configure&nbsp;--verbose&nbsp;\<br>
+
+    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;--disable-echo&nbsp;\<br>
+
+    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;--disable-overwrite&nbsp;\<br>
+
+    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;--enable-warnings&nbsp;\<br>
+
+    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;--with-warnings&nbsp;\<br>
+
+    &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;--prefix=<font color="#008080">$TOP</font>&nbsp;<font color="#008080">$*</font>&nbsp;<strong><font color="#008080">2</font></strong>&gt;&amp;<strong><font color="#008080">1</font></strong>&nbsp;|&nbsp;tee&nbsp;-a&nbsp;<font color="#008080">$OUT</font><br>
+
+    <!--atr2html}}--></p>
+  </blockquote>
+
+  <p>Other major changes to the configure script include:</p>
 
   <ul>
-    <li>configure script:
+    <li>
+      <p>ABI 6 is now the default, intending that the existing ABI
+      5 should build as before using the
+      &ldquo;<code>--with-abi-version=5</code>&rdquo; option.</p>
+    </li>
 
-      <ul>
-        <li>new options:
+    <li>
+      <p>added <code>--with-extra-suffix</code> option to help with
+      installing nonconflicting ncurses6 packages, e.g., avoiding
+      header- and library-conflicts.</p>
 
-          <dl>
-            <dt>--disable-libtool-version</dt>
+      <p><strong>NOTE:</strong> as a side-effect, this renames</p>
 
-            <dd>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.</dd>
+      <blockquote>
+        <p><code>adacurses-config</code> to
+        <code>adacurses5-config</code> and<br>
+        <code>adacursesw-config</code> to
+        <code>adacursesw5-config</code></p>
+      </blockquote>
+    </li>
 
-            <dt>--disable-rpath-hack</dt>
+    <li>
+      <p>the configure script looks for gnatgcc if the Ada95
+      binding is built, in preference to the default gcc/cc. The
+      script also ensures that the Ada95 binding is built with the
+      level of optimization as the C libraries.</p>
+    </li>
 
-            <dd>disable a feature which adds rpath options for
-            libraries in unusual places.</dd>
+    <li>
+      <p>the configure script captures define's related to
+      -D_XOPEN_SOURCE from the configure check and adds those to
+      the *-config and *.pc files, to simplify use for the
+      wide-character libraries.</p>
+    </li>
+  </ul>
 
-            <dt>--enable-interop</dt>
+  <h4><a name="h4-config-options" id=
+  "h4-config-options">Configuration options</a></h4>
 
-            <dd>integrate changes for generic/interop support to
-            form-library.</dd>
+  <p>There are several new (or extended) configure options:</p>
 
-            <dt>--enable-pc-files</dt>
+  <dl>
+    <dt><code>--disable-db-install</code></dt>
 
-            <dd>generate ".pc" files for each of the libraries, and
-            install them in <code>pkg-config</code>'s library
-            directory.</dd>
+    <dd>
+      <p>Do not install the terminal database. This is used to omit
+      features for packages, as done with
+      <code>--without-progs</code>. The option simplifies building
+      cross-compile support packages.</p>
+    </dd>
 
-            <dt>--enable-pthreads-eintr</dt>
+    <dt><code>--disable-gnat-projects</code></dt>
 
-            <dd>control whether to allow <code>EINTR</code> to
-            interrupt a read operation in <code>wgetch</code>. This
-            applies only to the pthread configuration</dd>
+    <dd>
+      <p>This option is used for regression testing</p>
+    </dd>
 
-            <dt>--enable-sp-funcs</dt>
+    <dt><code>--disable-lib-suffixes</code></dt>
 
-            <dd>compile-in support for extended functions which
-            accept a <code>SCREEN</code> pointer, reducing the need
-            for juggling the global <code>SP</code> value with
-            <code>set_term</code> and <code>delscreen</code>.</dd>
+    <dd>
+      <p>Suppress the &ldquo;w&rdquo;, &ldquo;t&rdquo; or
+      &ldquo;tw&rdquo; suffixes which normally would be added to
+      the library names for the <code>--enable-widec</code> and
+      <code>--with-pthread</code> options.</p>
+    </dd>
 
-            <dt>--enable-term-driver</dt>
+    <dt><code>--with-cxx-shared</code></dt>
 
-            <dd>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.</dd>
+    <dd>
+      <p>When <code>--with-shared</code> is set, build libncurses++
+      as a shared library. This implicitly relies upon building
+      with gcc/g++, since other compiler suites may have
+      differences in the way shared libraries are built. libtool by
+      the way has similar limitations.</p>
+    </dd>
 
-            <dt>--with-ncurses-wrap-prefix</dt>
+    <dt><code>--with-hashed-db</code></dt>
 
-            <dd>allows setting the prefix for functions used to
-            wrap global variables to something other than
-            "<code>_nc_</code>".</dd>
+    <dd>
+      <p>Extended this configure option to simplify building with
+      different versions of Berkeley database using FreeBSD
+      ports.</p>
+    </dd>
 
-            <dt>--with-pkg-config=[DIR]</dt>
+    <dt><code>--with-pc-suffix</code></dt>
 
-            <dd>check for <code>pkg-config</code>, optionally
-            specifying its path.</dd>
+    <dd>
+      <p>If ".pc" files are installed, optionally add a suffix to
+      the files and corresponding package names to separate unusual
+      configurations. If no option value is given (or if it is
+      "none"), no suffix is added. This option is used in the test
+      package for ncurses6.</p>
+    </dd>
 
-            <dt>--without-manpages</dt>
+    <dt><code>--with-xterm-kbs</code></dt>
 
-            <dd>tells the configure script to suppress the install
-            of ncurses' manpages.</dd>
+    <dd>
+      <p>Configure xterm's terminfo entries to use either BS
+      (<code>^H</code>, i.e., ASCII backspace) or DEL
+      (<code>^?</code>, or 127).</p>
+    </dd>
+  </dl>
 
-            <dt>--without-tests</dt>
+  <h3><a name="h3-portability" id=
+  "h3-portability">Portability</a></h3>
 
-            <dd>suppress building test programs.</dd>
-          </dl>
-        </li>
+  <h4><a name="h4-port-mingw" id="h4-port-mingw">MinGW</a></h4>
 
-        <li>improved options:
+  <p>Most of the portability-related work since <a href=
+  "http://invisible-island.net/ncurses/announce-5.9.html"><em class="small-caps">
+  ncurses</em> 5.9</a> extended and improved the MinGW port
+  introduced in <a href=
+  "http://invisible-island.net/ncurses/announce-5.8.html"><em class="small-caps">
+  ncurses</em> 5.8</a>.</p>
 
-          <ul>
-            <li>correct logic for <code>--with-database</code>,
-            which was coded as an enable-type switch.</li>
+  <p>The MinGW port can be readily cross-compiled:</p>
 
-            <li>omit the opaque-functions from
-            <code>lib_gen.o</code> when
-            <code>--disable-ext-funcs</code> is used.</li>
-          </ul>
-        </li>
-      </ul>
+  <ul>
+    <li>
+      <p>modified configure script to allow creating dll's for
+      MinGW when cross-compiling.</p>
     </li>
 
-    <li>packaging:
+    <li>
+      <p>enforced Windows-style path-separator if
+      cross-compiling,</p>
+    </li>
 
-      <ul>
-        <li>*-config scripts:
+    <li>
+      <p>added scripts for test-builds of cross-compiled packages
+      for ncurses6 to MinGW.</p>
+    </li>
 
-          <ul>
-            <li>modify <code>adacurses-config</code> to look for
-            ".ali" files in the adalib directory.</li>
+    <li>
+      <p>added pc-files to the MinGW cross-compiling
+      test-packages.</p>
+    </li>
+
+    <li>
+      <p>added script for building test-packages of binaries
+      cross-compiled to MinGW using NSIS.</p>
+    </li>
+
+    <li>
+      <p>added <code>nc_mingw.h</code> to installed headers for
+      MinGW port; this is needed for cross-compiling <a href=
+      "http://invisible-island.net/ncurses/ncurses-examples.html">ncurses-examples</a>.</p>
+    </li>
 
-            <li>correct install for the Ada95 tree, which omitted
-            <code>libAdaCurses.a</code> used in
-            <code>adacurses-config</code>.</li>
+    <li>
+      <p>added test-packages for cross-compiling ncurses-examples
+      using the MinGW test-packages.</p>
+    </li>
+  </ul>
 
-            <li>change install for <code>adacurses-config</code> to
-            provide additional flavors such as
-            <code>adacursesw-config</code>, for ncursesw.</li>
+  <p>The MinGW-specific Windows driver accounts for several
+  changes:</p>
 
-            <li>modify scripts to generate
-            <code>ncurses*-config</code> and pc-files to add
-            dependency for tinfo library.</li>
+  <ul>
+    <li>
+      <p>wide-character display is made usable by replacing MinGW's
+      non-working <code>wcrtomb</code> and <code>wctomb</code>
+      functions.</p>
+    </li>
 
-            <li>use <code>ncurses*-config</code> scripts if
-            available for test/configure.</li>
+    <li>
+      <p>implemented some display features: <a href=
+      "http://invisible-island.net/ncurses/man/curs_beep.3x.html">beep</a>,
+      <a href=
+      "http://invisible-island.net/ncurses/man/curs_beep.3x.html">flash</a>,
+      <a href=
+      "http://invisible-island.net/ncurses/man/curs_kernel.3x.html#h3-curs_set">
+      curs_set</a>.</p>
+    </li>
 
-            <li>correct name for termlib in
-            <code>ncurses*-config</code>, e.g., if it is renamed to
-            provide a single file for ncurses/ncursesw
-            libraries.</li>
+    <li>
+      <p>the driver handles repainting on endwin/refresh
+      combination.</p>
+    </li>
 
-            <li>generate manpages for the *-config scripts, adapted
-            from <code>help2man</code>.</li>
+    <li>
+      <p>modified treatment of <code>TERM</code> variable for MinGW
+      port to allow explicit use of the Windows console driver by
+      checking if <code>$TERM</code> is set to
+      &ldquo;<code>#win32console</code>&rdquo; or an abbreviation
+      of that.</p>
+    </li>
 
-            <li>modify install-rule for manpages so that *-config
-            manpages will install when building with
-            <code>--srcdir</code>.</li>
+    <li>
+      <p>the Windows driver also matches the special
+      <code>TERM</code> value &ldquo;unknown&rdquo;</p>
+    </li>
 
-            <li>build-fixes for OpenSolaris aka Solaris 11, for
-            wide-character configuration as well as for rpath
-            feature in *-config scripts.</li>
+    <li>
+      <p>the driver now returns characters for special keys, (like
+      <code>ansi.sys</code> does), when keypad mode is off, rather
+      than returning nothing at all.</p>
+    </li>
 
-            <li>use <code>$includedir</code> symbol in
-            <code>misc/ncurses-config.in</code>, add
-            <code>--includedir</code> option.</li>
+    <li>
+      <p>the driver checks a new environment variable <a href=
+      "http://invisible-island.net/ncurses/man/ncurses.3x.html#h3-NCURSES_CONSOLE2">
+      NCURSES_CONSOLE2</a> to optionally work around a deficiency
+      in <code>Console2</code> (and its descendent
+      <code>ConsoleZ</code>) which hang when an application creates
+      a console buffer.</p>
+    </li>
+  </ul>
 
-            <li>improve install-rules for pc-files.</li>
+  <p>Finally, there are other improvements:</p>
 
-            <li>create the <code>pkg-config</code> library
-            directory if needed.</li>
+  <ul>
+    <li>
+      <p>MinGW is one of the configurations where <em class=
+      "small-caps">ncurses</em> installs by default into /usr</p>
+    </li>
 
-            <li>fix typo "<code>==</code>" where "<code>=</code>"
-            is needed in <code>ncurses-config.in</code> and
-            <code>gen-pkgconfig.in</code> files.</li>
+    <li>configuration for cross-compiling uses AC_CHECK_TOOLS in
+    preference to AC_PATH_PROGS when searching for ncurses*-config,
+    e.g., in Ada95/configure and test/configure.</li>
 
-            <li>modify <code>gen-pkgconfig.in</code> to eliminate a
-            dependency on rpath when deciding whether to add
-            <code>$LIBS</code> to <code>--libs</code> output; that
-            should be shown for the ncurses and tinfo libraries
-            without taking rpath into account.</li>
+    <li>
+      <p>extend Windows support to work with MSYS2;</p>
 
-            <li>modify handling of <code>$PKG_CONFIG_LIBDIR</code>
-            to use only the first item in a possibly
-            colon-separated list.</li>
-          </ul>
+      <ul>
+        <li>
+          <p>this works with a scenario where there is an
+          ANSI-escape handler such as <code>ansicon</code> running
+          in the console window.</p>
         </li>
 
-        <li>other packaging issues
+        <li>wrap <code>isatty</code> calls with a macro, provide a
+        corresponding set of support routines to address
+        differences between MinGW and MSYS2.</li>
+      </ul>
+    </li>
+
+    <li>
+      <p>ensure <code>WINVER</code> is defined in makefiles rather
+      than using headers.</p>
+    </li>
+
+    <li>
+      <p>add check for the <code>gnatprep</code>
+      &ldquo;<code>-T</code>&rdquo; option.</p>
+    </li>
+
+    <li>
+      <p>work around a bug introduced by <a href=
+      "http://stackoverflow.com/questions/20877689/gcc-4-8-1-minggw-d-option-does-not-work-as-usual">
+      gcc 4.8.1</a> in MinGW which breaks "trace" feature.</p>
+    </li>
+
+    <li>
+      <p>add a driver-name method to each of the drivers.</p>
+    </li>
+  </ul>
 
-          <ul>
-            <li>add <code>make-tar.sh</code> scripts to Ada95 and
-            test subdirectories to help with making those
-            separately distributable.</li>
+  <h4><a name="h4-port-systems" id="h4-port-systems">Other
+  ports</a></h4>
 
-            <li>add <code>Ada95/configure</code> script, to use in
-            tar-file created by
-            <code>Ada95/make-tar.sh</code>.</li>
+  <p>These changes affect certain platforms (ports):</p>
 
-            <li>remove <code>tar-copy.sh</code> and related
-            <code>configure/Makefile</code> chunks, since the Ada95
-            binding is now installed using rules in
-            <code>Ada95/src</code>.</li>
-          </ul>
+  <ul>
+    <li>
+      <p>the configure script knows how to build shared libraries
+      with DragonFlyBSD and Interix.</p>
+    </li>
+
+    <li>
+      <p>support for AIX shared libraries is improved, tested with
+      AIX 5.3, 6.1 and 7.1 with both gcc 4.2.4 and cc:</p>
+
+      <ul>
+        <li>
+          <p>the shared-library suffix for AIX 5 and 6 is now
+          ".so"</p>
+        </li>
+
+        <li>
+          <p>the <code>-brtl</code> option is used with AIX 5-7; it
+          is needed to link with the shared libraries.</p>
         </li>
       </ul>
     </li>
 
-    <li>cross-compiling:
+    <li>
+      <p>the configure <code>--enable-pc-files</code> option takes
+      into account the <a href=
+      "http://linux.die.net/man/1/pkg-config"><code>PKG_CONFIG_PATH</code></a>
+      variable.</p>
+    </li>
+
+    <li>
+      <p>the configure option <code>--with-pkg-config-libdir</code>
+      provides control over the actual directory into which
+      pc-files are installed.</p>
+    </li>
+
+    <li>
+      <p>the build scripts add explicit -ltinfo, etc., to the
+      generated ".pc" file when <code>ld</code> option
+      &ldquo;<code>--as-needed</code>&rdquo; is used, or when
+      ncurses and tinfo are installed without using rpath.</p>
+    </li>
+
+    <li>
+      <p>the configure script disallows conflicting options
+      &ldquo;<code>--with-termlib</code>&rdquo; and
+      &ldquo;<code>--enable-term-driver</code>&rdquo;.</p>
+    </li>
+
+    <li>
+      <p>the check for missing c++ compiler to work when no error
+      is reported, and no variables set is improved (see note for
+      <a href=
+      "http://invisible-island.net/ncurses/NEWS.html#t20021206">20021206</a>).</p>
+    </li>
+
+    <li>
+      <p>the misc/gen_edit.sh script selects a "linux" entry which
+      works with the current kernel rather than assuming it is
+      always "linux3.0"</p>
+    </li>
+
+    <li>
+      <p>the test/configure script makes it simpler to override
+      names of curses-related libraries, to help with linking with
+      pdcurses in MinGW environment.</p>
+    </li>
+
+    <li>
+      <p>the configure-script/ifdef's allow the BSD OLD_TTY feature
+      to be suppressed if the type of <code>ospeed</code> is
+      configured using the option <code>--with-ospeed</code> to not
+      be a <code>short</code>. By default, it is a
+      <code>short</code> for termcap-compatibility.</p>
+    </li>
+
+    <li>
+      <p>the MKlib_gen.sh script works around a recent change in
+      gcc 5 (released <a href=
+      "https://gcc.gnu.org/gcc-5/">mid-2015</a>) which essentially
+      emits multiple <code>#line</code> statements for the same
+      position in a file.</p>
+    </li>
+
+    <li>
+      <p>the configure script works with Minix3.2 (see <a href=
+      "http://invisible-island.net/autoconf/portability-test.html">note</a>
+      on portability)</p>
+    </li>
+
+    <li>
+      <p>OS/2 redux:</p>
 
       <ul>
-        <li>improve configure checks for location of tic and
-        infocmp programs used for installing database and for
-        generating fallback data, e.g., for cross-compiling.</li>
-
-        <li>modify #define's for build-compiler to suppress cchar_t
-        symbol from compile of <code>make_hash</code> and
-        <code>make_keys</code>, improving cross-compilation of
-        ncursesw.</li>
-
-        <li>simplify include-dependencies of <code>make_hash</code>
-        and <code>make_keys</code>, to reduce the need for setting
-        BUILD_CPPFLAGS in cross-compiling when the build- and
-        target-machines differ.</li>
-
-        <li>correct cross-compiling configure check for
-        <code>CF_MKSTEMP</code> macro, by adding a check cache
-        variable set by <code>AC_CHECK_FUNC</code>.</li>
+        <li>
+          <p>the configure script supports OS/2 kLIBC.</p>
+        </li>
+
+        <li>
+          <p>the <code>--with-lib-prefix</code> option allows
+          configuring for old/new flavors of OS/2 EMX.</p>
+        </li>
       </ul>
     </li>
 
-    <li>library dependencies:
+    <li>
+      <p>improved configure-script checks for
+      <code>_XOPEN_SOURCE</code>:</p>
 
       <ul>
-        <li>revise <code>wadd_wch</code> and
-        <code>wecho_wchar</code> to eliminate dependency on
-        <code>unctrl</code>.</li>
-
-        <li>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.</li>
+        <li>
+          <p>the definition works starting with Solaris 10.</p>
+        </li>
+
+        <li>
+          <p>the definition is suppressed for IRIX64, since its
+          header files have a conflict versus
+          <code>_SGI_SOURCE</code>.</p>
+        </li>
       </ul>
     </li>
+  </ul>
+  <hr>
 
-    <li>building the Ada95 tree:
+  <h2><a name="h2-features" id="h2-features">Features of <em class=
+  "small-caps">ncurses</em></a></h2>
 
-      <ul>
-        <li>changes to use gnatmake project files in the Ada95
-        tree.</li>
+  <p>The <em class="small-caps">ncurses</em> package is fully
+  upward-compatible with SVr4 (System V Release 4) curses:</p>
 
-        <li>add/use configure check to turn on project rules for
-        <code>Ada95/src</code>.</li>
+  <ul>
+    <li>
+      <p>All of the SVr4 calls have been implemented (and are
+      documented).</p>
+    </li>
 
-        <li>old gnatmake (3.15) does not produce libraries using
-        project-file; work around by adding script to generate
-        alternate makefile.</li>
+    <li>
+      <p><em class="small-caps">ncurses</em> 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>add configure --with-ada-sharedlib option, for the
-        test_make rule.</li>
+    <li>
+      <p><em class="small-caps">ncurses</em> provides these SVr4
+      add-on libraries (not part of X/Open Curses):</p>
 
-        <li>move Ada95-related logic into aclocal.m4, since
-        additional checks will be needed to distinguish old/new
-        implementations of gnat.</li>
+      <ul>
+        <li>
+          <p>the panels library, supporting a stack of windows with
+          backing store.</p>
+        </li>
 
-        <li>add test_make / test_clean / test_install rules in
-        Ada95/src</li>
+        <li>
+          <p>the menus library, supporting a uniform but flexible
+          interface for menu programming.</p>
+        </li>
 
-        <li>change install-path for adainclude directory to
-        /usr/share/ada (was /usr/lib/ada).</li>
+        <li>
+          <p>the form library, supporting data collection through
+          on-screen forms.</p>
+        </li>
       </ul>
     </li>
 
-    <li>other configure/build issues:
+    <li>
+      <p><em class="small-caps">ncurses</em>'s terminal database is
+      fully compatible with that used by SVr4 curses.</p>
 
       <ul>
-        <li>make <code>CCHARW_MAX</code> value configurable, noting
-        that changing this would change the size of
-        <code>cchar_t</code>, and would be ABI-incompatible.</li>
-
-        <li>improve comparison of program-names when checking for
-        linked flavors such as "reset" by ignoring the executable
-        suffix.</li>
-
-        <li>drop <code>mkdirs.sh</code>, use
-        "<code>mkdir&nbsp;-p</code>".</li>
-
-        <li>drop <code>misc/ncu-indent</code> and
-        <code>misc/jpf-indent</code>; they are provided by an
-        external package <a href=
-        "http://invisible-island.net/cindent/cindent.html">cindent</a>.</li>
-
-        <li>change makefiles to use <code>$ARFLAGS</code> rather
-        than <code>$AR_OPTS</code>, provide a configure check to
-        detect whether a "-" is needed before "ar" options.</li>
-
-        <li>modify <code>CF_DISABLE_LEAKS</code> configure macro so
-        that the --enable-leaks option is not the same as
-        --disable-leaks.</li>
-
-        <li>improve configure script macros
-        <code>CF_HEADER_PATH</code> and
-        <code>CF_LIBRARY_PATH</code> by adding <code>CFLAGS</code>,
-        <code>CPPFLAGS</code> and <code>LDFLAGS</code>,
-        <code>LIBS</code> values to the search-lists.</li>
-
-        <li>improve configure macros <code>CF_GCC_VERSION</code>
-        and <code>CF_GCC_WARNINGS</code> to work with gcc 4.x's c89
-        alias, which gives warning messages for cases where older
-        versions would produce an error.</li>
-
-        <li>modify <code>CF_WITH_LIBTOOL</code> configure check to
-        allow unreleased libtool version numbers (e.g. which
-        include alphabetic chars, as well as digits, after the
-        final '.').</li>
-
-        <li>improve use of symbolic links in makefiles by using
-        "<code>-f</code>" option if it is supported, to eliminate
-        temporary removal of the target</li>
-
-        <li>add a configure-time check to pick a suitable value for
-        <code>CC_SHARED_OPTS</code> for Solaris.</li>
-
-        <li>add -shared option to <code>MK_SHARED_LIB</code> when
-        -Bsharable is used, for *BSD's, without which "main" might
-        be one of the shared library's dependencies.</li>
-
-        <li>modify configure script to allow building shared
-        libraries with gcc on AIX 5 or 6.</li>
-
-        <li>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.</li>
-
-        <li>suppress configure check for static/dynamic linker
-        flags for gcc on Darwin.</li>
-
-        <li>modify <code>misc/run_tic.in</code> to create parent
-        directory, in case this is a new install of hashed
-        database.</li>
-
-        <li>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.</li>
+        <li><em class="small-caps">ncurses</em> supports
+        user-defined capabilities which it can see, but which are
+        hidden from SVr4 curses applications using the
+        <em>same</em> terminal database.</li>
+
+        <li>
+          <p>It can be optionally configured to match the format
+          used in related systems such as AIX and Tru64.</p>
+        </li>
+
+        <li>
+          <p>Alternatively, <em class="small-caps">ncurses</em> can
+          be configured to use hashed databases rather than the
+          directory of files used by SVr4 curses.</p>
+        </li>
       </ul>
     </li>
 
-    <li>test programs:
+    <li>
+      <p>The <em class="small-caps">ncurses</em> 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>
 
-      <ul>
-        <li>add test/demo_terminfo, for comparison with
-        demo_termcap.</li>
+  <p>The <em class="small-caps">ncurses</em> package also has many
+  useful extensions over SVr4:</p>
 
-        <li>improve test/ncurses.c 'F' test, show combining
-        characters in color.</li>
+  <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 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).</p>
+    </li>
 
-        <li>fix logic for 'V' in test/ncurses.c tests f/F.</li>
+    <li>
+      <p>Unlike SVr3 curses, <em class="small-caps">ncurses</em>
+      can write to the rightmost-bottommost corner of the screen if
+      your terminal has an insert-character capability.</p>
+    </li>
 
-        <li>improve test/ncurses.c 'a test to put mouse droppings
-        in the proper window.</li>
+    <li>
+      <p>Ada95 and C++ bindings.</p>
+    </li>
 
-        <li>modify ncurses 'F' test to demo wborder_set with
-        colored lines.</li>
+    <li>
+      <p>Support for mouse event reporting with X Window xterm and
+      FreeBSD and OS/2 console windows.</p>
+    </li>
 
-        <li>modify ncurses 'f' test to demo wborder with colored
-        lines.</li>
+    <li>
+      <p>Extended mouse support via Alessandro Rubini's gpm
+      package.</p>
+    </li>
 
-        <li>improve test/ncurses.c 'a' test, using unctrl more
-        consistently to display meta-characters.</li>
+    <li>
+      <p>The function <code>wresize</code> allows you to resize
+      windows, preserving their data.</p>
+    </li>
 
-        <li>correct use of <code>key_name</code> in test/ncurses.c
-        'A' test, which only displays wide-characters, not
-        key-codes since 20070612.</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>add test/clip_printw.c to illustrate how to use printw
-        without wrapping.</li>
+    <li>
+      <p>The functions <code>keyok</code> and
+      <code>define_key</code> allow you to better control the use
+      of function keys, e.g., disabling the <em class=
+      "small-caps">ncurses</em> KEY_MOUSE, or by defining more than
+      one control sequence to map to a given key code.</p>
+    </li>
 
-        <li>modify test-programs, e.g,. test/view.c, to address
-        subtle differences between Tru64/Solaris and HPUX/AIX
-        getcchar return values.</li>
+    <li>
+      <p>Support for 256-color terminals, such as modern xterm.</p>
+    </li>
 
-        <li>add some test programs (and make these use the same
-        special keys by sharing <code>linedata.h</code> functions):
-        test/test_addstr.c test/test_addwstr.c test/test_addchstr.c
-        test/test_add_wchstr.c</li>
+    <li>
+      <p>Support for 16-color terminals, such as <em>aixterm</em>
+      and <em>modern xterm</em>.</p>
+    </li>
 
-        <li>add test/xterm-256color.dat</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>modify test programs to allow them to be built with
-        NetBSD curses.</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>fixes for test programs to build/work on HPUX and AIX,
-        etc.</li>
-      </ul>
+    <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>
-  </ul>
 
-  <h1>Features of Ncurses</h1>The ncurses package is fully
-  compatible with SVr4 (System V Release 4) curses:
+    <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>
 
-  <ul>
-    <li>All 257 of the SVr4 calls have been implemented (and are
-    documented).</li>
+    <li>
+      <p>The <a href=
+      "http://invisible-island.net/ncurses/man/tic.1m.html">tic</a>/<a href="http://invisible-island.net/ncurses/man/captoinfo.1m.html">captoinfo</a>
+      utility provided with <em class="small-caps">ncurses</em> has
+      the ability to translate many termcaps from the XENIX, IBM
+      and AT&amp;T extension sets.</p>
+    </li>
 
-    <li>Full support for SVr4 curses features including keyboard
-    mapping, color, forms-drawing with ACS characters, and
-    automatic recognition of keypad and function keys.</li>
+    <li>
+      <p>A BSD-like <a href=
+      "http://invisible-island.net/ncurses/man/tset.1.html">tset</a>
+      utility is provided.</p>
+    </li>
 
-    <li>An emulation of the SVr4 panels library, supporting a stack
-    of windows with backing store, is included.</li>
+    <li>
+      <p>The <em class="small-caps">ncurses</em> 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>An emulation of the SVr4 menus library, supporting a
-    uniform but flexible interface for menu programming, is
-    included.</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>An emulation of the SVr4 form library, supporting data
-    collection through on-screen forms, is included.</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>Binary terminfo entries generated by the ncurses tic(1)
-    implementation are bit-for-bit-compatible with the entry format
-    SVr4 curses uses.</li>
+    <li>
+      <p>The table-of-entries utility <a href=
+      "http://invisible-island.net/ncurses/man/toe.1m.html">toe</a>
+      makes it easy for users to see exactly what terminal types
+      are available on the system.</p>
+    </li>
 
-    <li>The utilities have options to allow you to filter terminfo
-    entries for use with less capable
-    <strong>curses</strong>/<strong>terminfo</strong> versions such
-    as the HP/UX and AIX ports.</li>
-  </ul>The ncurses package also has many useful extensions over
-  SVr4:
+    <li>
+      <p>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 <code>#undef</code>.</p>
+    </li>
 
-  <ul>
-    <li>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).</li>
-
-    <li>Unlike SVr3 curses, ncurses can write to the
-    rightmost-bottommost corner of the screen if your terminal has
-    an insert-character capability.</li>
-
-    <li>Ada95 and C++ bindings.</li>
-
-    <li>Support for mouse event reporting with X Window xterm and
-    FreeBSD and OS/2 console windows.</li>
-
-    <li>Extended mouse support via Alessandro Rubini's gpm
-    package.</li>
-
-    <li>The function <code>wresize</code> allows you to resize
-    windows, preserving their data.</li>
-
-    <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>
-
-    <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.</li>
-
-    <li>Support for 256-color terminals, such as modern xterm, when
-    configured using the <code>--enable-ext-colors</code>
-    option.</li>
-
-    <li>Support for 16-color terminals, such as <em>aixterm</em>
-    and <em>modern xterm</em>.</li>
-
-    <li>Better cursor-movement optimization. The package now
-    features a cursor-local-movement computation more efficient
-    than either BSD's or System V's.</li>
-
-    <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 the 4.4BSD curses <code>quickch</code>
-    routine.</li>
-
-    <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.</li>
-
-    <li>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).</li>
-
-    <li>The tic(1)/captoinfo utility provided with ncurses has the
-    ability to translate many termcaps from the XENIX, IBM and
-    AT&amp;T extension sets.</li>
-
-    <li>A BSD-like tset(1) utility is provided.</li>
-
-    <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 without giving up access to
-    the system terminfo directory.</li>
-
-    <li>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.)</li>
-
-    <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 $HOME/.terminfo directory.</li>
-
-    <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 and converts it to an equivalent
-    local terminfo tree under $HOME/.terminfo.</li>
-
-    <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, but it's there.</li>
-
-    <li>The table-of-entries utility <strong>toe</strong> makes it
-    easy for users to see exactly what terminal types are available
-    on the system.</li>
-
-    <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 <code>#undef</code>.</li>
-
-    <li>An HTML "Introduction to Programming with NCURSES" document
-    provides a narrative introduction to the curses programming
-    interface.</li>
+    <li>
+      <p>Extensive documentation is provided (see the <em><a href=
+      "http://invisible-island.net/ncurses/ncurses.faq.html#additional_reading">
+      Additional Reading</a></em> section of the <em><a href=
+      "http://invisible-island.net/ncurses/ncurses.faq.html"><em class="small-caps">
+      ncurses</em> FAQ</a></em> for online documentation).</p>
+    </li>
   </ul>
 
-  <h1>State of the Package</h1>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 and arena
-  corruption by the Purify memory-allocation tester.
+  <h2><a name="h2-who-uses" id="h2-who-uses">Applications using
+  <em class="small-caps">ncurses</em></a></h2>
 
-  <p>The ncurses code has been tested with a wide variety of
-  applications including (versions starting with those noted):</p>
+  <p>The <em class="small-caps">ncurses</em> distribution includes
+  a selection of test programs (including a few games). These are
+  available separately as <a href=
+  "http://invisible-island.net/ncurses/ncurses-examples.html">ncurses-examples</a></p>
 
-  <dl>
-    <dt>cdk</dt>
+  <p>The ncurses library has been tested with a wide variety of
+  applications including:</p>
 
-    <dd>Curses Development Kit<br>
-    <a href=
-    "http://invisible-island.net/cdk/">http://invisible-island.net/cdk/</a><br>
+  <blockquote>
+    <dl>
+      <dt>cdk</dt>
 
-    <a href=
-    "http://www.vexus.ca/products/CDK/">http://www.vexus.ca/products/CDK/</a></dd>
+      <dd>
+        <p>Curses Development Kit</p>
 
-    <dt>ded</dt>
+        <p><a href=
+        "http://invisible-island.net/cdk/">http://invisible-island.net/cdk/</a><br>
+        </p>
+      </dd>
 
-    <dd>directory-editor<br>
-    <a href=
-    "http://invisible-island.net/ded/">http://invisible-island.net/ded/</a></dd>
+      <dt>ded</dt>
 
-    <dt>dialog</dt>
+      <dd>
+        <p>directory-editor</p>
 
-    <dd>the underlying application used in Slackware's setup, and
-    the basis for similar applications on GNU/Linux.<br>
-    <a href=
-    "http://invisible-island.net/dialog/">http://invisible-island.net/dialog/</a></dd>
+        <p><a href=
+        "http://invisible-island.net/ded/">http://invisible-island.net/ded/</a></p>
+      </dd>
 
-    <dt>lynx</dt>
+      <dt>dialog</dt>
 
-    <dd>the character-screen WWW browser<br>
-    <a href=
-    "http://lynx.isc.org/release/">http://lynx.isc.org/release/</a></dd>
+      <dd>
+        <p>the underlying application used in Slackware's setup,
+        and the basis for similar install/configure applications on
+        many systems.</p>
 
-    <dt>Midnight Commander</dt>
+        <p><a href=
+        "http://invisible-island.net/dialog/">http://invisible-island.net/dialog/</a></p>
+      </dd>
 
-    <dd>file manager<br>
-    <a href=
-    "http://www.midnight-commander.org/">http://www.midnight-commander.org/</a></dd>
+      <dt>lynx</dt>
 
-    <dt>mutt</dt>
+      <dd>
+        <p>the text WWW browser</p>
 
-    <dd>mail utility<br>
-    <a href="http://www.mutt.org/">http://www.mutt.org/</a></dd>
+        <p><a href=
+        "http://lynx.isc.org/">http://lynx.isc.org/</a></p>
+      </dd>
 
-    <dt>ncftp</dt>
+      <dt>Midnight Commander</dt>
 
-    <dd>file-transfer utility<br>
-    <a href="http://www.ncftp.com/">http://www.ncftp.com/</a></dd>
+      <dd>
+        <p>file manager</p>
 
-    <dt>nvi</dt>
+        <p><a href=
+        "http://www.midnight-commander.org/">http://www.midnight-commander.org/</a></p>
+      </dd>
 
-    <dd>New vi versions 1.50 are able to use ncurses versions 1.9.7
-    and later.<br>
-    <a href=
-    "https://sites.google.com/a/bostic.com/keithbostic/nvi">https://sites.google.com/a/bostic.com/keithbostic/nvi</a><br>
-    </dd>
+      <dt>mutt</dt>
 
-    <dt>pinfo</dt>
+      <dd>
+        <p>mail utility</p>
 
-    <dd>Lynx-like info browser. <a href=
-    "https://alioth.debian.org/projects/pinfo/">https://alioth.debian.org/projects/pinfo/</a></dd>
+        <p><a href=
+        "http://www.mutt.org/">http://www.mutt.org/</a></p>
+      </dd>
 
-    <dt>tin</dt>
+      <dt>ncftp</dt>
 
-    <dd>newsreader, supporting color, MIME <a href=
-    "http://www.tin.org/">http://www.tin.org/</a></dd>
-  </dl>as well as some that use ncurses for the terminfo support
-  alone:
+      <dd>
+        <p>file-transfer utility</p>
 
-  <dl>
-    <dt>minicom</dt>
+        <p><a href=
+        "http://www.ncftp.com/">http://www.ncftp.com/</a></p>
+      </dd>
 
-    <dd>terminal emulator<br>
-    <a href=
-    "http://alioth.debian.org/projects/minicom/">http://alioth.debian.org/projects/minicom/</a></dd>
+      <dt>nvi</dt>
 
-    <dt>vile</dt>
+      <dd>
+        <p>New vi uses ncurses.</p>
 
-    <dd>vi-like-emacs<br>
-    <a href=
-    "http://invisible-island.net/vile/">http://invisible-island.net/vile/</a></dd>
-  </dl>
+        <p><a href=
+        "https://sites.google.com/a/bostic.com/keithbostic/nvi">https://sites.google.com/a/bostic.com/keithbostic/nvi</a><br>
+        </p>
+      </dd>
+
+      <dt>tin</dt>
+
+      <dd>
+        <p>newsreader, supporting color, MIME</p>
+
+        <p><a href=
+        "http://www.tin.org/">http://www.tin.org/</a></p>
+      </dd>
+    </dl>
+  </blockquote>
+
+  <p>as well as some that use <em class="small-caps">ncurses</em>
+  for the terminfo support alone:</p>
+
+  <blockquote>
+    <dl>
+      <dt>minicom</dt>
+
+      <dd>
+        <p>terminal emulator for serial modem connections</p>
+
+        <p><a href=
+        "http://alioth.debian.org/projects/minicom/">http://alioth.debian.org/projects/minicom/</a></p>
+      </dd>
+
+      <dt>mosh</dt>
+
+      <dd>
+        <p>a replacement for <code>ssh</code>.</p>
 
-  <p>The ncurses distribution includes a selection of test programs
-  (including a few games).</p>
+        <p><a href=
+        "https://mosh.mit.edu/">https://mosh.mit.edu/</a></p>
+      </dd>
 
-  <h2>Who's Who and What's What</h2>Zeyd Ben-Halim started it from
-  a previous package pcurses, written by Pavel Curtis. Eric S.
+      <dt>tack</dt>
+
+      <dd>
+        <p>terminfo action checker</p>
+
+        <p><a href=
+        "http://invisible-island.net/ncurses/tack.html">http://invisible-island.net/ncurses/tack.html</a></p>
+      </dd>
+
+      <dt>tmux</dt>
+
+      <dd>
+        <p>terminal multiplexor</p>
+
+        <p><a href=
+        "http://tmux.github.io/">http://tmux.github.io/</a></p>
+      </dd>
+
+      <dt>vile</dt>
+
+      <dd>
+        <p>vi-like-emacs may be built to use the terminfo, termcap
+        or curses interfaces.</p>
+
+        <p><a href=
+        "http://invisible-island.net/vile/">http://invisible-island.net/vile/</a></p>
+      </dd>
+    </dl>
+  </blockquote>
+
+  <p>and finally, those which use only the termcap interface:</p>
+
+  <blockquote>
+    <dl>
+      <dt>emacs</dt>
+
+      <dd>
+        <p>text editor</p>
+
+        <p><a href=
+        "http://www.gnu.org/software/emacs/">http://www.gnu.org/software/emacs/</a></p>
+      </dd>
+
+      <dt>screen</dt>
+
+      <dd>
+        <p>terminal multiplexor</p>
+
+        <p><a href=
+        "http://www.gnu.org/software/screen/">http://www.gnu.org/software/screen/</a></p>
+      </dd>
+
+      <dt>vim</dt>
+
+      <dd>
+        <p>text editor</p>
+
+        <p><a href=
+        "http://www.vim.org/">http://www.vim.org/</a></p>
+      </dd>
+    </dl>
+  </blockquote>
+
+  <h2><a name="h2-development" id="h2-development">Development
+  activities</a></h2>
+
+  <p>Zeyd Ben-Halim started <em class="small-caps">ncurses</em>
+  from a previous package pcurses, written by Pavel Curtis. Eric S.
   Raymond continued development. J&uuml;rgen Pfeifer wrote most of
-  the form and menu libraries. Ongoing work is being done by
+  the form and menu libraries. Ongoing development work is done by
   <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. Contact the
-  current maintainers at <a href=
-  "mailto:bug-ncurses@gnu.org">bug-ncurses@gnu.org</a>.
-
-  <p>To join the ncurses mailing list, please write email to
-  <code>bug-ncurses-request@gnu.org</code> containing the line:</p>
-  <pre>
-             subscribe &lt;name&gt;@&lt;host.domain&gt;
-</pre>
+  Thomas Dickey also acts as the maintainer for the Free Software
+  Foundation, which holds the <a href=
+  "http://invisible-island.net/ncurses/ncurses-license.html">copyright
+  on ncurses</a>.</p>
+
+  <p>Contact the current maintainers at</p>
+
+  <blockquote>
+    <a href="mailto:bug-ncurses@gnu.org">bug-ncurses@gnu.org</a>
+  </blockquote>
+
+  <p>To join the ncurses mailing list, please write email to</p>
+
+  <blockquote>
+    <a href=
+    "mailto:bug-ncurses-request@gnu.org">bug-ncurses-request@gnu.org</a>
+  </blockquote>containing the line:
+
+  <blockquote>
+    <p><code>subscribe</code>
+    <em>&lt;name&gt;@&lt;host.domain&gt;</em></p>
+  </blockquote>
 
   <p>This list is open to anyone interested in helping with the
   development and testing of this package.</p>
 
-  <p>Beta versions of ncurses and patches to the current release
-  are made available at <a href=
-  "ftp://invisible-island.net/ncurses/">ftp://invisible-island.net/ncurses/</a>&nbsp;.</p>
+  <p>Beta versions of <em class="small-caps">ncurses</em> and
+  patches to the current release are made available at</p>
+
+  <blockquote>
+    <p><a href=
+    "ftp://invisible-island.net/ncurses/">ftp://invisible-island.net/ncurses/</a>&nbsp;.</p>
+  </blockquote>
+
+  <p>There is an archive of the mailing list here:</p>
+
+  <blockquote>
+    <p><a href=
+    "http://lists.gnu.org/archive/html/bug-ncurses">http://lists.gnu.org/archive/html/bug-ncurses</a>
+    (also <a href=
+    "https://lists.gnu.org/archive/html/bug-ncurses">https</a>)</p>
+  </blockquote>
+
+  <h2><a name="h2-this-stuff" id="h2-this-stuff">Related
+  resources</a></h2>
 
-  <h2>Future Plans</h2>
+  <p>The release notes make scattered references to these pages,
+  which may be interesting by themselves:</p>
 
   <ul>
-    <li>Extended-level XPG4 conformance, with internationalization
-    support.</li>
+    <li><a href=
+    "http://invisible-island.net/scripts/man2html.html">man2html</a></li>
 
-    <li>Ports to more systems, including DOS and Windows.</li>
-  </ul>We need people to help with these projects. If you are
-  interested in working on them, please join the ncurses list.
+    <li><a href=
+    "http://invisible-island.nethttp://invisible-island.net/ncurses/ncurses-license.html">
+    <em class="small-caps">ncurses</em> licensing</a></li>
 
-  <h2>Other Related Resources</h2>The distribution provides a newer
-  version of the terminfo-format terminal description file once
-  maintained by <a href="http://www.catb.org/~esr/terminfo/">Eric
+    <li><a href=
+    "http://invisible-island.net/ncurses/ncurses-mapsyms.html">Symbol
+    versioning in <em class="small-caps">ncurses</em></a></li>
+
+    <li><a href=
+    "http://invisible-island.net/ncurses/ncurses-mingw.html">The
+    MinGW port of <em class="small-caps">ncurses</em></a></li>
+
+    <li><a href=
+    "http://invisible-island.net/ncurses/tack.html">tack &ndash;
+    terminfo action checker</a></li>
+
+    <li><a href=
+    "http://invisible-island.net/autoconf/portability-tar.html">tar
+    versus portability</a></li>
+
+    <li><a href=
+    "http://invisible-island.net/ncurses/tctest.html">tctest
+    &ndash; termcap library checker</a></li>
+
+    <li><a href=
+    "http://invisible-island.net/ncurses/ncurses.html#download_database">
+    Terminal Database</a></li>
+  </ul>
+
+  <h2><a name="h2-other-stuff" id="h2-other-stuff">Other
+  resources</a></h2>
+
+  <p>The distribution provides a newer version of the
+  terminfo-format terminal description file once maintained by
+  <a href="http://www.catb.org/~esr/terminfo/">Eric
   Raymond</a>&nbsp;. 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.
+  user-definable extensions beyond the X/Open specification.</p>
 
   <p>You can find lots of information on terminal-related topics
   not covered in the terminfo file at <a href=
   "http://web.archive.org/web/*/http://www.cs.utk.edu/~shuford/terminal">
   Richard Shuford's archive</a>&nbsp;.</p>
+
+  <div class="nav">
+    <ul>
+      <li><a href="#h2-overview">Overview</a></li>
+
+      <li>
+        <a href="#h2-release-notes">Release Notes</a>
+
+        <ul>
+          <li>
+            <a href="#h3-library">Library improvements</a>
+
+            <ul>
+              <li><a href="#h3-lib-setbuf">Output
+              buffering</a></li>
+
+              <li><a href="#h3-lib-versioning">Symbol
+              versioning</a></li>
+
+              <li><a href="#h3-lib-other">Miscellaneous</a></li>
+            </ul>
+          </li>
+
+          <li>
+            <a href="#h3-programs">Program improvements</a>
+
+            <ul>
+              <li><a href="#h4-utilities">Utilities</a></li>
+
+              <li><a href="#h4-examples">Examples</a></li>
+            </ul>
+          </li>
+
+          <li><a href="#h3-database">Terminal database</a></li>
+
+          <li><a href="#h3-documentation">Documentation</a></li>
+
+          <li><a href="#h3-bug-fixes">Interesting
+          bug-fixes</a></li>
+
+          <li>
+            <a href="#h3-config-config">Configuration changes</a>
+
+            <ul>
+              <li><a href="#h4-config-major">Major changes</a></li>
+
+              <li><a href="#h4-config-options">Configuration
+              options</a></li>
+            </ul>
+          </li>
+
+          <li>
+            <a href="#h3-portability">Portability</a>
+
+            <ul>
+              <li><a href="#h4-port-mingw">MinGW</a></li>
+
+              <li><a href="#h4-port-systems">Other ports</a></li>
+            </ul>
+          </li>
+        </ul>
+      </li>
+
+      <li><a href="#h2-features">Features of <em class=
+      "small-caps">ncurses</em></a></li>
+
+      <li><a href="#h2-who-uses">Applications using <em class=
+      "small-caps">ncurses</em></a></li>
+
+      <li><a href="#h2-development">Development activities</a></li>
+
+      <li><a href="#h2-this-stuff">Related resources</a></li>
+
+      <li><a href="#h2-other-stuff">Other resources</a></li>
+    </ul>
+  </div>
 </body>
 </html>