1<!-- 2 $Id: announce.html.in,v 1.96 2020/02/09 21:50:48 tom Exp $ 3 **************************************************************************** 4 * Copyright 2018-2019,2020 Thomas E. Dickey * 5 * * 6 * Permission is hereby granted, free of charge, to any person obtaining a * 7 * copy of this software and associated documentation files (the * 8 * "Software"), to deal in the Software without restriction, including * 9 * without limitation the rights to use, copy, modify, merge, publish, * 10 * distribute, distribute with modifications, sublicense, and/or sell * 11 * copies of the Software, and to permit persons to whom the Software is * 12 * furnished to do so, subject to the following conditions: * 13 * * 14 * The above copyright notice and this permission notice shall be included * 15 * in all copies or substantial portions of the Software. * 16 * * 17 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS * 18 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF * 19 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. * 20 * IN NO EVENT SHALL THE ABOVE COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, * 21 * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR * 22 * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR * 23 * THE USE OR OTHER DEALINGS IN THE SOFTWARE. * 24 * * 25 * Except as contained in this notice, the name(s) of the above copyright * 26 * holders shall not be used in advertising or otherwise to promote the * 27 * sale, use or other dealings in this Software without prior written * 28 * authorization. * 29 **************************************************************************** 30--> 31<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN"> 32 33<html> 34<head> 35 <meta name="generator" content= 36 "HTML Tidy for HTML5 for Linux version 5.2.0"> 37 38 <title>Announcing ncurses @VERSION@</title> 39 <link rel="author" href="mailto:bug-ncurses@gnu.org"> 40 <meta http-equiv="Content-Type" content= 41 "text/html; charset=us-ascii"> 42 <style type="text/css"> 43 p,li { max-width:700px; } 44 dd { max-width:630px; } 45 *.main-name { 46 font-style: italic; 47 font-variant: small-caps; 48 } 49 *.part-name { 50 font-family: "Andale Mono", "Monotype.com", monospace; 51 font-size: 12pt; 52 font-weight: bold; 53 } 54 *.demo-name { 55 font-family: "Andale Mono", "Monotype.com", monospace; 56 font-size: 10pt; 57 } 58 </style> 59</head> 60 61<body> 62 <h1 class="no-header">Announcing ncurses @VERSION@</h1> 63 64 <h2><a name="h2-overview" id="h2-overview">Overview</a></h2> 65 66 <p>The <span class="main-name">ncurses</span> (new curses) 67 library is a free software emulation of curses in System V 68 Release 4.0 (SVr4), and more. It uses terminfo format, supports 69 pads and color and multiple highlights and forms characters and 70 function-key mapping, and has all the other SVr4-curses 71 enhancements over BSD curses. SVr4 curses became the basis of 72 X/Open Curses.</p> 73 74 <p>In mid-June 1995, the maintainer of 4.4BSD curses declared 75 that he considered 4.4BSD curses obsolete, and encouraged the 76 keepers of <span class="main-name">unix</span> releases such as 77 BSD/OS, FreeBSD and NetBSD to switch over to <span class= 78 "main-name">ncurses</span>.</p> 79 80 <p>Since 1995, <span class="main-name">ncurses</span> has been 81 ported to many systems:</p> 82 83 <ul> 84 <li>It is used in almost every system based on the Linux kernel 85 (aside from some embedded applications).</li> 86 87 <li>It is used as the system curses library on OpenBSD, FreeBSD 88 and MacOS.</li> 89 90 <li>It is used in environments such as Cygwin and MinGW. The 91 first of these was EMX on OS/2 Warp.</li> 92 93 <li>It is used (though usually not as the <em>system</em> 94 curses) on all of the vendor <span class= 95 "main-name">unix</span> systems, e.g., AIX, HP-UX, IRIX64, SCO, 96 Solaris, Tru64.</li> 97 98 <li>It should work readily on any ANSI/POSIX-conforming 99 <span class="main-name">unix</span>.</li> 100 </ul> 101 102 <p>The distribution includes the library and support utilities, 103 including</p> 104 105 <ul> 106 <li><a href="@HOMEPAGE@/man/captoinfo.1m.html"><span class= 107 "part-name">captoinfo</span></a>, a termcap conversion 108 tool</li> 109 110 <li><a href="@HOMEPAGE@/man/clear.1.html"><span class= 111 "part-name">clear</span></a>, utility for clearing the 112 screen</li> 113 114 <li><a href="@HOMEPAGE@/man/infocmp.1m.html"><span class= 115 "part-name">infocmp</span></a>, the terminfo decompiler</li> 116 117 <li><a href="@HOMEPAGE@/man/tabs.1.html"><span class= 118 "part-name">tabs</span></a>, set tabs on a terminal</li> 119 120 <li><a href="@HOMEPAGE@/man/tic.1m.html"><span class= 121 "part-name">tic</span></a>, the terminfo compiler</li> 122 123 <li><a href="@HOMEPAGE@/man/toe.1m.html"><span class= 124 "part-name">toe</span></a>, list (table of) terminfo 125 entries</li> 126 127 <li><a href="@HOMEPAGE@/man/tput.1.html"><span class= 128 "part-name">tput</span></a>, utility for retrieving terminal 129 capabilities in shell scripts</li> 130 131 <li><a href="@HOMEPAGE@/man/tset.1.html"><span class= 132 "part-name">tset</span></a>, to initialize the terminal</li> 133 </ul> 134 135 <p>Full manual pages are provided for the library and tools.</p> 136 137 <p>The <span class="main-name">ncurses</span> distribution is 138 available at <span class="main-name">ncurses</span>' <a href= 139 "@HOMEPAGE@/">homepage</a>:</p> 140 141 <blockquote> 142 <p><a href= 143 "ftp://ftp.invisible-island.net/ncurses/">ftp://ftp.invisible-island.net/ncurses/</a> 144 or<br> 145 <a href= 146 "https://invisible-mirror.net/archives/ncurses/">https://invisible-mirror.net/archives/ncurses/</a> .</p> 147 </blockquote> 148 149 <p>It is also available via anonymous FTP at the GNU distribution 150 site</p> 151 152 <blockquote> 153 <p><a href= 154 "ftp://ftp.gnu.org/gnu/ncurses/">ftp://ftp.gnu.org/gnu/ncurses/</a> .</p> 155 </blockquote> 156 157 <h2><a name="h2-release-notes" id="h2-release-notes">Release 158 Notes</a></h2> 159 160 <p>These notes are for <span class="main-name">ncurses</span> 161 @VERSION@, released <strong>February 12, 2020</strong>.</p> 162 163 <p>This release is designed to be source-compatible with 164 <span class="main-name">ncurses</span> 5.0 through 6.1; providing 165 extensions to the application binary interface (ABI). Although 166 the source can still be configured to support the <span class= 167 "main-name">ncurses</span> 5 ABI, the reason for the release is 168 to reflect improvements to the <span class= 169 "main-name">ncurses</span> 6 ABI and the supporting utility 170 programs.</p> 171 172 <p>There are, of course, numerous other improvements, listed in 173 this announcement.</p> 174 175 <p>The most <a href="#h3-bug-fixes">important 176 bug-fixes/improvements</a> dealt with user-defined capabilities 177 in terminal descriptions. The release notes also mention some 178 other bug-fixes, but are focused on new features and improvements 179 to existing features since <span class="main-name">ncurses</span> 180 6.1 release.</p> 181 182 <h3><a name="h3-library" id="h3-library">Library improvements</a></h3> 183 184 <h4><a name="h4-new-library" id="h4-new-library">New features</a></h4> 185 186 <p>There are several new features:</p> 187 188 <ul> 189 <li> 190 <p><a href= 191 "@HOMEPAGE@/man/form_field_opts.3x.html">O_EDGE_INSERT_STAY</a> 192 tells the form library to optionally delay cursor movement on 193 a field edge/boundary</p> 194 </li> 195 196 <li> 197 <p><a href= 198 "@HOMEPAGE@/man/form_field_opts.3x.html">O_INPUT_FIELD</a> 199 extension to form library allows a dynamic field to shrink if 200 the new limit is smaller than the current field size.</p> 201 </li> 202 203 <li> 204 <p>added <a href= 205 "@HOMEPAGE@/man/curs_memleaks.3x.html">exit_curses</a> and 206 <a href= 207 "@HOMEPAGE@/man/curs_memleaks.3x.html">exit_terminfo</a> to 208 replace internal symbols for leak-checking.</p> 209 </li> 210 211 <li> 212 <p>added <a href= 213 "@HOMEPAGE@/man/curs_trace.3x.html#h3-Functions">curses_trace</a>, 214 to replace trace().</p> 215 </li> 216 </ul> 217 218 <p>Additionally, to improve performance other changes (and 219 extensions) are provided in this release:</p> 220 221 <ul> 222 <li> 223 <p>mouse decoding now handles shift/control/alt logic when 224 decoding xterm's 1006 mode</p> 225 </li> 226 227 <li> 228 <p>ncurses now defines a limit for <a href= 229 "@HOMEPAGE@/man/curs_getstr.3x.html">wgetnstr</a>, <a href= 230 "@HOMEPAGE@/man/curs_get_wstr.3x.html">wgetn_wstr</a> when 231 length is negative or “too large”.</p> 232 </li> 233 234 <li>reordered loop-limit checks in <a href= 235 "@HOMEPAGE@/man/curs_insstr.3x.html">winsnstr</a> in case the 236 string has no terminating null and only the number of 237 characters is used.</li> 238 239 <li> 240 <p>there is now no buffer-size limit when reading the 241 <a href="@HOMEPAGE@/man/ncurses.3x.html#h3-TERMCAP"><tt>$TERMCAP</tt></a> 242 variable.</p> 243 </li> 244 245 <li> 246 <p>the <a href= 247 "@HOMEPAGE@/man/ncurses.3x.html#h3-TERMCAP"><tt>$TERMCAP</tt></a> 248 variable may be interpreted as a fallback to a terminfo 249 entry</p> 250 </li> 251 252 <li> 253 <p><a href= 254 "@HOMEPAGE@/man/curs_terminfo.3x.html#h3-Output-Functions"><tt> 255 mvcur</tt></a> now decides whether to use hard-tabs, using 256 <strong><tt>xt</tt></strong>, <strong><tt>tbc</tt></strong> 257 and <strong><tt>hts</tt></strong> as clues.</p> 258 </li> 259 260 <li> 261 <p>extended colors are improved by modifying an internal call 262 to <a href= 263 "@HOMEPAGE@/man/curs_terminfo.3x.html#h3-Output-Functions"><tt> 264 vid_puts</tt></a> to pass extended color pairs e.g., from 265 <tt>tty_update.c</tt> and <tt>lib_mvcur.c</tt></p> 266 </li> 267 268 <li> 269 <p id="getenv-fixes">the initialization functions now avoid 270 relying upon persistent data for the result from <a href= 271 "#getenv-check"><tt>getenv</tt></a></p> 272 </li> 273 274 <li> 275 <p>scrolling is improved:</p> 276 277 <ul> 278 <li>a limit check in <tt>newline_forces_scroll</tt> handles 279 the case where the row is inside scroll-margins, but not at 280 the end.</li> 281 282 <li> 283 <p>improved loop limits in <tt>_nc_scroll_window</tt> 284 handle a case where the scrolled data is a pad which is 285 taller than the window.</p> 286 </li> 287 </ul> 288 </li> 289 </ul> 290 291 <h4><a name="h4-fixes-library" id="h4-fixes-library">Other 292 improvements</a></h4> 293 294 <p>These are revised features:</p> 295 296 <ul> 297 <li> 298 <p>used “<tt>const</tt>” in some prototypes 299 rather than <tt>NCURSES_CONST</tt> where X/Open Curses was 300 updated to do this, e.g., <tt>wscanw</tt>, <tt>newterm</tt>, 301 the terminfo interface. Also use “<tt>const</tt>” 302 for consistency in the termcap interface, which was withdrawn 303 by X/Open Curses in Issue 5 (2007). As of Issue 7, X/Open 304 Curses still lacks “<tt>const</tt>” for certain 305 return values, e.g., <a href= 306 "@HOMEPAGE@/man/curs_util.3x.html#h3-keyname_key_name">keyname</a>.</p> 307 </li> 308 309 <li> 310 <p>modified <a href= 311 "@HOMEPAGE@/man/curs_bkgd.3x.html#h3-bkgd"><tt>wbkgd</tt></a> 312 and <a href= 313 "@HOMEPAGE@/man/curs_bkgrnd.3x.html#h3-bkgrnd"><tt>wbkgrnd</tt></a> 314 to improve compatibility with SVr4 curses, changing the way 315 the window rendition is updated when the background character 316 is modified</p> 317 </li> 318 319 <li> 320 <p>improved terminfo write/read by modifying the fourth item 321 of the extended header to denote the number of valid strings 322 in the extended string table (see <a href= 323 "@HOMEPAGE@/man/term.5.html#h3-EXTENDED-STORAGE-FORMAT">term(5)</a>).</p> 324 </li> 325 326 <li> 327 <p>modified the initialization checks for mouse so that the 328 <a href= 329 "/ncurses/terminfo.src.html#tic-xterm_sm_1006"><tt>xterm+sm+1006</tt></a> 330 block will work with terminal descriptions not mentioning 331 <em>xterm</em>.</p> 332 </li> 333 </ul> 334 335 <p>These were done to limit or ultimately deprecate features:</p> 336 337 <ul> 338 <li> 339 <p>deprecated <a href= 340 "@HOMEPAGE@/NEWS.html#t970831">safe-sprintf</a>, since the 341 <tt>vsnprintf</tt> function, which does what was needed, was 342 standardized long ago.</p> 343 </li> 344 345 <li> 346 <p>marked <a href= 347 "@HOMEPAGE@/man/curs_printw.3x.html#h3-PORTABILITY"><tt>vwprintw</tt></a> 348 and <tt>vwscanw</tt> as deprecated; recommend using <a href= 349 "@HOMEPAGE@/man/curs_printw.3x.html"><tt>vw_printw</tt></a> 350 and <tt>vw_scanw</tt>, respectively.</p> 351 </li> 352 353 <li> 354 <p>added deprecation warnings for internal functions called 355 by older versions of <a href= 356 "@HOMEPAGE@/tack.html">tack</a>.</p> 357 </li> 358 359 <li> 360 <p>removed unused <tt>_nc_import_termtype2</tt> function.</p> 361 </li> 362 </ul> 363 364 <p>These are improvements to existing features:</p> 365 366 <ul> 367 <li> 368 <p>check parameter of <a href= 369 "@HOMEPAGE@/man/curs_threads.3x.html">set_escdelay</a>, 370 return ERR if negative.</p> 371 </li> 372 373 <li> 374 <p>check parameter of <a href= 375 "@HOMEPAGE@/man/curs_threads.3x.html">set_tabsize</a>, return 376 ERR if not greater than zero</p> 377 </li> 378 379 <li> 380 <p>correct a status-check in _nc_read_tic_entry() so that if 381 reading a hex/b64 <a href= 382 "@HOMEPAGE@/man/ncurses.3x.html#h3-TERMINFO"><tt>$TERMINFO</tt></a>, 383 and the <a href= 384 "@HOMEPAGE@/man/ncurses.3x.html#h3-TERM"><tt>$TERM</tt></a> 385 does not match, fall-through to the compiled-in search 386 list.</p> 387 </li> 388 389 <li> 390 <p>amend check for <a href= 391 "@HOMEPAGE@/man/terminfo.5.html#h3-Predefined-Capabilities"><tt> 392 repeat_char</tt></a> to handle a case where setlocale() was 393 called after <a href= 394 "@HOMEPAGE@/man/curs_initscr.3x.html"><tt>initscr</tt></a></p> 395 </li> 396 397 <li> 398 <p>move macro for <a href= 399 "@HOMEPAGE@/man/curs_touch.3x.html"><tt>is_linetouched</tt></a> 400 inside <strong><tt>NCURSES_NOMACROS</tt></strong> 401 <em><tt>ifndef</tt></em>.</p> 402 </li> 403 404 <li> 405 <p>use <tt>_nc_copy_termtype2</tt> rather than direct 406 assignment in <a href= 407 "@HOMEPAGE@/man/curs_terminfo.3x.html#h3-Initialization">setupterm</a>, 408 in case it is called repeatedly using fallback terminfo 409 descriptions</p> 410 </li> 411 412 <li> 413 <p>improve workaround for Solaris wcwidth versus line-drawing 414 characters</p> 415 </li> 416 417 <li> 418 <p>add checks in <a href= 419 "@HOMEPAGE@/man/resizeterm.3x.html"><tt>repair_subwindows</tt></a> 420 to keep the current position and scroll-margins inside the 421 resized subwindow.</p> 422 </li> 423 424 <li> 425 <p>correct a buffer-limit in <tt>write_entry.c</tt> for 426 systems that use caseless filenames.</p> 427 </li> 428 429 <li> 430 <p>improved build-time utility <em>report_offsets</em>:</p> 431 432 <ul> 433 <li> 434 <p>add categories, e.g., "w" for wide-character, "t" for 435 threads to make the report more readable. Reorganized the 436 structures reported to make the categories more 437 apparent.</p> 438 </li> 439 440 <li> 441 <p>add <tt>NCURSES_GLOBALS</tt> and 442 <tt>NCURSES_PRESCREEN</tt> to report to show how similar 443 the different <em>libtinfo</em> configurations are.</p> 444 </li> 445 </ul> 446 </li> 447 448 <li> 449 <p>modified some header files to ensure that those include 450 necessary files except for the previously-documented 451 cases</p> 452 </li> 453 454 <li> 455 <p>added some traces in initialization to show whether a 456 fallback entry is used.</p> 457 </li> 458 459 <li> 460 <p>made minor optimization to reduce calls to 461 _nc_reserve_pairs</p> 462 </li> 463 </ul> 464 465 <p>These are corrections to existing features:</p> 466 467 <ul> 468 <li> 469 <p>fix a special case in <tt>PutAttrChar</tt> where a cell is 470 marked as alternate-character set, but the terminal does not 471 actually support the given graphic character. This would 472 happen in an older terminal such as <em>vt52</em>, which 473 lacks most line-drawing capability.</p> 474 </li> 475 476 <li> 477 <p>corrected flag for "seq" method of db 1.8.5 interface, 478 needed by toe on some of the BSDs.</p> 479 </li> 480 481 <li> 482 <p>modify comparison in make_hash.c to correct a special case 483 in collision handling for Caps-hpux11</p> 484 </li> 485 486 <li> 487 <p>add extended_slk_color{,_sp} symbols to the appropriate 488 package/*.{map,sym} files</p> 489 </li> 490 491 <li> 492 <p>modify lib_setup to avoid calling pthread_self() without 493 first verifying that the address is valid, i.e., for weak 494 symbols</p> 495 </li> 496 497 <li> 498 <p>add a couple of broken-linker symbols to the list of 499 versioned symbols to help with link-time optimization versus 500 weak symbols.</p> 501 </li> 502 </ul> 503 504 <h3><a name="h3-programs" id="h3-programs">Program 505 improvements</a></h3> 506 507 <p>Several improvements were made to the utility programs:</p> 508 509 <dl> 510 <dt><span class="part-name">clear</span> 511 </dt> 512 513 <dd> 514 <ul> 515 <li>improved logic for clearing with the <em>E3</em> 516 extension, in case the terminal scrolls content onto its 517 saved-lines before actually clearing the display, by 518 clearing the saved-lines after clearing the display</li> 519 </ul> 520 </dd> 521 522 <dt><span class="part-name">infocmp</span> 523 </dt> 524 525 <dd> 526 <ul> 527 <li>omit filtering of “<tt>OTxx</tt>” names 528 which are used for obsolete capabilities, when the output 529 is sorted by long-names. This change helps when making a 530 table of the short/long capability names.</li> 531 </ul> 532 </dd> 533 534 <dt><span class="part-name">tic</span> 535 </dt> 536 537 <dd> 538 <ul> 539 <li>added check for consistent alternate character set 540 capabilities.</li> 541 542 <li>added check for paired <tt>indn</tt>/<tt>rin</tt>.</li> 543 544 <li>added check for terminals with <tt>parm_dch</tt> vs 545 <tt>parm_ich</tt>.</li> 546 547 <li>added check for the case where 548 <tt>setf</tt>/<tt>setb</tt> are given using different 549 strings, but provide identical results to 550 <tt>setaf</tt>/<tt>setab</tt>.</li> 551 552 <li>corrected check for <tt>ich1</tt>.</li> 553 554 <li>changed a too-large terminal entry from a fatal error 555 to a warning.</li> 556 </ul> 557 </dd> 558 559 <dt><span class="part-name">toe</span> 560 </dt> 561 562 <dd> 563 <ul> 564 <li>ignores any hex/b64 <tt>$TERMINFO</tt> value in the 565 list of terminfo databases.</li> 566 </ul> 567 </dd> 568 569 <dt><span class="part-name">tset</span> 570 </dt> 571 572 <dd> 573 <ul> 574 <li>replace check in <span class="part-name">reset</span> 575 command for obsolete “<tt>pt</tt>” capability 576 using <tt>tbc</tt> and <tt>hts</tt> capabilities as 577 clues</li> 578 579 <li>modify <span class="part-name">reset</span> to allow 580 for tabstops at intervals other than 8.</li> 581 582 <li>change <span class="part-name">reset</span>'s behavior 583 for margins to simply clear soft-margins if possible, 584 rather than clearing and then setting them according to the 585 terminal's width.</li> 586 </ul> 587 </dd> 588 589 <dt><span class="part-name">tput</span> 590 </dt> 591 592 <dd> 593 <ul> 594 <li>add “<tt>x</tt>” to <tt>getopt</tt> string 595 so that “<tt>tput -x clear</tt>” 596 works.</li> 597 </ul> 598 </dd> 599 </dl> 600 601 <p>Several changes were made to the generated ncurses*config 602 scripts and the analogous “<tt>.pc</tt>” files to 603 reduce differences between the configurations they report:</p> 604 605 <ul> 606 <li> 607 <p>modified the ncurse*-config and pc-files to more closely 608 match for the <tt>-I</tt> and <tt>-l</tt> options.</p> 609 </li> 610 611 <li> 612 <p>filtered out linker-specs from the <tt>--libs</tt> 613 report.</p> 614 </li> 615 616 <li> 617 <p>amended the ncurses*-config and pc-files to take into 618 account the rpath hack which differed between those 619 files.</p> 620 </li> 621 622 <li> 623 <p>modified generated ncurses*config and ncurses.pc, 624 ncursesw.pc, etc., to list helper libraries such as gpm for 625 static linking.</p> 626 </li> 627 </ul> 628 629 <h4><a name="h4-examples" id="h4-examples">Examples</a></h4> 630 631 <p>Along with the library and utilities, improvements were made 632 to the <a href= 633 "@HOMEPAGE@/ncurses-examples.html">ncurses-examples</a>. Most of 634 this activity aimed at improving the test-packages. A few changes 635 are more generally useful, e.g., for the main ncurses 636 test-program, and for analyzing traces using the 637 <em>tracemunch</em> script:</p> 638 639 <ul> 640 <li> 641 <p>improve recovery from error when reading command-character 642 in <tt>test/ncurses.c</tt>, showing the relevant error 643 message and not exiting on EINTR.</p> 644 </li> 645 646 <li> 647 <p>improve <em>tracemunch</em>, by keeping track of 648 <tt>TERMINAL*</tt> values, and if tracing was first turned on 649 after initialization, attempt to show distinct screen, window 650 and terminal names anyway.</p> 651 </li> 652 653 <li> 654 <p>modify <em>tracemunch</em> to accept filename parameters 655 in addition to use as a pipe/filter.</p> 656 </li> 657 658 <li> 659 <p>update <em>tracemunch</em> to work with <em>perl 660 5.26.2</em>, which changed the rules for escaping regular 661 expressions.</p> 662 </li> 663 664 <li> 665 <p>add some checks in <em>tracemunch</em> for undefined 666 variables.</p> 667 </li> 668 669 <li> 670 <p>modify <tt>TurnOn</tt>/<tt>TurnOff</tt> macros (in 671 lib_vidattr.c and lib_vid_attr.c) to avoid expansion of 672 “<tt>CUR</tt>” in trace.</p> 673 </li> 674 </ul> 675 676 <p>There are other new demo/test programs and reusable 677 examples:</p> 678 679 <dl> 680 <dt><span class="part-name">color_content</span> 681 </dt> 682 683 <dd>Demonstrate the <tt>color_content</tt> and 684 <tt>extended_color_content</tt> functions.</dd> 685 686 <dt><span class="part-name">demo_tabs</span> 687 </dt> 688 689 <dd>A simple demo of tabs in curses.</dd> 690 691 <dt><span class="part-name">dump_window</span> 692 </dt> 693 694 <dd>A portable curses screen-dump, used to compare ncurses 695 screen contents with Solaris.</dd> 696 697 <dt><span class="part-name">pair_content</span> 698 </dt> 699 700 <dd>Demonstrate the <tt>pair_content</tt> and 701 <tt>extended_pair_content</tt> functions.</dd> 702 703 <dt><span class="part-name">report_hashing</span> 704 </dt> 705 706 <dd>Check hash-tables used for terminfo and termcap names.</dd> 707 708 <dt><span class="part-name">parse_rgb</span> 709 </dt> 710 711 <dd>Sample implementation of the ncurses RGB extension from 712 <a href="@HOMEPAGE@/man/user_caps.5.html">user_caps.5</a>, used 713 in <em>picsmap</em> and <em>savescreen</em> programs.</dd> 714 </dl> 715 716 <p>A variety of improvements were made to existing programs, both 717 new features as well as options added to make the set of programs 718 more consistent.</p> 719 720 <ul> 721 <li> 722 <p>add “<tt>-l</tt>” option to test/background, 723 to dump screen contents in a form that lets different curses 724 implementations be compared.</p> 725 </li> 726 727 <li> 728 <p>add “<tt>@</tt>” command to test/ncurses 729 F-test, to allow rapid jump to different character pages.</p> 730 </li> 731 732 <li> 733 <p>added enum, regex examples to test/demo_forms</p> 734 </li> 735 736 <li> 737 <p>amend Scaled256() macro in test/picsmap.c to cover the 738 full range 0..1000</p> 739 </li> 740 741 <li> 742 <p>corrected pathname used in Ada95 sample programs for 743 <tt>explain.txt</tt>, to work with test-packages, and used an 744 awk script to split the resulting pathname when it would be 745 too long for a single line.</p> 746 </li> 747 748 <li> 749 <p>ignore interrupted system-call in test/ncurses's 750 command-line, e.g., if the terminal were resized.</p> 751 </li> 752 753 <li> 754 <p>improved ifdef's for <tt>TABSIZE</tt> variable, to help 755 with AIX/HPUX ports.</p> 756 </li> 757 </ul> 758 759 <h3><a name="h3-database" id="h3-database">Terminal database</a></h3> 760 761 <p>There are several new terminal descriptions:</p> 762 763 <blockquote style="word-break:keep-all"> 764 <p><tt>alacritty</tt>, <tt>domterm</tt>, <tt>kitty</tt>, 765 <tt>mintty</tt>, <tt>mintty-direct</tt>, <tt>ms-terminal</tt>, 766 <tt>n7900</tt>, <tt>nsterm-build309</tt>, 767 <tt>nsterm-direct</tt>, <tt>screen5</tt>, <tt>ti703</tt>, 768 <tt>ti707</tt>, <tt>ti703-w</tt>, <tt>ti707-w</tt> 769 <tt>vscode</tt>, <tt>vscode-direct</tt>, <tt>xterm-mono</tt>, 770 <tt>xterm.js</tt></p> 771 </blockquote> 772 773 <p>There are many changes to existing terminal descriptions. Some 774 were updates to several descriptions:</p> 775 776 <ul> 777 <li>use <a href= 778 "/ncurses/terminfo.src.html#tic-ansi_rep"><tt>ansi+rep</tt></a> 779 in a dozen places</li> 780 781 <li>add rs1 to konsole, mlterm</li> 782 783 <li>improve several flash capabilities with trailing mandatory 784 delays</li> 785 786 <li>drop <tt>ich1</tt> from <tt>rxvt-basic</tt>, <tt>Eterm</tt> 787 and <tt>mlterm</tt> to improve compatibility with old 788 non-curses programs</li> 789 790 <li>add/use <a href= 791 "/ncurses/terminfo.src.html#tic-xterm_keypad"><tt>xterm+keypad</tt></a> 792 in <tt>xterm-new</tt></li> 793 794 <li>use <a href= 795 "/ncurses/terminfo.src.html#tic-xterm_sl-twm"><tt>xterm+sl-twm</tt></a> 796 for consistency, nine places</li> 797 798 <li>improve <em>xm</em> example in <a href= 799 "/ncurses/terminfo.src.html#tic-xterm_x11mouse">xterm+x11mouse</a> 800 and <a href= 801 "/ncurses/terminfo.src.html#tic-xterm_sm_1006">xterm+sm_1006</a>.</li> 802 </ul> 803 804 <p>while others affected specific descriptions. These were 805 retested, to take into account changes by their developers:</p> 806 807 <blockquote> 808 <p><tt>terminator</tt>, <tt>st</tt></p> 809 </blockquote> 810 811 <p>while these are specific fixes based on reviewing 812 documentation, user reports, or warnings from <span class= 813 "part-name">tic</span>:</p> 814 815 <dl> 816 <dt><a href= 817 "/ncurses/terminfo.src.html#tic-adds200">adds200</a>:</dt> 818 819 <dd> 820 <ul> 821 <li>fix typo</li> 822 </ul> 823 </dd> 824 825 <dt><a href= 826 "/ncurses/terminfo.src.html#tic-gnome-256color">gnome-256color</a> 827 </dt> 828 829 <dd> 830 <ul> 831 <li>base entry on "gnome", not "vte", for consistency</li> 832 </ul> 833 </dd> 834 835 <dt><a href= 836 "/ncurses/terminfo.src.html#tic-interix">interix</a> 837 </dt> 838 839 <dd> 840 <ul> 841 <li>trim unnecessary setf/setb</li> 842 </ul> 843 </dd> 844 845 <dt><a href= 846 "/ncurses/terminfo.src.html#tic-linux-16color">linux-16color</a> 847 </dt> 848 849 <dd> 850 <ul> 851 <li>accommodate <a href= 852 "https://lists.gnu.org/archive/html/bug-ncurses/2019-10/msg00061.html"> 853 Linux console driver</a> incompatibility introduced in 854 early 2018</li> 855 </ul> 856 </dd> 857 858 <dt><a href= 859 "/ncurses/terminfo.src.html#tic-nsterm-256color">nsterm-256color</a>:</dt> 860 861 <dd> 862 <ul> 863 <li>add nsterm-build309 to replace nsterm-256color, 864 assigning the latter as an alias of nsterm, to make mouse 865 work with nsterm-256color</li> 866 </ul> 867 </dd> 868 869 <dt><a href= 870 "/ncurses/terminfo.src.html#tic-regent40">regent40</a>:</dt> 871 872 <dd> 873 <ul> 874 <li>renumber function-keys to match manual</li> 875 </ul> 876 </dd> 877 878 <dt><a href= 879 "/ncurses/terminfo.src.html#tic-regent60">regent60</a>:</dt> 880 881 <dd> 882 <ul> 883 <li>add cd (clr_eos)</li> 884 885 <li>corrected acsc</li> 886 887 <li>add shifted function-keys</li> 888 </ul> 889 </dd> 890 891 <dt><a href= 892 "/ncurses/terminfo.src.html#tic-tvi950">tvi950</a>:</dt> 893 894 <dd> 895 <ul> 896 <li>added function-key definitions to agree with Televideo 897 950 manual</li> 898 899 <li>corrected acsc</li> 900 901 <li>remove bogus kf0</li> 902 903 <li>add bel</li> 904 </ul> 905 </dd> 906 907 <dt><a href= 908 "/ncurses/terminfo.src.html#tic-tvi955">tvi955</a>:</dt> 909 910 <dd> 911 <ul> 912 <li>fix typo</li> 913 </ul> 914 </dd> 915 916 <dt><a href= 917 "/ncurses/terminfo.src.html#tic-vi200">vi200</a>:</dt> 918 919 <dd> 920 <ul> 921 <li>add acsc string, including right/down-arrow</li> 922 </ul> 923 </dd> 924 925 <dt><a href= 926 "/ncurses/terminfo.src.html#tic-wy50">wy50</a>:</dt> 927 928 <dd> 929 <ul> 930 <li>corrected acsc</li> 931 </ul> 932 </dd> 933 934 <dt><a href="/ncurses/terminfo.src.html#tic-wy50">wy50</a> and 935 <a href="/ncurses/terminfo.src.html#tic-wy60">wy60</a>:</dt> 936 937 <dd> 938 <ul> 939 <li>add shifted function-keys as kF1 to kF16</li> 940 </ul> 941 </dd> 942 943 <dt><a href= 944 "/ncurses/terminfo.src.html#tic-xterm_x11hilite">xterm+x11hilite</a>:</dt> 945 946 <dd> 947 <ul> 948 <li>eliminate unused <em>p5</em> parameter.</li> 949 </ul> 950 </dd> 951 </dl> 952 953 <p>A few entries use extensions (user-defined terminal 954 capabilities):</p> 955 956 <ul> 957 <li>use <a href= 958 "/ncurses/terminfo.src.html#tic-xterm_sm_1006"><tt>xterm+sm+1006</tt></a> 959 (aka “SGR 1006 mouse”) for konsole-base and 960 putty</li> 961 962 <li>add <em><tt>Smol/Rmol</tt></em> user-defined capability to 963 <tt>tmux</tt> and <tt>vte-2018</tt></li> 964 965 <li>add <em><tt>Smulx</tt></em> user-defined capability to 966 <tt>tmux</tt>, <tt>vte-2018</tt></li> 967 </ul> 968 969 <h3><a name="h3-documentation" id= 970 "h3-documentation">Documentation</a></h3> 971 972 <p>As usual, this release</p> 973 974 <ul> 975 <li> 976 <p>improves documentation by describing new features,</p> 977 </li> 978 979 <li> 980 <p>attempts to improve the description of features which 981 users have found confusing</p> 982 </li> 983 984 <li> 985 <p>fills in overlooked descriptions of features which were 986 described in the <a href="@HOMEPAGE@/NEWS.html">NEWS</a> file 987 but treated sketchily in manual pages.</p> 988 </li> 989 </ul> 990 991 <p>In addition to providing background information to explain 992 these features and show how they evolved, there are corrections, 993 clarifications, etc.:</p> 994 995 <ul> 996 <li> 997 <p>Corrections:</p> 998 999 <ul> 1000 <li>correct error-returns listed in manual pages for a few 1001 form functions</li> 1002 1003 <li>corrected prototypes in several manpages using script 1004 to extract those in compilable form.</li> 1005 1006 <li>fix typo in <a href= 1007 "@HOMEPAGE@/man/term.5.html#h3-EXTENDED-NUMBER-FORMAT">term.5</a>, 1008 improve explanation of format</li> 1009 </ul> 1010 </li> 1011 1012 <li> 1013 <p>Clarify in manual pages that <a href= 1014 "@HOMEPAGE@/man/curs_printw.3x.html#h2-PORTABILITY">vwprintw</a> 1015 and <a href= 1016 "@HOMEPAGE@/man/curs_scanw.3x.html#h2-PORTABILITY">vwscanw</a> 1017 are obsolete.<br> 1018 They have not been part of X/Open Curses since 2007.</p> 1019 </li> 1020 1021 <li> 1022 <p>New/improved history and portability sections:</p> 1023 1024 <ul> 1025 <li><a href= 1026 "@HOMEPAGE@/man/curs_addch.3x.html#h3-ACS-Symbols">curs_addch.3x</a> 1027 gives some background for ACS symbols.</li> 1028 1029 <li><a href= 1030 "@HOMEPAGE@/man/curs_getcchar.3x.html#h2-PORTABILITY">curs_getcchar.3x</a> 1031 explains a difference between ncurses and X/Open 1032 Curses.</li> 1033 1034 <li><a href= 1035 "@HOMEPAGE@/man/curs_getstr.3x.html#h2-PORTABILITY">curs_getstr.3x</a> 1036 gives historical/portability background for the length 1037 parameter of <tt>wgetnstr</tt>.</li> 1038 1039 <li><a href= 1040 "@HOMEPAGE@/man/curs_slk.3x.html">curs_slk.3x</a> lists a 1041 few differences between SVr4 curses and X/Open Curses for 1042 soft-keys.</li> 1043 1044 <li><a href= 1045 "@HOMEPAGE@/man/curs_terminfo.3x.html">curs_terminfo.3x</a> 1046 explains that the initial implementation of terminfo in 1047 SVr2 was mostly replaced by other developers in SVr3.</li> 1048 1049 <li><a href="@HOMEPAGE@/man/infocmp.1m.html">infocmp.1</a> 1050 explains that the initial version of terminfo had no tool 1051 for decompiling descriptions. That came later, with SVr3, 1052 with a different developer.</li> 1053 1054 <li><a href="@HOMEPAGE@/man/tabs.1">tabs.1</a> tells more 1055 than you wanted to know about the tool.</li> 1056 1057 <li><a href="@HOMEPAGE@/man/tic.1m.html">tic.1</a> explains 1058 that the initial version of terminfo had a rudimentary tool 1059 (based on termcap) for compiling entries. The tool used 1060 with Unix was developed by others for SVr3.</li> 1061 1062 <li><a href="@HOMEPAGE@/man/toe.1m.html">toe.1</a> explains 1063 the origin of this tool.</li> 1064 </ul> 1065 </li> 1066 1067 <li> 1068 <p>Improvements for <a href= 1069 "@HOMEPAGE@/man/user_caps.5.html">user_caps.5</a>:</p> 1070 1071 <ul> 1072 <li>mention <tt>meml</tt>, <tt>memu</tt> and 1073 <tt>box1</tt></li> 1074 1075 <li>expanded description of <tt>XM</tt></li> 1076 1077 <li>add a clarification regarding the <tt>RGB</tt> 1078 capability.</li> 1079 1080 <li>mention user_caps.5 in the tic and infocmp manual 1081 pages.</li> 1082 </ul> 1083 </li> 1084 1085 <li> 1086 <p>Other improvements:</p> 1087 1088 <ul> 1089 <li><a href= 1090 "@HOMEPAGE@/man/curs_add_wch.3x.html#h3-Line-Graphics">curs_add_wch.3x</a> 1091 adds note about Unicode terminology for the line-drawing 1092 characters.</li> 1093 1094 <li><a href= 1095 "@HOMEPAGE@/man/curs_color.3x.html#h3-RETURN-VALUE">curs_color.3x</a> 1096 improves discussion of error returns and extensions.</li> 1097 1098 <li><a href= 1099 "@HOMEPAGE@/man/curs_mouse.3x.html">curs_mouse.3x</a> 1100 explains how the <tt>kmous</tt> and <tt>XM</tt> 1101 capabilities are used for xterm-mouse input.</li> 1102 1103 <li><a href= 1104 "@HOMEPAGE@/man/curs_refresh.3x.html#h3-wnoutrefresh_doupdate"> 1105 curs_refresh.3x</a> improves documentation regarding the 1106 virtual and physical screens.</li> 1107 1108 <li><a href= 1109 "@HOMEPAGE@/man/curs_util.3x.html">curs_util.3x</a> 1110 mentions a difference between SVr4 and X/Open Curses for 1111 <tt>unctrl.h</tt></li> 1112 1113 <li><a href= 1114 "@HOMEPAGE@/man/curs_variables.3x.html#h2-PORTABILITY">curs_variables.3x</a> 1115 improves description of the <em>init_tabs</em> capability 1116 and <tt>TABSIZE</tt> variable.</li> 1117 1118 <li><a href= 1119 "@HOMEPAGE@/man/ncurses.3x.html#h2-ALTERNATE-CONFIGURATIONS"> 1120 ncurses.3x</a> improves documentation regarding 1121 feature-test macros in curses.h</li> 1122 1123 <li><a href= 1124 "@HOMEPAGE@/man/resizeterm.3x.html#h3-resize_term">resizeterm.3x</a> 1125 about top-level windows which touch the screen's 1126 borders.</li> 1127 1128 <li><a href= 1129 "@HOMEPAGE@/man/tput.1.html#h3-Terminal-Size">tput.1</a> 1130 clarifies how <em>tput</em> determines the terminal 1131 size.</li> 1132 </ul> 1133 </li> 1134 </ul> 1135 1136 <p>There are no new manual pages (all of the manual page updates 1137 are to existing pages).</p> 1138 1139 <p>Some of the improvements are more subtle, relating to the way 1140 the information is presented. For instance, the generated 1141 terminfo.5 file uses a different table layout, allowing it to use 1142 space on wide terminals more effectively.</p> 1143 1144 <h3><a name="h3-bug-fixes" id="h3-bug-fixes">Interesting 1145 bug-fixes</a></h3> 1146 1147 <p>While there were many bugs fixed during development of ncurses 1148 6.2, only a few (the reason for this release) were both important 1149 and interesting. Most of the bug-fixes were for local issues 1150 which did not affect compatibility across releases. Since those 1151 are detailed in the NEWS file no elaboration is needed here.</p> 1152 1153 <p>The interesting bugs were in tic/infocmp's handling of 1154 user-defined capabilities. These were not recent bugs. Initially 1155 it was a simple problem:</p> 1156 1157 <ul> 1158 <li>The user-defined capabilities can be any type (boolean, 1159 number or string), but once given a type all uses of the name 1160 must conform to that type—unless some special support for 1161 a particular multi-typed name is built into ncurses.</li> 1162 1163 <li> 1164 <p>One of simpleterm's contributors copied some definitions 1165 for using <em>tmux</em>'s user-defined capabilities in 1166 <a href= 1167 "https://git.suckless.org/st/commit/06f8cf8ca87a81db15816658c40b2afcd1ad5332.html"> 1168 late in 2016</a>.</p> 1169 1170 <blockquote> 1171 <pre class="demo-name"> 1172diff --git a/st.info b/st.info 1173@@ -185,7 +185,10 @@ st| simpleterm, 1174 tsl=\E]0;, 1175 xenl, 1176 vpa=\E[%i%p1%dd, 1177- 1178+# Tmux unofficial extensions, see TERMINFO EXTENSIONS in tmux(1) 1179+ Se, 1180+ Ss, 1181+ Tc, 1182 1183 st-256color| simpleterm with 256 colors, 1184 use=st, 1185</pre> 1186 </blockquote> 1187 </li> 1188 1189 <li> 1190 <p>Later, in (referring to a version from <a href= 1191 "https://git.suckless.org/st/commit/c0882f2ed1d7a2dd0fa2efa52157e6fc6fde3652.html"> 1192 mid-2017</a>), a user asked to have it updated in 1193 ncurses.</p> 1194 </li> 1195 1196 <li> 1197 <p>However, it had an error from the change in late 2016. The 1198 terminal description made what <em>tmux</em> expected to be 1199 <strong>string</strong> actually a 1200 <strong>boolean</strong>.</p> 1201 1202 <p>Over the years, there were problems with each of 1203 simpleterm's terminal descriptions. I repaired those, and 1204 usually dealt with the problem.</p> 1205 </li> 1206 1207 <li> 1208 <p>The difference in this case was that when compiling the 1209 terminal database, <em>tic</em> may have in memory the 1210 definitions for more than one terminal description (so that 1211 it can resolve “<tt>use=</tt>” clauses). Seeing 1212 two different types for the same name, in certain situations 1213 it would incorrectly merge the symbol tables for the two 1214 terminal descriptions.</p> 1215 </li> 1216 1217 <li> 1218 <p>On simpleterm's side, their bug was finally fixed in 1219 <a href= 1220 "https://git.suckless.org/st/commit/83866428de031300eab03fbb116bcf7d2b1d4f60.html"> 1221 late 2019</a>, three years after the bug was created.</p> 1222 </li> 1223 </ul> 1224 1225 <p>For ncurses, the elapsed time to fix this bug was less than 1226 three years. Someone reported a problem with the terminal 1227 description a few weeks after releasing ncurses 6.1 (in <a href= 1228 "https://github.com/tmux/tmux/issues/1264">tmux #1264</a>), and 1229 the terminal description was updated that week (ncurses patch 1230 <a href="@HOMEPAGE@/NEWS.html#t20180224">20180224</a>):</p> 1231 1232 <blockquote> 1233 <pre class="demo-name"> 123420180224 1235 + modify _nc_resolve_uses2() to detect incompatible types when merging 1236 a "use=" clause of extended capabilities. The problem was seen in a 1237 defective terminfo integrated from simpleterm sources in 20171111, 1238 compounded by repair in 20180121. 1239 + correct Ss/Ms interchange in st-0.7 entry (tmux #1264) -TD 1240</pre> 1241 </blockquote> 1242 1243 <p>The larger part of that change added a check to prevent a 1244 simple merge of terminal descriptions where the same user-defined 1245 name was used with different types. But it raised some 1246 questions:</p> 1247 1248 <ul> 1249 <li> 1250 <p>Was there a reliable way to manage terminal descriptions 1251 which used the same extended name in different ways?</p> 1252 </li> 1253 1254 <li> 1255 <p>Should ncurses provide a registry of well-known extended 1256 names, with their types?</p> 1257 </li> 1258 </ul> 1259 1260 <p>Since the correction to <a href= 1261 "@HOMEPAGE@/ncurses.html#download_database"><tt>terminfo.src</tt></a> 1262 could have been readily adopted by packagers, there was nothing 1263 more to be done from ncurses' standpoint on that part. But 1264 improving ncurses to prevent issues like that is the reason for 1265 making a release.</p> 1266 1267 <p>Nothing more (constructive) was mentioned with regard to 1268 simpleterm. But a few problems were found in the handling of 1269 user-defined capabilities:</p> 1270 1271 <ul> 1272 <li> 1273 <p>Forward-references to user-defined capabilities in a 1274 “<tt>use=</tt>” clause did not allocate new data 1275 for each use. In <em>tic</em>, successive compilation of 1276 terminal entries could add user-defined capabilities to the 1277 wrong terminal entry.</p> 1278 1279 <p>This was not noticed before, since xterm's terminal 1280 descriptions were the main users of the feature, and almost 1281 all of the uses of the building-blocks which contained 1282 user-defined capabilities were backward-references.</p> 1283 </li> 1284 1285 <li> 1286 <p>There is one (documented) case where ncurses 6.1 supports 1287 a user-defined capability that could be any type (i.e., 1288 “RGB”). The check added in February 2018 to guard 1289 against mismatches did not handle all of the combinations 1290 needed.</p> 1291 </li> 1292 </ul> 1293 1294 <p>Both of these issues dated from the original implementation of 1295 user-defined capabilities. Fixing them does not change the 1296 terminal database, but a older <em>tic</em> without the fixes 1297 will not be able to handle terminfo sources which rely upon those 1298 fixes. Starting in June 2019, the download link for the terminfo 1299 source file was capped at that date. The development sources have 1300 an up-to-date copy of the file, for people with a legitimate need 1301 for it.</p> 1302 1303 <p>The “<tt>-c</tt>” (check) option of <em>tic</em> 1304 is not very useful if it cannot offer advice on parameters needed 1305 for user-defined capabilities. The various <em>Caps</em> files 1306 were reorganized to reduce redundancy, and in the common portion 1307 (<a href= 1308 "https://github.com/ThomasDickey/ncurses-snapshots/blob/master/include/Caps-ncurses">Caps-ncurses</a>), 1309 a registry of user-defined capabilities is provided for use by 1310 <em>tic</em>. While users can still define their own custom 1311 capabilities, <em>tic</em> will not offer any advice when their 1312 parameters do not match.</p> 1313 1314 <p>In ncurses 6.2, <em>tic</em> makes a special check to allow 1315 any type for <em>RGB</em>, but its being able to do this relies 1316 upon fixes made in the ncurses library in mid-2019.</p> 1317 1318 <h3><a name="h3-config-config" id= 1319 "h3-config-config">Configuration changes</a></h3> 1320 1321 <h4><a name="h4-config-major" id="h4-config-major">Major 1322 changes</a></h4> 1323 1324 <p>There are no major changes. Several new options were added to 1325 ease integration of packages with systems using different 1326 versions of <em>GNAT</em> and <em>ncurses</em>. Also, 1327 improvements were made to configure checks.</p> 1328 1329 <h4><a name="h4-config-options" id= 1330 "h4-config-options">Configuration options</a></h4> 1331 1332 <p>There are a few new/modified configure options:</p> 1333 1334 <dl> 1335 <dt><tt>--with-config-suffix</tt> 1336 </dt> 1337 1338 <dd> 1339 <p>helps work around a filename conflict with Debian packages 1340 versus test-packages.</p> 1341 </dd> 1342 1343 <dt><tt>--with-ada-libname</tt> 1344 </dt> 1345 1346 <dd> 1347 <p>allows one to rename the “AdaCurses” library 1348 (at least one packager prefers a lowercase name).</p> 1349 </dd> 1350 1351 <dt><tt>--with-fallbacks</tt> 1352 </dt> 1353 1354 <dd> 1355 <p>now ensures there is a value, and adds the fallback 1356 information to top-level Makefile summary.</p> 1357 </dd> 1358 1359 <dt><tt>--with-pcre2</tt> 1360 </dt> 1361 1362 <dd> 1363 <p>check for pcre-posix library to help with MinGW port.</p> 1364 </dd> 1365 1366 <dt><tt>--with-tic-path</tt> and<br></dt> 1367 1368 <dt><tt>--with-infocmp-path</tt> 1369 </dt> 1370 1371 <dd> 1372 <p>help work around problems building fallback source using 1373 pre-6.0 tic/infocmp.</p> 1374 </dd> 1375 1376 <dt><tt>--with-versioned-syms</tt> 1377 </dt> 1378 1379 <dd> 1380 <p>option value can now be a relative pathname.</p> 1381 </dd> 1382 </dl> 1383 1384 <h3><a name="h3-portability" id="h3-portability">Portability</a></h3> 1385 1386 <p>Many of the portability changes are implemented via the 1387 configure script:</p> 1388 1389 <ul> 1390 <li> 1391 <p>ignore <a href= 1392 "/ncurses/man/ncurses.3x.html#h3-TERMINFO"><tt>$TERMINFO</tt></a> 1393 as a default value in configure script if it came from the 1394 <tt>infocmp</tt> <strong><tt>-Q</tt></strong> option.</p> 1395 </li> 1396 1397 <li> 1398 <p>distinguish gcc from icc and clang when the 1399 <tt>--enable-warnings</tt> option is not used, to avoid 1400 unnecessary warnings about unrecognized inline options</p> 1401 </li> 1402 1403 <li> 1404 <p>consistently prepend new libraries as they are found 1405 during configuration, rather than relying upon the linker to 1406 resolve order dependencies of libraries.</p> 1407 </li> 1408 1409 <li> 1410 <p>modified configure scripts to reduce relinking/ranlib 1411 during library install :</p> 1412 1413 <ul> 1414 <li>use “<tt>install -p</tt>” when available, 1415 to avoid need for ranlib of static libraries.</li> 1416 1417 <li>scripts which use 1418 “<tt>--disable-relink</tt>;” add a 1-second 1419 sleep to work around tools which use whole-second 1420 timestamps, e.g., in <tt>utime</tt> rather than the actual 1421 file system resolution.</li> 1422 </ul> 1423 </li> 1424 1425 <li> 1426 <p id="getenv-check">add configure check for <a href= 1427 "#getenv-fixes"><tt>getenv</tt></a> to work around 1428 implementation shown in Emscripten which overwrites the 1429 previous return value on each call.</p> 1430 1431 <p>Use that to optionally suppress <tt>START_TRACE</tt> 1432 macro, whose call to <tt>getenv</tt> may not work 1433 properly</p> 1434 </li> 1435 1436 <li> 1437 <p>change target configure level for <tt>_XOPEN_SOURCE</tt> 1438 to 600 to address use of <tt>vsscanf</tt> and 1439 <tt>setenv</tt>.</p> 1440 </li> 1441 1442 <li> 1443 <p>reduce use of <tt>_GNU_SOURCE</tt> for current glibc where 1444 <tt>_DEFAULT_SOURCE</tt> combines with 1445 <tt>_XOPEN_SOURCE</tt></p> 1446 1447 <p>Allow for Cygwin's newlib when checking for the 1448 _DEFAULT_SOURCE symbol.</p> 1449 1450 <p>MidnightBSD is now checked for the 1451 <tt>_XOPEN_SOURCE</tt>-related definitions.</p> 1452 </li> 1453 1454 <li> 1455 <p>If the check for <tt>va_copy</tt> or <tt>__va_copy</tt> 1456 fails,</p> 1457 1458 <ul> 1459 <li>configure now tries copying the pointers for 1460 <tt>va_list</tt>, or as an array.</li> 1461 1462 <li>alternatively, it checks for 1463 <tt>__builtin_va_copy</tt>(), which could be used with AIX 1464 <tt>xlc</tt> in <em>c89</em> mode.</li> 1465 </ul> 1466 </li> 1467 1468 <li> 1469 <p>several changes to support a port to Ultrix 3.1:</p> 1470 1471 <ul> 1472 <li>check if "b" binary feature of fopen works</li> 1473 1474 <li>check for missing feature of locale.h</li> 1475 1476 <li>add fallback for strstr() in test-programs</li> 1477 1478 <li>add fallback for STDOUT_FILENO in test-programs</li> 1479 </ul> 1480 </li> 1481 1482 <li> 1483 <p>The <em>test/configure</em> script (used for <a href= 1484 "/ncurses/ncurses-examples.html"><em>ncurses-examples</em></a>) 1485 is improved:</p> 1486 1487 <ul> 1488 <li>work around non-ncurses termcap.h file, e.g., in 1489 Slackware.</li> 1490 1491 <li>check for <a href= 1492 "/ncurses/man/curs_variables.3x.html#h3-TABSIZE"><tt>TABSIZE</tt></a> 1493 variable.</li> 1494 1495 <li>checks for the X11/Intrinsic.h header, accommodate 1496 recent MacOS changes which largely emptied 1497 <tt>/usr/include</tt>.</li> 1498 </ul> 1499 </li> 1500 </ul> 1501 1502 <p>Here are some of the other portability fixes:</p> 1503 1504 <ul> 1505 <li> 1506 <p>added dummy "check" rule in top-level and test-Makefile to 1507 simplify building test-packages for ArchLinux.</p> 1508 </li> 1509 1510 <li> 1511 <p>dropped library-dependency on psapi for MinGW port, since 1512 win_driver.c defines <tt>PSAPI_VERSION</tt> to 2, making it 1513 use <tt>GetProcessImageFileName</tt> from kernel32.dll</p> 1514 </li> 1515 1516 <li> 1517 <p>made build-fixes for configuration using --program-suffix 1518 with Ada95, noticed with MacOS but applicable to other 1519 platforms without libpanelw, etc.</p> 1520 </li> 1521 1522 <li> 1523 <p>modified ncurses/Makefile.in to fix a case where 1524 Debian/testing changes to the ld --as-needed configuration 1525 broke ncurses-examples test packages.</p> 1526 </li> 1527 1528 <li> 1529 <p>used <tt>_WIN32</tt>/<tt>_WIN64</tt> in preference to 1530 <tt>__MINGW32__</tt>/<tt>__MINGW64__</tt> symbols to simplify 1531 building with Microsoft Visual C++, since the former are 1532 defined in both compiler configurations.</p> 1533 </li> 1534 </ul> 1535 1536 <hr> 1537 1538 <h2><a name="h2-features" id="h2-features">Features of 1539 <span class="main-name">ncurses</span></a></h2> 1540 1541 <p>The <span class="main-name">ncurses</span> package is fully 1542 upward-compatible with SVr4 (System V Release 4) curses:</p> 1543 1544 <ul> 1545 <li> 1546 <p>All of the SVr4 calls have been implemented (and are 1547 documented).</p> 1548 </li> 1549 1550 <li> 1551 <p><span class="main-name">ncurses</span> supports all of the 1552 for SVr4 curses features including keyboard mapping, color, 1553 forms-drawing with ACS characters, and automatic recognition 1554 of keypad and function keys.</p> 1555 </li> 1556 1557 <li> 1558 <p><span class="main-name">ncurses</span> provides these SVr4 1559 add-on libraries (not part of X/Open Curses):</p> 1560 1561 <ul> 1562 <li> 1563 <p>the panels library, supporting a stack of windows with 1564 backing store.</p> 1565 </li> 1566 1567 <li> 1568 <p>the menus library, supporting a uniform but flexible 1569 interface for menu programming.</p> 1570 </li> 1571 1572 <li> 1573 <p>the form library, supporting data collection through 1574 on-screen forms.</p> 1575 </li> 1576 </ul> 1577 </li> 1578 1579 <li> 1580 <p><span class="main-name">ncurses</span>'s terminal database 1581 is fully compatible with that used by SVr4 curses.</p> 1582 1583 <ul> 1584 <li> 1585 <p><span class="main-name">ncurses</span> supports 1586 user-defined capabilities which it can see, but which are 1587 hidden from SVr4 curses applications using the 1588 <em>same</em> terminal database.</p> 1589 </li> 1590 1591 <li> 1592 <p>It can be optionally configured to match the format 1593 used in related systems such as AIX and Tru64.</p> 1594 </li> 1595 1596 <li> 1597 <p>Alternatively, <span class="main-name">ncurses</span> 1598 can be configured to use hashed databases rather than the 1599 directory of files used by SVr4 curses.</p> 1600 </li> 1601 </ul> 1602 </li> 1603 1604 <li> 1605 <p>The <span class="main-name">ncurses</span> utilities have 1606 options to allow you to filter terminfo entries for use with 1607 less capable <em>curses</em>/<em>terminfo</em> versions such 1608 as the HP/UX and AIX ports.</p> 1609 </li> 1610 </ul> 1611 1612 <p>The <span class="main-name">ncurses</span> package also has 1613 many useful extensions over SVr4:</p> 1614 1615 <ul> 1616 <li> 1617 <p>The API is 8-bit clean and base-level conformant with the 1618 X/OPEN curses specification, XSI curses (that is, it 1619 implements all BASE level features, and most EXTENDED 1620 features). It includes many function calls not supported 1621 under SVr4 curses (but portability of all calls is documented 1622 so you can use the SVr4 subset only).</p> 1623 </li> 1624 1625 <li> 1626 <p>Unlike SVr3 curses, <span class="main-name">ncurses</span> 1627 can write to the rightmost-bottommost corner of the screen if 1628 your terminal has an insert-character capability.</p> 1629 </li> 1630 1631 <li> 1632 <p>Ada95 and C++ bindings.</p> 1633 </li> 1634 1635 <li> 1636 <p>Support for mouse event reporting with X Window xterm and 1637 FreeBSD and OS/2 console windows.</p> 1638 </li> 1639 1640 <li> 1641 <p>Extended mouse support via Alessandro Rubini's gpm 1642 package.</p> 1643 </li> 1644 1645 <li> 1646 <p>The function <code>wresize</code> allows you to resize 1647 windows, preserving their data.</p> 1648 </li> 1649 1650 <li> 1651 <p>The function <code>use_default_colors</code> allows you to 1652 use the terminal's default colors for the default color pair, 1653 achieving the effect of transparent colors.</p> 1654 </li> 1655 1656 <li> 1657 <p>The functions <code>keyok</code> and 1658 <code>define_key</code> allow you to better control the use 1659 of function keys, e.g., disabling the <span class= 1660 "main-name">ncurses</span> KEY_MOUSE, or by defining more 1661 than one control sequence to map to a given key code.</p> 1662 </li> 1663 1664 <li> 1665 <p>Support for 256-color terminals, such as modern xterm.</p> 1666 </li> 1667 1668 <li> 1669 <p>Support for 16-color terminals, such as <em>aixterm</em> 1670 and <em>modern xterm</em>.</p> 1671 </li> 1672 1673 <li> 1674 <p>Better cursor-movement optimization. The package now 1675 features a cursor-local-movement computation more efficient 1676 than either BSD's or System V's.</p> 1677 </li> 1678 1679 <li> 1680 <p>Super hardware scrolling support. The screen-update code 1681 incorporates a novel, simple, and cheap algorithm that 1682 enables it to make optimal use of hardware scrolling, 1683 line-insertion, and line-deletion for screen-line movements. 1684 This algorithm is more powerful than the 4.4BSD curses 1685 <code>quickch</code> routine.</p> 1686 </li> 1687 1688 <li> 1689 <p>Real support for terminals with the magic-cookie glitch. 1690 The screen-update code will refrain from drawing a highlight 1691 if the magic- cookie unattributed spaces required just before 1692 the beginning and after the end would step on a non-space 1693 character. It will automatically shift highlight boundaries 1694 when doing so would make it possible to draw the highlight 1695 without changing the visual appearance of the screen.</p> 1696 </li> 1697 1698 <li> 1699 <p>It is possible to generate the library with a list of 1700 pre-loaded fallback entries linked to it so that it can serve 1701 those terminal types even when no terminfo tree or termcap 1702 file is accessible (this may be useful for support of 1703 screen-oriented programs that must run in single-user 1704 mode).</p> 1705 </li> 1706 1707 <li> 1708 <p>The <a href="@HOMEPAGE@/man/tic.1m.html"><span class= 1709 "part-name">tic</span></a>/<a href= 1710 "@HOMEPAGE@/man/captoinfo.1m.html">captoinfo</a> utility 1711 provided with <span class="main-name">ncurses</span> has the 1712 ability to translate many termcaps from the XENIX, IBM and 1713 AT&T extension sets.</p> 1714 </li> 1715 1716 <li> 1717 <p>A BSD-like <a href= 1718 "@HOMEPAGE@/man/tset.1.html"><span class= 1719 "part-name">tset</span></a> utility is provided.</p> 1720 </li> 1721 1722 <li> 1723 <p>The <span class="main-name">ncurses</span> library and 1724 utilities will automatically read terminfo entries from 1725 $HOME/.terminfo if it exists, and compile to that directory 1726 if it exists and the user has no write access to the system 1727 directory. This feature makes it easier for users to have 1728 personal terminfo entries without giving up access to the 1729 system terminfo directory.</p> 1730 </li> 1731 1732 <li> 1733 <p>You may specify a path of directories to search for 1734 compiled descriptions with the environment variable 1735 TERMINFO_DIRS (this generalizes the feature provided by 1736 TERMINFO under stock System V.)</p> 1737 </li> 1738 1739 <li> 1740 <p>In terminfo source files, use capabilities may refer not 1741 just to other entries in the same source file (as in System 1742 V) but also to compiled entries in either the system terminfo 1743 directory or the user's $HOME/.terminfo directory.</p> 1744 </li> 1745 1746 <li> 1747 <p>The table-of-entries utility <a href= 1748 "@HOMEPAGE@/man/toe.1m.html"><span class= 1749 "part-name">toe</span></a> makes it easy for users to see 1750 exactly what terminal types are available on the system.</p> 1751 </li> 1752 1753 <li> 1754 <p>The library meets the XSI requirement that every macro 1755 entry point have a corresponding function which may be linked 1756 (and will be prototype-checked) if the macro definition is 1757 disabled with <code>#undef</code>.</p> 1758 </li> 1759 1760 <li> 1761 <p>Extensive documentation is provided (see the <em><a href= 1762 "@HOMEPAGE@/ncurses.faq.html#additional_reading">Additional 1763 Reading</a></em> section of the <em><a href= 1764 "@HOMEPAGE@/ncurses.faq.html"><span class= 1765 "main-name">ncurses</span> FAQ</a></em> for online 1766 documentation).</p> 1767 </li> 1768 </ul> 1769 1770 <h2><a name="h2-who-uses" id="h2-who-uses">Applications using 1771 <span class="main-name">ncurses</span></a></h2> 1772 1773 <p>The <span class="main-name">ncurses</span> distribution 1774 includes a selection of test programs (including a few games). 1775 These are available separately as <a href= 1776 "@HOMEPAGE@/ncurses-examples.html">ncurses-examples</a></p> 1777 1778 <p>The ncurses library has been tested with a wide variety of 1779 applications including:</p> 1780 1781 <blockquote> 1782 <dl> 1783 <dt><span class="part-name">aptitude</span> 1784 </dt> 1785 1786 <dd> 1787 <p>FrontEnd to Apt, the debian package manager</p> 1788 1789 <p><a href= 1790 "https://wiki.debian.org/Aptitude">https://wiki.debian.org/Aptitude</a></p> 1791 </dd> 1792 1793 <dt><span class="part-name">cdk</span> 1794 </dt> 1795 1796 <dd> 1797 <p>Curses Development Kit</p> 1798 1799 <p><a href="@WEBSITE@/cdk/">@WEBSITE@/cdk/</a><br> 1800 </p> 1801 </dd> 1802 1803 <dt><span class="part-name">ded</span> 1804 </dt> 1805 1806 <dd> 1807 <p>directory-editor</p> 1808 1809 <p><a href="@WEBSITE@/ded/">@WEBSITE@/ded/</a></p> 1810 </dd> 1811 1812 <dt><span class="part-name">dialog</span> 1813 </dt> 1814 1815 <dd> 1816 <p>the underlying application used in Slackware's setup, 1817 and the basis for similar install/configure applications on 1818 many systems.</p> 1819 1820 <p><a href="@WEBSITE@/dialog/">@WEBSITE@/dialog/</a></p> 1821 </dd> 1822 1823 <dt><span class="part-name">lynx</span> 1824 </dt> 1825 1826 <dd> 1827 <p>the text WWW browser</p> 1828 1829 <p><a href= 1830 "https://lynx.invisible-island.net/">https://lynx.invisible-island.net/</a></p> 1831 </dd> 1832 1833 <dt><span class="part-name">mutt</span> 1834 </dt> 1835 1836 <dd> 1837 <p>mail utility</p> 1838 1839 <p><a href="http://www.mutt.org/">http://www.mutt.org/</a></p> 1840 </dd> 1841 1842 <dt><span class="part-name">ncftp</span> 1843 </dt> 1844 1845 <dd> 1846 <p>file-transfer utility</p> 1847 1848 <p><a href= 1849 "https://www.ncftp.com/">https://www.ncftp.com/</a></p> 1850 </dd> 1851 1852 <dt><span class="part-name">nvi</span> 1853 </dt> 1854 1855 <dd> 1856 <p>New vi uses ncurses.</p> 1857 1858 <p><a href= 1859 "https://sites.google.com/a/bostic.com/keithbostic/vi">https://sites.google.com/a/bostic.com/keithbostic/vi</a><br> 1860 1861 </p> 1862 </dd> 1863 1864 <dt><span class="part-name">ranger</span> 1865 </dt> 1866 1867 <dd> 1868 <p>A console file manager with VI key bindings in 1869 <em>Python</em>.</p> 1870 1871 <p><a href= 1872 "https://ranger.github.io/">https://ranger.github.io/</a></p> 1873 </dd> 1874 1875 <dt><span class="part-name">tin</span> 1876 </dt> 1877 1878 <dd> 1879 <p>newsreader, supporting color, MIME</p> 1880 1881 <p><a href="http://www.tin.org/">http://www.tin.org/</a></p> 1882 </dd> 1883 1884 <dt><span class="part-name">vifm</span> 1885 </dt> 1886 1887 <dd> 1888 <p>File manager with vi like keybindings</p> 1889 1890 <p><a href="https://vifm.info/">https://vifm.info/</a></p> 1891 </dd> 1892 </dl> 1893 </blockquote> 1894 1895 <p>as well as some that use <span class= 1896 "main-name">ncurses</span> for the terminfo support alone:</p> 1897 1898 <blockquote> 1899 <dl> 1900 <dt><span class="part-name">minicom</span> 1901 </dt> 1902 1903 <dd> 1904 <p>terminal emulator for serial modem connections</p> 1905 1906 <p><a href= 1907 "https://alioth.debian.org/projects/minicom/">https://alioth.debian.org/projects/minicom/</a></p> 1908 </dd> 1909 1910 <dt><span class="part-name">mosh</span> 1911 </dt> 1912 1913 <dd> 1914 <p>a replacement for <code>ssh</code>.</p> 1915 1916 <p><a href= 1917 "https://mosh.mit.edu/">https://mosh.mit.edu/</a></p> 1918 </dd> 1919 1920 <dt><span class="part-name">tack</span> 1921 </dt> 1922 1923 <dd> 1924 <p>terminfo action checker</p> 1925 1926 <p><a href="@HOMEPAGE@/tack.html">@HOMEPAGE@/tack.html</a></p> 1927 </dd> 1928 1929 <dt><span class="part-name">tmux</span> 1930 </dt> 1931 1932 <dd> 1933 <p>terminal multiplexor</p> 1934 1935 <p><a href= 1936 "https://github.com/tmux/tmux/wiki">https://github.com/tmux/tmux/wiki</a></p> 1937 </dd> 1938 1939 <dt><span class="part-name">vile</span> 1940 </dt> 1941 1942 <dd> 1943 <p><em>vi-like-emacs</em> may be built to use the terminfo, 1944 termcap or curses interfaces.</p> 1945 1946 <p><a href="@WEBSITE@/vile/">@WEBSITE@/vile/</a></p> 1947 </dd> 1948 </dl> 1949 </blockquote> 1950 1951 <p>and finally, those which use only the termcap interface:</p> 1952 1953 <blockquote> 1954 <dl> 1955 <dt><span class="part-name">emacs</span> 1956 </dt> 1957 1958 <dd> 1959 <p>text editor</p> 1960 1961 <p><a href= 1962 "https://www.gnu.org/software/emacs/">https://www.gnu.org/software/emacs/</a></p> 1963 </dd> 1964 1965 <dt><span class="part-name">less</span> 1966 </dt> 1967 1968 <dd> 1969 <p>The most commonly used <em>pager</em> (a program that 1970 displays text files).</p> 1971 1972 <p><a href= 1973 "http://www.greenwoodsoftware.com/less/">http://www.greenwoodsoftware.com/less/</a></p> 1974 </dd> 1975 1976 <dt><span class="part-name">screen</span> 1977 </dt> 1978 1979 <dd> 1980 <p>terminal multiplexor</p> 1981 1982 <p><a href= 1983 "https://www.gnu.org/software/screen/">https://www.gnu.org/software/screen/</a></p> 1984 </dd> 1985 1986 <dt><span class="part-name">vim</span> 1987 </dt> 1988 1989 <dd> 1990 <p>text editor</p> 1991 1992 <p><a href="https://www.vim.org/">https://www.vim.org/</a></p> 1993 </dd> 1994 </dl> 1995 </blockquote> 1996 1997 <h2><a name="h2-development" id="h2-development">Development 1998 activities</a></h2> 1999 2000 <p>Zeyd Ben-Halim started <span class="main-name">ncurses</span> 2001 from a previous package pcurses, written by Pavel Curtis. Eric S. 2002 Raymond continued development. Jürgen Pfeifer wrote most of 2003 the form and menu libraries.</p> 2004 2005 <p>Ongoing development work is done by <a href= 2006 "mailto:dickey@invisible-island.net">Thomas E. Dickey</a>. Thomas 2007 E. Dickey has acted as the maintainer for the Free Software 2008 Foundation, which holds a <a href= 2009 "@HOMEPAGE@/ncurses-license.html">copyright on ncurses</a> for 2010 releases 4.2 through 6.1. Following the release of ncurses 6.1, 2011 effective as of release 6.2, copyright for ncurses reverted to 2012 Thomas E. Dickey (see the <a href= 2013 "@HOMEPAGE@/ncurses.faq.html#relicensed">ncurses FAQ</a> for 2014 additional information).</p> 2015 2016 <p>Contact the current maintainers at</p> 2017 2018 <blockquote> 2019 <a href="mailto:bug-ncurses@gnu.org">bug-ncurses@gnu.org</a> 2020 </blockquote> 2021 2022 <p>To join the ncurses mailing list, please write email to</p> 2023 2024 <blockquote> 2025 <a href= 2026 "mailto:bug-ncurses-request@gnu.org">bug-ncurses-request@gnu.org</a> 2027 </blockquote> 2028 containing the line: 2029 2030 <blockquote> 2031 <p><code>subscribe</code> 2032 <em><name>@<host.domain></em></p> 2033 </blockquote> 2034 2035 <p>This list is open to anyone interested in helping with the 2036 development and testing of this package.</p> 2037 2038 <p>Beta versions of <span class="main-name">ncurses</span> are 2039 made available at</p> 2040 2041 <blockquote> 2042 <p><a href= 2043 "ftp://ftp.invisible-island.net/ncurses/current/">ftp://ftp.invisible-island.net/ncurses/current/</a> 2044 and<br> 2045 <a href= 2046 "https://invisible-mirror.net/archives/ncurses/current/">https://invisible-mirror.net/archives/ncurses/current/</a> .</p> 2047 </blockquote> 2048 2049 <p>Patches to the current release are made available at</p> 2050 2051 <blockquote> 2052 <p><a href= 2053 "ftp://ftp.invisible-island.net/ncurses/6.1/">ftp://ftp.invisible-island.net/ncurses/6.1/</a> 2054 and<br> 2055 <a href= 2056 "https://invisible-mirror.net/archives/ncurses/6.1/">https://invisible-mirror.net/archives/ncurses/6.1/</a> .</p> 2057 </blockquote> 2058 2059 <p>There is an archive of the mailing list here:</p> 2060 2061 <blockquote> 2062 <p><a href= 2063 "http://lists.gnu.org/archive/html/bug-ncurses">http://lists.gnu.org/archive/html/bug-ncurses</a> 2064 (also <a href= 2065 "https://lists.gnu.org/archive/html/bug-ncurses">https</a>)</p> 2066 </blockquote> 2067 2068 <h2><a name="h2-this-stuff" id="h2-this-stuff">Related 2069 resources</a></h2> 2070 2071 <p>The release notes make scattered references to these pages, 2072 which may be interesting by themselves:</p> 2073 2074 <ul> 2075 <li><a href="@HOMEPAGE@/ncurses-license.html"><span class= 2076 "main-name">ncurses</span> licensing</a></li> 2077 2078 <li><a href="@HOMEPAGE@/ncurses-mapsyms.html">Symbol versioning 2079 in <span class="main-name">ncurses</span></a></li> 2080 2081 <li><a href="@HOMEPAGE@/ncurses-slang.html">Comments on 2082 <span class="main-name">ncurses</span> versus <span class= 2083 "main-name">slang</span> (S-Lang)</a></li> 2084 2085 <li><a href="@HOMEPAGE@/tack.html">tack – terminfo action 2086 checker</a></li> 2087 2088 <li><a href="@HOMEPAGE@/tctest.html">tctest – termcap 2089 library checker</a></li> 2090 2091 <li><a href= 2092 "@HOMEPAGE@/ncurses.html#download_database">Terminal 2093 Database</a></li> 2094 </ul> 2095 2096 <h2><a name="h2-other-stuff" id="h2-other-stuff">Other 2097 resources</a></h2> 2098 2099 <p>The distribution provides a newer version of the 2100 terminfo-format terminal description file once maintained by 2101 <a href="http://www.catb.org/~esr/terminfo/">Eric 2102 Raymond</a> . Unlike the older version, the termcap and 2103 terminfo data are provided in the same file, which also provides 2104 several user-definable extensions beyond the X/Open 2105 specification.</p> 2106 2107 <p>You can find lots of information on terminal-related topics 2108 not covered in the terminfo file at <a href= 2109 "http://web.archive.org/web/*/http://www.cs.utk.edu/~shuford/terminal"> 2110 Richard Shuford's archive</a> . The collection of computer 2111 manuals at <a href= 2112 "http://www.bitsavers.org/pdf/">bitsavers.org</a> has also been 2113 useful.</p> 2114 2115 <div class="nav"> 2116 <ul> 2117 <li><a href="#h2-overview">Overview</a></li> 2118 2119 <li> 2120 <a href="#h2-release-notes">Release Notes</a> 2121 2122 <ul> 2123 <li> 2124 <a href="#h3-library">Library improvements</a> 2125 2126 <ul> 2127 <li><a href="#h4-new-library">New features</a></li> 2128 2129 <li><a href="#h4-fixes-library">Other 2130 improvements</a></li> 2131 </ul> 2132 </li> 2133 2134 <li> 2135 <a href="#h3-programs">Program improvements</a> 2136 2137 <ul> 2138 <li><a href="#h4-utilities">Utilities</a></li> 2139 2140 <li><a href="#h4-examples">Examples</a></li> 2141 </ul> 2142 </li> 2143 2144 <li><a href="#h3-database">Terminal database</a></li> 2145 2146 <li><a href="#h3-documentation">Documentation</a></li> 2147 2148 <li><a href="#h3-bug-fixes">Interesting bug-fixes</a></li> 2149 2150 <li> 2151 <a href="#h3-config-config">Configuration changes</a> 2152 2153 <ul> 2154 <li><a href="#h4-config-major">Major changes</a></li> 2155 2156 <li><a href="#h4-config-options">Configuration 2157 options</a></li> 2158 </ul> 2159 </li> 2160 2161 <li><a href="#h3-portability">Portability</a></li> 2162 </ul> 2163 </li> 2164 2165 <li><a href="#h2-features">Features of <span class= 2166 "main-name">ncurses</span></a></li> 2167 2168 <li><a href="#h2-who-uses">Applications using <span class= 2169 "main-name">ncurses</span></a></li> 2170 2171 <li><a href="#h2-development">Development activities</a></li> 2172 2173 <li><a href="#h2-this-stuff">Related resources</a></li> 2174 2175 <li><a href="#h2-other-stuff">Other resources</a></li> 2176 </ul> 2177 </div> 2178</body> 2179</html> 2180