- Announcing ncurses 6.2
+ Announcing ncurses 6.3
Overview
Release Notes
- These notes are for ncurses 6.2, released February 12, 2020.
+ These notes are for ncurses 6.3, released October 21, 2021.
This release is designed to be source-compatible with ncurses 5.0
- through 6.1; providing extensions to the application binary interface
+ through 6.2; providing extensions to the application binary interface
(ABI). Although the source can still be configured to support the
ncurses 5 ABI, the reason for the release is to reflect improvements
to the ncurses 6 ABI and the supporting utility programs.
There are, of course, numerous other improvements, listed in this
announcement.
- The most important bug-fixes/improvements dealt with user-defined
- capabilities in terminal descriptions. The release notes also mention
- some other bug-fixes, but are focused on new features and improvements
- to existing features since ncurses 6.1 release.
+ The most important bug-fixes/improvements dealt with portability
+ issues. The release notes also mention some other bug-fixes, but are
+ focused on new features and improvements to existing features since
+ ncurses 6.2 release.
Library improvements
New features
- There are several new features:
- * O_EDGE_INSERT_STAY tells the form library to optionally delay
- cursor movement on a field edge/boundary
- * O_INPUT_FIELD extension to form library allows a dynamic field to
- shrink if the new limit is smaller than the current field size.
- * added exit_curses and exit_terminfo to replace internal symbols
- for leak-checking.
- * added curses_trace, to replace trace().
+ There are a few new features:
+ * A new (experimental) driver, for the Windows Terminal
+ configuration is provided.
+ * A script is provided which enables OpenBSD users to upgrade their
+ system to use ncurses 6.3 (OpenBSD developers are also invited to
+ do this).
Additionally, to improve performance other changes (and extensions)
are provided in this release:
- * mouse decoding now handles shift/control/alt logic when decoding
- xterm's 1006 mode
- * ncurses now defines a limit for wgetnstr, wgetn_wstr when length
- is negative or "too large".
- * reordered loop-limit checks in winsnstr in case the string has no
- terminating null and only the number of characters is used.
- * there is now no buffer-size limit when reading the $TERMCAP
- variable.
- * the $TERMCAP variable may be interpreted as a fallback to a
- terminfo entry
- * mvcur now decides whether to use hard-tabs, using xt, tbc and hts
- as clues.
- * extended colors are improved by modifying an internal call to
- vid_puts to pass extended color pairs e.g., from tty_update.c and
- lib_mvcur.c
- * the initialization functions now avoid relying upon persistent
- data for the result from getenv
- * scrolling is improved:
- + a limit check in newline_forces_scroll handles the case where
- the row is inside scroll-margins, but not at the end.
- + improved loop limits in _nc_scroll_window handle a case where
- the scrolled data is a pad which is taller than the window.
+ * modify lib_mouse.c to check for out-of-range button numbers,
+ convert those to position reports.
+ * add sp-funcs for erasewchar, killwchar.
Other improvements
These are revised features:
- * used "const" in some prototypes rather than NCURSES_CONST where
- X/Open Curses was updated to do this, e.g., wscanw, newterm, the
- terminfo interface. Also use "const" for consistency in the
- termcap interface, which was withdrawn by X/Open Curses in Issue 5
- (2007). As of Issue 7, X/Open Curses still lacks "const" for
- certain return values, e.g., keyname.
- * modified wbkgd and wbkgrnd to improve compatibility with SVr4
- curses, changing the way the window rendition is updated when the
- background character is modified
- * improved terminfo write/read by modifying the fourth item of the
- extended header to denote the number of valid strings in the
- extended string table (see term(5)).
- * modified the initialization checks for mouse so that the
- xterm+sm+1006 block will work with terminal descriptions not
- mentioning xterm.
+ * modify wgetnstr, wgetn_wstr to improve compatibility with SVr4
+ curses in its treatment of interrupt and quit characters
These were done to limit or ultimately deprecate features:
- * deprecated safe-sprintf, since the vsnprintf function, which does
- what was needed, was standardized long ago.
- * marked vwprintw and vwscanw as deprecated; recommend using
- vw_printw and vw_scanw, respectively.
- * added deprecation warnings for internal functions called by older
- versions of tack.
- * removed unused _nc_import_termtype2 function.
+ * mark wgetch-events feature as deprecated.
+ + prevent KEY_EVENT from appearing in curses.h unless the
+ configure option --enable-wgetch-events is used.
+ + modify MKkey_defs.sh to hide ncurses' definition of
+ KEY_EVENTS to reduce Visual Studio C++ redefinition warnings.
+ * reduce build-warnings by excluding ncurses-internals from
+ deprecation warnings.
These are improvements to existing features:
- * check parameter of set_escdelay, return ERR if negative.
- * check parameter of set_tabsize, return ERR if not greater than
- zero
- * correct a status-check in _nc_read_tic_entry() so that if reading
- a hex/b64 $TERMINFO, and the $TERM does not match, fall-through to
- the compiled-in search list.
- * amend check for repeat_char to handle a case where setlocale() was
- called after initscr
- * move macro for is_linetouched inside NCURSES_NOMACROS ifndef.
- * use _nc_copy_termtype2 rather than direct assignment in setupterm,
- in case it is called repeatedly using fallback terminfo
- descriptions
- * improve workaround for Solaris wcwidth versus line-drawing
- characters
- * add checks in repair_subwindows to keep the current position and
- scroll-margins inside the resized subwindow.
- * correct a buffer-limit in write_entry.c for systems that use
- caseless filenames.
- * improved build-time utility report_offsets:
- + add categories, e.g., "w" for wide-character, "t" for threads
- to make the report more readable. Reorganized the structures
- reported to make the categories more apparent.
- + add NCURSES_GLOBALS and NCURSES_PRESCREEN to report to show
- how similar the different libtinfo configurations are.
- * modified some header files to ensure that those include necessary
- files except for the previously-documented cases
- * added some traces in initialization to show whether a fallback
- entry is used.
- * made minor optimization to reduce calls to _nc_reserve_pairs
+ * drop symbols GCC_PRINTF and GCC_SCANF from <curses.h>, to simplify
+ use.
+ * apply gcc format attribute to prototypes which use a va_list
+ parameter rather than a "..." variable-length parameter list.
+ * modify <term.h> so that it is not necessary to include <curses.h>
+ before <term.h>.
+ * provide for wide-characters as background character in wbkgrnd
+ * improve parameter-checking for tparm, adding function _nc_tiparm()
+ to handle the most-used case, which accepts only numeric
+ parameters.
+ * use return-value from vsnprintf to reallocate as needed to allow
+ for buffers larger than the screen size.
+ * add another fflush(stdout) in _nc_flush to handle time-delays in
+ the middle of strings such as flash when the application uses
+ low-level calls rather than curses.
These are corrections to existing features:
- * fix a special case in PutAttrChar where a cell is marked as
- alternate-character set, but the terminal does not actually
- support the given graphic character. This would happen in an older
- terminal such as vt52, which lacks most line-drawing capability.
- * corrected flag for "seq" method of db 1.8.5 interface, needed by
- toe on some of the BSDs.
- * modify comparison in make_hash.c to correct a special case in
- collision handling for Caps-hpux11
- * add extended_slk_color{,_sp} symbols to the appropriate
- package/*.{map,sym} files
- * modify lib_setup to avoid calling pthread_self() without first
- verifying that the address is valid, i.e., for weak symbols
- * add a couple of broken-linker symbols to the list of versioned
- symbols to help with link-time optimization versus weak symbols.
+ * add a check to guard against repeat_char emitting digits which
+ could be interpreted as BSD-style padding when --enable-bsdpad is
+ configured.
+ * check for screen size-change in scr_init and scr_restore, in case
+ a screen dump does not match the current screen dimensions
Program improvements
Several improvements were made to the utility programs:
- clear
+ tabs
- + improved logic for clearing with the E3 extension, in case
- the terminal scrolls content onto its saved-lines before
- actually clearing the display, by clearing the saved-lines
- after clearing the display
-
- infocmp
-
- + omit filtering of "OTxx" names which are used for obsolete
- capabilities, when the output is sorted by long-names. This
- change helps when making a table of the short/long capability
- names.
+ + implement "+m" option
tic
- + added check for consistent alternate character set
- capabilities.
- + added check for paired indn/rin.
- + added check for terminals with parm_dch vs parm_ich.
- + added check for the case where setf/setb are given using
- different strings, but provide identical results to
- setaf/setab.
- + corrected check for ich1.
- + changed a too-large terminal entry from a fatal error to a
- warning.
+ + add check for duplicate "use=" clauses.
+ + add check to report instances where tparm would detect an
+ error in an expression.
+ + add user-defined capabilities from mintty to Caps-ncurses,
+ for checking consistency.
+ + improve warning when oc/op do not mention SGR 39/49 for xterm
+ compatible XT flag.
+ + improve checks for number of parameters of smglp, smgrp,
+ smgtp, and smgbp.
+ + improve "-c" option to validate the number and type of
+ parameters and compare against expected number/type before
+ deciding which set of parameter-lists to use in tparm calls.
+ + improve check for errors detected in tparm.
+ + improve format of output, to ensure that the messages contain
+ only printable text.
+ + modify to eliminate unnecessary "\" to escape ":" in terminfo
+ format.
+ + remove check that assumes that none or both parameterized and
+ non-parameterized margin-setting capabilities are present.
toe
- + ignores any hex/b64 $TERMINFO value in the list of terminfo
- databases.
-
- tset
-
- + replace check in reset command for obsolete "pt" capability
- using tbc and hts capabilities as clues
- + modify reset to allow for tabstops at intervals other than 8.
- + change reset's behavior for margins to simply clear
- soft-margins if possible, rather than clearing and then
- setting them according to the terminal's width.
+ + modify output of "toe -as" to show first description found
+ rather than the last.
+ + add a check to ensure that a "termcap file" is text rather
+ than binary.
tput
- + add "x" to getopt string so that "tput -x clear" works.
-
- Several changes were made to the generated ncurses*config scripts and
- the analogous ".pc" files to reduce differences between the
- configurations they report:
- * modified the ncurse*-config and pc-files to more closely match for
- the -I and -l options.
- * filtered out linker-specs from the --libs report.
- * amended the ncurses*-config and pc-files to take into account the
- rpath hack which differed between those files.
- * modified generated ncurses*config and ncurses.pc, ncursesw.pc,
- etc., to list helper libraries such as gpm for static linking.
+ + modify to allow multiple commands per line.
+ + improve parameter-checking by analyzing all extended string
+ capabilities, e.g., as used in the Cs and Ms capabilities of
+ the tmux description.
+ + make warning messages consistently using alias names when
+ those are used, rather than the underlying program's name.
+ + improve usage message for aliases such as clear, by
+ eliminating tput-specific portions.
+ + modify initialization to avoid opening /dev/tty for cases
+ other than reset/init, e.g., for clear.
Examples
test-packages. A few changes are more generally useful, e.g., for the
main ncurses test-program, and for analyzing traces using the
tracemunch script:
- * improve recovery from error when reading command-character in
- test/ncurses.c, showing the relevant error message and not exiting
- on EINTR.
- * improve tracemunch, by keeping track of TERMINAL* values, and if
- tracing was first turned on after initialization, attempt to show
- distinct screen, window and terminal names anyway.
- * modify tracemunch to accept filename parameters in addition to use
- as a pipe/filter.
- * update tracemunch to work with perl 5.26.2, which changed the
- rules for escaping regular expressions.
- * add some checks in tracemunch for undefined variables.
- * modify TurnOn/TurnOff macros (in lib_vidattr.c and lib_vid_attr.c)
- to avoid expansion of "CUR" in trace.
+ * add "-r" option to the dots test-programs, to help with scripting
+ a performance comparison.
+ * build-fix for test_opaque, for configurations without opaque
+ curses structs, e.g., ncurses 5.7.
+ * improve tracemunch logic for "RUN" compaction.
+ * improve tracemunch's coverage of form/menu/panel libraries.
+ * improve tracemunch's checking/reporting the type for the first
+ parameter, e.g., "WINDOW*" rather than "#1".
+ * modify tracemunch and the panel library to show readable traces
+ for panel- and user-pointers.
There are other new demo/test programs and reusable examples:
- color_content
- Demonstrate the color_content and extended_color_content
- functions.
-
- demo_tabs
- A simple demo of tabs in curses.
-
- dump_window
- A portable curses screen-dump, used to compare ncurses screen
- contents with Solaris.
-
- pair_content
- Demonstrate the pair_content and extended_pair_content
- functions.
-
- report_hashing
- Check hash-tables used for terminfo and termcap names.
-
- parse_rgb
- Sample implementation of the ncurses RGB extension from
- user_caps.5, used in picsmap and savescreen programs.
-
- A variety of improvements were made to existing programs, both new
- features as well as options added to make the set of programs more
- consistent.
- * add "-l" option to test/background, to dump screen contents in a
- form that lets different curses implementations be compared.
- * add "@" command to test/ncurses F-test, to allow rapid jump to
- different character pages.
- * added enum, regex examples to test/demo_forms
- * amend Scaled256() macro in test/picsmap.c to cover the full range
- 0..1000
- * corrected pathname used in Ada95 sample programs for explain.txt,
- to work with test-packages, and used an awk script to split the
- resulting pathname when it would be too long for a single line.
- * ignore interrupted system-call in test/ncurses's command-line,
- e.g., if the terminal were resized.
- * improved ifdef's for TABSIZE variable, to help with AIX/HPUX
- ports.
+ back_ground
+ to exercise the wide-character background functions.
+
+ move_field
+ to demonstrate move_field, and a stub for a corresponding demo
+ of dup_field.
+
+ test_tparm
+ for checking tparm changes.
Terminal database
There are several new terminal descriptions:
- alacritty, domterm, kitty, mintty, mintty-direct, ms-terminal,
- n7900, nsterm-build309, nsterm-direct, screen5, ti703, ti707,
- ti703-w, ti707-w vscode, vscode-direct, xterm-mono, xterm.js
+ absolute, att610+cvis, foot, foot-direct, hp98550-color,
+ hpterm-color2, hterm, hterm-256color, linux-s, putty+keypad,
+ putty+screen, putty-screen, screen.linux-s, scrt/securecrt,
+ tmux-direct, vt220+cvis, vt220+cvis8, vt220+pcedit, vt220+vtedit,
+ vt220-base, vt52+keypad, xterm+256color2, xterm+88color2,
+ xterm-direct16, xterm-direct256, xterm+nofkeys, and
+ xterm+nopcfkeys.
There are many changes to existing terminal descriptions. Some were
updates to several descriptions:
- * use ansi+rep in a dozen places
- * add rs1 to konsole, mlterm
- * improve several flash capabilities with trailing mandatory delays
- * drop ich1 from rxvt-basic, Eterm and mlterm to improve
- compatibility with old non-curses programs
- * add/use xterm+keypad in xterm-new
- * use xterm+sl-twm for consistency, nine places
- * improve xm example in xterm+x11mouse and xterm+sm_1006.
+ * correct use-ordering in some xterm-direct flavors
+ * fix some sgr inconsistencies in d230c, ibm6153, ibm6154,
+ ncrvt100an
+ * improve vt50h and vt52 based on DECScope manual
+ * use hp+arrows in a few places
+ * use hp+pfk-cr in a few places
+ * use vt220+cvis in st, terminology, termite since they ignore
+ blinking-cursor detail in att610+cvis
while others affected specific descriptions. These were retested, to
take into account changes by their developers:
- terminator, st
+ kitty+common, mlterm3, ms-terminal
while these are specific fixes based on reviewing documentation, user
reports, or warnings from tic:
- adds200:
-
- + fix typo
-
- gnome-256color
-
- + base entry on "gnome", not "vte", for consistency
+ aaa+dec, aaa+rv
+ correct rmacs/smacs
- interix
+ aaa+rv
+ correct sgr
- + trim unnecessary setf/setb
+ icl6404
+ correct csr
- linux-16color
+ kitty
+ use att610+cvis, xterm+tmux and ansi+enq
- + accommodate Linux console driver incompatibility introduced
- in early 2018
+ konsole-base
+ re-enable "bel"
- nsterm-256color:
+ linux2.6
+ fix pound-sign mapping in acsc
- + add nsterm-build309 to replace nsterm-256color, assigning the
- latter as an alias of nsterm, to make mouse work with
- nsterm-256color
+ linux3.0
+ modify to reflect default mapping of shift-tab by kbd 1.14
- regent40:
+ pccons
+ fill in some missing pieces, to make it comparable to the vt220
+ entry
- + renumber function-keys to match manual
+ putty
+ use vt100+fnkeys, add rep
- regent60:
-
- + add cd (clr_eos)
- + corrected acsc
- + add shifted function-keys
-
- tvi950:
-
- + added function-key definitions to agree with Televideo 950
- manual
- + corrected acsc
- + remove bogus kf0
- + add bel
-
- tvi955:
-
- + fix typo
+ screen
+ use vt100+enq
- vi200:
+ terminator
+ corrected tsl capability
- + add acsc string, including right/down-arrow
+ ti916
+ correct cup
- wy50:
+ tmux
+ change kbs to ^?
- + corrected acsc
+ vt220
+ use vt220+cvis
- wy50 and wy60:
+ vt420+lrmm
+ add smglp and smgrp
- + add shifted function-keys as kF1 to kF16
+ vt420
+ use vt420+lrmm
- xterm+x11hilite:
+ xterm-new
+ add nel
- + eliminate unused p5 parameter.
+ xterm-vt52
+ use vt52+keypad
A few entries use extensions (user-defined terminal capabilities):
- * use xterm+sm+1006 (aka "SGR 1006 mouse") for konsole-base and
- putty
- * add Smol/Rmol user-defined capability to tmux and vte-2018
- * add Smulx user-defined capability to tmux, vte-2018
+ * add shifted Linux console keys in linux+sfkeys entry for
+ screen.linux
+ * add Smulx to alacritty
+ * add kbeg to xterm+keypad to accommodate termcap applications
+ * add extensions in xterm+tmux and ecma+strikeout to ms-terminal,
+ but cancel the non-working Cr and Ms capabilities
Documentation
features and show how they evolved, there are corrections,
clarifications, etc.:
* Corrections:
- + correct error-returns listed in manual pages for a few form
- functions
- + corrected prototypes in several manpages using script to
- extract those in compilable form.
- + fix typo in term.5, improve explanation of format
- * Clarify in manual pages that vwprintw and vwscanw are obsolete.
- They have not been part of X/Open Curses since 2007.
+ + make opts extension for getcchar work as documented for
+ ncurses 6.1, adding "-g" flag to demo_new_pair to illustrate.
+ + modify tset "-q" option to refrain from modifying terminal
+ modes, to match the documentation.
* New/improved history and portability sections:
- + curs_addch.3x gives some background for ACS symbols.
- + curs_getcchar.3x explains a difference between ncurses and
- X/Open Curses.
- + curs_getstr.3x gives historical/portability background for
- the length parameter of wgetnstr.
- + curs_slk.3x lists a few differences between SVr4 curses and
- X/Open Curses for soft-keys.
- + curs_terminfo.3x explains that the initial implementation of
- terminfo in SVr2 was mostly replaced by other developers in
- SVr3.
- + infocmp.1 explains that the initial version of terminfo had
- no tool for decompiling descriptions. That came later, with
- SVr3, with a different developer.
- + tabs.1 tells more than you wanted to know about the tool.
- + tic.1 explains that the initial version of terminfo had a
- rudimentary tool (based on termcap) for compiling entries.
- The tool used with Unix was developed by others for SVr3.
- + toe.1 explains the origin of this tool.
- * Improvements for user_caps.5:
- + mention meml, memu and box1
- + expanded description of XM
- + add a clarification regarding the RGB capability.
- + mention user_caps.5 in the tic and infocmp manual pages.
+ + improve documentation for tparm and static/dynamic variables.
+ + add history note to curs_scanw.3x for <stdarg.h> and
+ <varargs.h>
+ + add history note to curs_printw.3x for <stdarg.h> and
+ <varargs.h>
+ + add portability note to ncurses.3x regarding <stdarg.h>
+ + add historical notes to tput, curses-terminfo and
+ curses-color manpages based on source-code for SVr2, SVr3 and
+ SVr4.
+ + improve history section for tset manpage based on the 1BSD
+ tarball, which preceded BSD's SCCS checkins by more than
+ three years.
* Other improvements:
- + curs_add_wch.3x adds note about Unicode terminology for the
- line-drawing characters.
- + curs_color.3x improves discussion of error returns and
- extensions.
- + curs_mouse.3x explains how the kmous and XM capabilities are
- used for xterm-mouse input.
- + curs_refresh.3x improves documentation regarding the virtual
- and physical screens.
- + curs_util.3x mentions a difference between SVr4 and X/Open
- Curses for unctrl.h
- + curs_variables.3x improves description of the init_tabs
- capability and TABSIZE variable.
- + ncurses.3x improves documentation regarding feature-test
- macros in curses.h
- + resizeterm.3x about top-level windows which touch the
- screen's borders.
- + tput.1 clarifies how tput determines the terminal size.
+ + explain in ncurses.3x that functions in the tinfo library do
+ not rely upon wide-characters.
+ + improve manual page for panel library, extending the
+ portability section as well as documenting error-returns.
+ + add section on margins to terminfo.5, adapted from X/Open
+ Curses.
+ + improve man/term.5 section on legacy storage format.
+ + add a note in terminfo.5 explaining that no-parameter strings
+ such as sgr0 or cnorm should not be used with tparm.
+ + improve description of BSD-style padding in curs_termcap.3x
+ + improve discussion of padding versus tparm and tputs in
+ man/curs_terminfo.3x
+ + add a note in manual page to explain ungetch vs unget_wch.
+ + improve description of error-returns in waddch and waddnstr
+ manual pages.
There are no new manual pages (all of the manual page updates are to
existing pages).
Some of the improvements are more subtle, relating to the way the
- information is presented. For instance, the generated terminfo.5 file
- uses a different table layout, allowing it to use space on wide
- terminals more effectively.
+ information is presented. For instance, hyphenation is suppressed in
+ the HTML files generated from manual pages because an upgrade to groff
+ gave noticeably poorer results, interfering with the process of
+ creating links between the resulting webpages.
Interesting bug-fixes
- While there were many bugs fixed during development of ncurses 6.2,
+ While there were many bugs fixed during development of ncurses 6.3,
only a few (the reason for this release) were both important and
interesting. Most of the bug-fixes were for local issues which did not
affect compatibility across releases. Since those are detailed in the
NEWS file no elaboration is needed here.
- The interesting bugs were in tic/infocmp's handling of user-defined
- capabilities. These were not recent bugs. Initially it was a simple
- problem:
- * The user-defined capabilities can be any type (boolean, number or
- string), but once given a type all uses of the name must conform
- to that type--unless some special support for a particular
- multi-typed name is built into ncurses.
- * One of simpleterm's contributors copied some definitions for using
- tmux's user-defined capabilities in late in 2016.
-
-diff --git a/st.info b/st.info
-@@ -185,7 +185,10 @@ st| simpleterm,
- tsl=\E]0;,
- xenl,
- vpa=\E[%i%p1%dd,
--
-+# Tmux unofficial extensions, see TERMINFO EXTENSIONS in tmux(1)
-+ Se,
-+ Ss,
-+ Tc,
-
- st-256color| simpleterm with 256 colors,
- use=st,
-
- * Later, in (referring to a version from mid-2017), a user asked to
- have it updated in ncurses.
- * However, it had an error from the change in late 2016. The
- terminal description made what tmux expected to be string actually
- a boolean.
- Over the years, there were problems with each of simpleterm's
- terminal descriptions. I repaired those, and usually dealt with
- the problem.
- * The difference in this case was that when compiling the terminal
- database, tic may have in memory the definitions for more than one
- terminal description (so that it can resolve "use=" clauses).
- Seeing two different types for the same name, in certain
- situations it would incorrectly merge the symbol tables for the
- two terminal descriptions.
- * On simpleterm's side, their bug was finally fixed in late 2019,
- three years after the bug was created.
-
- For ncurses, the elapsed time to fix this bug was less than three
- years. Someone reported a problem with the terminal description a few
- weeks after releasing ncurses 6.1 (in tmux #1264), and the terminal
- description was updated that week (ncurses patch 20180224):
-
-20180224
- + modify _nc_resolve_uses2() to detect incompatible types when merging
- a "use=" clause of extended capabilities. The problem was seen in a
- defective terminfo integrated from simpleterm sources in 20171111,
- compounded by repair in 20180121.
- + correct Ss/Ms interchange in st-0.7 entry (tmux #1264) -TD
-
- The larger part of that change added a check to prevent a simple merge
- of terminal descriptions where the same user-defined name was used
- with different types. But it raised some questions:
- * Was there a reliable way to manage terminal descriptions which
- used the same extended name in different ways?
- * Should ncurses provide a registry of well-known extended names,
- with their types?
-
- Since the correction to terminfo.src could have been readily adopted
- by packagers, there was nothing more to be done from ncurses'
- standpoint on that part. But improving ncurses to prevent issues like
- that is the reason for making a release.
-
- Nothing more (constructive) was mentioned with regard to simpleterm.
- But a few problems were found in the handling of user-defined
- capabilities:
- * Forward-references to user-defined capabilities in a "use=" clause
- did not allocate new data for each use. In tic, successive
- compilation of terminal entries could add user-defined
- capabilities to the wrong terminal entry.
- This was not noticed before, since xterm's terminal descriptions
- were the main users of the feature, and almost all of the uses of
- the building-blocks which contained user-defined capabilities were
- backward-references.
- * There is one (documented) case where ncurses 6.1 supports a
- user-defined capability that could be any type (i.e., "RGB"). The
- check added in February 2018 to guard against mismatches did not
- handle all of the combinations needed.
-
- Both of these issues dated from the original implementation of
- user-defined capabilities. Fixing them does not change the terminal
- database, but a older tic without the fixes will not be able to handle
- terminfo sources which rely upon those fixes. Starting in June 2019,
- the download link for the terminfo source file was capped at that
- date. The development sources have an up-to-date copy of the file, for
- people with a legitimate need for it.
-
- The "-c" (check) option of tic is not very useful if it cannot offer
- advice on parameters needed for user-defined capabilities. The various
- Caps files were reorganized to reduce redundancy, and in the common
- portion (Caps-ncurses), a registry of user-defined capabilities is
- provided for use by tic. While users can still define their own custom
- capabilities, tic will not offer any advice when their parameters do
- not match.
-
- In ncurses 6.2, tic makes a special check to allow any type for RGB,
- but its being able to do this relies upon fixes made in the ncurses
- library in mid-2019.
+ The interesting bugs were:
+ * modify wbkgd and wbkgrnd to avoid storing a null in the background
+ character, because it may be used in cases where the corresponding
+ 0x80 is not treated as a null.
+ This was a regression introduced in ncurses 6.2 (reported on the
+ mailing list), for which the workaround was to specify a blank for
+ the background character.
+ * remove output-related checks for nl/nonl (also reported on the
+ mailing list).
+ * improve tparm implementation of %P and %g, more closely matching
+ SVr4 terminfo. Those denote static and dynamic variables in
+ terminfo expressions.
+ Exactly what those terms meant was never documented before in any
+ implementation of curses, aside from source code. Unlike the other
+ two fixes, the problem was discovered while studying OpenBSD's
+ version of tset.
Configuration changes
There are a few new/modified configure options:
- --with-config-suffix
- helps work around a filename conflict with Debian packages
- versus test-packages.
+ --enable-fvisibility
+ new configure option and check for gcc -fvisibility=hidden
+ feature
- --with-ada-libname
- allows one to rename the "AdaCurses" library (at least one
- packager prefers a lowercase name).
+ --enable-leaks
+ corrected to allow turning leak-checking off later in a set of
+ options.
- --with-fallbacks
- now ensures there is a value, and adds the fallback information
- to top-level Makefile summary.
+ --enable-stdnoreturn
+ new configure option makes the _Noreturn keyword optional to
+ ease transition.
- --with-pcre2
- check for pcre-posix library to help with MinGW port.
+ --disable-pkg-ldflags
+ revised option also controls whether $LDFLAGS from the build is
+ provided in "-config" and ".pc" files.
- --with-tic-path and
+ --disable-root-access
+ add configure option which tells ncurses to disallow most
+ file-opens by setuid processes.
- --with-infocmp-path
- help work around problems building fallback source using
- pre-6.0 tic/infocmp.
+ --disable-wattr-macros
+ changed default to help packagers who reuse wide ncursesw
+ header file with non-wide ncurses library.
- --with-versioned-syms
- option value can now be a relative pathname.
+ --with-pkg-config-libdir
+ revised option uses the actual search path from pkg-config or
+ pkgconf using the output from --debug.
+
+ --with-ada-libname
+ --with-form-libname
+ --with-menu-libname
+ --with-panel-libname
+ new several --with-xxx-libname options, to help with pkgsrc
Portability
Many of the portability changes are implemented via the configure
script:
- * ignore $TERMINFO as a default value in configure script if it came
- from the infocmp -Q option.
- * distinguish gcc from icc and clang when the --enable-warnings
- option is not used, to avoid unnecessary warnings about
- unrecognized inline options
- * consistently prepend new libraries as they are found during
- configuration, rather than relying upon the linker to resolve
- order dependencies of libraries.
- * modified configure scripts to reduce relinking/ranlib during
- library install :
- + use "install -p" when available, to avoid need for ranlib of
- static libraries.
- + scripts which use "--disable-relink;" add a 1-second sleep to
- work around tools which use whole-second timestamps, e.g., in
- utime rather than the actual file system resolution.
- * add configure check for getenv to work around implementation shown
- in Emscripten which overwrites the previous return value on each
- call.
- Use that to optionally suppress START_TRACE macro, whose call to
- getenv may not work properly
- * change target configure level for _XOPEN_SOURCE to 600 to address
- use of vsscanf and setenv.
- * reduce use of _GNU_SOURCE for current glibc where _DEFAULT_SOURCE
- combines with _XOPEN_SOURCE
- Allow for Cygwin's newlib when checking for the _DEFAULT_SOURCE
- symbol.
- MidnightBSD is now checked for the _XOPEN_SOURCE-related
- definitions.
- * If the check for va_copy or __va_copy fails,
- + configure now tries copying the pointers for va_list, or as
- an array.
- + alternatively, it checks for __builtin_va_copy(), which could
- be used with AIX xlc in c89 mode.
- * several changes to support a port to Ultrix 3.1:
- + check if "b" binary feature of fopen works
- + check for missing feature of locale.h
- + add fallback for strstr() in test-programs
- + add fallback for STDOUT_FILENO in test-programs
- * The test/configure script (used for ncurses-examples) is improved:
- + work around non-ncurses termcap.h file, e.g., in Slackware.
- + check for TABSIZE variable.
- + checks for the X11/Intrinsic.h header, accommodate recent
- MacOS changes which largely emptied /usr/include.
+ * add a special case in the configure script to work around one of
+ the build-time breakages reported for OpenBSD 6 here:
+
+ https://www.mail-archive.com/bugs@openbsd.org/msg13200.html
+ * modify configure check for libtool to prevent accidental use of an
+ OpenBSD program which uses the same name.
+ * modify configuration checks for build-time tic/infocmp to use
+ AC_CHECK_TOOL. That can still be overridden by --with-tic-path and
+ --with-infocmp-path when fallbacks are used, but even if not using
+ fallbacks, the improved check may help with cross-compiling.
+ * relax modification-time comparison in CF_LINK_FUNCS to allow it to
+ accept link() function with NFS filesystems which change the mtime
+ on the link target, e.g., several BSD systems.
+ * modify configure check for c89/c99 aliases of clang to use its
+ -std option instead, because some platforms, in particular macOS,
+ do not provide workable c89/c99 aliases.
+ * modify CF_NCURSES_CONFIG to work around Xcode's c99 "-W" option,
+ which conflicts with conventional use for passing linker options.
+ * modify configure scripts to filter out redefinitions of
+ _XOPEN_SOURCE, e.g., for NetBSD which generally supports 500, but
+ 600 is needed for ncursesw.
Here are some of the other portability fixes:
- * added dummy "check" rule in top-level and test-Makefile to
- simplify building test-packages for ArchLinux.
- * dropped library-dependency on psapi for MinGW port, since
- win_driver.c defines PSAPI_VERSION to 2, making it use
- GetProcessImageFileName from kernel32.dll
- * made build-fixes for configuration using --program-suffix with
- Ada95, noticed with MacOS but applicable to other platforms
- without libpanelw, etc.
- * modified ncurses/Makefile.in to fix a case where Debian/testing
- changes to the ld --as-needed configuration broke ncurses-examples
- test packages.
- * used _WIN32/_WIN64 in preference to __MINGW32__/__MINGW64__
- symbols to simplify building with Microsoft Visual C++, since the
- former are defined in both compiler configurations.
+ * change configure-check and source-code for gcc's noreturn
+ attribute to assume it is a prefix rather than suffix, matching
+ c11's _Noreturn convention.
+ * modify mk-1st.awk to account for extra-suffix configure option.
+ * build-fix for termsort module when configured with termcap.
+ * modify configure script and makefiles to support ".PHONY" make
+ program feature.
+ * amend libtool configuration to add dependency for install.tic,
+ etc., in ncurses/Makefile on the lower-level libraries.
+ * modify Ada95 source-generation utility to write to a file given as
+ parameter rather than to the standard output, allowing builds with
+ MinGW.
+ * amend tic/infocmp check to allow for the respective tool's
+ absence.
+ * build-fixes for gnat 10.1.1, whose gnatmake drops integration with
+ gprbuild.
+ * correct configure version-check/warning for g++ to allow for 10.x
_________________________________________________________________
Features of ncurses
curses.
* The ncurses utilities have options to allow you to filter terminfo
entries for use with less capable curses/terminfo versions such as
- the HP/UX and AIX ports.
+ the HP-UX and AIX ports.
The ncurses package also has many useful extensions over SVr4:
* The API is 8-bit clean and base-level conformant with the X/OPEN
use of function keys, e.g., disabling the ncurses KEY_MOUSE, or by
defining more than one control sequence to map to a given key
code.
+ * Support for direct-color terminals, such as modern xterm.
* Support for 256-color terminals, such as modern xterm.
* Support for 16-color terminals, such as aixterm and modern xterm.
* Better cursor-movement optimization. The package now features a
* The table-of-entries utility toe makes it easy for users to see
exactly what terminal types are available on the system.
* The library meets the XSI requirement that every macro entry point
- have a corresponding function which may be linked (and will be
+ has a corresponding function which may be linked (and will be
prototype-checked) if the macro definition is disabled with
#undef.
* Extensive documentation is provided (see the Additional Reading
mosh
a replacement for ssh.
- https://mosh.mit.edu/
+ https://mosh.org/
tack
terminfo action checker
Ongoing development work is done by Thomas E. Dickey. Thomas E. Dickey
has acted as the maintainer for the Free Software Foundation, which
- holds a copyright on ncurses for releases 4.2 through 6.1. Following
+ held a copyright on ncurses for releases 4.2 through 6.1. Following
the release of ncurses 6.1, effective as of release 6.2, copyright for
ncurses reverted to Thomas E. Dickey (see the ncurses FAQ for
additional information).
Patches to the current release are made available at
- ftp://ftp.invisible-island.net/ncurses/6.1/ and
- https://invisible-mirror.net/archives/ncurses/6.1/ .
+ ftp://ftp.invisible-island.net/ncurses/6.2/ and
+ https://invisible-mirror.net/archives/ncurses/6.2/ .
There is an archive of the mailing list here:
* ncurses licensing
* Symbol versioning in ncurses
* Comments on ncurses versus slang (S-Lang)
+ * Comments on OpenBSD
* tack - terminfo action checker
* tctest - termcap library checker
* Terminal Database
-- sale, use or other dealings in this Software without prior written --
-- authorization. --
-------------------------------------------------------------------------------
--- $Id: INSTALL,v 1.234 2021/10/10 22:36:55 tom Exp $
+-- $Id: INSTALL,v 1.235 2021/10/19 23:34:17 tom Exp $
---------------------------------------------------------------------
How to install Ncurses/Terminfo on your system
---------------------------------------------------------------------
you may encounter when building a system with different versions of
ncurses:
+ 6.3 (Oct 21, 2021)
+ Interface changes:
+
+ + the definition of TERMTYPE2 is now internal, not visible in the ABI,
+ like the enclosing TERMINAL which was previously made opaque. This
+ was done to provide SCREEN-specific "static" variables in terminfo.
+
+ Added extensions:
+
+ + add sp-funcs for erasewchar, killwchar.
+
+ Added internal functions (other than "_sp" variants):
+
+ + _nc_safe_fopen and _nc_safe_open3 limit privileges if possible when
+ opening a file; otherwise disallow access for updating files.
+
+ + _nc_tiparm is a variant of tiparm which is used when all of the
+ parameters are known to be numbers rather than possibly strings.
+
+ + _nc_reset_tparm improves tic's checks by resetting the terminfo
+ "static variables" before calling functions which may update them.
+
+ Removed internal functions:
+
+ + none
+
+ Modified internal functions:
+
+ + _nc_trace_ttymode passes pointer to const data
+
+ + _nc_tparm_analyze passes pointer to int*, not int[]
+
6.2 (Feb 12, 2020)
Interface changes:
./misc/makellib
./misc/menu.def
./misc/menu.ref
+./misc/ncu2openbsd
./misc/ncurses-config.in
./misc/ncurses.def
./misc/ncurses.ref
-- sale, use or other dealings in this Software without prior written --
-- authorization. --
-------------------------------------------------------------------------------
--- $Id: NEWS,v 1.3730 2021/10/18 22:51:28 tom Exp $
+-- $Id: NEWS,v 1.3732 2021/10/20 22:49:51 tom Exp $
-------------------------------------------------------------------------------
This is a log of changes that ncurses has gone through since Zeyd started
Changes through 1.9.9e did not credit all contributions;
it is not possible to add this information.
+20211021 6.3 release for upload to ftp.gnu.org
+ + update release notes
+ + add "ncu2openbsd" script, to illustrate how to update an OpenBSD
+ system to use a current ncurses release.
+
20211018
+ check for screen size-change in scr_init() and scr_restore(), in case
a screen dump does not match the current screen dimensions (report by
-5:0:10 6.2 20211018
+5:0:10 6.3 20211021
<!--
- $Id: announce.html.in,v 1.101 2021/08/15 20:02:52 tom Exp $
+ $Id: announce.html.in,v 1.102 2021/10/20 22:41:55 tom Exp $
****************************************************************************
* Copyright 2018-2020,2021 Thomas E. Dickey *
* *
****************************************************************************
-->
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN">
-
<html>
<head>
<meta name="generator" content=
- "HTML Tidy for HTML5 for Linux version 5.2.0">
-
+ "HTML Tidy for HTML5 for Linux version 5.6.0">
<title>Announcing ncurses @VERSION@</title>
<link rel="author" href="mailto:bug-ncurses@gnu.org">
<meta http-equiv="Content-Type" content=
}
</style>
</head>
-
<body>
<h1 class="no-header">Announcing ncurses @VERSION@</h1>
Notes</a></h2>
<p>These notes are for <span class="main-name">ncurses</span>
- @VERSION@, released <strong>February 12, 2020</strong>.</p>
+ @VERSION@, released <strong>October 21, 2021</strong>.</p>
<p>This release is designed to be source-compatible with
- <span class="main-name">ncurses</span> 5.0 through 6.1; providing
+ <span class="main-name">ncurses</span> 5.0 through 6.2; providing
extensions to the application binary interface (ABI). Although
the source can still be configured to support the <span class=
"main-name">ncurses</span> 5 ABI, the reason for the release is
this announcement.</p>
<p>The most <a href="#h3-bug-fixes">important
- bug-fixes/improvements</a> dealt with user-defined capabilities
- in terminal descriptions. The release notes also mention some
- other bug-fixes, but are focused on new features and improvements
- to existing features since <span class="main-name">ncurses</span>
- 6.1 release.</p>
+ bug-fixes/improvements</a> dealt with portability issues. The
+ release notes also mention some other bug-fixes, but are focused
+ on new features and improvements to existing features since
+ <span class="main-name">ncurses</span> 6.2 release.</p>
<h3><a name="h3-library" id="h3-library">Library improvements</a></h3>
<h4><a name="h4-new-library" id="h4-new-library">New features</a></h4>
- <p>There are several new features:</p>
+ <p>There are a few new features:</p>
<ul>
<li>
- <p><a href=
- "@HOMEPAGE@/man/form_field_opts.3x.html">O_EDGE_INSERT_STAY</a>
- tells the form library to optionally delay cursor movement on
- a field edge/boundary</p>
+ <p>A new (experimental) driver, for the Windows Terminal
+ configuration is provided.</p>
</li>
<li>
- <p><a href=
- "@HOMEPAGE@/man/form_field_opts.3x.html">O_INPUT_FIELD</a>
- extension to form library allows a dynamic field to shrink if
- the new limit is smaller than the current field size.</p>
- </li>
-
- <li>
- <p>added <a href=
- "@HOMEPAGE@/man/curs_memleaks.3x.html">exit_curses</a> and
- <a href=
- "@HOMEPAGE@/man/curs_memleaks.3x.html">exit_terminfo</a> to
- replace internal symbols for leak-checking.</p>
- </li>
-
- <li>
- <p>added <a href=
- "@HOMEPAGE@/man/curs_trace.3x.html#h3-Functions">curses_trace</a>,
- to replace trace().</p>
+ <p>A script is provided which enables <a href=
+ "@HOMEPAGE@/ncurses-openbsd.html">OpenBSD</a> users to
+ upgrade their system to use ncurses 6.3 (OpenBSD developers
+ are also invited to do this).</p>
</li>
</ul>
<ul>
<li>
- <p>mouse decoding now handles shift/control/alt logic when
- decoding xterm's 1006 mode</p>
- </li>
-
- <li>
- <p>ncurses now defines a limit for <a href=
- "@HOMEPAGE@/man/curs_getstr.3x.html">wgetnstr</a>, <a href=
- "@HOMEPAGE@/man/curs_get_wstr.3x.html">wgetn_wstr</a> when
- length is negative or “too large”.</p>
- </li>
-
- <li>reordered loop-limit checks in <a href=
- "@HOMEPAGE@/man/curs_insstr.3x.html">winsnstr</a> in case the
- string has no terminating null and only the number of
- characters is used.</li>
-
- <li>
- <p>there is now no buffer-size limit when reading the
- <a href="@HOMEPAGE@/man/ncurses.3x.html#h3-TERMCAP"><tt>$TERMCAP</tt></a>
- variable.</p>
- </li>
-
- <li>
- <p>the <a href=
- "@HOMEPAGE@/man/ncurses.3x.html#h3-TERMCAP"><tt>$TERMCAP</tt></a>
- variable may be interpreted as a fallback to a terminfo
- entry</p>
- </li>
-
- <li>
- <p><a href=
- "@HOMEPAGE@/man/curs_terminfo.3x.html#h3-Output-Functions"><tt>
- mvcur</tt></a> now decides whether to use hard-tabs, using
- <strong><tt>xt</tt></strong>, <strong><tt>tbc</tt></strong>
- and <strong><tt>hts</tt></strong> as clues.</p>
- </li>
-
- <li>
- <p>extended colors are improved by modifying an internal call
- to <a href=
- "@HOMEPAGE@/man/curs_terminfo.3x.html#h3-Output-Functions"><tt>
- vid_puts</tt></a> to pass extended color pairs e.g., from
- <tt>tty_update.c</tt> and <tt>lib_mvcur.c</tt></p>
+ <p>modify lib_mouse.c to check for out-of-range button
+ numbers, convert those to position reports.</p>
</li>
<li>
- <p id="getenv-fixes">the initialization functions now avoid
- relying upon persistent data for the result from <a href=
- "#getenv-check"><tt>getenv</tt></a></p>
- </li>
-
- <li>
- <p>scrolling is improved:</p>
-
- <ul>
- <li>a limit check in <tt>newline_forces_scroll</tt> handles
- the case where the row is inside scroll-margins, but not at
- the end.</li>
-
- <li>
- <p>improved loop limits in <tt>_nc_scroll_window</tt>
- handle a case where the scrolled data is a pad which is
- taller than the window.</p>
- </li>
- </ul>
+ <p>add sp-funcs for <a href=
+ "@HOMEPAGE@/man/curs_termattrs.3x.html#h3-erasechar_-erasewchar">
+ erasewchar</a>, <a href=
+ "@HOMEPAGE@/man/curs_termattrs.3x.html#h3-killchar_-killwchar">
+ killwchar</a>.</p>
</li>
</ul>
<p>These are revised features:</p>
<ul>
- <li>
- <p>used “<tt>const</tt>” in some prototypes
- rather than <tt>NCURSES_CONST</tt> where X/Open Curses was
- updated to do this, e.g., <tt>wscanw</tt>, <tt>newterm</tt>,
- the terminfo interface. Also use “<tt>const</tt>”
- for consistency in the termcap interface, which was withdrawn
- by X/Open Curses in Issue 5 (2007). As of Issue 7, X/Open
- Curses still lacks “<tt>const</tt>” for certain
- return values, e.g., <a href=
- "@HOMEPAGE@/man/curs_util.3x.html#h3-keyname_key_name">keyname</a>.</p>
- </li>
-
- <li>
- <p>modified <a href=
- "@HOMEPAGE@/man/curs_bkgd.3x.html#h3-bkgd"><tt>wbkgd</tt></a>
- and <a href=
- "@HOMEPAGE@/man/curs_bkgrnd.3x.html#h3-bkgrnd"><tt>wbkgrnd</tt></a>
- to improve compatibility with SVr4 curses, changing the way
- the window rendition is updated when the background character
- is modified</p>
- </li>
-
- <li>
- <p>improved terminfo write/read by modifying the fourth item
- of the extended header to denote the number of valid strings
- in the extended string table (see <a href=
- "@HOMEPAGE@/man/term.5.html#h3-EXTENDED-STORAGE-FORMAT">term(5)</a>).</p>
- </li>
-
- <li>
- <p>modified the initialization checks for mouse so that the
- <a href=
- "/ncurses/terminfo.src.html#tic-xterm_sm_1006"><tt>xterm+sm+1006</tt></a>
- block will work with terminal descriptions not mentioning
- <em>xterm</em>.</p>
- </li>
+ <li>modify wgetnstr, wgetn_wstr to improve compatibility with
+ SVr4 curses in its treatment of interrupt and quit
+ characters</li>
</ul>
<p>These were done to limit or ultimately deprecate features:</p>
<ul>
<li>
- <p>deprecated <a href=
- "@HOMEPAGE@/NEWS.html#t970831">safe-sprintf</a>, since the
- <tt>vsnprintf</tt> function, which does what was needed, was
- standardized long ago.</p>
- </li>
+ <p>mark wgetch-events feature as deprecated.</p>
- <li>
- <p>marked <a href=
- "@HOMEPAGE@/man/curs_printw.3x.html#h2-PORTABILITY"><tt>vwprintw</tt></a>
- and <tt>vwscanw</tt> as deprecated; recommend using <a href=
- "@HOMEPAGE@/man/curs_printw.3x.html"><tt>vw_printw</tt></a>
- and <tt>vw_scanw</tt>, respectively.</p>
- </li>
+ <ul>
+ <li>
+ <p>prevent <tt>KEY_EVENT</tt> from appearing in
+ <tt>curses.h</tt> unless the configure option
+ <code>--enable-wgetch-events</code> is used.</p>
+ </li>
- <li>
- <p>added deprecation warnings for internal functions called
- by older versions of <a href=
- "@HOMEPAGE@/tack.html">tack</a>.</p>
+ <li>
+ <p>modify <tt>MKkey_defs.sh</tt> to hide ncurses'
+ definition of <tt>KEY_EVENTS</tt> to reduce <em>Visual
+ Studio C++</em> redefinition warnings.</p>
+ </li>
+ </ul>
</li>
<li>
- <p>removed unused <tt>_nc_import_termtype2</tt> function.</p>
+ <p>reduce build-warnings by excluding ncurses-internals from
+ deprecation warnings.</p>
</li>
</ul>
<ul>
<li>
- <p>check parameter of <a href=
- "@HOMEPAGE@/man/curs_threads.3x.html">set_escdelay</a>,
- return ERR if negative.</p>
- </li>
-
- <li>
- <p>check parameter of <a href=
- "@HOMEPAGE@/man/curs_threads.3x.html">set_tabsize</a>, return
- ERR if not greater than zero</p>
- </li>
-
- <li>
- <p>correct a status-check in _nc_read_tic_entry() so that if
- reading a hex/b64 <a href=
- "@HOMEPAGE@/man/ncurses.3x.html#h3-TERMINFO"><tt>$TERMINFO</tt></a>,
- and the <a href=
- "@HOMEPAGE@/man/ncurses.3x.html#h3-TERM"><tt>$TERM</tt></a>
- does not match, fall-through to the compiled-in search
- list.</p>
- </li>
-
- <li>
- <p>amend check for <a href=
- "@HOMEPAGE@/man/terminfo.5.html#h3-Predefined-Capabilities"><tt>
- repeat_char</tt></a> to handle a case where setlocale() was
- called after <a href=
- "@HOMEPAGE@/man/curs_initscr.3x.html"><tt>initscr</tt></a></p>
- </li>
-
- <li>
- <p>move macro for <a href=
- "@HOMEPAGE@/man/curs_touch.3x.html"><tt>is_linetouched</tt></a>
- inside <strong><tt>NCURSES_NOMACROS</tt></strong>
- <em><tt>ifndef</tt></em>.</p>
- </li>
-
- <li>
- <p>use <tt>_nc_copy_termtype2</tt> rather than direct
- assignment in <a href=
- "@HOMEPAGE@/man/curs_terminfo.3x.html#h3-Initialization">setupterm</a>,
- in case it is called repeatedly using fallback terminfo
- descriptions</p>
+ <p>drop symbols <em>GCC_PRINTF</em> and <em>GCC_SCANF</em>
+ from <curses.h>, to simplify use.</p>
</li>
<li>
- <p>improve workaround for Solaris wcwidth versus line-drawing
- characters</p>
+ <p>apply gcc format attribute to prototypes which use a
+ va_list parameter rather than a “<tt>...</tt>”
+ variable-length parameter list.</p>
</li>
<li>
- <p>add checks in <a href=
- "@HOMEPAGE@/man/resizeterm.3x.html"><tt>repair_subwindows</tt></a>
- to keep the current position and scroll-margins inside the
- resized subwindow.</p>
+ <p>modify <term.h> so that it is not necessary to
+ include <curses.h> before <term.h>.</p>
</li>
<li>
- <p>correct a buffer-limit in <tt>write_entry.c</tt> for
- systems that use caseless filenames.</p>
- </li>
-
- <li>
- <p>improved build-time utility <em>report_offsets</em>:</p>
-
- <ul>
- <li>
- <p>add categories, e.g., "w" for wide-character, "t" for
- threads to make the report more readable. Reorganized the
- structures reported to make the categories more
- apparent.</p>
- </li>
-
- <li>
- <p>add <tt>NCURSES_GLOBALS</tt> and
- <tt>NCURSES_PRESCREEN</tt> to report to show how similar
- the different <em>libtinfo</em> configurations are.</p>
- </li>
- </ul>
+ <p>provide for wide-characters as background character in
+ wbkgrnd</p>
</li>
<li>
- <p>modified some header files to ensure that those include
- necessary files except for the previously-documented
- cases</p>
+ <p>improve parameter-checking for tparm, adding function
+ _nc_tiparm() to handle the most-used case, which accepts only
+ numeric parameters.</p>
</li>
<li>
- <p>added some traces in initialization to show whether a
- fallback entry is used.</p>
+ <p>use return-value from <em>vsnprintf</em> to reallocate as
+ needed to allow for buffers larger than the screen size.</p>
</li>
<li>
- <p>made minor optimization to reduce calls to
- _nc_reserve_pairs</p>
+ <p>add another <em>fflush(stdout)</em> in <em>_nc_flush</em>
+ to handle time-delays in the middle of strings such as flash
+ when the application uses low-level calls rather than
+ curses.</p>
</li>
</ul>
<ul>
<li>
- <p>fix a special case in <tt>PutAttrChar</tt> where a cell is
- marked as alternate-character set, but the terminal does not
- actually support the given graphic character. This would
- happen in an older terminal such as <em>vt52</em>, which
- lacks most line-drawing capability.</p>
- </li>
-
- <li>
- <p>corrected flag for "seq" method of db 1.8.5 interface,
- needed by toe on some of the BSDs.</p>
- </li>
-
- <li>
- <p>modify comparison in make_hash.c to correct a special case
- in collision handling for Caps-hpux11</p>
- </li>
-
- <li>
- <p>add extended_slk_color{,_sp} symbols to the appropriate
- package/*.{map,sym} files</p>
- </li>
-
- <li>
- <p>modify lib_setup to avoid calling pthread_self() without
- first verifying that the address is valid, i.e., for weak
- symbols</p>
+ <p>add a check to guard against <em>repeat_char</em> emitting
+ digits which could be interpreted as BSD-style padding when
+ <tt>--enable-bsdpad</tt> is configured.</p>
</li>
<li>
- <p>add a couple of broken-linker symbols to the list of
- versioned symbols to help with link-time optimization versus
- weak symbols.</p>
+ <p>check for screen size-change in <a href=
+ "@HOMEPAGE@/man/curs_scr_dump.3x.html">scr_init</a> and
+ <a href=
+ "@HOMEPAGE@/man/curs_scr_dump.3x.html">scr_restore</a>, in
+ case a screen dump does not match the current screen
+ dimensions</p>
</li>
</ul>
<h3><a name="h3-programs" id="h3-programs">Program
improvements</a></h3>
- <p id="h4-utilities">Several improvements were made to the utility programs:</p>
+ <p id="h4-utilities">Several improvements were made to the
+ utility programs:</p>
<dl>
- <dt><span class="part-name">clear</span>
+ <dt><span class="part-name"><a href=
+ "@HOMEPAGE@/man/tabs.1.html">tabs</a></span>
</dt>
<dd>
<ul>
- <li>improved logic for clearing with the <em>E3</em>
- extension, in case the terminal scrolls content onto its
- saved-lines before actually clearing the display, by
- clearing the saved-lines after clearing the display</li>
+ <li>
+ <p>implement “<tt>+m</tt>” option</p>
+ </li>
</ul>
</dd>
- <dt><span class="part-name">infocmp</span>
+ <dt><span class="part-name"><a href=
+ "@HOMEPAGE@/man/tic.1m.html">tic</a></span>
</dt>
<dd>
<ul>
- <li>omit filtering of “<tt>OTxx</tt>” names
- which are used for obsolete capabilities, when the output
- is sorted by long-names. This change helps when making a
- table of the short/long capability names.</li>
- </ul>
- </dd>
+ <li>
+ <p>add check for duplicate “<tt>use=</tt>”
+ clauses.</p>
+ </li>
- <dt><span class="part-name">tic</span>
- </dt>
+ <li>
+ <p>add check to report instances where <tt>tparm</tt>
+ would detect an error in an expression.</p>
+ </li>
- <dd>
- <ul>
- <li>added check for consistent alternate character set
- capabilities.</li>
+ <li>
+ <p>add user-defined capabilities from <em>mintty</em> to
+ <tt>Caps-ncurses</tt>, for checking consistency.</p>
+ </li>
- <li>added check for paired <tt>indn</tt>/<tt>rin</tt>.</li>
+ <li>
+ <p>improve warning when oc/op do not mention SGR 39/49
+ for <em>xterm</em> compatible <code>XT</code> flag.</p>
+ </li>
- <li>added check for terminals with <tt>parm_dch</tt> vs
- <tt>parm_ich</tt>.</li>
+ <li>
+ <p>improve checks for number of parameters of
+ <code>smglp</code>, <code>smgrp</code>,
+ <code>smgtp</code>, and <code>smgbp</code>.</p>
+ </li>
- <li>added check for the case where
- <tt>setf</tt>/<tt>setb</tt> are given using different
- strings, but provide identical results to
- <tt>setaf</tt>/<tt>setab</tt>.</li>
+ <li>
+ <p>improve “<tt>-c</tt>” option to validate
+ the number and type of parameters and compare against
+ expected number/type before deciding which set of
+ parameter-lists to use in tparm calls.</p>
+ </li>
- <li>corrected check for <tt>ich1</tt>.</li>
+ <li>
+ <p>improve check for errors detected in
+ <code>tparm</code>.</p>
+ </li>
- <li>changed a too-large terminal entry from a fatal error
- to a warning.</li>
- </ul>
- </dd>
+ <li>
+ <p>improve format of output, to ensure that the messages
+ contain only printable text.</p>
+ </li>
- <dt><span class="part-name">toe</span>
- </dt>
+ <li>
+ <p>modify to eliminate unnecessary
+ “<code>\</code>” to escape
+ “<code>:</code>” in terminfo format.</p>
+ </li>
- <dd>
- <ul>
- <li>ignores any hex/b64 <tt>$TERMINFO</tt> value in the
- list of terminfo databases.</li>
+ <li>
+ <p>remove check that assumes that none or both
+ parameterized and non-parameterized margin-setting
+ capabilities are present.</p>
+ </li>
</ul>
</dd>
- <dt><span class="part-name">tset</span>
+ <dt><span class="part-name"><a href=
+ "@HOMEPAGE@/man/toe.1m.html">toe</a></span>
</dt>
<dd>
<ul>
- <li>replace check in <span class="part-name">reset</span>
- command for obsolete “<tt>pt</tt>” capability
- using <tt>tbc</tt> and <tt>hts</tt> capabilities as
- clues</li>
-
- <li>modify <span class="part-name">reset</span> to allow
- for tabstops at intervals other than 8.</li>
-
- <li>change <span class="part-name">reset</span>'s behavior
- for margins to simply clear soft-margins if possible,
- rather than clearing and then setting them according to the
- terminal's width.</li>
+ <li>
+ <p>modify output of “<tt>toe -as</tt>” to
+ show first description found rather than the last.</p>
+ </li>
+
+ <li>
+ <p>add a check to ensure that a “termcap
+ file” is text rather than binary.</p>
+ </li>
</ul>
</dd>
- <dt><span class="part-name">tput</span>
+ <dt><span class="part-name"><a href=
+ "@HOMEPAGE@/man/tput.1.html">tput</a></span>
</dt>
<dd>
<ul>
- <li>add “<tt>x</tt>” to <tt>getopt</tt> string
- so that “<tt>tput -x clear</tt>”
- works.</li>
- </ul>
- </dd>
- </dl>
-
- <p>Several changes were made to the generated ncurses*config
- scripts and the analogous “<tt>.pc</tt>” files to
- reduce differences between the configurations they report:</p>
+ <li>
+ <p>modify to allow multiple commands per line.</p>
+ </li>
- <ul>
- <li>
- <p>modified the ncurse*-config and pc-files to more closely
- match for the <tt>-I</tt> and <tt>-l</tt> options.</p>
- </li>
+ <li>
+ <p>improve parameter-checking by analyzing all extended
+ string capabilities, e.g., as used in the <code>Cs</code>
+ and <code>Ms</code> capabilities of the <em>tmux</em>
+ description.</p>
+ </li>
- <li>
- <p>filtered out linker-specs from the <tt>--libs</tt>
- report.</p>
- </li>
+ <li>
+ <p>make warning messages consistently using alias names
+ when those are used, rather than the underlying program's
+ name.</p>
+ </li>
- <li>
- <p>amended the ncurses*-config and pc-files to take into
- account the rpath hack which differed between those
- files.</p>
- </li>
+ <li>
+ <p>improve usage message for aliases such as
+ <em>clear</em>, by eliminating <em>tput</em>-specific
+ portions.</p>
+ </li>
- <li>
- <p>modified generated ncurses*config and ncurses.pc,
- ncursesw.pc, etc., to list helper libraries such as gpm for
- static linking.</p>
- </li>
- </ul>
+ <li>
+ <p>modify initialization to avoid opening
+ <tt>/dev/tty</tt> for cases other than
+ <em>reset/init</em>, e.g., for <em>clear</em>.</p>
+ </li>
+ </ul>
+ </dd>
+ </dl>
<h4><a name="h4-examples" id="h4-examples">Examples</a></h4>
<ul>
<li>
- <p>improve recovery from error when reading command-character
- in <tt>test/ncurses.c</tt>, showing the relevant error
- message and not exiting on EINTR.</p>
+ <p>add “<tt>-r</tt>” option to the <em>dots</em>
+ test-programs, to help with scripting a performance
+ comparison.</p>
</li>
<li>
- <p>improve <em>tracemunch</em>, by keeping track of
- <tt>TERMINAL*</tt> values, and if tracing was first turned on
- after initialization, attempt to show distinct screen, window
- and terminal names anyway.</p>
+ <p>build-fix for <em>test_opaque</em>, for configurations
+ without opaque curses structs, e.g., ncurses 5.7.</p>
</li>
<li>
- <p>modify <em>tracemunch</em> to accept filename parameters
- in addition to use as a pipe/filter.</p>
+ <p>improve <em>tracemunch</em> logic for "RUN"
+ compaction.</p>
</li>
<li>
- <p>update <em>tracemunch</em> to work with <em>perl
- 5.26.2</em>, which changed the rules for escaping regular
- expressions.</p>
+ <p>improve <em>tracemunch</em>'s coverage of form/menu/panel
+ libraries.</p>
</li>
<li>
- <p>add some checks in <em>tracemunch</em> for undefined
- variables.</p>
+ <p>improve <em>tracemunch</em>'s checking/reporting the type
+ for the first parameter, e.g., "WINDOW*" rather than
+ "#1".</p>
</li>
<li>
- <p>modify <tt>TurnOn</tt>/<tt>TurnOff</tt> macros (in
- lib_vidattr.c and lib_vid_attr.c) to avoid expansion of
- “<tt>CUR</tt>” in trace.</p>
+ <p>modify <em>tracemunch</em> and the panel library to show
+ readable traces for panel- and user-pointers.</p>
</li>
</ul>
examples:</p>
<dl>
- <dt><span class="part-name">color_content</span>
- </dt>
-
- <dd>Demonstrate the <tt>color_content</tt> and
- <tt>extended_color_content</tt> functions.</dd>
-
- <dt><span class="part-name">demo_tabs</span>
- </dt>
-
- <dd>A simple demo of tabs in curses.</dd>
-
- <dt><span class="part-name">dump_window</span>
- </dt>
-
- <dd>A portable curses screen-dump, used to compare ncurses
- screen contents with Solaris.</dd>
-
- <dt><span class="part-name">pair_content</span>
+ <dt><span class="part-name"><em>back_ground</em></span>
</dt>
- <dd>Demonstrate the <tt>pair_content</tt> and
- <tt>extended_pair_content</tt> functions.</dd>
+ <dd>to exercise the wide-character background functions.</dd>
- <dt><span class="part-name">report_hashing</span>
+ <dt><span class="part-name"><em>move_field</em></span>
</dt>
- <dd>Check hash-tables used for terminfo and termcap names.</dd>
+ <dd>to demonstrate <a href=
+ "@HOMEPAGE@/man/form_field.3x.html">move_field</a>, and a stub
+ for a corresponding demo of <a href=
+ "@HOMEPAGE@/man/form_field_new.3x.html">dup_field</a>.</dd>
- <dt><span class="part-name">parse_rgb</span>
+ <dt><span class="part-name"><em>test_tparm</em></span>
</dt>
- <dd>Sample implementation of the ncurses RGB extension from
- <a href="@HOMEPAGE@/man/user_caps.5.html">user_caps.5</a>, used
- in <em>picsmap</em> and <em>savescreen</em> programs.</dd>
+ <dd>for checking <em>tparm</em> changes.</dd>
</dl>
- <p>A variety of improvements were made to existing programs, both
- new features as well as options added to make the set of programs
- more consistent.</p>
-
- <ul>
- <li>
- <p>add “<tt>-l</tt>” option to test/background,
- to dump screen contents in a form that lets different curses
- implementations be compared.</p>
- </li>
-
- <li>
- <p>add “<tt>@</tt>” command to test/ncurses
- F-test, to allow rapid jump to different character pages.</p>
- </li>
-
- <li>
- <p>added enum, regex examples to test/demo_forms</p>
- </li>
-
- <li>
- <p>amend Scaled256() macro in test/picsmap.c to cover the
- full range 0..1000</p>
- </li>
-
- <li>
- <p>corrected pathname used in Ada95 sample programs for
- <tt>explain.txt</tt>, to work with test-packages, and used an
- awk script to split the resulting pathname when it would be
- too long for a single line.</p>
- </li>
-
- <li>
- <p>ignore interrupted system-call in test/ncurses's
- command-line, e.g., if the terminal were resized.</p>
- </li>
-
- <li>
- <p>improved ifdef's for <tt>TABSIZE</tt> variable, to help
- with AIX/HPUX ports.</p>
- </li>
- </ul>
-
<h3><a name="h3-database" id="h3-database">Terminal database</a></h3>
<p>There are several new terminal descriptions:</p>
<blockquote style="word-break:keep-all">
- <p><tt>alacritty</tt>, <tt>domterm</tt>, <tt>kitty</tt>,
- <tt>mintty</tt>, <tt>mintty-direct</tt>, <tt>ms-terminal</tt>,
- <tt>n7900</tt>, <tt>nsterm-build309</tt>,
- <tt>nsterm-direct</tt>, <tt>screen5</tt>, <tt>ti703</tt>,
- <tt>ti707</tt>, <tt>ti703-w</tt>, <tt>ti707-w</tt>
- <tt>vscode</tt>, <tt>vscode-direct</tt>, <tt>xterm-mono</tt>,
- <tt>xterm.js</tt></p>
+ <p><tt><a href=
+ "@HOMEPAGE@/terminfo.src.html#tic-absolute">absolute</a></tt>,
+ <tt><a href=
+ "@HOMEPAGE@/terminfo.src.html#tic-att610_cvis">att610+cvis</a></tt>,
+ <tt><a href=
+ "@HOMEPAGE@/terminfo.src.html#tic-foot">foot</a></tt>,
+ <tt><a href=
+ "@HOMEPAGE@/terminfo.src.html#tic-foot-direct">foot-direct</a></tt>,
+ <tt><a href=
+ "@HOMEPAGE@/terminfo.src.html#tic-hp98550-color">hp98550-color</a></tt>,
+ <tt><a href=
+ "@HOMEPAGE@/terminfo.src.html#tic-hpterm-color2">hpterm-color2</a></tt>,
+ <tt><a href=
+ "@HOMEPAGE@/terminfo.src.html#tic-hterm">hterm</a></tt>,
+ <tt><a href=
+ "@HOMEPAGE@/terminfo.src.html#tic-hterm-256color">hterm-256color</a></tt>,
+ <tt><a href=
+ "@HOMEPAGE@/terminfo.src.html#tic-linux-s">linux-s</a></tt>,
+ <tt><a href=
+ "@HOMEPAGE@/terminfo.src.html#tic-putty_keypad">putty+keypad</a></tt>,
+ <tt><a href=
+ "@HOMEPAGE@/terminfo.src.html#tic-putty_screen">putty+screen</a></tt>,
+ <tt><a href=
+ "@HOMEPAGE@/terminfo.src.html#tic-putty-screen">putty-screen</a></tt>,
+ <tt><a href=
+ "@HOMEPAGE@/terminfo.src.html#tic-screen.linux-s">screen.linux-s</a></tt>,
+ <tt><a href=
+ "@HOMEPAGE@/terminfo.src.html#tic-scrt/securecrt">scrt/securecrt</a></tt>,
+ <tt><a href=
+ "@HOMEPAGE@/terminfo.src.html#tic-tmux-direct">tmux-direct</a></tt>,
+ <tt><a href=
+ "@HOMEPAGE@/terminfo.src.html#tic-vt220_cvis">vt220+cvis</a></tt>,
+ <tt><a href=
+ "@HOMEPAGE@/terminfo.src.html#tic-vt220_cvis8">vt220+cvis8</a></tt>,
+ <tt><a href=
+ "@HOMEPAGE@/terminfo.src.html#tic-vt220_pcedit">vt220+pcedit</a></tt>,
+ <tt><a href=
+ "@HOMEPAGE@/terminfo.src.html#tic-vt220_vtedit">vt220+vtedit</a></tt>,
+ <tt><a href=
+ "@HOMEPAGE@/terminfo.src.html#tic-vt220-base">vt220-base</a></tt>,
+ <tt><a href=
+ "@HOMEPAGE@/terminfo.src.html#tic-vt52_keypad">vt52+keypad</a></tt>,
+ <tt><a href=
+ "@HOMEPAGE@/terminfo.src.html#tic-xterm_256color2">xterm+256color2</a></tt>,
+ <tt><a href=
+ "@HOMEPAGE@/terminfo.src.html#tic-xterm_88color2">xterm+88color2</a></tt>,
+ <tt><a href=
+ "@HOMEPAGE@/terminfo.src.html#tic-xterm-direct16">xterm-direct16</a></tt>,
+ <tt><a href=
+ "@HOMEPAGE@/terminfo.src.html#tic-xterm-direct256">xterm-direct256</a></tt>,
+ <tt><a href=
+ "@HOMEPAGE@/terminfo.src.html#tic-xterm_nofkeys">xterm+nofkeys</a></tt>,
+ and <tt><a href=
+ "@HOMEPAGE@/terminfo.src.html#tic-xterm_nopcfkeys">xterm+nopcfkeys</a></tt>.</p>
</blockquote>
<p>There are many changes to existing terminal descriptions. Some
were updates to several descriptions:</p>
<ul>
- <li>use <a href=
- "/ncurses/terminfo.src.html#tic-ansi_rep"><tt>ansi+rep</tt></a>
- in a dozen places</li>
-
- <li>add rs1 to konsole, mlterm</li>
-
- <li>improve several flash capabilities with trailing mandatory
- delays</li>
+ <li>correct use-ordering in some <a href=
+ "@HOMEPAGE@/terminfo.src.html#tic-xterm-direct">xterm-direct</a>
+ flavors</li>
+
+ <li>fix some sgr inconsistencies in <a href=
+ "@HOMEPAGE@/terminfo.src.html#tic-d230c">d230c</a>, <a href=
+ "@HOMEPAGE@/terminfo.src.html#tic-ibm6153">ibm6153</a>,
+ <a href="@HOMEPAGE@/terminfo.src.html#tic-ibm6154">ibm6154</a>,
+ <a href=
+ "@HOMEPAGE@/terminfo.src.html#tic-ncrvt100an">ncrvt100an</a></li>
- <li>drop <tt>ich1</tt> from <tt>rxvt-basic</tt>, <tt>Eterm</tt>
- and <tt>mlterm</tt> to improve compatibility with old
- non-curses programs</li>
+ <li>improve <a href=
+ "@HOMEPAGE@/terminfo.src.html#tic-vt50h">vt50h</a> and <a href=
+ "@HOMEPAGE@/terminfo.src.html#tic-vt52">vt52</a> based on
+ DECScope manual</li>
- <li>add/use <a href=
- "/ncurses/terminfo.src.html#tic-xterm_keypad"><tt>xterm+keypad</tt></a>
- in <tt>xterm-new</tt></li>
+ <li>use <a href=
+ "@HOMEPAGE@/terminfo.src.html#tic-hp_arrows">hp+arrows</a> in a
+ few places</li>
<li>use <a href=
- "/ncurses/terminfo.src.html#tic-xterm_sl-twm"><tt>xterm+sl-twm</tt></a>
- for consistency, nine places</li>
+ "@HOMEPAGE@/terminfo.src.html#tic-hp_pfk-cr">hp+pfk-cr</a> in a
+ few places</li>
- <li>improve <em>xm</em> example in <a href=
- "/ncurses/terminfo.src.html#tic-xterm_x11mouse">xterm+x11mouse</a>
- and <a href=
- "/ncurses/terminfo.src.html#tic-xterm_sm_1006">xterm+sm_1006</a>.</li>
+ <li>use <a href=
+ "@HOMEPAGE@/terminfo.src.html#tic-vt220_cvis">vt220+cvis</a> in
+ <tt>st</tt>, <tt>terminology</tt>, <tt>termite</tt> since they
+ ignore blinking-cursor detail in <a href=
+ "@HOMEPAGE@/terminfo.src.html#tic-att610_cvis">att610+cvis</a></li>
</ul>
<p>while others affected specific descriptions. These were
retested, to take into account changes by their developers:</p>
<blockquote>
- <p><tt>terminator</tt>, <tt>st</tt></p>
+ <p><tt><a href=
+ "@HOMEPAGE@/terminfo.src.html#tic-kitty_common">kitty+common</a></tt>,
+ <tt><a href=
+ "@HOMEPAGE@/terminfo.src.html#tic-mlterm3">mlterm3</a></tt>,
+ <tt><a href=
+ "@HOMEPAGE@/terminfo.src.html#tic-ms-terminal">ms-terminal</a></tt></p>
</blockquote>
<p>while these are specific fixes based on reviewing
<dl>
<dt><a href=
- "/ncurses/terminfo.src.html#tic-adds200">adds200</a>:</dt>
+ "@HOMEPAGE@/terminfo.src.html#tic-aaa_dec">aaa+dec</a>,
+ aaa+rv</dt>
- <dd>
- <ul>
- <li>fix typo</li>
- </ul>
- </dd>
+ <dd>correct rmacs/smacs</dd>
<dt><a href=
- "/ncurses/terminfo.src.html#tic-gnome-256color">gnome-256color</a>
+ "@HOMEPAGE@/terminfo.src.html#tic-aaa_rv">aaa+rv</a>
</dt>
- <dd>
- <ul>
- <li>base entry on "gnome", not "vte", for consistency</li>
- </ul>
- </dd>
+ <dd>correct sgr</dd>
<dt><a href=
- "/ncurses/terminfo.src.html#tic-interix">interix</a>
+ "@HOMEPAGE@/terminfo.src.html#tic-icl6404">icl6404</a>
</dt>
- <dd>
- <ul>
- <li>trim unnecessary setf/setb</li>
- </ul>
- </dd>
+ <dd>correct csr</dd>
+
+ <dt><a href="@HOMEPAGE@/terminfo.src.html#tic-kitty">kitty</a>
+ </dt>
+
+ <dd>use att610+cvis, xterm+tmux and ansi+enq</dd>
<dt><a href=
- "/ncurses/terminfo.src.html#tic-linux-16color">linux-16color</a>
+ "@HOMEPAGE@/terminfo.src.html#tic-konsole-base">konsole-base</a>
</dt>
- <dd>
- <ul>
- <li>accommodate <a href=
- "https://lists.gnu.org/archive/html/bug-ncurses/2019-10/msg00061.html">
- Linux console driver</a> incompatibility introduced in
- early 2018</li>
- </ul>
- </dd>
+ <dd>re-enable "bel"</dd>
<dt><a href=
- "/ncurses/terminfo.src.html#tic-nsterm-256color">nsterm-256color</a>:</dt>
+ "@HOMEPAGE@/terminfo.src.html#tic-linux2.6">linux2.6</a>
+ </dt>
- <dd>
- <ul>
- <li>add nsterm-build309 to replace nsterm-256color,
- assigning the latter as an alias of nsterm, to make mouse
- work with nsterm-256color</li>
- </ul>
- </dd>
+ <dd>fix pound-sign mapping in acsc</dd>
<dt><a href=
- "/ncurses/terminfo.src.html#tic-regent40">regent40</a>:</dt>
+ "@HOMEPAGE@/terminfo.src.html#tic-linux3.0">linux3.0</a>
+ </dt>
- <dd>
- <ul>
- <li>renumber function-keys to match manual</li>
- </ul>
- </dd>
+ <dd>modify to reflect default mapping of shift-tab by kbd
+ 1.14</dd>
<dt><a href=
- "/ncurses/terminfo.src.html#tic-regent60">regent60</a>:</dt>
+ "@HOMEPAGE@/terminfo.src.html#tic-pccons">pccons</a>
+ </dt>
- <dd>
- <ul>
- <li>add cd (clr_eos)</li>
+ <dd>fill in some missing pieces, to make it comparable to the
+ vt220 entry</dd>
- <li>corrected acsc</li>
+ <dt><a href="@HOMEPAGE@/terminfo.src.html#tic-putty">putty</a>
+ </dt>
- <li>add shifted function-keys</li>
- </ul>
- </dd>
+ <dd>use vt100+fnkeys, add rep</dd>
<dt><a href=
- "/ncurses/terminfo.src.html#tic-tvi950">tvi950</a>:</dt>
+ "@HOMEPAGE@/terminfo.src.html#tic-screen">screen</a>
+ </dt>
- <dd>
- <ul>
- <li>added function-key definitions to agree with Televideo
- 950 manual</li>
+ <dd>use vt100+enq</dd>
- <li>corrected acsc</li>
+ <dt><a href=
+ "@HOMEPAGE@/terminfo.src.html#tic-terminator">terminator</a>
+ </dt>
- <li>remove bogus kf0</li>
+ <dd>corrected tsl capability</dd>
- <li>add bel</li>
- </ul>
- </dd>
+ <dt><a href="@HOMEPAGE@/terminfo.src.html#tic-ti916">ti916</a>
+ </dt>
- <dt><a href=
- "/ncurses/terminfo.src.html#tic-tvi955">tvi955</a>:</dt>
+ <dd>correct cup</dd>
- <dd>
- <ul>
- <li>fix typo</li>
- </ul>
- </dd>
+ <dt><a href="@HOMEPAGE@/terminfo.src.html#tic-tmux">tmux</a>
+ </dt>
- <dt><a href=
- "/ncurses/terminfo.src.html#tic-vi200">vi200</a>:</dt>
+ <dd>change kbs to ^?</dd>
- <dd>
- <ul>
- <li>add acsc string, including right/down-arrow</li>
- </ul>
- </dd>
+ <dt><a href="@HOMEPAGE@/terminfo.src.html#tic-vt220">vt220</a>
+ </dt>
+
+ <dd>use vt220+cvis</dd>
<dt><a href=
- "/ncurses/terminfo.src.html#tic-wy50">wy50</a>:</dt>
+ "@HOMEPAGE@/terminfo.src.html#tic-vt420_lrmm">vt420+lrmm</a>
+ </dt>
- <dd>
- <ul>
- <li>corrected acsc</li>
- </ul>
- </dd>
+ <dd>add smglp and smgrp</dd>
- <dt><a href="/ncurses/terminfo.src.html#tic-wy50">wy50</a> and
- <a href="/ncurses/terminfo.src.html#tic-wy60">wy60</a>:</dt>
+ <dt><a href="@HOMEPAGE@/terminfo.src.html#tic-vt420">vt420</a>
+ </dt>
- <dd>
- <ul>
- <li>add shifted function-keys as kF1 to kF16</li>
- </ul>
- </dd>
+ <dd>use vt420+lrmm</dd>
<dt><a href=
- "/ncurses/terminfo.src.html#tic-xterm_x11hilite">xterm+x11hilite</a>:</dt>
+ "@HOMEPAGE@/terminfo.src.html#tic-xterm-new">xterm-new</a>
+ </dt>
- <dd>
- <ul>
- <li>eliminate unused <em>p5</em> parameter.</li>
- </ul>
- </dd>
+ <dd>add nel</dd>
+
+ <dt><a href=
+ "@HOMEPAGE@/terminfo.src.html#tic-xterm-vt52">xterm-vt52</a>
+ </dt>
+
+ <dd>use vt52+keypad</dd>
</dl>
<p>A few entries use extensions (user-defined terminal
capabilities):</p>
<ul>
- <li>use <a href=
- "/ncurses/terminfo.src.html#tic-xterm_sm_1006"><tt>xterm+sm+1006</tt></a>
- (aka “SGR 1006 mouse”) for konsole-base and
- putty</li>
+ <li>add shifted Linux console keys in <a href=
+ "@HOMEPAGE@/terminfo.src.html#tic-linux_sfkeys">linux+sfkeys</a>
+ entry for <a href=
+ "@HOMEPAGE@/terminfo.src.html#tic-screen.linux">screen.linux</a></li>
- <li>add <em><tt>Smol/Rmol</tt></em> user-defined capability to
- <tt>tmux</tt> and <tt>vte-2018</tt></li>
+ <li>add Smulx to <a href=
+ "@HOMEPAGE@/terminfo.src.html#tic-alacritty">alacritty</a></li>
- <li>add <em><tt>Smulx</tt></em> user-defined capability to
- <tt>tmux</tt>, <tt>vte-2018</tt></li>
+ <li>add kbeg to <a href=
+ "@HOMEPAGE@/terminfo.src.html#tic-xterm_keypad">xterm+keypad</a>
+ to accommodate termcap applications</li>
+
+ <li>add extensions in <a href=
+ "@HOMEPAGE@/terminfo.src.html#tic-xterm_tmux">xterm+tmux</a>
+ and <a href=
+ "@HOMEPAGE@/terminfo.src.html#tic-ecma_strikeout">ecma+strikeout</a>
+ to <a href=
+ "@HOMEPAGE@/terminfo.src.html#tic-ms-terminal">ms-terminal</a>,
+ but cancel the non-working Cr and Ms capabilities</li>
</ul>
<h3><a name="h3-documentation" id=
<p>Corrections:</p>
<ul>
- <li>correct error-returns listed in manual pages for a few
- form functions</li>
-
- <li>corrected prototypes in several manpages using script
- to extract those in compilable form.</li>
+ <li>
+ <p>make <em>opts</em> extension for <a href=
+ "@HOMEPAGE@/man/curs_getcchar.3x.html#h3-getcchar"><tt>getcchar</tt></a>
+ work as documented for <a href=
+ "@HOMEPAGE@/announce-6.1.htmll#h4-new-library">ncurses
+ 6.1</a>, adding “<tt>-g</tt>” flag to
+ <em>demo_new_pair</em> to illustrate.</p>
+ </li>
- <li>fix typo in <a href=
- "@HOMEPAGE@/man/term.5.html#h3-EXTENDED-NUMBER-FORMAT">term.5</a>,
- improve explanation of format</li>
+ <li>
+ <p>modify <a href="@HOMEPAGE@/man/tset.1.html">tset</a>
+ “-q” option to refrain from modifying
+ terminal modes, to match the documentation.</p>
+ </li>
</ul>
</li>
- <li>
- <p>Clarify in manual pages that <a href=
- "@HOMEPAGE@/man/curs_printw.3x.html#h2-PORTABILITY">vwprintw</a>
- and <a href=
- "@HOMEPAGE@/man/curs_scanw.3x.html#h2-PORTABILITY">vwscanw</a>
- are obsolete.<br>
- They have not been part of X/Open Curses since 2007.</p>
- </li>
-
<li>
<p>New/improved history and portability sections:</p>
<ul>
- <li><a href=
- "@HOMEPAGE@/man/curs_addch.3x.html#h3-ACS-Symbols">curs_addch.3x</a>
- gives some background for ACS symbols.</li>
-
- <li><a href=
- "@HOMEPAGE@/man/curs_getcchar.3x.html#h2-PORTABILITY">curs_getcchar.3x</a>
- explains a difference between ncurses and X/Open
- Curses.</li>
-
- <li><a href=
- "@HOMEPAGE@/man/curs_getstr.3x.html#h2-PORTABILITY">curs_getstr.3x</a>
- gives historical/portability background for the length
- parameter of <tt>wgetnstr</tt>.</li>
-
- <li><a href=
- "@HOMEPAGE@/man/curs_slk.3x.html">curs_slk.3x</a> lists a
- few differences between SVr4 curses and X/Open Curses for
- soft-keys.</li>
-
- <li><a href=
- "@HOMEPAGE@/man/curs_terminfo.3x.html">curs_terminfo.3x</a>
- explains that the initial implementation of terminfo in
- SVr2 was mostly replaced by other developers in SVr3.</li>
-
- <li><a href="@HOMEPAGE@/man/infocmp.1m.html">infocmp.1</a>
- explains that the initial version of terminfo had no tool
- for decompiling descriptions. That came later, with SVr3,
- with a different developer.</li>
-
- <li><a href="@HOMEPAGE@/man/tabs.1.html">tabs.1</a> tells more
- than you wanted to know about the tool.</li>
-
- <li><a href="@HOMEPAGE@/man/tic.1m.html">tic.1</a> explains
- that the initial version of terminfo had a rudimentary tool
- (based on termcap) for compiling entries. The tool used
- with Unix was developed by others for SVr3.</li>
-
- <li><a href="@HOMEPAGE@/man/toe.1m.html">toe.1</a> explains
- the origin of this tool.</li>
- </ul>
- </li>
+ <li>
+ <p>improve documentation for <a href=
+ "@HOMEPAGE@/man/terminfo.5.html#h3-Parameterized-Strings">
+ tparm</a> and static/dynamic variables.</p>
+ </li>
- <li>
- <p>Improvements for <a href=
- "@HOMEPAGE@/man/user_caps.5.html">user_caps.5</a>:</p>
+ <li>
+ <p>add history note to <a href=
+ "@HOMEPAGE@/man/curs_scanw.3x.html#h2-HISTORY">curs_scanw.3x</a>
+ for <stdarg.h> and <varargs.h></p>
+ </li>
- <ul>
- <li>mention <tt>meml</tt>, <tt>memu</tt> and
- <tt>box1</tt></li>
+ <li>
+ <p>add history note to <a href=
+ "@HOMEPAGE@/man/curs_printw.3x.html#h2-HISTORY">curs_printw.3x</a>
+ for <stdarg.h> and <varargs.h></p>
+ </li>
- <li>expanded description of <tt>XM</tt></li>
+ <li>
+ <p>add portability note to <a href=
+ "@HOMEPAGE@/man/ncurses.3x.html#h3-Header-files">ncurses.3x</a>
+ regarding <stdarg.h></p>
+ </li>
- <li>add a clarification regarding the <tt>RGB</tt>
- capability.</li>
+ <li>
+ <p>add historical notes to <a href=
+ "@HOMEPAGE@/man/tput.1.html#h2-HISTORY">tput</a>,
+ <a href="@HOMEPAGE@/man/curs_terminfo.3x.html#h2-HISTORY">
+ curses-terminfo</a> and <a href=
+ "@HOMEPAGE@/man/curs_color.3x.html#h2-HISTORY">curses-color</a>
+ manpages based on source-code for SVr2, SVr3 and
+ SVr4.</p>
+ </li>
- <li>mention user_caps.5 in the tic and infocmp manual
- pages.</li>
+ <li>
+ <p>improve history section for <a href=
+ "@HOMEPAGE@/man/tset.1.html#h2-HISTORY">tset</a> manpage
+ based on the 1BSD tarball, which preceded BSD's SCCS
+ checkins by more than three years.</p>
+ </li>
</ul>
</li>
<p>Other improvements:</p>
<ul>
- <li><a href=
- "@HOMEPAGE@/man/curs_add_wch.3x.html#h3-Line-Graphics">curs_add_wch.3x</a>
- adds note about Unicode terminology for the line-drawing
- characters.</li>
-
- <li><a href=
- "@HOMEPAGE@/man/curs_color.3x.html#h2-RETURN-VALUE">curs_color.3x</a>
- improves discussion of error returns and extensions.</li>
-
- <li><a href=
- "@HOMEPAGE@/man/curs_mouse.3x.html">curs_mouse.3x</a>
- explains how the <tt>kmous</tt> and <tt>XM</tt>
- capabilities are used for xterm-mouse input.</li>
-
- <li><a href=
- "@HOMEPAGE@/man/curs_refresh.3x.html#h3-wnoutrefresh_doupdate">
- curs_refresh.3x</a> improves documentation regarding the
- virtual and physical screens.</li>
-
- <li><a href=
- "@HOMEPAGE@/man/curs_util.3x.html">curs_util.3x</a>
- mentions a difference between SVr4 and X/Open Curses for
- <tt>unctrl.h</tt></li>
-
- <li><a href=
- "@HOMEPAGE@/man/curs_variables.3x.html#h2-PORTABILITY">curs_variables.3x</a>
- improves description of the <em>init_tabs</em> capability
- and <tt>TABSIZE</tt> variable.</li>
-
- <li><a href=
- "@HOMEPAGE@/man/ncurses.3x.html#h2-ALTERNATE-CONFIGURATIONS">
- ncurses.3x</a> improves documentation regarding
- feature-test macros in curses.h</li>
-
- <li><a href=
- "@HOMEPAGE@/man/resizeterm.3x.html#h3-resize_term">resizeterm.3x</a>
- about top-level windows which touch the screen's
- borders.</li>
-
- <li><a href=
- "@HOMEPAGE@/man/tput.1.html#h3-Terminal-Size">tput.1</a>
- clarifies how <em>tput</em> determines the terminal
- size.</li>
+ <li>
+ <p>explain in <a href=
+ "@HOMEPAGE@/man/ncurses.3x.html#h2-ALTERNATE-CONFIGURATIONS">
+ ncurses.3x</a> that functions in the tinfo library do not
+ rely upon wide-characters.</p>
+ </li>
+
+ <li>
+ <p>improve manual page for <a href=
+ "@HOMEPAGE@/man/panel.3x.html#h2-PORTABILITY">panel</a>
+ library, extending the portability section as well as
+ documenting error-returns.</p>
+ </li>
+
+ <li>
+ <p>add section on margins to <a href=
+ "@HOMEPAGE@/man/terminfo.5.html#h3-Margins">terminfo.5</a>,
+ adapted from X/Open Curses.</p>
+ </li>
+
+ <li>
+ <p>improve <a href=
+ "@HOMEPAGE@/man/term.5.html#h3-LEGACY-STORAGE-FORMAT">man/term.5</a>
+ section on legacy storage format.</p>
+ </li>
+
+ <li>
+ <p>add a note in <a href=
+ "@HOMEPAGE@/man/terminfo.5.html#h3-Predefined-Capabilities">
+ terminfo.5</a> explaining that no-parameter strings such
+ as <em><tt>sgr0</tt></em> or <em><tt>cnorm</tt></em>
+ should not be used with tparm.</p>
+ </li>
+
+ <li>
+ <p>improve description of BSD-style padding in <a href=
+ "@HOMEPAGE@/man/curs_termcap.3x.html#h2-BUGS">curs_termcap.3x</a></p>
+ </li>
+
+ <li>
+ <p>improve discussion of padding versus <tt>tparm</tt>
+ and <tt>tputs</tt> in <a href=
+ "@HOMEPAGE@/man/curs_terminfo.3x.html#h3-Formatting-Output">
+ man/curs_terminfo.3x</a></p>
+ </li>
+
+ <li>
+ <p>add a note in manual page to explain <a href=
+ "@HOMEPAGE@/man/curs_getch.3x.html#h3-Ungetting-characters">
+ ungetch</a> vs <a href=
+ "@HOMEPAGE@/man/curs_get_wch.3x.html#h3-unget_wch">unget_wch</a>.</p>
+ </li>
+
+ <li>
+ <p>improve description of error-returns in <a href=
+ "@HOMEPAGE@/man/curs_addch.3x.html#h2-RETURN-VALUE">waddch</a>
+ and <a href=
+ "@HOMEPAGE@/man/curs_addstr.3x.html#h2-RETURN-VALUE">waddnstr</a>
+ manual pages.</p>
+ </li>
</ul>
</li>
</ul>
are to existing pages).</p>
<p>Some of the improvements are more subtle, relating to the way
- the information is presented. For instance, the generated
- terminfo.5 file uses a different table layout, allowing it to use
- space on wide terminals more effectively.</p>
+ the information is presented. For instance, hyphenation is
+ suppressed in the HTML files generated from manual pages because
+ an upgrade to <em>groff</em> gave noticeably poorer results,
+ interfering with the process of creating links between the
+ resulting webpages.</p>
<h3><a name="h3-bug-fixes" id="h3-bug-fixes">Interesting
bug-fixes</a></h3>
<p>While there were many bugs fixed during development of ncurses
- 6.2, only a few (the reason for this release) were both important
+ 6.3, only a few (the reason for this release) were both important
and interesting. Most of the bug-fixes were for local issues
which did not affect compatibility across releases. Since those
- are detailed in the NEWS file no elaboration is needed here.</p>
+ are detailed in the <a href=
+ "@HOMEPAGE@/NEWS.html#t20211018">NEWS</a> file no elaboration is
+ needed here.</p>
- <p>The interesting bugs were in tic/infocmp's handling of
- user-defined capabilities. These were not recent bugs. Initially
- it was a simple problem:</p>
+ <p>The interesting bugs were:</p>
<ul>
- <li>The user-defined capabilities can be any type (boolean,
- number or string), but once given a type all uses of the name
- must conform to that type—unless some special support for
- a particular multi-typed name is built into ncurses.</li>
-
<li>
- <p>One of simpleterm's contributors copied some definitions
- for using <em>tmux</em>'s user-defined capabilities in
+ <p>modify <a href=
+ "@HOMEPAGE@/man/curs_bkgd.3x.html#h3-bkgd">wbkgd</a> and
<a href=
- "https://git.suckless.org/st/commit/06f8cf8ca87a81db15816658c40b2afcd1ad5332.html">
- late in 2016</a>.</p>
-
- <blockquote>
- <pre class="demo-name">
-diff --git a/st.info b/st.info
-@@ -185,7 +185,10 @@ st| simpleterm,
- tsl=\E]0;,
- xenl,
- vpa=\E[%i%p1%dd,
--
-+# Tmux unofficial extensions, see TERMINFO EXTENSIONS in tmux(1)
-+ Se,
-+ Ss,
-+ Tc,
-
- st-256color| simpleterm with 256 colors,
- use=st,
-</pre>
- </blockquote>
- </li>
-
- <li>
- <p>Later, in (referring to a version from <a href=
- "https://git.suckless.org/st/commit/c0882f2ed1d7a2dd0fa2efa52157e6fc6fde3652.html">
- mid-2017</a>), a user asked to have it updated in
- ncurses.</p>
- </li>
+ "@HOMEPAGE@/man/curs_bkgrnd.3x.html#h3-bkgrnd">wbkgrnd</a> to
+ avoid storing a null in the background character, because it
+ may be used in cases where the corresponding 0x80 is not
+ treated as a null.</p>
- <li>
- <p>However, it had an error from the change in late 2016. The
- terminal description made what <em>tmux</em> expected to be
- <strong>string</strong> actually a
- <strong>boolean</strong>.</p>
-
- <p>Over the years, there were problems with each of
- simpleterm's terminal descriptions. I repaired those, and
- usually dealt with the problem.</p>
+ <p>This was a regression introduced in ncurses 6.2 (<a href=
+ "https://lists.gnu.org/archive/html/bug-ncurses/2020-03/msg00000.html">reported</a>
+ on the mailing list), for which the workaround was to specify
+ a blank for the background character.</p>
</li>
<li>
- <p>The difference in this case was that when compiling the
- terminal database, <em>tic</em> may have in memory the
- definitions for more than one terminal description (so that
- it can resolve “<tt>use=</tt>” clauses). Seeing
- two different types for the same name, in certain situations
- it would incorrectly merge the symbol tables for the two
- terminal descriptions.</p>
- </li>
-
- <li>
- <p>On simpleterm's side, their bug was finally fixed in
+ <p>remove output-related checks for <a href=
+ "@HOMEPAGE@/man/curs_outopts.3x.html">nl/nonl</a> (also
<a href=
- "https://git.suckless.org/st/commit/83866428de031300eab03fbb116bcf7d2b1d4f60.html">
- late 2019</a>, three years after the bug was created.</p>
- </li>
- </ul>
-
- <p>For ncurses, the elapsed time to fix this bug was less than
- three years. Someone reported a problem with the terminal
- description a few weeks after releasing ncurses 6.1 (in <a href=
- "https://github.com/tmux/tmux/issues/1264">tmux #1264</a>), and
- the terminal description was updated that week (ncurses patch
- <a href="@HOMEPAGE@/NEWS.html#t20180224">20180224</a>):</p>
-
- <blockquote>
- <pre class="demo-name">
-20180224
- + modify _nc_resolve_uses2() to detect incompatible types when merging
- a "use=" clause of extended capabilities. The problem was seen in a
- defective terminfo integrated from simpleterm sources in 20171111,
- compounded by repair in 20180121.
- + correct Ss/Ms interchange in st-0.7 entry (tmux #1264) -TD
-</pre>
- </blockquote>
-
- <p>The larger part of that change added a check to prevent a
- simple merge of terminal descriptions where the same user-defined
- name was used with different types. But it raised some
- questions:</p>
-
- <ul>
- <li>
- <p>Was there a reliable way to manage terminal descriptions
- which used the same extended name in different ways?</p>
+ "https://lists.gnu.org/archive/html/bug-ncurses/2020-09/msg00018.html">
+ reported</a> on the mailing list).</p>
</li>
<li>
- <p>Should ncurses provide a registry of well-known extended
- names, with their types?</p>
- </li>
- </ul>
+ <p>improve tparm implementation of <tt>%P</tt> and
+ <tt>%g</tt>, more closely matching SVr4 terminfo. Those
+ denote <em>static</em> and <em>dynamic</em> variables in
+ terminfo expressions.</p>
- <p>Since the correction to <a href=
- "@HOMEPAGE@/ncurses.html#download_database"><tt>terminfo.src</tt></a>
- could have been readily adopted by packagers, there was nothing
- more to be done from ncurses' standpoint on that part. But
- improving ncurses to prevent issues like that is the reason for
- making a release.</p>
-
- <p>Nothing more (constructive) was mentioned with regard to
- simpleterm. But a few problems were found in the handling of
- user-defined capabilities:</p>
-
- <ul>
- <li>
- <p>Forward-references to user-defined capabilities in a
- “<tt>use=</tt>” clause did not allocate new data
- for each use. In <em>tic</em>, successive compilation of
- terminal entries could add user-defined capabilities to the
- wrong terminal entry.</p>
-
- <p>This was not noticed before, since xterm's terminal
- descriptions were the main users of the feature, and almost
- all of the uses of the building-blocks which contained
- user-defined capabilities were backward-references.</p>
- </li>
-
- <li>
- <p>There is one (documented) case where ncurses 6.1 supports
- a user-defined capability that could be any type (i.e.,
- “RGB”). The check added in February 2018 to guard
- against mismatches did not handle all of the combinations
- needed.</p>
+ <p>Exactly what those terms meant was never documented before
+ in any implementation of curses, aside from source code.
+ Unlike the other two fixes, the problem was discovered while
+ studying OpenBSD's version of <a href=
+ "@HOMEPAGE@/ncurses-openbsd.html#issue_tput">tset</a>.</p>
</li>
</ul>
- <p>Both of these issues dated from the original implementation of
- user-defined capabilities. Fixing them does not change the
- terminal database, but a older <em>tic</em> without the fixes
- will not be able to handle terminfo sources which rely upon those
- fixes. Starting in June 2019, the download link for the terminfo
- source file was capped at that date. The development sources have
- an up-to-date copy of the file, for people with a legitimate need
- for it.</p>
-
- <p>The “<tt>-c</tt>” (check) option of <em>tic</em>
- is not very useful if it cannot offer advice on parameters needed
- for user-defined capabilities. The various <em>Caps</em> files
- were reorganized to reduce redundancy, and in the common portion
- (<a href=
- "https://github.com/ThomasDickey/ncurses-snapshots/blob/master/include/Caps-ncurses">Caps-ncurses</a>),
- a registry of user-defined capabilities is provided for use by
- <em>tic</em>. While users can still define their own custom
- capabilities, <em>tic</em> will not offer any advice when their
- parameters do not match.</p>
-
- <p>In ncurses 6.2, <em>tic</em> makes a special check to allow
- any type for <em>RGB</em>, but its being able to do this relies
- upon fixes made in the ncurses library in mid-2019.</p>
-
<h3><a name="h3-config-config" id=
"h3-config-config">Configuration changes</a></h3>
<p>There are a few new/modified configure options:</p>
<dl>
- <dt><tt>--with-config-suffix</tt>
+ <dt><tt>--enable-fvisibility</tt>
</dt>
<dd>
- <p>helps work around a filename conflict with Debian packages
- versus test-packages.</p>
+ <p>new configure option and check for <em>gcc</em>
+ <tt>-fvisibility=hidden</tt> feature</p>
</dd>
- <dt><tt>--with-ada-libname</tt>
+ <dt><tt>--enable-leaks</tt>
</dt>
<dd>
- <p>allows one to rename the “AdaCurses” library
- (at least one packager prefers a lowercase name).</p>
+ <p>corrected to allow turning leak-checking off later in a
+ set of options.</p>
</dd>
- <dt><tt>--with-fallbacks</tt>
+ <dt><tt>--enable-stdnoreturn</tt>
</dt>
<dd>
- <p>now ensures there is a value, and adds the fallback
- information to top-level Makefile summary.</p>
+ <p>new configure option makes the <code>_Noreturn</code>
+ keyword optional to ease transition.</p>
</dd>
- <dt><tt>--with-pcre2</tt>
+ <dt><tt>--disable-pkg-ldflags</tt>
</dt>
<dd>
- <p>check for pcre-posix library to help with MinGW port.</p>
+ <p>revised option also controls whether <code>$LDFLAGS</code>
+ from the build is provided in “<tt>-config</tt>”
+ and “<tt>.pc</tt>” files.</p>
</dd>
- <dt><tt>--with-tic-path</tt> and<br></dt>
+ <dt><tt>--disable-root-access</tt>
+ </dt>
+
+ <dd>
+ <p>add configure option which tells ncurses to disallow most
+ file-opens by setuid processes.</p>
+ </dd>
- <dt><tt>--with-infocmp-path</tt>
+ <dt><tt>--disable-wattr-macros</tt>
</dt>
<dd>
- <p>help work around problems building fallback source using
- pre-6.0 tic/infocmp.</p>
+ <p>changed default to help packagers who reuse wide ncursesw
+ header file with non-wide ncurses library.</p>
</dd>
- <dt><tt>--with-versioned-syms</tt>
+ <dt><tt>--with-pkg-config-libdir</tt>
</dt>
<dd>
- <p>option value can now be a relative pathname.</p>
+ <p>revised option uses the actual search path from
+ <em>pkg-config</em> or <em>pkgconf</em> using the output from
+ <tt>--debug</tt>.</p>
+ </dd>
+
+ <dt><tt>--with-ada-libname</tt><br>
+ <tt>--with-form-libname</tt><br>
+ <tt>--with-menu-libname</tt><br>
+ <tt>--with-panel-libname</tt>
+ </dt>
+
+ <dd>
+ <p>new several <tt>--with-<em>xxx</em>-libname</tt> options,
+ to help with pkgsrc</p>
</dd>
</dl>
<ul>
<li>
- <p>ignore <a href=
- "/ncurses/man/ncurses.3x.html#h3-TERMINFO"><tt>$TERMINFO</tt></a>
- as a default value in configure script if it came from the
- <tt>infocmp</tt> <strong><tt>-Q</tt></strong> option.</p>
+ <p>add a special case in the configure script to work around
+ one of the build-time breakages reported for <a href=
+ "@HOMEPAGE@/ncurses-openbsd.html">OpenBSD 6</a> here:</p>
+
+ <blockquote>
+ <p><a href=
+ "https://www.mail-archive.com/bugs@openbsd.org/msg13200.html">
+ https://www.mail-archive.com/bugs@openbsd.org/msg13200.html</a></p>
+ </blockquote>
</li>
<li>
- <p>distinguish gcc from icc and clang when the
- <tt>--enable-warnings</tt> option is not used, to avoid
- unnecessary warnings about unrecognized inline options</p>
+ <p>modify configure check for <em>libtool</em> to prevent
+ accidental use of an OpenBSD program which uses the same
+ name.</p>
</li>
<li>
- <p>consistently prepend new libraries as they are found
- during configuration, rather than relying upon the linker to
- resolve order dependencies of libraries.</p>
+ <p>modify configuration checks for build-time tic/infocmp to
+ use <em>AC_CHECK_TOOL</em>. That can still be overridden by
+ <tt>--with-tic-path</tt> and <tt>--with-infocmp-path</tt>
+ when fallbacks are used, but even if not using fallbacks, the
+ improved check may help with cross-compiling.</p>
</li>
<li>
- <p>modified configure scripts to reduce relinking/ranlib
- during library install :</p>
-
- <ul>
- <li>use “<tt>install -p</tt>” when available,
- to avoid need for ranlib of static libraries.</li>
-
- <li>scripts which use
- “<tt>--disable-relink</tt>;” add a 1-second
- sleep to work around tools which use whole-second
- timestamps, e.g., in <tt>utime</tt> rather than the actual
- file system resolution.</li>
- </ul>
+ <p>relax modification-time comparison in
+ <em>CF_LINK_FUNCS</em> to allow it to accept link() function
+ with NFS filesystems which change the mtime on the link
+ target, e.g., several BSD systems.</p>
</li>
<li>
- <p id="getenv-check">add configure check for <a href=
- "#getenv-fixes"><tt>getenv</tt></a> to work around
- implementation shown in Emscripten which overwrites the
- previous return value on each call.</p>
-
- <p>Use that to optionally suppress <tt>START_TRACE</tt>
- macro, whose call to <tt>getenv</tt> may not work
- properly</p>
+ <p>modify configure check for c89/c99 aliases of
+ <em>clang</em> to use its <tt>-std</tt> option instead,
+ because some platforms, in particular macOS, do not provide
+ workable c89/c99 aliases.</p>
</li>
<li>
- <p>change target configure level for <tt>_XOPEN_SOURCE</tt>
- to 600 to address use of <tt>vsscanf</tt> and
- <tt>setenv</tt>.</p>
+ <p>modify <em>CF_NCURSES_CONFIG</em> to work around
+ <em>Xcode</em>'s c99 "-W" option, which conflicts with
+ conventional use for passing linker options.</p>
</li>
<li>
- <p>reduce use of <tt>_GNU_SOURCE</tt> for current glibc where
- <tt>_DEFAULT_SOURCE</tt> combines with
- <tt>_XOPEN_SOURCE</tt></p>
+ <p>modify configure scripts to filter out redefinitions of
+ _XOPEN_SOURCE, e.g., for NetBSD which generally supports 500,
+ but 600 is needed for ncursesw.</p>
+ </li>
+ </ul>
- <p>Allow for Cygwin's newlib when checking for the
- _DEFAULT_SOURCE symbol.</p>
+ <p>Here are some of the other portability fixes:</p>
- <p>MidnightBSD is now checked for the
- <tt>_XOPEN_SOURCE</tt>-related definitions.</p>
+ <ul>
+ <li>
+ <p>change configure-check and source-code for gcc's noreturn
+ attribute to assume it is a prefix rather than suffix,
+ matching c11's _Noreturn convention.</p>
</li>
<li>
- <p>If the check for <tt>va_copy</tt> or <tt>__va_copy</tt>
- fails,</p>
-
- <ul>
- <li>configure now tries copying the pointers for
- <tt>va_list</tt>, or as an array.</li>
-
- <li>alternatively, it checks for
- <tt>__builtin_va_copy</tt>(), which could be used with AIX
- <tt>xlc</tt> in <em>c89</em> mode.</li>
- </ul>
+ <p>modify mk-1st.awk to account for extra-suffix configure
+ option.</p>
</li>
<li>
- <p>several changes to support a port to Ultrix 3.1:</p>
-
- <ul>
- <li>check if "b" binary feature of fopen works</li>
-
- <li>check for missing feature of locale.h</li>
-
- <li>add fallback for strstr() in test-programs</li>
-
- <li>add fallback for STDOUT_FILENO in test-programs</li>
- </ul>
+ <p>build-fix for termsort module when configured with
+ termcap.</p>
</li>
<li>
- <p>The <em>test/configure</em> script (used for <a href=
- "/ncurses/ncurses-examples.html"><em>ncurses-examples</em></a>)
- is improved:</p>
-
- <ul>
- <li>work around non-ncurses termcap.h file, e.g., in
- Slackware.</li>
-
- <li>check for <a href=
- "/ncurses/man/curs_variables.3x.html#h3-TABSIZE"><tt>TABSIZE</tt></a>
- variable.</li>
-
- <li>checks for the X11/Intrinsic.h header, accommodate
- recent MacOS changes which largely emptied
- <tt>/usr/include</tt>.</li>
- </ul>
+ <p>modify configure script and makefiles to support ".PHONY"
+ make program feature.</p>
</li>
- </ul>
- <p>Here are some of the other portability fixes:</p>
-
- <ul>
<li>
- <p>added dummy "check" rule in top-level and test-Makefile to
- simplify building test-packages for ArchLinux.</p>
+ <p>amend <em>libtool</em> configuration to add dependency for
+ install.tic, etc., in ncurses/Makefile on the lower-level
+ libraries.</p>
</li>
<li>
- <p>dropped library-dependency on psapi for MinGW port, since
- win_driver.c defines <tt>PSAPI_VERSION</tt> to 2, making it
- use <tt>GetProcessImageFileName</tt> from kernel32.dll</p>
+ <p>modify Ada95 source-generation utility to write to a file
+ given as parameter rather than to the standard output,
+ allowing builds with MinGW.</p>
</li>
<li>
- <p>made build-fixes for configuration using --program-suffix
- with Ada95, noticed with MacOS but applicable to other
- platforms without libpanelw, etc.</p>
+ <p>amend tic/infocmp check to allow for the respective tool's
+ absence.</p>
</li>
<li>
- <p>modified ncurses/Makefile.in to fix a case where
- Debian/testing changes to the ld --as-needed configuration
- broke ncurses-examples test packages.</p>
+ <p>build-fixes for gnat 10.1.1, whose gnatmake drops
+ integration with gprbuild.</p>
</li>
<li>
- <p>used <tt>_WIN32</tt>/<tt>_WIN64</tt> in preference to
- <tt>__MINGW32__</tt>/<tt>__MINGW64__</tt> symbols to simplify
- building with Microsoft Visual C++, since the former are
- defined in both compiler configurations.</p>
+ <p>correct configure version-check/warning for g++ to allow
+ for 10.x</p>
</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>
+ implements all <em>BASE</em> level features, and most
+ <em>EXTENDED</em> features). It includes many function calls
+ not supported under SVr4 curses (but portability of all calls
+ is documented so you can use the SVr4 subset only).</p>
</li>
<li>
than one control sequence to map to a given key code.</p>
</li>
+ <li>
+ <p>Support for direct-color terminals, such as modern
+ xterm.</p>
+ </li>
+
<li>
<p>Support for 256-color terminals, such as modern xterm.</p>
</li>
<li>
<p>The library meets the XSI requirement that every macro
- entry point have a corresponding function which may be linked
+ entry point has a corresponding function which may be linked
(and will be prototype-checked) if the macro definition is
disabled with <code>#undef</code>.</p>
</li>
<dd>
<p>a replacement for <code>ssh</code>.</p>
- <p><a href=
- "https://mosh.mit.edu/">https://mosh.mit.edu/</a></p>
+ <p><a href="https://mosh.org/">https://mosh.org/</a></p>
</dd>
<dt><span class="part-name">tack</span>
<p>Ongoing development work is done by <a href=
"mailto:dickey@invisible-island.net">Thomas E. Dickey</a>. Thomas
E. Dickey has acted as the maintainer for the Free Software
- Foundation, which holds a <a href=
+ Foundation, which held a <a href=
"@HOMEPAGE@/ncurses-license.html">copyright on ncurses</a> for
releases 4.2 through 6.1. Following the release of ncurses 6.1,
effective as of release 6.2, copyright for ncurses reverted to
"mailto:bug-ncurses-request@gnu.org">bug-ncurses-request@gnu.org</a>
</blockquote>
containing the line:
-
<blockquote>
<p><code>subscribe</code>
<em><name>@<host.domain></em></p>
<blockquote>
<p><a href=
- "ftp://ftp.invisible-island.net/ncurses/6.1/">ftp://ftp.invisible-island.net/ncurses/6.1/</a>
+ "ftp://ftp.invisible-island.net/ncurses/6.2/">ftp://ftp.invisible-island.net/ncurses/6.2/</a>
and<br>
<a href=
- "https://invisible-mirror.net/archives/ncurses/6.1/">https://invisible-mirror.net/archives/ncurses/6.1/</a> .</p>
+ "https://invisible-mirror.net/archives/ncurses/6.2/">https://invisible-mirror.net/archives/ncurses/6.2/</a> .</p>
</blockquote>
<p>There is an archive of the mailing list here:</p>
<span class="main-name">ncurses</span> versus <span class=
"main-name">slang</span> (S-Lang)</a></li>
+ <li><a href="@HOMEPAGE@/ncurses-openbsd.html">Comments on
+ <span class="main-name">OpenBSD</span></a></li>
+
<li><a href="@HOMEPAGE@/tack.html">tack – terminfo action
checker</a></li>
<li>
<a href="#h2-release-notes">Release Notes</a>
-
<ul>
<li>
<a href="#h3-library">Library improvements</a>
-
<ul>
<li><a href="#h4-new-library">New features</a></li>
<li>
<a href="#h3-programs">Program improvements</a>
-
<ul>
<li><a href="#h4-utilities">Utilities</a></li>
<li>
<a href="#h3-config-config">Configuration changes</a>
-
<ul>
<li><a href="#h4-config-major">Major changes</a></li>
# use or other dealings in this Software without prior written #
# authorization. #
##############################################################################
-# $Id: dist.mk,v 1.1442 2021/10/18 23:31:58 tom Exp $
+# $Id: dist.mk,v 1.1444 2021/10/20 22:43:08 tom Exp $
# Makefile for creating ncurses distributions.
#
# This only needs to be used directly as a makefile by developers, but
# These define the major/minor/patch versions of ncurses.
NCURSES_MAJOR = 6
-NCURSES_MINOR = 2
-NCURSES_PATCH = 20211018
+NCURSES_MINOR = 3
+NCURSES_PATCH = 20211021
# We don't append the patch to the version, since this only applies to releases
VERSION = $(NCURSES_MAJOR).$(NCURSES_MINOR)
<span class="comment"><EM>-- Version of the ncurses library from extensions(3NCURSES)</EM></span>
<span class="symbol"><A NAME="ref_21_4">NCURSES_VERSION_MAJOR</A></span> : <b>constant</b> := 6;
- <span class="symbol"><A NAME="ref_22_4">NCURSES_VERSION_MINOR</A></span> : <b>constant</b> := 2;
- <span class="symbol"><A NAME="ref_23_4">Version</A></span> : <b>constant</b> String := "6.2";
+ <span class="symbol"><A NAME="ref_22_4">NCURSES_VERSION_MINOR</A></span> : <b>constant</b> := 3;
+ <span class="symbol"><A NAME="ref_23_4">Version</A></span> : <b>constant</b> String := "6.3";
<span class="comment"><EM>-- Character non-color attributes from attr(3NCURSES)</EM></span>
<!--
- $Id: announce.html,v 1.64 2020/10/19 08:18:48 tom Exp $
+ $Id: announce.html,v 1.66 2021/10/20 22:54:22 tom Exp $
****************************************************************************
- * Copyright 2018-2019,2020 Thomas E. Dickey *
+ * Copyright 2018-2020,2021 Thomas E. Dickey *
* *
* Permission is hereby granted, free of charge, to any person obtaining a *
* copy of this software and associated documentation files (the *
****************************************************************************
-->
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN">
-
<html>
<head>
<meta name="generator" content=
- "HTML Tidy for HTML5 for Linux version 5.2.0">
-
- <title>Announcing ncurses 6.2</title>
+ "HTML Tidy for HTML5 for Linux version 5.6.0">
+ <title>Announcing ncurses 6.3</title>
<link rel="author" href="mailto:bug-ncurses@gnu.org">
<meta http-equiv="Content-Type" content=
"text/html; charset=us-ascii">
}
</style>
</head>
-
<body>
- <h1 class="no-header">Announcing ncurses 6.2</h1>
+ <h1 class="no-header">Announcing ncurses 6.3</h1>
<h2><a name="h2-overview" id="h2-overview">Overview</a></h2>
including</p>
<ul>
- <li><a href=
- "https://invisible-island.net/ncurses/man/captoinfo.1m.html"><span class="part-name">
- captoinfo</span></a>, a termcap conversion tool</li>
+ <li><a href="https://invisible-island.net/ncurses/man/captoinfo.1m.html"><span class=
+ "part-name">captoinfo</span></a>, a termcap conversion
+ tool</li>
- <li><a href=
- "https://invisible-island.net/ncurses/man/clear.1.html"><span class="part-name">
- clear</span></a>, utility for clearing the screen</li>
+ <li><a href="https://invisible-island.net/ncurses/man/clear.1.html"><span class=
+ "part-name">clear</span></a>, utility for clearing the
+ screen</li>
- <li><a href=
- "https://invisible-island.net/ncurses/man/infocmp.1m.html"><span class="part-name">
- infocmp</span></a>, the terminfo decompiler</li>
+ <li><a href="https://invisible-island.net/ncurses/man/infocmp.1m.html"><span class=
+ "part-name">infocmp</span></a>, the terminfo decompiler</li>
- <li><a href=
- "https://invisible-island.net/ncurses/man/tabs.1.html"><span class="part-name">
- tabs</span></a>, set tabs on a terminal</li>
+ <li><a href="https://invisible-island.net/ncurses/man/tabs.1.html"><span class=
+ "part-name">tabs</span></a>, set tabs on a terminal</li>
- <li><a href=
- "https://invisible-island.net/ncurses/man/tic.1m.html"><span class="part-name">
- tic</span></a>, the terminfo compiler</li>
+ <li><a href="https://invisible-island.net/ncurses/man/tic.1m.html"><span class=
+ "part-name">tic</span></a>, the terminfo compiler</li>
- <li><a href=
- "https://invisible-island.net/ncurses/man/toe.1m.html"><span class="part-name">
- toe</span></a>, list (table of) terminfo entries</li>
+ <li><a href="https://invisible-island.net/ncurses/man/toe.1m.html"><span class=
+ "part-name">toe</span></a>, list (table of) terminfo
+ entries</li>
- <li><a href=
- "https://invisible-island.net/ncurses/man/tput.1.html"><span class="part-name">
- tput</span></a>, utility for retrieving terminal capabilities
- in shell scripts</li>
+ <li><a href="https://invisible-island.net/ncurses/man/tput.1.html"><span class=
+ "part-name">tput</span></a>, utility for retrieving terminal
+ capabilities in shell scripts</li>
- <li><a href=
- "https://invisible-island.net/ncurses/man/tset.1.html"><span class="part-name">
- tset</span></a>, to initialize the terminal</li>
+ <li><a href="https://invisible-island.net/ncurses/man/tset.1.html"><span class=
+ "part-name">tset</span></a>, to initialize the terminal</li>
</ul>
<p>Full manual pages are provided for the library and tools.</p>
Notes</a></h2>
<p>These notes are for <span class="main-name">ncurses</span>
- 6.2, released <strong>February 12, 2020</strong>.</p>
+ 6.3, released <strong>October 21, 2021</strong>.</p>
<p>This release is designed to be source-compatible with
- <span class="main-name">ncurses</span> 5.0 through 6.1; providing
+ <span class="main-name">ncurses</span> 5.0 through 6.2; providing
extensions to the application binary interface (ABI). Although
the source can still be configured to support the <span class=
"main-name">ncurses</span> 5 ABI, the reason for the release is
this announcement.</p>
<p>The most <a href="#h3-bug-fixes">important
- bug-fixes/improvements</a> dealt with user-defined capabilities
- in terminal descriptions. The release notes also mention some
- other bug-fixes, but are focused on new features and improvements
- to existing features since <span class="main-name">ncurses</span>
- 6.1 release.</p>
+ bug-fixes/improvements</a> dealt with portability issues. The
+ release notes also mention some other bug-fixes, but are focused
+ on new features and improvements to existing features since
+ <span class="main-name">ncurses</span> 6.2 release.</p>
<h3><a name="h3-library" id="h3-library">Library improvements</a></h3>
<h4><a name="h4-new-library" id="h4-new-library">New features</a></h4>
- <p>There are several new features:</p>
+ <p>There are a few new features:</p>
<ul>
<li>
- <p><a href=
- "https://invisible-island.net/ncurses/man/form_field_opts.3x.html">
- O_EDGE_INSERT_STAY</a> tells the form library to optionally
- delay cursor movement on a field edge/boundary</p>
- </li>
-
- <li>
- <p><a href=
- "https://invisible-island.net/ncurses/man/form_field_opts.3x.html">
- O_INPUT_FIELD</a> extension to form library allows a dynamic
- field to shrink if the new limit is smaller than the current
- field size.</p>
+ <p>A new (experimental) driver, for the Windows Terminal
+ configuration is provided.</p>
</li>
<li>
- <p>added <a href=
- "https://invisible-island.net/ncurses/man/curs_memleaks.3x.html">
- exit_curses</a> and <a href=
- "https://invisible-island.net/ncurses/man/curs_memleaks.3x.html">
- exit_terminfo</a> to replace internal symbols for
- leak-checking.</p>
- </li>
-
- <li>
- <p>added <a href=
- "https://invisible-island.net/ncurses/man/curs_trace.3x.html#h3-Functions">
- curses_trace</a>, to replace trace().</p>
+ <p>A script is provided which enables <a href=
+ "https://invisible-island.net/ncurses/ncurses-openbsd.html">OpenBSD</a> users to
+ upgrade their system to use ncurses 6.3 (OpenBSD developers
+ are also invited to do this).</p>
</li>
</ul>
<ul>
<li>
- <p>mouse decoding now handles shift/control/alt logic when
- decoding xterm's 1006 mode</p>
- </li>
-
- <li>
- <p>ncurses now defines a limit for <a href=
- "https://invisible-island.net/ncurses/man/curs_getstr.3x.html">
- wgetnstr</a>, <a href=
- "https://invisible-island.net/ncurses/man/curs_get_wstr.3x.html">
- wgetn_wstr</a> when length is negative or “too
- large”.</p>
- </li>
-
- <li>reordered loop-limit checks in <a href=
- "https://invisible-island.net/ncurses/man/curs_insstr.3x.html">winsnstr</a>
- in case the string has no terminating null and only the number
- of characters is used.</li>
-
- <li>
- <p>there is now no buffer-size limit when reading the
- <a href="https://invisible-island.net/ncurses/man/ncurses.3x.html#h3-TERMCAP">
- <tt>$TERMCAP</tt></a> variable.</p>
- </li>
-
- <li>
- <p>the <a href=
- "https://invisible-island.net/ncurses/man/ncurses.3x.html#h3-TERMCAP">
- <tt>$TERMCAP</tt></a> variable may be interpreted as a
- fallback to a terminfo entry</p>
+ <p>modify lib_mouse.c to check for out-of-range button
+ numbers, convert those to position reports.</p>
</li>
<li>
- <p><a href=
- "https://invisible-island.net/ncurses/man/curs_terminfo.3x.html#h3-Output-Functions">
- <tt>mvcur</tt></a> now decides whether to use hard-tabs,
- using <strong><tt>xt</tt></strong>,
- <strong><tt>tbc</tt></strong> and
- <strong><tt>hts</tt></strong> as clues.</p>
- </li>
-
- <li>
- <p>extended colors are improved by modifying an internal call
- to <a href=
- "https://invisible-island.net/ncurses/man/curs_terminfo.3x.html#h3-Output-Functions">
- <tt>vid_puts</tt></a> to pass extended color pairs e.g., from
- <tt>tty_update.c</tt> and <tt>lib_mvcur.c</tt></p>
- </li>
-
- <li>
- <p id="getenv-fixes">the initialization functions now avoid
- relying upon persistent data for the result from <a href=
- "#getenv-check"><tt>getenv</tt></a></p>
- </li>
-
- <li>
- <p>scrolling is improved:</p>
-
- <ul>
- <li>a limit check in <tt>newline_forces_scroll</tt> handles
- the case where the row is inside scroll-margins, but not at
- the end.</li>
-
- <li>
- <p>improved loop limits in <tt>_nc_scroll_window</tt>
- handle a case where the scrolled data is a pad which is
- taller than the window.</p>
- </li>
- </ul>
+ <p>add sp-funcs for <a href=
+ "https://invisible-island.net/ncurses/man/curs_termattrs.3x.html#h3-erasechar_-erasewchar">
+ erasewchar</a>, <a href=
+ "https://invisible-island.net/ncurses/man/curs_termattrs.3x.html#h3-killchar_-killwchar">
+ killwchar</a>.</p>
</li>
</ul>
<p>These are revised features:</p>
<ul>
- <li>
- <p>used “<tt>const</tt>” in some prototypes
- rather than <tt>NCURSES_CONST</tt> where X/Open Curses was
- updated to do this, e.g., <tt>wscanw</tt>, <tt>newterm</tt>,
- the terminfo interface. Also use “<tt>const</tt>”
- for consistency in the termcap interface, which was withdrawn
- by X/Open Curses in Issue 5 (2007). As of Issue 7, X/Open
- Curses still lacks “<tt>const</tt>” for certain
- return values, e.g., <a href=
- "https://invisible-island.net/ncurses/man/curs_util.3x.html#h3-keyname_key_name">
- keyname</a>.</p>
- </li>
-
- <li>
- <p>modified <a href=
- "https://invisible-island.net/ncurses/man/curs_bkgd.3x.html#h3-bkgd">
- <tt>wbkgd</tt></a> and <a href=
- "https://invisible-island.net/ncurses/man/curs_bkgrnd.3x.html#h3-bkgrnd">
- <tt>wbkgrnd</tt></a> to improve compatibility with SVr4
- curses, changing the way the window rendition is updated when
- the background character is modified</p>
- </li>
-
- <li>
- <p>improved terminfo write/read by modifying the fourth item
- of the extended header to denote the number of valid strings
- in the extended string table (see <a href=
- "https://invisible-island.net/ncurses/man/term.5.html#h3-EXTENDED-STORAGE-FORMAT">
- term(5)</a>).</p>
- </li>
-
- <li>
- <p>modified the initialization checks for mouse so that the
- <a href=
- "/ncurses/terminfo.src.html#tic-xterm_sm_1006"><tt>xterm+sm+1006</tt></a>
- block will work with terminal descriptions not mentioning
- <em>xterm</em>.</p>
- </li>
+ <li>modify wgetnstr, wgetn_wstr to improve compatibility with
+ SVr4 curses in its treatment of interrupt and quit
+ characters</li>
</ul>
<p>These were done to limit or ultimately deprecate features:</p>
<ul>
<li>
- <p>deprecated <a href=
- "https://invisible-island.net/ncurses/NEWS.html#t970831">safe-sprintf</a>,
- since the <tt>vsnprintf</tt> function, which does what was
- needed, was standardized long ago.</p>
- </li>
+ <p>mark wgetch-events feature as deprecated.</p>
- <li>
- <p>marked <a href=
- "https://invisible-island.net/ncurses/man/curs_printw.3x.html#h2-PORTABILITY">
- <tt>vwprintw</tt></a> and <tt>vwscanw</tt> as deprecated;
- recommend using <a href=
- "https://invisible-island.net/ncurses/man/curs_printw.3x.html">
- <tt>vw_printw</tt></a> and <tt>vw_scanw</tt>,
- respectively.</p>
- </li>
+ <ul>
+ <li>
+ <p>prevent <tt>KEY_EVENT</tt> from appearing in
+ <tt>curses.h</tt> unless the configure option
+ <code>--enable-wgetch-events</code> is used.</p>
+ </li>
- <li>
- <p>added deprecation warnings for internal functions called
- by older versions of <a href=
- "https://invisible-island.net/ncurses/tack.html">tack</a>.</p>
+ <li>
+ <p>modify <tt>MKkey_defs.sh</tt> to hide ncurses'
+ definition of <tt>KEY_EVENTS</tt> to reduce <em>Visual
+ Studio C++</em> redefinition warnings.</p>
+ </li>
+ </ul>
</li>
<li>
- <p>removed unused <tt>_nc_import_termtype2</tt> function.</p>
+ <p>reduce build-warnings by excluding ncurses-internals from
+ deprecation warnings.</p>
</li>
</ul>
<ul>
<li>
- <p>check parameter of <a href=
- "https://invisible-island.net/ncurses/man/curs_threads.3x.html">
- set_escdelay</a>, return ERR if negative.</p>
- </li>
-
- <li>
- <p>check parameter of <a href=
- "https://invisible-island.net/ncurses/man/curs_threads.3x.html">
- set_tabsize</a>, return ERR if not greater than zero</p>
- </li>
-
- <li>
- <p>correct a status-check in _nc_read_tic_entry() so that if
- reading a hex/b64 <a href=
- "https://invisible-island.net/ncurses/man/ncurses.3x.html#h3-TERMINFO">
- <tt>$TERMINFO</tt></a>, and the <a href=
- "https://invisible-island.net/ncurses/man/ncurses.3x.html#h3-TERM">
- <tt>$TERM</tt></a> does not match, fall-through to the
- compiled-in search list.</p>
- </li>
-
- <li>
- <p>amend check for <a href=
- "https://invisible-island.net/ncurses/man/terminfo.5.html#h3-Predefined-Capabilities">
- <tt>repeat_char</tt></a> to handle a case where setlocale()
- was called after <a href=
- "https://invisible-island.net/ncurses/man/curs_initscr.3x.html">
- <tt>initscr</tt></a></p>
- </li>
-
- <li>
- <p>move macro for <a href=
- "https://invisible-island.net/ncurses/man/curs_touch.3x.html">
- <tt>is_linetouched</tt></a> inside
- <strong><tt>NCURSES_NOMACROS</tt></strong>
- <em><tt>ifndef</tt></em>.</p>
- </li>
-
- <li>
- <p>use <tt>_nc_copy_termtype2</tt> rather than direct
- assignment in <a href=
- "https://invisible-island.net/ncurses/man/curs_terminfo.3x.html#h3-Initialization">
- setupterm</a>, in case it is called repeatedly using fallback
- terminfo descriptions</p>
- </li>
-
- <li>
- <p>improve workaround for Solaris wcwidth versus line-drawing
- characters</p>
+ <p>drop symbols <em>GCC_PRINTF</em> and <em>GCC_SCANF</em>
+ from <curses.h>, to simplify use.</p>
</li>
<li>
- <p>add checks in <a href=
- "https://invisible-island.net/ncurses/man/resizeterm.3x.html">
- <tt>repair_subwindows</tt></a> to keep the current position
- and scroll-margins inside the resized subwindow.</p>
+ <p>apply gcc format attribute to prototypes which use a
+ va_list parameter rather than a “<tt>...</tt>”
+ variable-length parameter list.</p>
</li>
<li>
- <p>correct a buffer-limit in <tt>write_entry.c</tt> for
- systems that use caseless filenames.</p>
+ <p>modify <term.h> so that it is not necessary to
+ include <curses.h> before <term.h>.</p>
</li>
<li>
- <p>improved build-time utility <em>report_offsets</em>:</p>
-
- <ul>
- <li>
- <p>add categories, e.g., "w" for wide-character, "t" for
- threads to make the report more readable. Reorganized the
- structures reported to make the categories more
- apparent.</p>
- </li>
-
- <li>
- <p>add <tt>NCURSES_GLOBALS</tt> and
- <tt>NCURSES_PRESCREEN</tt> to report to show how similar
- the different <em>libtinfo</em> configurations are.</p>
- </li>
- </ul>
+ <p>provide for wide-characters as background character in
+ wbkgrnd</p>
</li>
<li>
- <p>modified some header files to ensure that those include
- necessary files except for the previously-documented
- cases</p>
+ <p>improve parameter-checking for tparm, adding function
+ _nc_tiparm() to handle the most-used case, which accepts only
+ numeric parameters.</p>
</li>
<li>
- <p>added some traces in initialization to show whether a
- fallback entry is used.</p>
+ <p>use return-value from <em>vsnprintf</em> to reallocate as
+ needed to allow for buffers larger than the screen size.</p>
</li>
<li>
- <p>made minor optimization to reduce calls to
- _nc_reserve_pairs</p>
+ <p>add another <em>fflush(stdout)</em> in <em>_nc_flush</em>
+ to handle time-delays in the middle of strings such as flash
+ when the application uses low-level calls rather than
+ curses.</p>
</li>
</ul>
<ul>
<li>
- <p>fix a special case in <tt>PutAttrChar</tt> where a cell is
- marked as alternate-character set, but the terminal does not
- actually support the given graphic character. This would
- happen in an older terminal such as <em>vt52</em>, which
- lacks most line-drawing capability.</p>
+ <p>add a check to guard against <em>repeat_char</em> emitting
+ digits which could be interpreted as BSD-style padding when
+ <tt>--enable-bsdpad</tt> is configured.</p>
</li>
<li>
- <p>corrected flag for "seq" method of db 1.8.5 interface,
- needed by toe on some of the BSDs.</p>
- </li>
-
- <li>
- <p>modify comparison in make_hash.c to correct a special case
- in collision handling for Caps-hpux11</p>
- </li>
-
- <li>
- <p>add extended_slk_color{,_sp} symbols to the appropriate
- package/*.{map,sym} files</p>
- </li>
-
- <li>
- <p>modify lib_setup to avoid calling pthread_self() without
- first verifying that the address is valid, i.e., for weak
- symbols</p>
- </li>
-
- <li>
- <p>add a couple of broken-linker symbols to the list of
- versioned symbols to help with link-time optimization versus
- weak symbols.</p>
+ <p>check for screen size-change in <a href=
+ "https://invisible-island.net/ncurses/man/curs_scr_dump.3x.html">scr_init</a> and
+ <a href=
+ "https://invisible-island.net/ncurses/man/curs_scr_dump.3x.html">scr_restore</a>, in
+ case a screen dump does not match the current screen
+ dimensions</p>
</li>
</ul>
utility programs:</p>
<dl>
- <dt><span class="part-name">clear</span>
+ <dt><span class="part-name"><a href=
+ "https://invisible-island.net/ncurses/man/tabs.1.html">tabs</a></span>
</dt>
<dd>
<ul>
- <li>improved logic for clearing with the <em>E3</em>
- extension, in case the terminal scrolls content onto its
- saved-lines before actually clearing the display, by
- clearing the saved-lines after clearing the display</li>
+ <li>
+ <p>implement “<tt>+m</tt>” option</p>
+ </li>
</ul>
</dd>
- <dt><span class="part-name">infocmp</span>
+ <dt><span class="part-name"><a href=
+ "https://invisible-island.net/ncurses/man/tic.1m.html">tic</a></span>
</dt>
<dd>
<ul>
- <li>omit filtering of “<tt>OTxx</tt>” names
- which are used for obsolete capabilities, when the output
- is sorted by long-names. This change helps when making a
- table of the short/long capability names.</li>
- </ul>
- </dd>
+ <li>
+ <p>add check for duplicate “<tt>use=</tt>”
+ clauses.</p>
+ </li>
- <dt><span class="part-name">tic</span>
- </dt>
+ <li>
+ <p>add check to report instances where <tt>tparm</tt>
+ would detect an error in an expression.</p>
+ </li>
- <dd>
- <ul>
- <li>added check for consistent alternate character set
- capabilities.</li>
+ <li>
+ <p>add user-defined capabilities from <em>mintty</em> to
+ <tt>Caps-ncurses</tt>, for checking consistency.</p>
+ </li>
- <li>added check for paired <tt>indn</tt>/<tt>rin</tt>.</li>
+ <li>
+ <p>improve warning when oc/op do not mention SGR 39/49
+ for <em>xterm</em> compatible <code>XT</code> flag.</p>
+ </li>
- <li>added check for terminals with <tt>parm_dch</tt> vs
- <tt>parm_ich</tt>.</li>
+ <li>
+ <p>improve checks for number of parameters of
+ <code>smglp</code>, <code>smgrp</code>,
+ <code>smgtp</code>, and <code>smgbp</code>.</p>
+ </li>
- <li>added check for the case where
- <tt>setf</tt>/<tt>setb</tt> are given using different
- strings, but provide identical results to
- <tt>setaf</tt>/<tt>setab</tt>.</li>
+ <li>
+ <p>improve “<tt>-c</tt>” option to validate
+ the number and type of parameters and compare against
+ expected number/type before deciding which set of
+ parameter-lists to use in tparm calls.</p>
+ </li>
- <li>corrected check for <tt>ich1</tt>.</li>
+ <li>
+ <p>improve check for errors detected in
+ <code>tparm</code>.</p>
+ </li>
- <li>changed a too-large terminal entry from a fatal error
- to a warning.</li>
- </ul>
- </dd>
+ <li>
+ <p>improve format of output, to ensure that the messages
+ contain only printable text.</p>
+ </li>
- <dt><span class="part-name">toe</span>
- </dt>
+ <li>
+ <p>modify to eliminate unnecessary
+ “<code>\</code>” to escape
+ “<code>:</code>” in terminfo format.</p>
+ </li>
- <dd>
- <ul>
- <li>ignores any hex/b64 <tt>$TERMINFO</tt> value in the
- list of terminfo databases.</li>
+ <li>
+ <p>remove check that assumes that none or both
+ parameterized and non-parameterized margin-setting
+ capabilities are present.</p>
+ </li>
</ul>
</dd>
- <dt><span class="part-name">tset</span>
+ <dt><span class="part-name"><a href=
+ "https://invisible-island.net/ncurses/man/toe.1m.html">toe</a></span>
</dt>
<dd>
<ul>
- <li>replace check in <span class="part-name">reset</span>
- command for obsolete “<tt>pt</tt>” capability
- using <tt>tbc</tt> and <tt>hts</tt> capabilities as
- clues</li>
-
- <li>modify <span class="part-name">reset</span> to allow
- for tabstops at intervals other than 8.</li>
-
- <li>change <span class="part-name">reset</span>'s behavior
- for margins to simply clear soft-margins if possible,
- rather than clearing and then setting them according to the
- terminal's width.</li>
+ <li>
+ <p>modify output of “<tt>toe -as</tt>” to
+ show first description found rather than the last.</p>
+ </li>
+
+ <li>
+ <p>add a check to ensure that a “termcap
+ file” is text rather than binary.</p>
+ </li>
</ul>
</dd>
- <dt><span class="part-name">tput</span>
+ <dt><span class="part-name"><a href=
+ "https://invisible-island.net/ncurses/man/tput.1.html">tput</a></span>
</dt>
<dd>
<ul>
- <li>add “<tt>x</tt>” to <tt>getopt</tt> string
- so that “<tt>tput -x clear</tt>”
- works.</li>
- </ul>
- </dd>
- </dl>
-
- <p>Several changes were made to the generated ncurses*config
- scripts and the analogous “<tt>.pc</tt>” files to
- reduce differences between the configurations they report:</p>
+ <li>
+ <p>modify to allow multiple commands per line.</p>
+ </li>
- <ul>
- <li>
- <p>modified the ncurse*-config and pc-files to more closely
- match for the <tt>-I</tt> and <tt>-l</tt> options.</p>
- </li>
+ <li>
+ <p>improve parameter-checking by analyzing all extended
+ string capabilities, e.g., as used in the <code>Cs</code>
+ and <code>Ms</code> capabilities of the <em>tmux</em>
+ description.</p>
+ </li>
- <li>
- <p>filtered out linker-specs from the <tt>--libs</tt>
- report.</p>
- </li>
+ <li>
+ <p>make warning messages consistently using alias names
+ when those are used, rather than the underlying program's
+ name.</p>
+ </li>
- <li>
- <p>amended the ncurses*-config and pc-files to take into
- account the rpath hack which differed between those
- files.</p>
- </li>
+ <li>
+ <p>improve usage message for aliases such as
+ <em>clear</em>, by eliminating <em>tput</em>-specific
+ portions.</p>
+ </li>
- <li>
- <p>modified generated ncurses*config and ncurses.pc,
- ncursesw.pc, etc., to list helper libraries such as gpm for
- static linking.</p>
- </li>
- </ul>
+ <li>
+ <p>modify initialization to avoid opening
+ <tt>/dev/tty</tt> for cases other than
+ <em>reset/init</em>, e.g., for <em>clear</em>.</p>
+ </li>
+ </ul>
+ </dd>
+ </dl>
<h4><a name="h4-examples" id="h4-examples">Examples</a></h4>
<p>Along with the library and utilities, improvements were made
to the <a href=
- "https://invisible-island.net/ncurses/ncurses-examples.html">ncurses-examples</a>.
- Most of this activity aimed at improving the test-packages. A few
- changes are more generally useful, e.g., for the main ncurses
+ "https://invisible-island.net/ncurses/ncurses-examples.html">ncurses-examples</a>. Most of
+ this activity aimed at improving the test-packages. A few changes
+ are more generally useful, e.g., for the main ncurses
test-program, and for analyzing traces using the
<em>tracemunch</em> script:</p>
<ul>
<li>
- <p>improve recovery from error when reading command-character
- in <tt>test/ncurses.c</tt>, showing the relevant error
- message and not exiting on EINTR.</p>
+ <p>add “<tt>-r</tt>” option to the <em>dots</em>
+ test-programs, to help with scripting a performance
+ comparison.</p>
</li>
<li>
- <p>improve <em>tracemunch</em>, by keeping track of
- <tt>TERMINAL*</tt> values, and if tracing was first turned on
- after initialization, attempt to show distinct screen, window
- and terminal names anyway.</p>
+ <p>build-fix for <em>test_opaque</em>, for configurations
+ without opaque curses structs, e.g., ncurses 5.7.</p>
</li>
<li>
- <p>modify <em>tracemunch</em> to accept filename parameters
- in addition to use as a pipe/filter.</p>
+ <p>improve <em>tracemunch</em> logic for "RUN"
+ compaction.</p>
</li>
<li>
- <p>update <em>tracemunch</em> to work with <em>perl
- 5.26.2</em>, which changed the rules for escaping regular
- expressions.</p>
+ <p>improve <em>tracemunch</em>'s coverage of form/menu/panel
+ libraries.</p>
</li>
<li>
- <p>add some checks in <em>tracemunch</em> for undefined
- variables.</p>
+ <p>improve <em>tracemunch</em>'s checking/reporting the type
+ for the first parameter, e.g., "WINDOW*" rather than
+ "#1".</p>
</li>
<li>
- <p>modify <tt>TurnOn</tt>/<tt>TurnOff</tt> macros (in
- lib_vidattr.c and lib_vid_attr.c) to avoid expansion of
- “<tt>CUR</tt>” in trace.</p>
+ <p>modify <em>tracemunch</em> and the panel library to show
+ readable traces for panel- and user-pointers.</p>
</li>
</ul>
examples:</p>
<dl>
- <dt><span class="part-name">color_content</span>
- </dt>
-
- <dd>Demonstrate the <tt>color_content</tt> and
- <tt>extended_color_content</tt> functions.</dd>
-
- <dt><span class="part-name">demo_tabs</span>
- </dt>
-
- <dd>A simple demo of tabs in curses.</dd>
-
- <dt><span class="part-name">dump_window</span>
- </dt>
-
- <dd>A portable curses screen-dump, used to compare ncurses
- screen contents with Solaris.</dd>
-
- <dt><span class="part-name">pair_content</span>
+ <dt><span class="part-name"><em>back_ground</em></span>
</dt>
- <dd>Demonstrate the <tt>pair_content</tt> and
- <tt>extended_pair_content</tt> functions.</dd>
+ <dd>to exercise the wide-character background functions.</dd>
- <dt><span class="part-name">report_hashing</span>
+ <dt><span class="part-name"><em>move_field</em></span>
</dt>
- <dd>Check hash-tables used for terminfo and termcap names.</dd>
+ <dd>to demonstrate <a href=
+ "https://invisible-island.net/ncurses/man/form_field.3x.html">move_field</a>, and a stub
+ for a corresponding demo of <a href=
+ "https://invisible-island.net/ncurses/man/form_field_new.3x.html">dup_field</a>.</dd>
- <dt><span class="part-name">parse_rgb</span>
+ <dt><span class="part-name"><em>test_tparm</em></span>
</dt>
- <dd>Sample implementation of the ncurses RGB extension from
- <a href=
- "https://invisible-island.net/ncurses/man/user_caps.5.html">user_caps.5</a>,
- used in <em>picsmap</em> and <em>savescreen</em> programs.</dd>
+ <dd>for checking <em>tparm</em> changes.</dd>
</dl>
- <p>A variety of improvements were made to existing programs, both
- new features as well as options added to make the set of programs
- more consistent.</p>
-
- <ul>
- <li>
- <p>add “<tt>-l</tt>” option to test/background,
- to dump screen contents in a form that lets different curses
- implementations be compared.</p>
- </li>
-
- <li>
- <p>add “<tt>@</tt>” command to test/ncurses
- F-test, to allow rapid jump to different character pages.</p>
- </li>
-
- <li>
- <p>added enum, regex examples to test/demo_forms</p>
- </li>
-
- <li>
- <p>amend Scaled256() macro in test/picsmap.c to cover the
- full range 0..1000</p>
- </li>
-
- <li>
- <p>corrected pathname used in Ada95 sample programs for
- <tt>explain.txt</tt>, to work with test-packages, and used an
- awk script to split the resulting pathname when it would be
- too long for a single line.</p>
- </li>
-
- <li>
- <p>ignore interrupted system-call in test/ncurses's
- command-line, e.g., if the terminal were resized.</p>
- </li>
-
- <li>
- <p>improved ifdef's for <tt>TABSIZE</tt> variable, to help
- with AIX/HPUX ports.</p>
- </li>
- </ul>
-
<h3><a name="h3-database" id="h3-database">Terminal database</a></h3>
<p>There are several new terminal descriptions:</p>
<blockquote style="word-break:keep-all">
- <p><tt>alacritty</tt>, <tt>domterm</tt>, <tt>kitty</tt>,
- <tt>mintty</tt>, <tt>mintty-direct</tt>, <tt>ms-terminal</tt>,
- <tt>n7900</tt>, <tt>nsterm-build309</tt>,
- <tt>nsterm-direct</tt>, <tt>screen5</tt>, <tt>ti703</tt>,
- <tt>ti707</tt>, <tt>ti703-w</tt>, <tt>ti707-w</tt>
- <tt>vscode</tt>, <tt>vscode-direct</tt>, <tt>xterm-mono</tt>,
- <tt>xterm.js</tt></p>
+ <p><tt><a href=
+ "https://invisible-island.net/ncurses/terminfo.src.html#tic-absolute">absolute</a></tt>,
+ <tt><a href=
+ "https://invisible-island.net/ncurses/terminfo.src.html#tic-att610_cvis">att610+cvis</a></tt>,
+ <tt><a href=
+ "https://invisible-island.net/ncurses/terminfo.src.html#tic-foot">foot</a></tt>,
+ <tt><a href=
+ "https://invisible-island.net/ncurses/terminfo.src.html#tic-foot-direct">foot-direct</a></tt>,
+ <tt><a href=
+ "https://invisible-island.net/ncurses/terminfo.src.html#tic-hp98550-color">hp98550-color</a></tt>,
+ <tt><a href=
+ "https://invisible-island.net/ncurses/terminfo.src.html#tic-hpterm-color2">hpterm-color2</a></tt>,
+ <tt><a href=
+ "https://invisible-island.net/ncurses/terminfo.src.html#tic-hterm">hterm</a></tt>,
+ <tt><a href=
+ "https://invisible-island.net/ncurses/terminfo.src.html#tic-hterm-256color">hterm-256color</a></tt>,
+ <tt><a href=
+ "https://invisible-island.net/ncurses/terminfo.src.html#tic-linux-s">linux-s</a></tt>,
+ <tt><a href=
+ "https://invisible-island.net/ncurses/terminfo.src.html#tic-putty_keypad">putty+keypad</a></tt>,
+ <tt><a href=
+ "https://invisible-island.net/ncurses/terminfo.src.html#tic-putty_screen">putty+screen</a></tt>,
+ <tt><a href=
+ "https://invisible-island.net/ncurses/terminfo.src.html#tic-putty-screen">putty-screen</a></tt>,
+ <tt><a href=
+ "https://invisible-island.net/ncurses/terminfo.src.html#tic-screen.linux-s">screen.linux-s</a></tt>,
+ <tt><a href=
+ "https://invisible-island.net/ncurses/terminfo.src.html#tic-scrt/securecrt">scrt/securecrt</a></tt>,
+ <tt><a href=
+ "https://invisible-island.net/ncurses/terminfo.src.html#tic-tmux-direct">tmux-direct</a></tt>,
+ <tt><a href=
+ "https://invisible-island.net/ncurses/terminfo.src.html#tic-vt220_cvis">vt220+cvis</a></tt>,
+ <tt><a href=
+ "https://invisible-island.net/ncurses/terminfo.src.html#tic-vt220_cvis8">vt220+cvis8</a></tt>,
+ <tt><a href=
+ "https://invisible-island.net/ncurses/terminfo.src.html#tic-vt220_pcedit">vt220+pcedit</a></tt>,
+ <tt><a href=
+ "https://invisible-island.net/ncurses/terminfo.src.html#tic-vt220_vtedit">vt220+vtedit</a></tt>,
+ <tt><a href=
+ "https://invisible-island.net/ncurses/terminfo.src.html#tic-vt220-base">vt220-base</a></tt>,
+ <tt><a href=
+ "https://invisible-island.net/ncurses/terminfo.src.html#tic-vt52_keypad">vt52+keypad</a></tt>,
+ <tt><a href=
+ "https://invisible-island.net/ncurses/terminfo.src.html#tic-xterm_256color2">xterm+256color2</a></tt>,
+ <tt><a href=
+ "https://invisible-island.net/ncurses/terminfo.src.html#tic-xterm_88color2">xterm+88color2</a></tt>,
+ <tt><a href=
+ "https://invisible-island.net/ncurses/terminfo.src.html#tic-xterm-direct16">xterm-direct16</a></tt>,
+ <tt><a href=
+ "https://invisible-island.net/ncurses/terminfo.src.html#tic-xterm-direct256">xterm-direct256</a></tt>,
+ <tt><a href=
+ "https://invisible-island.net/ncurses/terminfo.src.html#tic-xterm_nofkeys">xterm+nofkeys</a></tt>,
+ and <tt><a href=
+ "https://invisible-island.net/ncurses/terminfo.src.html#tic-xterm_nopcfkeys">xterm+nopcfkeys</a></tt>.</p>
</blockquote>
<p>There are many changes to existing terminal descriptions. Some
were updates to several descriptions:</p>
<ul>
- <li>use <a href=
- "/ncurses/terminfo.src.html#tic-ansi_rep"><tt>ansi+rep</tt></a>
- in a dozen places</li>
-
- <li>add rs1 to konsole, mlterm</li>
-
- <li>improve several flash capabilities with trailing mandatory
- delays</li>
+ <li>correct use-ordering in some <a href=
+ "https://invisible-island.net/ncurses/terminfo.src.html#tic-xterm-direct">xterm-direct</a>
+ flavors</li>
+
+ <li>fix some sgr inconsistencies in <a href=
+ "https://invisible-island.net/ncurses/terminfo.src.html#tic-d230c">d230c</a>, <a href=
+ "https://invisible-island.net/ncurses/terminfo.src.html#tic-ibm6153">ibm6153</a>,
+ <a href="https://invisible-island.net/ncurses/terminfo.src.html#tic-ibm6154">ibm6154</a>,
+ <a href=
+ "https://invisible-island.net/ncurses/terminfo.src.html#tic-ncrvt100an">ncrvt100an</a></li>
- <li>drop <tt>ich1</tt> from <tt>rxvt-basic</tt>, <tt>Eterm</tt>
- and <tt>mlterm</tt> to improve compatibility with old
- non-curses programs</li>
+ <li>improve <a href=
+ "https://invisible-island.net/ncurses/terminfo.src.html#tic-vt50h">vt50h</a> and <a href=
+ "https://invisible-island.net/ncurses/terminfo.src.html#tic-vt52">vt52</a> based on
+ DECScope manual</li>
- <li>add/use <a href=
- "/ncurses/terminfo.src.html#tic-xterm_keypad"><tt>xterm+keypad</tt></a>
- in <tt>xterm-new</tt></li>
+ <li>use <a href=
+ "https://invisible-island.net/ncurses/terminfo.src.html#tic-hp_arrows">hp+arrows</a> in a
+ few places</li>
<li>use <a href=
- "/ncurses/terminfo.src.html#tic-xterm_sl-twm"><tt>xterm+sl-twm</tt></a>
- for consistency, nine places</li>
+ "https://invisible-island.net/ncurses/terminfo.src.html#tic-hp_pfk-cr">hp+pfk-cr</a> in a
+ few places</li>
- <li>improve <em>xm</em> example in <a href=
- "/ncurses/terminfo.src.html#tic-xterm_x11mouse">xterm+x11mouse</a>
- and <a href=
- "/ncurses/terminfo.src.html#tic-xterm_sm_1006">xterm+sm_1006</a>.</li>
+ <li>use <a href=
+ "https://invisible-island.net/ncurses/terminfo.src.html#tic-vt220_cvis">vt220+cvis</a> in
+ <tt>st</tt>, <tt>terminology</tt>, <tt>termite</tt> since they
+ ignore blinking-cursor detail in <a href=
+ "https://invisible-island.net/ncurses/terminfo.src.html#tic-att610_cvis">att610+cvis</a></li>
</ul>
<p>while others affected specific descriptions. These were
retested, to take into account changes by their developers:</p>
<blockquote>
- <p><tt>terminator</tt>, <tt>st</tt></p>
+ <p><tt><a href=
+ "https://invisible-island.net/ncurses/terminfo.src.html#tic-kitty_common">kitty+common</a></tt>,
+ <tt><a href=
+ "https://invisible-island.net/ncurses/terminfo.src.html#tic-mlterm3">mlterm3</a></tt>,
+ <tt><a href=
+ "https://invisible-island.net/ncurses/terminfo.src.html#tic-ms-terminal">ms-terminal</a></tt></p>
</blockquote>
<p>while these are specific fixes based on reviewing
<dl>
<dt><a href=
- "/ncurses/terminfo.src.html#tic-adds200">adds200</a>:</dt>
+ "https://invisible-island.net/ncurses/terminfo.src.html#tic-aaa_dec">aaa+dec</a>,
+ aaa+rv</dt>
- <dd>
- <ul>
- <li>fix typo</li>
- </ul>
- </dd>
+ <dd>correct rmacs/smacs</dd>
<dt><a href=
- "/ncurses/terminfo.src.html#tic-gnome-256color">gnome-256color</a>
+ "https://invisible-island.net/ncurses/terminfo.src.html#tic-aaa_rv">aaa+rv</a>
</dt>
- <dd>
- <ul>
- <li>base entry on "gnome", not "vte", for consistency</li>
- </ul>
- </dd>
+ <dd>correct sgr</dd>
<dt><a href=
- "/ncurses/terminfo.src.html#tic-interix">interix</a>
+ "https://invisible-island.net/ncurses/terminfo.src.html#tic-icl6404">icl6404</a>
</dt>
- <dd>
- <ul>
- <li>trim unnecessary setf/setb</li>
- </ul>
- </dd>
+ <dd>correct csr</dd>
+
+ <dt><a href="https://invisible-island.net/ncurses/terminfo.src.html#tic-kitty">kitty</a>
+ </dt>
+
+ <dd>use att610+cvis, xterm+tmux and ansi+enq</dd>
<dt><a href=
- "/ncurses/terminfo.src.html#tic-linux-16color">linux-16color</a>
+ "https://invisible-island.net/ncurses/terminfo.src.html#tic-konsole-base">konsole-base</a>
</dt>
- <dd>
- <ul>
- <li>accommodate <a href=
- "https://lists.gnu.org/archive/html/bug-ncurses/2019-10/msg00061.html">
- Linux console driver</a> incompatibility introduced in
- early 2018</li>
- </ul>
- </dd>
+ <dd>re-enable "bel"</dd>
<dt><a href=
- "/ncurses/terminfo.src.html#tic-nsterm-256color">nsterm-256color</a>:</dt>
+ "https://invisible-island.net/ncurses/terminfo.src.html#tic-linux2.6">linux2.6</a>
+ </dt>
- <dd>
- <ul>
- <li>add nsterm-build309 to replace nsterm-256color,
- assigning the latter as an alias of nsterm, to make mouse
- work with nsterm-256color</li>
- </ul>
- </dd>
+ <dd>fix pound-sign mapping in acsc</dd>
<dt><a href=
- "/ncurses/terminfo.src.html#tic-regent40">regent40</a>:</dt>
+ "https://invisible-island.net/ncurses/terminfo.src.html#tic-linux3.0">linux3.0</a>
+ </dt>
- <dd>
- <ul>
- <li>renumber function-keys to match manual</li>
- </ul>
- </dd>
+ <dd>modify to reflect default mapping of shift-tab by kbd
+ 1.14</dd>
<dt><a href=
- "/ncurses/terminfo.src.html#tic-regent60">regent60</a>:</dt>
+ "https://invisible-island.net/ncurses/terminfo.src.html#tic-pccons">pccons</a>
+ </dt>
- <dd>
- <ul>
- <li>add cd (clr_eos)</li>
+ <dd>fill in some missing pieces, to make it comparable to the
+ vt220 entry</dd>
- <li>corrected acsc</li>
+ <dt><a href="https://invisible-island.net/ncurses/terminfo.src.html#tic-putty">putty</a>
+ </dt>
- <li>add shifted function-keys</li>
- </ul>
- </dd>
+ <dd>use vt100+fnkeys, add rep</dd>
<dt><a href=
- "/ncurses/terminfo.src.html#tic-tvi950">tvi950</a>:</dt>
+ "https://invisible-island.net/ncurses/terminfo.src.html#tic-screen">screen</a>
+ </dt>
- <dd>
- <ul>
- <li>added function-key definitions to agree with Televideo
- 950 manual</li>
+ <dd>use vt100+enq</dd>
- <li>corrected acsc</li>
+ <dt><a href=
+ "https://invisible-island.net/ncurses/terminfo.src.html#tic-terminator">terminator</a>
+ </dt>
- <li>remove bogus kf0</li>
+ <dd>corrected tsl capability</dd>
- <li>add bel</li>
- </ul>
- </dd>
+ <dt><a href="https://invisible-island.net/ncurses/terminfo.src.html#tic-ti916">ti916</a>
+ </dt>
- <dt><a href=
- "/ncurses/terminfo.src.html#tic-tvi955">tvi955</a>:</dt>
+ <dd>correct cup</dd>
- <dd>
- <ul>
- <li>fix typo</li>
- </ul>
- </dd>
+ <dt><a href="https://invisible-island.net/ncurses/terminfo.src.html#tic-tmux">tmux</a>
+ </dt>
- <dt><a href=
- "/ncurses/terminfo.src.html#tic-vi200">vi200</a>:</dt>
+ <dd>change kbs to ^?</dd>
- <dd>
- <ul>
- <li>add acsc string, including right/down-arrow</li>
- </ul>
- </dd>
+ <dt><a href="https://invisible-island.net/ncurses/terminfo.src.html#tic-vt220">vt220</a>
+ </dt>
+
+ <dd>use vt220+cvis</dd>
<dt><a href=
- "/ncurses/terminfo.src.html#tic-wy50">wy50</a>:</dt>
+ "https://invisible-island.net/ncurses/terminfo.src.html#tic-vt420_lrmm">vt420+lrmm</a>
+ </dt>
- <dd>
- <ul>
- <li>corrected acsc</li>
- </ul>
- </dd>
+ <dd>add smglp and smgrp</dd>
+
+ <dt><a href="https://invisible-island.net/ncurses/terminfo.src.html#tic-vt420">vt420</a>
+ </dt>
- <dt><a href="/ncurses/terminfo.src.html#tic-wy50">wy50</a> and
- <a href="/ncurses/terminfo.src.html#tic-wy60">wy60</a>:</dt>
+ <dd>use vt420+lrmm</dd>
- <dd>
- <ul>
- <li>add shifted function-keys as kF1 to kF16</li>
- </ul>
- </dd>
+ <dt><a href=
+ "https://invisible-island.net/ncurses/terminfo.src.html#tic-xterm-new">xterm-new</a>
+ </dt>
+
+ <dd>add nel</dd>
<dt><a href=
- "/ncurses/terminfo.src.html#tic-xterm_x11hilite">xterm+x11hilite</a>:</dt>
+ "https://invisible-island.net/ncurses/terminfo.src.html#tic-xterm-vt52">xterm-vt52</a>
+ </dt>
- <dd>
- <ul>
- <li>eliminate unused <em>p5</em> parameter.</li>
- </ul>
- </dd>
+ <dd>use vt52+keypad</dd>
</dl>
<p>A few entries use extensions (user-defined terminal
capabilities):</p>
<ul>
- <li>use <a href=
- "/ncurses/terminfo.src.html#tic-xterm_sm_1006"><tt>xterm+sm+1006</tt></a>
- (aka “SGR 1006 mouse”) for konsole-base and
- putty</li>
+ <li>add shifted Linux console keys in <a href=
+ "https://invisible-island.net/ncurses/terminfo.src.html#tic-linux_sfkeys">linux+sfkeys</a>
+ entry for <a href=
+ "https://invisible-island.net/ncurses/terminfo.src.html#tic-screen.linux">screen.linux</a></li>
- <li>add <em><tt>Smol/Rmol</tt></em> user-defined capability to
- <tt>tmux</tt> and <tt>vte-2018</tt></li>
+ <li>add Smulx to <a href=
+ "https://invisible-island.net/ncurses/terminfo.src.html#tic-alacritty">alacritty</a></li>
- <li>add <em><tt>Smulx</tt></em> user-defined capability to
- <tt>tmux</tt>, <tt>vte-2018</tt></li>
+ <li>add kbeg to <a href=
+ "https://invisible-island.net/ncurses/terminfo.src.html#tic-xterm_keypad">xterm+keypad</a>
+ to accommodate termcap applications</li>
+
+ <li>add extensions in <a href=
+ "https://invisible-island.net/ncurses/terminfo.src.html#tic-xterm_tmux">xterm+tmux</a>
+ and <a href=
+ "https://invisible-island.net/ncurses/terminfo.src.html#tic-ecma_strikeout">ecma+strikeout</a>
+ to <a href=
+ "https://invisible-island.net/ncurses/terminfo.src.html#tic-ms-terminal">ms-terminal</a>,
+ but cancel the non-working Cr and Ms capabilities</li>
</ul>
<h3><a name="h3-documentation" id=
<li>
<p>fills in overlooked descriptions of features which were
- described in the <a href=
- "https://invisible-island.net/ncurses/NEWS.html">NEWS</a>
- file but treated sketchily in manual pages.</p>
+ described in the <a href="https://invisible-island.net/ncurses/NEWS.html">NEWS</a> file
+ but treated sketchily in manual pages.</p>
</li>
</ul>
<p>Corrections:</p>
<ul>
- <li>correct error-returns listed in manual pages for a few
- form functions</li>
-
- <li>corrected prototypes in several manpages using script
- to extract those in compilable form.</li>
+ <li>
+ <p>make <em>opts</em> extension for <a href=
+ "https://invisible-island.net/ncurses/man/curs_getcchar.3x.html#h3-getcchar"><tt>getcchar</tt></a>
+ work as documented for <a href=
+ "https://invisible-island.net/ncurses/announce-6.1.htmll#h4-new-library">ncurses
+ 6.1</a>, adding “<tt>-g</tt>” flag to
+ <em>demo_new_pair</em> to illustrate.</p>
+ </li>
- <li>fix typo in <a href=
- "https://invisible-island.net/ncurses/man/term.5.html#h3-EXTENDED-NUMBER-FORMAT">
- term.5</a>, improve explanation of format</li>
+ <li>
+ <p>modify <a href="https://invisible-island.net/ncurses/man/tset.1.html">tset</a>
+ “-q” option to refrain from modifying
+ terminal modes, to match the documentation.</p>
+ </li>
</ul>
</li>
- <li>
- <p>Clarify in manual pages that <a href=
- "https://invisible-island.net/ncurses/man/curs_printw.3x.html#h2-PORTABILITY">
- vwprintw</a> and <a href=
- "https://invisible-island.net/ncurses/man/curs_scanw.3x.html#h2-PORTABILITY">
- vwscanw</a> are obsolete.<br>
- They have not been part of X/Open Curses since 2007.</p>
- </li>
-
<li>
<p>New/improved history and portability sections:</p>
<ul>
- <li><a href=
- "https://invisible-island.net/ncurses/man/curs_addch.3x.html#h3-ACS-Symbols">
- curs_addch.3x</a> gives some background for ACS
- symbols.</li>
-
- <li><a href=
- "https://invisible-island.net/ncurses/man/curs_getcchar.3x.html#h2-PORTABILITY">
- curs_getcchar.3x</a> explains a difference between ncurses
- and X/Open Curses.</li>
-
- <li><a href=
- "https://invisible-island.net/ncurses/man/curs_getstr.3x.html#h2-PORTABILITY">
- curs_getstr.3x</a> gives historical/portability background
- for the length parameter of <tt>wgetnstr</tt>.</li>
-
- <li><a href=
- "https://invisible-island.net/ncurses/man/curs_slk.3x.html">
- curs_slk.3x</a> lists a few differences between SVr4 curses
- and X/Open Curses for soft-keys.</li>
-
- <li><a href=
- "https://invisible-island.net/ncurses/man/curs_terminfo.3x.html">
- curs_terminfo.3x</a> explains that the initial
- implementation of terminfo in SVr2 was mostly replaced by
- other developers in SVr3.</li>
-
- <li><a href=
- "https://invisible-island.net/ncurses/man/infocmp.1m.html">infocmp.1</a>
- explains that the initial version of terminfo had no tool
- for decompiling descriptions. That came later, with SVr3,
- with a different developer.</li>
-
- <li><a href=
- "https://invisible-island.net/ncurses/man/tabs.1.html">tabs.1</a>
- tells more than you wanted to know about the tool.</li>
-
- <li><a href=
- "https://invisible-island.net/ncurses/man/tic.1m.html">tic.1</a>
- explains that the initial version of terminfo had a
- rudimentary tool (based on termcap) for compiling entries.
- The tool used with Unix was developed by others for
- SVr3.</li>
-
- <li><a href=
- "https://invisible-island.net/ncurses/man/toe.1m.html">toe.1</a>
- explains the origin of this tool.</li>
- </ul>
- </li>
+ <li>
+ <p>improve documentation for <a href=
+ "https://invisible-island.net/ncurses/man/terminfo.5.html#h3-Parameterized-Strings">
+ tparm</a> and static/dynamic variables.</p>
+ </li>
- <li>
- <p>Improvements for <a href=
- "https://invisible-island.net/ncurses/man/user_caps.5.html">user_caps.5</a>:</p>
+ <li>
+ <p>add history note to <a href=
+ "https://invisible-island.net/ncurses/man/curs_scanw.3x.html#h2-HISTORY">curs_scanw.3x</a>
+ for <stdarg.h> and <varargs.h></p>
+ </li>
- <ul>
- <li>mention <tt>meml</tt>, <tt>memu</tt> and
- <tt>box1</tt></li>
+ <li>
+ <p>add history note to <a href=
+ "https://invisible-island.net/ncurses/man/curs_printw.3x.html#h2-HISTORY">curs_printw.3x</a>
+ for <stdarg.h> and <varargs.h></p>
+ </li>
- <li>expanded description of <tt>XM</tt></li>
+ <li>
+ <p>add portability note to <a href=
+ "https://invisible-island.net/ncurses/man/ncurses.3x.html#h3-Header-files">ncurses.3x</a>
+ regarding <stdarg.h></p>
+ </li>
- <li>add a clarification regarding the <tt>RGB</tt>
- capability.</li>
+ <li>
+ <p>add historical notes to <a href=
+ "https://invisible-island.net/ncurses/man/tput.1.html#h2-HISTORY">tput</a>,
+ <a href="https://invisible-island.net/ncurses/man/curs_terminfo.3x.html#h2-HISTORY">
+ curses-terminfo</a> and <a href=
+ "https://invisible-island.net/ncurses/man/curs_color.3x.html#h2-HISTORY">curses-color</a>
+ manpages based on source-code for SVr2, SVr3 and
+ SVr4.</p>
+ </li>
- <li>mention user_caps.5 in the tic and infocmp manual
- pages.</li>
+ <li>
+ <p>improve history section for <a href=
+ "https://invisible-island.net/ncurses/man/tset.1.html#h2-HISTORY">tset</a> manpage
+ based on the 1BSD tarball, which preceded BSD's SCCS
+ checkins by more than three years.</p>
+ </li>
</ul>
</li>
<p>Other improvements:</p>
<ul>
- <li><a href=
- "https://invisible-island.net/ncurses/man/curs_add_wch.3x.html#h3-Line-Graphics">
- curs_add_wch.3x</a> adds note about Unicode terminology for
- the line-drawing characters.</li>
-
- <li><a href=
- "https://invisible-island.net/ncurses/man/curs_color.3x.html#h2-RETURN-VALUE">
- curs_color.3x</a> improves discussion of error returns and
- extensions.</li>
-
- <li><a href=
- "https://invisible-island.net/ncurses/man/curs_mouse.3x.html">
- curs_mouse.3x</a> explains how the <tt>kmous</tt> and
- <tt>XM</tt> capabilities are used for xterm-mouse
- input.</li>
-
- <li><a href=
- "https://invisible-island.net/ncurses/man/curs_refresh.3x.html#h3-wnoutrefresh_doupdate">
- curs_refresh.3x</a> improves documentation regarding the
- virtual and physical screens.</li>
-
- <li><a href=
- "https://invisible-island.net/ncurses/man/curs_util.3x.html">
- curs_util.3x</a> mentions a difference between SVr4 and
- X/Open Curses for <tt>unctrl.h</tt></li>
-
- <li><a href=
- "https://invisible-island.net/ncurses/man/curs_variables.3x.html#h2-PORTABILITY">
- curs_variables.3x</a> improves description of the
- <em>init_tabs</em> capability and <tt>TABSIZE</tt>
- variable.</li>
-
- <li><a href=
- "https://invisible-island.net/ncurses/man/ncurses.3x.html#h2-ALTERNATE-CONFIGURATIONS">
- ncurses.3x</a> improves documentation regarding
- feature-test macros in curses.h</li>
-
- <li><a href=
- "https://invisible-island.net/ncurses/man/resizeterm.3x.html#h3-resize_term">
- resizeterm.3x</a> about top-level windows which touch the
- screen's borders.</li>
-
- <li><a href=
- "https://invisible-island.net/ncurses/man/tput.1.html#h3-Terminal-Size">
- tput.1</a> clarifies how <em>tput</em> determines the
- terminal size.</li>
+ <li>
+ <p>explain in <a href=
+ "https://invisible-island.net/ncurses/man/ncurses.3x.html#h2-ALTERNATE-CONFIGURATIONS">
+ ncurses.3x</a> that functions in the tinfo library do not
+ rely upon wide-characters.</p>
+ </li>
+
+ <li>
+ <p>improve manual page for <a href=
+ "https://invisible-island.net/ncurses/man/panel.3x.html#h2-PORTABILITY">panel</a>
+ library, extending the portability section as well as
+ documenting error-returns.</p>
+ </li>
+
+ <li>
+ <p>add section on margins to <a href=
+ "https://invisible-island.net/ncurses/man/terminfo.5.html#h3-Margins">terminfo.5</a>,
+ adapted from X/Open Curses.</p>
+ </li>
+
+ <li>
+ <p>improve <a href=
+ "https://invisible-island.net/ncurses/man/term.5.html#h3-LEGACY-STORAGE-FORMAT">man/term.5</a>
+ section on legacy storage format.</p>
+ </li>
+
+ <li>
+ <p>add a note in <a href=
+ "https://invisible-island.net/ncurses/man/terminfo.5.html#h3-Predefined-Capabilities">
+ terminfo.5</a> explaining that no-parameter strings such
+ as <em><tt>sgr0</tt></em> or <em><tt>cnorm</tt></em>
+ should not be used with tparm.</p>
+ </li>
+
+ <li>
+ <p>improve description of BSD-style padding in <a href=
+ "https://invisible-island.net/ncurses/man/curs_termcap.3x.html#h2-BUGS">curs_termcap.3x</a></p>
+ </li>
+
+ <li>
+ <p>improve discussion of padding versus <tt>tparm</tt>
+ and <tt>tputs</tt> in <a href=
+ "https://invisible-island.net/ncurses/man/curs_terminfo.3x.html#h3-Formatting-Output">
+ man/curs_terminfo.3x</a></p>
+ </li>
+
+ <li>
+ <p>add a note in manual page to explain <a href=
+ "https://invisible-island.net/ncurses/man/curs_getch.3x.html#h3-Ungetting-characters">
+ ungetch</a> vs <a href=
+ "https://invisible-island.net/ncurses/man/curs_get_wch.3x.html#h3-unget_wch">unget_wch</a>.</p>
+ </li>
+
+ <li>
+ <p>improve description of error-returns in <a href=
+ "https://invisible-island.net/ncurses/man/curs_addch.3x.html#h2-RETURN-VALUE">waddch</a>
+ and <a href=
+ "https://invisible-island.net/ncurses/man/curs_addstr.3x.html#h2-RETURN-VALUE">waddnstr</a>
+ manual pages.</p>
+ </li>
</ul>
</li>
</ul>
are to existing pages).</p>
<p>Some of the improvements are more subtle, relating to the way
- the information is presented. For instance, the generated
- terminfo.5 file uses a different table layout, allowing it to use
- space on wide terminals more effectively.</p>
+ the information is presented. For instance, hyphenation is
+ suppressed in the HTML files generated from manual pages because
+ an upgrade to <em>groff</em> gave noticeably poorer results,
+ interfering with the process of creating links between the
+ resulting webpages.</p>
<h3><a name="h3-bug-fixes" id="h3-bug-fixes">Interesting
bug-fixes</a></h3>
<p>While there were many bugs fixed during development of ncurses
- 6.2, only a few (the reason for this release) were both important
+ 6.3, only a few (the reason for this release) were both important
and interesting. Most of the bug-fixes were for local issues
which did not affect compatibility across releases. Since those
- are detailed in the NEWS file no elaboration is needed here.</p>
+ are detailed in the <a href=
+ "https://invisible-island.net/ncurses/NEWS.html#t20211018">NEWS</a> file no elaboration is
+ needed here.</p>
- <p>The interesting bugs were in tic/infocmp's handling of
- user-defined capabilities. These were not recent bugs. Initially
- it was a simple problem:</p>
+ <p>The interesting bugs were:</p>
<ul>
- <li>The user-defined capabilities can be any type (boolean,
- number or string), but once given a type all uses of the name
- must conform to that type—unless some special support for
- a particular multi-typed name is built into ncurses.</li>
-
<li>
- <p>One of simpleterm's contributors copied some definitions
- for using <em>tmux</em>'s user-defined capabilities in
+ <p>modify <a href=
+ "https://invisible-island.net/ncurses/man/curs_bkgd.3x.html#h3-bkgd">wbkgd</a> and
<a href=
- "https://git.suckless.org/st/commit/06f8cf8ca87a81db15816658c40b2afcd1ad5332.html">
- late in 2016</a>.</p>
+ "https://invisible-island.net/ncurses/man/curs_bkgrnd.3x.html#h3-bkgrnd">wbkgrnd</a> to
+ avoid storing a null in the background character, because it
+ may be used in cases where the corresponding 0x80 is not
+ treated as a null.</p>
- <blockquote>
- <pre class="demo-name">
-diff --git a/st.info b/st.info
-@@ -185,7 +185,10 @@ st| simpleterm,
- tsl=\E]0;,
- xenl,
- vpa=\E[%i%p1%dd,
--
-+# Tmux unofficial extensions, see TERMINFO EXTENSIONS in tmux(1)
-+ Se,
-+ Ss,
-+ Tc,
-
- st-256color| simpleterm with 256 colors,
- use=st,
-</pre>
- </blockquote>
- </li>
-
- <li>
- <p>Later, in (referring to a version from <a href=
- "https://git.suckless.org/st/commit/c0882f2ed1d7a2dd0fa2efa52157e6fc6fde3652.html">
- mid-2017</a>), a user asked to have it updated in
- ncurses.</p>
+ <p>This was a regression introduced in ncurses 6.2 (<a href=
+ "https://lists.gnu.org/archive/html/bug-ncurses/2020-03/msg00000.html">reported</a>
+ on the mailing list), for which the workaround was to specify
+ a blank for the background character.</p>
</li>
<li>
- <p>However, it had an error from the change in late 2016. The
- terminal description made what <em>tmux</em> expected to be
- <strong>string</strong> actually a
- <strong>boolean</strong>.</p>
-
- <p>Over the years, there were problems with each of
- simpleterm's terminal descriptions. I repaired those, and
- usually dealt with the problem.</p>
- </li>
-
- <li>
- <p>The difference in this case was that when compiling the
- terminal database, <em>tic</em> may have in memory the
- definitions for more than one terminal description (so that
- it can resolve “<tt>use=</tt>” clauses). Seeing
- two different types for the same name, in certain situations
- it would incorrectly merge the symbol tables for the two
- terminal descriptions.</p>
- </li>
-
- <li>
- <p>On simpleterm's side, their bug was finally fixed in
+ <p>remove output-related checks for <a href=
+ "https://invisible-island.net/ncurses/man/curs_outopts.3x.html">nl/nonl</a> (also
<a href=
- "https://git.suckless.org/st/commit/83866428de031300eab03fbb116bcf7d2b1d4f60.html">
- late 2019</a>, three years after the bug was created.</p>
- </li>
- </ul>
-
- <p>For ncurses, the elapsed time to fix this bug was less than
- three years. Someone reported a problem with the terminal
- description a few weeks after releasing ncurses 6.1 (in <a href=
- "https://github.com/tmux/tmux/issues/1264">tmux #1264</a>), and
- the terminal description was updated that week (ncurses patch
- <a href=
- "https://invisible-island.net/ncurses/NEWS.html#t20180224">20180224</a>):</p>
-
- <blockquote>
- <pre class="demo-name">
-20180224
- + modify _nc_resolve_uses2() to detect incompatible types when merging
- a "use=" clause of extended capabilities. The problem was seen in a
- defective terminfo integrated from simpleterm sources in 20171111,
- compounded by repair in 20180121.
- + correct Ss/Ms interchange in st-0.7 entry (tmux #1264) -TD
-</pre>
- </blockquote>
-
- <p>The larger part of that change added a check to prevent a
- simple merge of terminal descriptions where the same user-defined
- name was used with different types. But it raised some
- questions:</p>
-
- <ul>
- <li>
- <p>Was there a reliable way to manage terminal descriptions
- which used the same extended name in different ways?</p>
+ "https://lists.gnu.org/archive/html/bug-ncurses/2020-09/msg00018.html">
+ reported</a> on the mailing list).</p>
</li>
<li>
- <p>Should ncurses provide a registry of well-known extended
- names, with their types?</p>
- </li>
- </ul>
-
- <p>Since the correction to <a href=
- "https://invisible-island.net/ncurses/ncurses.html#download_database">
- <tt>terminfo.src</tt></a> could have been readily adopted by
- packagers, there was nothing more to be done from ncurses'
- standpoint on that part. But improving ncurses to prevent issues
- like that is the reason for making a release.</p>
+ <p>improve tparm implementation of <tt>%P</tt> and
+ <tt>%g</tt>, more closely matching SVr4 terminfo. Those
+ denote <em>static</em> and <em>dynamic</em> variables in
+ terminfo expressions.</p>
- <p>Nothing more (constructive) was mentioned with regard to
- simpleterm. But a few problems were found in the handling of
- user-defined capabilities:</p>
-
- <ul>
- <li>
- <p>Forward-references to user-defined capabilities in a
- “<tt>use=</tt>” clause did not allocate new data
- for each use. In <em>tic</em>, successive compilation of
- terminal entries could add user-defined capabilities to the
- wrong terminal entry.</p>
-
- <p>This was not noticed before, since xterm's terminal
- descriptions were the main users of the feature, and almost
- all of the uses of the building-blocks which contained
- user-defined capabilities were backward-references.</p>
- </li>
-
- <li>
- <p>There is one (documented) case where ncurses 6.1 supports
- a user-defined capability that could be any type (i.e.,
- “RGB”). The check added in February 2018 to guard
- against mismatches did not handle all of the combinations
- needed.</p>
+ <p>Exactly what those terms meant was never documented before
+ in any implementation of curses, aside from source code.
+ Unlike the other two fixes, the problem was discovered while
+ studying OpenBSD's version of <a href=
+ "https://invisible-island.net/ncurses/ncurses-openbsd.html#issue_tput">tset</a>.</p>
</li>
</ul>
- <p>Both of these issues dated from the original implementation of
- user-defined capabilities. Fixing them does not change the
- terminal database, but a older <em>tic</em> without the fixes
- will not be able to handle terminfo sources which rely upon those
- fixes. Starting in June 2019, the download link for the terminfo
- source file was capped at that date. The development sources have
- an up-to-date copy of the file, for people with a legitimate need
- for it.</p>
-
- <p>The “<tt>-c</tt>” (check) option of <em>tic</em>
- is not very useful if it cannot offer advice on parameters needed
- for user-defined capabilities. The various <em>Caps</em> files
- were reorganized to reduce redundancy, and in the common portion
- (<a href=
- "https://github.com/ThomasDickey/ncurses-snapshots/blob/master/include/Caps-ncurses">Caps-ncurses</a>),
- a registry of user-defined capabilities is provided for use by
- <em>tic</em>. While users can still define their own custom
- capabilities, <em>tic</em> will not offer any advice when their
- parameters do not match.</p>
-
- <p>In ncurses 6.2, <em>tic</em> makes a special check to allow
- any type for <em>RGB</em>, but its being able to do this relies
- upon fixes made in the ncurses library in mid-2019.</p>
-
<h3><a name="h3-config-config" id=
"h3-config-config">Configuration changes</a></h3>
<p>There are a few new/modified configure options:</p>
<dl>
- <dt><tt>--with-config-suffix</tt>
+ <dt><tt>--enable-fvisibility</tt>
</dt>
<dd>
- <p>helps work around a filename conflict with Debian packages
- versus test-packages.</p>
+ <p>new configure option and check for <em>gcc</em>
+ <tt>-fvisibility=hidden</tt> feature</p>
</dd>
- <dt><tt>--with-ada-libname</tt>
+ <dt><tt>--enable-leaks</tt>
</dt>
<dd>
- <p>allows one to rename the “AdaCurses” library
- (at least one packager prefers a lowercase name).</p>
+ <p>corrected to allow turning leak-checking off later in a
+ set of options.</p>
</dd>
- <dt><tt>--with-fallbacks</tt>
+ <dt><tt>--enable-stdnoreturn</tt>
</dt>
<dd>
- <p>now ensures there is a value, and adds the fallback
- information to top-level Makefile summary.</p>
+ <p>new configure option makes the <code>_Noreturn</code>
+ keyword optional to ease transition.</p>
</dd>
- <dt><tt>--with-pcre2</tt>
+ <dt><tt>--disable-pkg-ldflags</tt>
</dt>
<dd>
- <p>check for pcre-posix library to help with MinGW port.</p>
+ <p>revised option also controls whether <code>$LDFLAGS</code>
+ from the build is provided in “<tt>-config</tt>”
+ and “<tt>.pc</tt>” files.</p>
</dd>
- <dt><tt>--with-tic-path</tt> and<br></dt>
+ <dt><tt>--disable-root-access</tt>
+ </dt>
+
+ <dd>
+ <p>add configure option which tells ncurses to disallow most
+ file-opens by setuid processes.</p>
+ </dd>
+
+ <dt><tt>--disable-wattr-macros</tt>
+ </dt>
+
+ <dd>
+ <p>changed default to help packagers who reuse wide ncursesw
+ header file with non-wide ncurses library.</p>
+ </dd>
- <dt><tt>--with-infocmp-path</tt>
+ <dt><tt>--with-pkg-config-libdir</tt>
</dt>
<dd>
- <p>help work around problems building fallback source using
- pre-6.0 tic/infocmp.</p>
+ <p>revised option uses the actual search path from
+ <em>pkg-config</em> or <em>pkgconf</em> using the output from
+ <tt>--debug</tt>.</p>
</dd>
- <dt><tt>--with-versioned-syms</tt>
+ <dt><tt>--with-ada-libname</tt><br>
+ <tt>--with-form-libname</tt><br>
+ <tt>--with-menu-libname</tt><br>
+ <tt>--with-panel-libname</tt>
</dt>
<dd>
- <p>option value can now be a relative pathname.</p>
+ <p>new several <tt>--with-<em>xxx</em>-libname</tt> options,
+ to help with pkgsrc</p>
</dd>
</dl>
<ul>
<li>
- <p>ignore <a href=
- "/ncurses/man/ncurses.3x.html#h3-TERMINFO"><tt>$TERMINFO</tt></a>
- as a default value in configure script if it came from the
- <tt>infocmp</tt> <strong><tt>-Q</tt></strong> option.</p>
+ <p>add a special case in the configure script to work around
+ one of the build-time breakages reported for <a href=
+ "https://invisible-island.net/ncurses/ncurses-openbsd.html">OpenBSD 6</a> here:</p>
+
+ <blockquote>
+ <p><a href=
+ "https://www.mail-archive.com/bugs@openbsd.org/msg13200.html">
+ https://www.mail-archive.com/bugs@openbsd.org/msg13200.html</a></p>
+ </blockquote>
</li>
<li>
- <p>distinguish gcc from icc and clang when the
- <tt>--enable-warnings</tt> option is not used, to avoid
- unnecessary warnings about unrecognized inline options</p>
+ <p>modify configure check for <em>libtool</em> to prevent
+ accidental use of an OpenBSD program which uses the same
+ name.</p>
</li>
<li>
- <p>consistently prepend new libraries as they are found
- during configuration, rather than relying upon the linker to
- resolve order dependencies of libraries.</p>
+ <p>modify configuration checks for build-time tic/infocmp to
+ use <em>AC_CHECK_TOOL</em>. That can still be overridden by
+ <tt>--with-tic-path</tt> and <tt>--with-infocmp-path</tt>
+ when fallbacks are used, but even if not using fallbacks, the
+ improved check may help with cross-compiling.</p>
</li>
<li>
- <p>modified configure scripts to reduce relinking/ranlib
- during library install :</p>
-
- <ul>
- <li>use “<tt>install -p</tt>” when available,
- to avoid need for ranlib of static libraries.</li>
-
- <li>scripts which use
- “<tt>--disable-relink</tt>;” add a 1-second
- sleep to work around tools which use whole-second
- timestamps, e.g., in <tt>utime</tt> rather than the actual
- file system resolution.</li>
- </ul>
+ <p>relax modification-time comparison in
+ <em>CF_LINK_FUNCS</em> to allow it to accept link() function
+ with NFS filesystems which change the mtime on the link
+ target, e.g., several BSD systems.</p>
</li>
<li>
- <p id="getenv-check">add configure check for <a href=
- "#getenv-fixes"><tt>getenv</tt></a> to work around
- implementation shown in Emscripten which overwrites the
- previous return value on each call.</p>
-
- <p>Use that to optionally suppress <tt>START_TRACE</tt>
- macro, whose call to <tt>getenv</tt> may not work
- properly</p>
+ <p>modify configure check for c89/c99 aliases of
+ <em>clang</em> to use its <tt>-std</tt> option instead,
+ because some platforms, in particular macOS, do not provide
+ workable c89/c99 aliases.</p>
</li>
<li>
- <p>change target configure level for <tt>_XOPEN_SOURCE</tt>
- to 600 to address use of <tt>vsscanf</tt> and
- <tt>setenv</tt>.</p>
+ <p>modify <em>CF_NCURSES_CONFIG</em> to work around
+ <em>Xcode</em>'s c99 "-W" option, which conflicts with
+ conventional use for passing linker options.</p>
</li>
<li>
- <p>reduce use of <tt>_GNU_SOURCE</tt> for current glibc where
- <tt>_DEFAULT_SOURCE</tt> combines with
- <tt>_XOPEN_SOURCE</tt></p>
+ <p>modify configure scripts to filter out redefinitions of
+ _XOPEN_SOURCE, e.g., for NetBSD which generally supports 500,
+ but 600 is needed for ncursesw.</p>
+ </li>
+ </ul>
- <p>Allow for Cygwin's newlib when checking for the
- _DEFAULT_SOURCE symbol.</p>
+ <p>Here are some of the other portability fixes:</p>
- <p>MidnightBSD is now checked for the
- <tt>_XOPEN_SOURCE</tt>-related definitions.</p>
+ <ul>
+ <li>
+ <p>change configure-check and source-code for gcc's noreturn
+ attribute to assume it is a prefix rather than suffix,
+ matching c11's _Noreturn convention.</p>
</li>
<li>
- <p>If the check for <tt>va_copy</tt> or <tt>__va_copy</tt>
- fails,</p>
-
- <ul>
- <li>configure now tries copying the pointers for
- <tt>va_list</tt>, or as an array.</li>
-
- <li>alternatively, it checks for
- <tt>__builtin_va_copy</tt>(), which could be used with AIX
- <tt>xlc</tt> in <em>c89</em> mode.</li>
- </ul>
+ <p>modify mk-1st.awk to account for extra-suffix configure
+ option.</p>
</li>
<li>
- <p>several changes to support a port to Ultrix 3.1:</p>
-
- <ul>
- <li>check if "b" binary feature of fopen works</li>
-
- <li>check for missing feature of locale.h</li>
-
- <li>add fallback for strstr() in test-programs</li>
-
- <li>add fallback for STDOUT_FILENO in test-programs</li>
- </ul>
+ <p>build-fix for termsort module when configured with
+ termcap.</p>
</li>
<li>
- <p>The <em>test/configure</em> script (used for <a href=
- "/ncurses/ncurses-examples.html"><em>ncurses-examples</em></a>)
- is improved:</p>
-
- <ul>
- <li>work around non-ncurses termcap.h file, e.g., in
- Slackware.</li>
-
- <li>check for <a href=
- "/ncurses/man/curs_variables.3x.html#h3-TABSIZE"><tt>TABSIZE</tt></a>
- variable.</li>
-
- <li>checks for the X11/Intrinsic.h header, accommodate
- recent MacOS changes which largely emptied
- <tt>/usr/include</tt>.</li>
- </ul>
+ <p>modify configure script and makefiles to support ".PHONY"
+ make program feature.</p>
</li>
- </ul>
- <p>Here are some of the other portability fixes:</p>
-
- <ul>
<li>
- <p>added dummy "check" rule in top-level and test-Makefile to
- simplify building test-packages for ArchLinux.</p>
+ <p>amend <em>libtool</em> configuration to add dependency for
+ install.tic, etc., in ncurses/Makefile on the lower-level
+ libraries.</p>
</li>
<li>
- <p>dropped library-dependency on psapi for MinGW port, since
- win_driver.c defines <tt>PSAPI_VERSION</tt> to 2, making it
- use <tt>GetProcessImageFileName</tt> from kernel32.dll</p>
+ <p>modify Ada95 source-generation utility to write to a file
+ given as parameter rather than to the standard output,
+ allowing builds with MinGW.</p>
</li>
<li>
- <p>made build-fixes for configuration using --program-suffix
- with Ada95, noticed with MacOS but applicable to other
- platforms without libpanelw, etc.</p>
+ <p>amend tic/infocmp check to allow for the respective tool's
+ absence.</p>
</li>
<li>
- <p>modified ncurses/Makefile.in to fix a case where
- Debian/testing changes to the ld --as-needed configuration
- broke ncurses-examples test packages.</p>
+ <p>build-fixes for gnat 10.1.1, whose gnatmake drops
+ integration with gprbuild.</p>
</li>
<li>
- <p>used <tt>_WIN32</tt>/<tt>_WIN64</tt> in preference to
- <tt>__MINGW32__</tt>/<tt>__MINGW64__</tt> symbols to simplify
- building with Microsoft Visual C++, since the former are
- defined in both compiler configurations.</p>
+ <p>correct configure version-check/warning for g++ to allow
+ for 10.x</p>
</li>
</ul>
<p>The <span class="main-name">ncurses</span> utilities have
options to allow you to filter terminfo entries for use with
less capable <em>curses</em>/<em>terminfo</em> versions such
- as the HP/UX and AIX ports.</p>
+ as the HP-UX and AIX ports.</p>
</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>
+ implements all <em>BASE</em> level features, and most
+ <em>EXTENDED</em> features). It includes many function calls
+ not supported under SVr4 curses (but portability of all calls
+ is documented so you can use the SVr4 subset only).</p>
</li>
<li>
than one control sequence to map to a given key code.</p>
</li>
+ <li>
+ <p>Support for direct-color terminals, such as modern
+ xterm.</p>
+ </li>
+
<li>
<p>Support for 256-color terminals, such as modern xterm.</p>
</li>
</li>
<li>
- <p>The <a href=
- "https://invisible-island.net/ncurses/man/tic.1m.html"><span class="part-name">
- tic</span></a>/<a href=
- "https://invisible-island.net/ncurses/man/captoinfo.1m.html">captoinfo</a>
- utility provided with <span class="main-name">ncurses</span>
- has the ability to translate many termcaps from the XENIX,
- IBM and AT&T extension sets.</p>
+ <p>The <a href="https://invisible-island.net/ncurses/man/tic.1m.html"><span class=
+ "part-name">tic</span></a>/<a href=
+ "https://invisible-island.net/ncurses/man/captoinfo.1m.html">captoinfo</a> utility
+ provided with <span class="main-name">ncurses</span> has the
+ ability to translate many termcaps from the XENIX, IBM and
+ AT&T extension sets.</p>
</li>
<li>
<p>A BSD-like <a href=
- "https://invisible-island.net/ncurses/man/tset.1.html"><span class="part-name">
- tset</span></a> utility is provided.</p>
+ "https://invisible-island.net/ncurses/man/tset.1.html"><span class=
+ "part-name">tset</span></a> utility is provided.</p>
</li>
<li>
<li>
<p>The table-of-entries utility <a href=
- "https://invisible-island.net/ncurses/man/toe.1m.html"><span class="part-name">
- toe</span></a> makes it easy for users to see exactly what
- terminal types are available on the system.</p>
+ "https://invisible-island.net/ncurses/man/toe.1m.html"><span class=
+ "part-name">toe</span></a> makes it easy for users to see
+ exactly what terminal types are available on the system.</p>
</li>
<li>
<p>The library meets the XSI requirement that every macro
- entry point have a corresponding function which may be linked
+ entry point has a corresponding function which may be linked
(and will be prototype-checked) if the macro definition is
disabled with <code>#undef</code>.</p>
</li>
<li>
<p>Extensive documentation is provided (see the <em><a href=
- "https://invisible-island.net/ncurses/ncurses.faq.html#additional_reading">
- Additional Reading</a></em> section of the <em><a href=
- "https://invisible-island.net/ncurses/ncurses.faq.html"><span class="main-name">
- ncurses</span> FAQ</a></em> for online documentation).</p>
+ "https://invisible-island.net/ncurses/ncurses.faq.html#additional_reading">Additional
+ Reading</a></em> section of the <em><a href=
+ "https://invisible-island.net/ncurses/ncurses.faq.html"><span class=
+ "main-name">ncurses</span> FAQ</a></em> for online
+ documentation).</p>
</li>
</ul>
<dd>
<p>Curses Development Kit</p>
- <p><a href=
- "https://invisible-island.net/cdk/">https://invisible-island.net/cdk/</a><br>
-
+ <p><a href="https://invisible-island.net/cdk/">https://invisible-island.net/cdk/</a><br>
</p>
</dd>
<dd>
<p>directory-editor</p>
- <p><a href=
- "https://invisible-island.net/ded/">https://invisible-island.net/ded/</a></p>
+ <p><a href="https://invisible-island.net/ded/">https://invisible-island.net/ded/</a></p>
</dd>
<dt><span class="part-name">dialog</span>
and the basis for similar install/configure applications on
many systems.</p>
- <p><a href=
- "https://invisible-island.net/dialog/">https://invisible-island.net/dialog/</a></p>
+ <p><a href="https://invisible-island.net/dialog/">https://invisible-island.net/dialog/</a></p>
</dd>
<dt><span class="part-name">lynx</span>
<dd>
<p>a replacement for <code>ssh</code>.</p>
- <p><a href=
- "https://mosh.mit.edu/">https://mosh.mit.edu/</a></p>
+ <p><a href="https://mosh.org/">https://mosh.org/</a></p>
</dd>
<dt><span class="part-name">tack</span>
<dd>
<p>terminfo action checker</p>
- <p><a href=
- "https://invisible-island.net/ncurses/tack.html">https://invisible-island.net/ncurses/tack.html</a></p>
+ <p><a href="https://invisible-island.net/ncurses/tack.html">https://invisible-island.net/ncurses/tack.html</a></p>
</dd>
<dt><span class="part-name">tmux</span>
<p><em>vi-like-emacs</em> may be built to use the terminfo,
termcap or curses interfaces.</p>
- <p><a href=
- "https://invisible-island.net/vile/">https://invisible-island.net/vile/</a></p>
+ <p><a href="https://invisible-island.net/vile/">https://invisible-island.net/vile/</a></p>
</dd>
</dl>
</blockquote>
<p>Ongoing development work is done by <a href=
"mailto:dickey@invisible-island.net">Thomas E. Dickey</a>. Thomas
E. Dickey has acted as the maintainer for the Free Software
- Foundation, which holds a <a href=
- "https://invisible-island.net/ncurses/ncurses-license.html">copyright
- on ncurses</a> for releases 4.2 through 6.1. Following the
- release of ncurses 6.1, effective as of release 6.2, copyright
- for ncurses reverted to Thomas E. Dickey (see the <a href=
- "https://invisible-island.net/ncurses/ncurses.faq.html#relicensed">
- ncurses FAQ</a> for additional information).</p>
+ Foundation, which held a <a href=
+ "https://invisible-island.net/ncurses/ncurses-license.html">copyright on ncurses</a> for
+ releases 4.2 through 6.1. Following the release of ncurses 6.1,
+ effective as of release 6.2, copyright for ncurses reverted to
+ Thomas E. Dickey (see the <a href=
+ "https://invisible-island.net/ncurses/ncurses.faq.html#relicensed">ncurses FAQ</a> for
+ additional information).</p>
<p>Contact the current maintainers at</p>
"mailto:bug-ncurses-request@gnu.org">bug-ncurses-request@gnu.org</a>
</blockquote>
containing the line:
-
<blockquote>
<p><code>subscribe</code>
<em><name>@<host.domain></em></p>
<blockquote>
<p><a href=
- "ftp://ftp.invisible-island.net/ncurses/6.1/">ftp://ftp.invisible-island.net/ncurses/6.1/</a>
+ "ftp://ftp.invisible-island.net/ncurses/6.2/">ftp://ftp.invisible-island.net/ncurses/6.2/</a>
and<br>
<a href=
- "https://invisible-mirror.net/archives/ncurses/6.1/">https://invisible-mirror.net/archives/ncurses/6.1/</a> .</p>
+ "https://invisible-mirror.net/archives/ncurses/6.2/">https://invisible-mirror.net/archives/ncurses/6.2/</a> .</p>
</blockquote>
<p>There is an archive of the mailing list here:</p>
which may be interesting by themselves:</p>
<ul>
- <li><a href=
- "https://invisible-island.net/ncurses/ncurses-license.html"><span class="main-name">
- ncurses</span> licensing</a></li>
+ <li><a href="https://invisible-island.net/ncurses/ncurses-license.html"><span class=
+ "main-name">ncurses</span> licensing</a></li>
- <li><a href=
- "https://invisible-island.net/ncurses/ncurses-mapsyms.html">Symbol
- versioning in <span class="main-name">ncurses</span></a></li>
+ <li><a href="https://invisible-island.net/ncurses/ncurses-mapsyms.html">Symbol versioning
+ in <span class="main-name">ncurses</span></a></li>
- <li><a href=
- "https://invisible-island.net/ncurses/ncurses-slang.html">Comments
- on <span class="main-name">ncurses</span> versus <span class=
+ <li><a href="https://invisible-island.net/ncurses/ncurses-slang.html">Comments on
+ <span class="main-name">ncurses</span> versus <span class=
"main-name">slang</span> (S-Lang)</a></li>
- <li><a href=
- "https://invisible-island.net/ncurses/tack.html">tack –
- terminfo action checker</a></li>
+ <li><a href="https://invisible-island.net/ncurses/ncurses-openbsd.html">Comments on
+ <span class="main-name">OpenBSD</span></a></li>
- <li><a href=
- "https://invisible-island.net/ncurses/tctest.html">tctest
- – termcap library checker</a></li>
+ <li><a href="https://invisible-island.net/ncurses/tack.html">tack – terminfo action
+ checker</a></li>
+
+ <li><a href="https://invisible-island.net/ncurses/tctest.html">tctest – termcap
+ library checker</a></li>
<li><a href=
- "https://invisible-island.net/ncurses/ncurses.html#download_database">
- Terminal Database</a></li>
+ "https://invisible-island.net/ncurses/ncurses.html#download_database">Terminal
+ Database</a></li>
</ul>
<h2><a name="h2-other-stuff" id="h2-other-stuff">Other
<li>
<a href="#h2-release-notes">Release Notes</a>
-
<ul>
<li>
<a href="#h3-library">Library improvements</a>
-
<ul>
<li><a href="#h4-new-library">New features</a></li>
<li>
<a href="#h3-programs">Program improvements</a>
-
<ul>
<li><a href="#h4-utilities">Utilities</a></li>
<li>
<a href="#h3-config-config">Configuration changes</a>
-
<ul>
<li><a href="#h4-config-major">Major changes</a></li>
</PRE><H2><a name="h2-SEE-ALSO">SEE ALSO</a></H2><PRE>
<STRONG><A HREF="ncurses.3x.html">curses(3x)</A></STRONG>
- This describes <STRONG>ncurses</STRONG> version 6.2 (patch 20211016).
+ This describes <STRONG>ncurses</STRONG> version 6.3 (patch 20211021).
</PRE><H2><a name="h2-SEE-ALSO">SEE ALSO</a></H2><PRE>
<STRONG><A HREF="infocmp.1m.html">infocmp(1m)</A></STRONG>, <STRONG><A HREF="ncurses.3x.html">curses(3x)</A></STRONG>, <STRONG><A HREF="terminfo.5.html">terminfo(5)</A></STRONG>
- This describes <STRONG>ncurses</STRONG> version 6.2 (patch 20211016).
+ This describes <STRONG>ncurses</STRONG> version 6.3 (patch 20211021).
</PRE><H2><a name="h2-AUTHOR">AUTHOR</a></H2><PRE>
</PRE><H2><a name="h2-SEE-ALSO">SEE ALSO</a></H2><PRE>
<STRONG><A HREF="tput.1.html">tput(1)</A></STRONG>, <STRONG><A HREF="terminfo.5.html">terminfo(5)</A></STRONG>
- This describes <STRONG>ncurses</STRONG> version 6.2 (patch 20211016).
+ This describes <STRONG>ncurses</STRONG> version 6.3 (patch 20211021).
<!--
****************************************************************************
- * Copyright 2018-2019,2020 Thomas E. Dickey *
+ * Copyright 2018-2020,2021 Thomas E. Dickey *
* Copyright 1998-2010,2017 Free Software Foundation, Inc. *
* *
* Permission is hereby granted, free of charge, to any person obtaining a *
* sale, use or other dealings in this Software without prior written *
* authorization. *
****************************************************************************
- * @Id: curs_scr_dump.3x,v 1.16 2020/10/24 09:44:43 tom Exp @
+ * @Id: curs_scr_dump.3x,v 1.17 2021/10/20 22:37:48 tom Exp @
-->
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN">
<HTML>
</PRE><H2><a name="h2-DESCRIPTION">DESCRIPTION</a></H2><PRE>
+
+</PRE><H3><a name="h3-scr_dump">scr_dump</a></H3><PRE>
The <STRONG>scr_dump</STRONG> routine dumps the current contents of the <EM>virtual</EM> <EM>screen</EM>
to the file <EM>filename</EM>.
+
+</PRE><H3><a name="h3-scr_restore">scr_restore</a></H3><PRE>
The <STRONG>scr_restore</STRONG> routine sets the <EM>virtual</EM> <EM>screen</EM> to the contents of
<EM>filename</EM>, which must have been written using <STRONG>scr_dump</STRONG>. The next call
to <STRONG>doupdate</STRONG> restores the <EM>physical</EM> <EM>screen</EM> to the way it looked in the
dump file.
+
+</PRE><H3><a name="h3-scr_init">scr_init</a></H3><PRE>
The <STRONG>scr_init</STRONG> routine reads in the contents of <EM>filename</EM> and uses them to
initialize the <STRONG>curses</STRONG> data structures about what the terminal currently
has on its screen. If the data is determined to be valid, <STRONG>curses</STRONG> bases
<STRONG>o</STRONG> if the terminal has been written to since the preceding <STRONG>scr_dump</STRONG>
call.
+
+</PRE><H3><a name="h3-scr_set">scr_set</a></H3><PRE>
The <STRONG>scr_set</STRONG> routine is a combination of <STRONG>scr_restore</STRONG> and <STRONG>scr_init</STRONG>. It
tells the program that the information in <EM>filename</EM> is what is currently
on the screen, and also what the program wants on the screen. This can
<ul>
<li><a href="#h2-NAME">NAME</a></li>
<li><a href="#h2-SYNOPSIS">SYNOPSIS</a></li>
-<li><a href="#h2-DESCRIPTION">DESCRIPTION</a></li>
+<li><a href="#h2-DESCRIPTION">DESCRIPTION</a>
+<ul>
+<li><a href="#h3-scr_dump">scr_dump</a></li>
+<li><a href="#h3-scr_restore">scr_restore</a></li>
+<li><a href="#h3-scr_init">scr_init</a></li>
+<li><a href="#h3-scr_set">scr_set</a></li>
+</ul>
+</li>
<li><a href="#h2-RETURN-VALUE">RETURN VALUE</a></li>
<li><a href="#h2-NOTES">NOTES</a></li>
<li><a href="#h2-PORTABILITY">PORTABILITY</a></li>
<STRONG><A HREF="ncurses.3x.html">curses(3x)</A></STRONG> and related pages whose names begin "form_" for detailed
descriptions of the entry points.
- This describes <STRONG>ncurses</STRONG> version 6.2 (patch 20211016).
+ This describes <STRONG>ncurses</STRONG> version 6.3 (patch 20211021).
https://invisible-island.net/ncurses/tctest.html
- This describes <STRONG>ncurses</STRONG> version 6.2 (patch 20211016).
+ This describes <STRONG>ncurses</STRONG> version 6.3 (patch 20211021).
</PRE><H2><a name="h2-AUTHOR">AUTHOR</a></H2><PRE>
</PRE><H2><a name="h2-SEE-ALSO">SEE ALSO</a></H2><PRE>
<STRONG><A HREF="infocmp.1m.html">infocmp(1m)</A></STRONG>, <STRONG><A HREF="tic.1m.html">tic(1m)</A></STRONG>, <STRONG><A HREF="ncurses.3x.html">curses(3x)</A></STRONG>, <STRONG><A HREF="terminfo.5.html">terminfo(5)</A></STRONG>
- This describes <STRONG>ncurses</STRONG> version 6.2 (patch 20211016).
+ This describes <STRONG>ncurses</STRONG> version 6.3 (patch 20211021).
</PRE><H2><a name="h2-AUTHOR">AUTHOR</a></H2><PRE>
<STRONG><A HREF="ncurses.3x.html">curses(3x)</A></STRONG> and related pages whose names begin "menu_" for detailed
descriptions of the entry points.
- This describes <STRONG>ncurses</STRONG> version 6.2 (patch 20211016).
+ This describes <STRONG>ncurses</STRONG> version 6.3 (patch 20211021).
method of updating character screens with reasonable optimization.
This implementation is "new curses" (ncurses) and is the approved
replacement for 4.4BSD classic curses, which has been discontinued.
- This describes <STRONG>ncurses</STRONG> version 6.2 (patch 20211016).
+ This describes <STRONG>ncurses</STRONG> version 6.3 (patch 20211021).
The <STRONG>ncurses</STRONG> library emulates the curses library of System V Release 4
UNIX, and XPG4 (X/Open Portability Guide) curses (also known as XSI
</PRE><H2><a name="h2-SEE-ALSO">SEE ALSO</a></H2><PRE>
<STRONG><A HREF="ncurses.3x.html">curses(3x)</A></STRONG>
- This describes <STRONG>ncurses</STRONG> version 6.2 (patch 20211016).
+ This describes <STRONG>ncurses</STRONG> version 6.3 (patch 20211021).
</PRE><H2><a name="h2-SEE-ALSO">SEE ALSO</a></H2><PRE>
<STRONG><A HREF="ncurses.3x.html">curses(3x)</A></STRONG>, <STRONG><A HREF="curs_variables.3x.html">curs_variables(3x)</A></STRONG>,
- This describes <STRONG>ncurses</STRONG> version 6.2 (patch 20211016).
+ This describes <STRONG>ncurses</STRONG> version 6.3 (patch 20211021).
</PRE><H2><a name="h2-AUTHOR">AUTHOR</a></H2><PRE>
</PRE><H2><a name="h2-SEE-ALSO">SEE ALSO</a></H2><PRE>
<STRONG><A HREF="infocmp.1m.html">infocmp(1m)</A></STRONG>, <STRONG><A HREF="tset.1.html">tset(1)</A></STRONG>, <STRONG><A HREF="ncurses.3x.html">curses(3x)</A></STRONG>, <STRONG><A HREF="terminfo.5.html">terminfo(5)</A></STRONG>.
- This describes <STRONG>ncurses</STRONG> version 6.2 (patch 20211016).
+ This describes <STRONG>ncurses</STRONG> version 6.3 (patch 20211021).
have, by specifying how to perform screen operations, and by specifying
padding requirements and initialization sequences.
- This manual describes <STRONG>ncurses</STRONG> version 6.2 (patch 20211016).
+ This manual describes <STRONG>ncurses</STRONG> version 6.3 (patch 20211021).
</PRE><H3><a name="h3-Terminfo-Entry-Syntax">Terminfo Entry Syntax</a></H3><PRE>
<STRONG><A HREF="captoinfo.1m.html">captoinfo(1m)</A></STRONG>, <STRONG><A HREF="infocmp.1m.html">infocmp(1m)</A></STRONG>, <STRONG><A HREF="infotocap.1m.html">infotocap(1m)</A></STRONG>, <STRONG><A HREF="toe.1m.html">toe(1m)</A></STRONG>, <STRONG><A HREF="ncurses.3x.html">curses(3x)</A></STRONG>,
<STRONG><A HREF="term.5.html">term(5)</A></STRONG>. <STRONG><A HREF="terminfo.5.html">terminfo(5)</A></STRONG>. <STRONG><A HREF="user_caps.5.html">user_caps(5)</A></STRONG>.
- This describes <STRONG>ncurses</STRONG> version 6.2 (patch 20211016).
+ This describes <STRONG>ncurses</STRONG> version 6.3 (patch 20211021).
</PRE><H2><a name="h2-AUTHOR">AUTHOR</a></H2><PRE>
<STRONG><A HREF="captoinfo.1m.html">captoinfo(1m)</A></STRONG>, <STRONG><A HREF="infocmp.1m.html">infocmp(1m)</A></STRONG>, <STRONG><A HREF="infotocap.1m.html">infotocap(1m)</A></STRONG>, <STRONG><A HREF="tic.1m.html">tic(1m)</A></STRONG>, <STRONG><A HREF="ncurses.3x.html">curses(3x)</A></STRONG>,
<STRONG><A HREF="terminfo.5.html">terminfo(5)</A></STRONG>.
- This describes <STRONG>ncurses</STRONG> version 6.2 (patch 20211016).
+ This describes <STRONG>ncurses</STRONG> version 6.3 (patch 20211021).
</PRE><H2><a name="h2-SEE-ALSO">SEE ALSO</a></H2><PRE>
<STRONG><A HREF="clear.1.html">clear(1)</A></STRONG>, <STRONG>stty(1)</STRONG>, <STRONG><A HREF="tabs.1.html">tabs(1)</A></STRONG>, <STRONG><A HREF="tset.1.html">tset(1)</A></STRONG>, <STRONG><A HREF="curs_termcap.3x.html">curs_termcap(3x)</A></STRONG>, <STRONG><A HREF="terminfo.5.html">terminfo(5)</A></STRONG>.
- This describes <STRONG>ncurses</STRONG> version 6.2 (patch 20211016).
+ This describes <STRONG>ncurses</STRONG> version 6.3 (patch 20211021).
<STRONG>csh(1)</STRONG>, <STRONG>sh(1)</STRONG>, <STRONG>stty(1)</STRONG>, <STRONG><A HREF="curs_terminfo.3x.html">curs_terminfo(3x)</A></STRONG>, <STRONG>tty(4)</STRONG>, <STRONG><A HREF="terminfo.5.html">terminfo(5)</A></STRONG>,
<STRONG>ttys(5)</STRONG>, <STRONG>environ(7)</STRONG>
- This describes <STRONG>ncurses</STRONG> version 6.2 (patch 20211016).
+ This describes <STRONG>ncurses</STRONG> version 6.3 (patch 20211021).
.\"***************************************************************************
-.\" Copyright 2018-2019,2020 Thomas E. Dickey *
+.\" Copyright 2018-2020,2021 Thomas E. Dickey *
.\" Copyright 1998-2010,2017 Free Software Foundation, Inc. *
.\" *
.\" Permission is hereby granted, free of charge, to any person obtaining a *
.\" authorization. *
.\"***************************************************************************
.\"
-.\" $Id: curs_scr_dump.3x,v 1.16 2020/10/24 09:44:43 tom Exp $
+.\" $Id: curs_scr_dump.3x,v 1.17 2021/10/20 22:37:48 tom Exp $
.TH curs_scr_dump 3X ""
.ie \n(.g .ds `` \(lq
.el .ds `` ``
\fBint scr_set(const char *\fP\fIfilename\fP\fB);\fR
.br
.SH DESCRIPTION
+.SS scr_dump
+.PP
The \fBscr_dump\fR routine dumps the current contents
of the \fIvirtual screen\fP
to the file \fIfilename\fR.
+.SS scr_restore
.PP
The \fBscr_restore\fR routine sets the \fIvirtual screen\fP to the contents
of \fIfilename\fR, which must have been written using \fBscr_dump\fR.
The next call to \fBdoupdate\fR restores
the \fIphysical screen\fP to the way it looked in the dump file.
+.SS scr_init
.PP
The \fBscr_init\fR routine reads in the contents of \fIfilename\fR and uses
them to initialize the \fBcurses\fR data structures about what the terminal
if the terminfo capabilities \fBrmcup\fR and \fBnrrmc\fR exist, also
.bP
if the terminal has been written to since the preceding \fBscr_dump\fR call.
+.SS scr_set
.PP
The \fBscr_set\fR routine is a combination of \fBscr_restore\fR and
\fBscr_init\fR. It tells the program that the information in \fIfilename\fR is
--- /dev/null
+#!/usr/bin/env perl
+# $Id: ncu2openbsd,v 1.65 2021/10/03 18:52:22 tom Exp $
+# -----------------------------------------------------------------------------
+# Copyright 2021 by Thomas E. Dickey
+#
+# All Rights Reserved
+#
+# Permission is hereby granted, free of charge, to any person obtaining a
+# copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be included
+# in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+# OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+# IN NO EVENT SHALL THE ABOVE LISTED COPYRIGHT HOLDER(S) BE LIABLE FOR ANY
+# CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+# TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+# SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+#
+# Except as contained in this notice, the name(s) of the above copyright
+# holders shall not be used in advertising or otherwise to promote the
+# sale, use or other dealings in this Software without prior written
+# authorization.
+# -----------------------------------------------------------------------------
+# https://invisible-island.net/ncurses/ncurses-openbsd.html
+#
+# Update the OpenBSD source-tree given an ncurses tarball or build-tree.
+
+use strict;
+use warnings;
+
+use Getopt::Std;
+use Cwd;
+use Cwd 'abs_path';
+use File::Path qw/ remove_tree /;
+use File::Temp qw/ tempdir /;
+
+$| = 1;
+
+our ( $opt_d, $opt_n, $opt_r, $opt_t, $opt_v, $opt_x );
+our $source_dir;
+our $target_dir;
+our $update_dir;
+our $backup_dir;
+
+our $tempdir = tempdir( CLEANUP => 1 );
+my $current = getcwd;
+my $working = $current;
+
+our $generated_by = "generated by: ncu2openbsd";
+
+our %setup_dir = qw(
+ lib/libcurses ncurses
+ lib/libform form
+ lib/libmenu menu
+ lib/libpanel panel
+ usr.bin/infocmp progs
+ usr.bin/tabs progs
+ usr.bin/tic progs
+ usr.bin/toe progs
+ usr.bin/tput progs
+ usr.bin/tset progs
+ share/termtypes misc
+);
+
+our %generated = qw(
+ codes.c 1
+ comp_captab.c 1
+ comp_userdefs.c 1
+ expanded.c 1
+ fallback.c 1
+ init_keytry.h 1
+ keys.list 1
+ lib_gen.c 1
+ lib_keyname.c 1
+ make_hash 1
+ make_keys 1
+ names.c 1
+ termsort.c 1
+ unctrl.c 1
+);
+
+our %definitions = qw(
+ CAPTOINFO captoinfo
+ DATADIR /usr/share
+ INFOCMP infocmp
+ INFOTOCAP infotocap
+ NCURSES_MAJOR 5
+ NCURSES_MINOR 7
+ NCURSES_OSPEED int
+ NCURSES_PATCH 20081102
+ TERMINFO /usr/share/terminfo
+ TIC tic
+ TOE toe
+ TPUT tput
+ TSET tset
+);
+
+sub patchdate() {
+ return $definitions{"NCURSES_PATCH"};
+}
+
+sub failed($) {
+ chdir $current;
+ printf STDERR "? %s\n", $_[0];
+ exit;
+}
+
+sub verbose($) {
+ my $text = shift;
+ printf "%s\n", $text if ($opt_v);
+}
+
+sub read_file($) {
+ my $name = shift;
+ open( my $fp, $name ) || &failed("cannot open $name");
+ my (@input) = <$fp>;
+ chomp @input;
+ close($fp);
+ return @input;
+}
+
+sub read_dir($) {
+ my $path = shift;
+ my @result;
+ if ( opendir( my $dh, $path ) ) {
+ my @data = sort readdir($dh);
+ closedir $dh;
+ for my $d ( 0 .. $#data ) {
+ next if ( $data[$d] =~ /^\.(\.)?$/ );
+ next if ( -l $path . "/" . $data[$d] );
+ $result[ $#result + 1 ] = $data[$d];
+ }
+ }
+ return @result;
+}
+
+sub rename_dir($$) {
+ my $src = shift;
+ my $dst = shift;
+ printf "%% mv %s -> %s\n", $src, $dst if ($opt_v);
+ rename $src, $dst unless ($opt_n);
+}
+
+sub check_sourcedir($) {
+ my $path = shift;
+ &failed("not a directory: $path") unless ( -d $path );
+ my $full = abs_path($path);
+ chdir $full;
+ &failed("not an ncurses source-tree: $path")
+ unless ( -f "NEWS" and -f "dist.mk" );
+ $source_dir = $full;
+}
+
+sub unpack($) {
+ my $path = shift;
+ my $full = abs_path($path);
+ my $command = "";
+ if ( $path =~ /\.tgz$/ or $path =~ /\.tar\.gz$/ ) {
+ $command = "tar xzf %s";
+ }
+ elsif ( $path =~ /\.zip$/ ) {
+ $command = "unzip -q %s";
+ }
+ else {
+ &failed("not a gzip'd tarball or zip-file: $path");
+ }
+ chdir $tempdir;
+ system( sprintf( $command, $full ) );
+
+ # there should be exactly one subdirectory -- the source-tree
+ my @data = &read_dir(".");
+ &failed("found no subdirectories of $path") if ( $#data < 0 );
+ &failed( "too many subdirectories: " . $data[0] . " vs " . $data[1] )
+ if ( $#data > 0 );
+ &check_sourcedir( $data[0] );
+}
+
+sub remove_dir($) {
+ my $tree = shift;
+ if ( -d $tree ) {
+ printf "%% rm -rf %s\n", $tree if ($opt_v);
+ remove_tree( $tree, $opt_v ? 1 : 0, 1 ) unless ($opt_n);
+ }
+}
+
+sub copy_CVS($) {
+ my $leaf = shift;
+ my $src = $target_dir . $leaf . "/CVS";
+ my $dst = $update_dir . $leaf . "/CVS";
+ my $verbose = $opt_v ? "v" : "";
+ if ( -d $src and !-d $dst ) {
+ my $mid = $update_dir . $leaf;
+ mkdir $mid unless ( -d $mid );
+ mkdir $dst unless ( -d $dst );
+ system("cp -a$verbose $src/* $dst/");
+ }
+}
+
+sub is_tic_code($) {
+ my $item = shift;
+ my $result = 0;
+ $result = 1
+ if (
+ $item =~ /^(capconvert
+ |tic
+ |dump
+ |progs
+ |termsort
+ |transform
+ |MKtermsort)/x
+ );
+ return $result;
+}
+
+sub is_ident($$) {
+ my $name = shift;
+ my $text = shift;
+ my $code = 0;
+ $code = 1 if ( $text =~ /\$$name:.*\$/ );
+ return $code;
+}
+
+# We "could", filter out differences with ident's using the diff -I option,
+# but in practice, that is cumbersome.
+sub munge_ident($) {
+ my $target = shift;
+ my $source = $target;
+ $source =~ s/\.update\b//;
+ &failed("bug at $source") if ( $source eq $target );
+ return unless ( -f $source );
+ my @source = &read_file($source);
+ my @target = &read_file($target);
+ my $old_id = "";
+ my $gap_id = 0;
+ my $new_id = "";
+ my $skipit = -1;
+
+ for my $n ( 0 .. $#source ) {
+ if ( &is_ident( "OpenBSD", $source[$n] ) ) {
+ $old_id = $source[$n];
+ $skipit = $n + 1;
+ }
+ elsif ( &is_ident( "Id", $source[$n] ) ) {
+ $new_id = $source[$n];
+ last;
+ }
+ elsif ( $n == $skipit ) {
+ $source[$n] =~ s/\s+$//;
+ if ( $source[$n] eq "" ) {
+ $gap_id = $source[$n];
+ }
+ elsif ( $source[$n] eq '.\"' ) {
+ $gap_id = $source[$n];
+ }
+ }
+ }
+ if ( $old_id ne "" ) {
+ my @update;
+ my $tables = &uses_tables($target);
+ $update[ $#update + 1 ] = $target[0] if ($tables);
+ $update[ $#update + 1 ] = $old_id;
+ $update[ $#update + 1 ] = $gap_id unless ( $gap_id eq 0 );
+ for my $n ( $tables .. $#target ) {
+ if ( &is_ident( "Id", $target[$n] ) ) {
+ $update[ $#update + 1 ] = $new_id;
+ }
+ else {
+ $update[ $#update + 1 ] = $target[$n];
+ }
+ }
+ system("chmod u+w $target");
+ if ( open my $fp, ">", $target ) {
+ for my $n ( 0 .. $#update ) {
+ printf $fp "%s\n", $update[$n];
+ }
+ close $fp;
+ system("chmod u-w $target");
+ }
+ }
+}
+
+# ncurses manual pages provide for renaming the utilities, normally as part of
+# the scripts provided in its sources. OpenBSD developers do not use those.
+sub munge_docs($) {
+ my $path = shift;
+ my @data = &read_file($path);
+ my $done = 0;
+ for my $n ( 0 .. $#data ) {
+ my $text = $data[$n];
+ $text =~ s/\b1M\b/1/g;
+ $text =~ s/\b3X\b/3/g;
+ $text =~ s/\bcurs_(term(info|cap)\s*3\b)/$1/g;
+ $text =~ s/(\\fB)curs_(term(info|cap)\\f[RP]\(3\))/$1$2/g;
+ my $left = "";
+ while ( $text =~ /@[[:alnum:]_]+@/ ) {
+ my $next = index( $text, "@" );
+ last if ( $next < 0 );
+ $left .= substr( $text, 0, $next++ );
+ $text = substr( $text, $next );
+ $next = index( $text, "@" );
+ last if ( $next < 0 );
+ my $word = substr( $text, 0, $next );
+ if ( $word =~ /^[[:alnum:]_]+/ ) {
+
+ if ( $definitions{$word} ) {
+ $word = $definitions{$word};
+ }
+ else {
+ $word = "?";
+ }
+ $left .= $word;
+ $text = substr( $text, $next + 1 );
+ }
+ else {
+ &failed("unexpected definition @$word@");
+ }
+ }
+ $text = $left . $text;
+ if ( $text ne $data[$n] ) {
+ $done++;
+ $data[$n] = $text;
+ }
+ }
+ if ($done) {
+ system("chmod u+w $path");
+ if ( open my $fp, ">", $path ) {
+ for my $n ( 0 .. $#data ) {
+ printf $fp "%s\n", $data[$n];
+ }
+ close $fp;
+ system("chmod u-w $path");
+ }
+ }
+}
+
+sub copy_file($$) {
+ my $src = shift;
+ my $dst = shift;
+ my $verbose = $opt_v ? "v" : "";
+ if ( -d $dst ) {
+ my $leaf = $src;
+ $leaf =~ s,^.*/,,;
+ $dst .= "/" . $leaf;
+ }
+ system("chmod u+w $dst") if ( -f $dst );
+ system("cp -a$verbose $src $dst");
+ &munge_ident($dst);
+}
+
+sub copy_code($) {
+ my $src = shift;
+ my $dst = shift;
+ ©_CVS( substr( $dst, length($update_dir) ) );
+ printf ".. copying files for $dst\n";
+ my @data = &read_dir($src);
+ printf ".. %d entries\n", $#data + 1;
+ my $verbose = $opt_v ? "v" : "";
+ for my $d ( 0 .. $#data ) {
+ my $item = $data[$d];
+ my $src_item = $src . "/" . $item;
+ next if ( -d $src_item );
+ next if ( -l $src_item );
+ next if ( $item =~ /^\.(\.)?$/ );
+ next if ( $item =~ /\.(bak|in|log|status)$/ );
+ next if ( $item =~ /^llib-/ );
+ next if ( $item =~ /^modules/ );
+ next if ( $item =~ /^[fm]_trace\.c/ and not $opt_t );
+ next
+ if ( $item =~ /^Makefile/ and index( $update_dir, "/share/" ) < 0 );
+ next if ( $item =~ /^README/ );
+ next if ( $item eq "headers" );
+ next if ( $generated{$item} );
+ next if ( $item eq "link_test.c" );
+
+ if ( index( $dst, "/usr.bin/" ) >= 0 ) {
+ next if ( $item =~ /^(clear)/ ); # OpenBSD uses "tput clear"
+ my $prog = $dst;
+ $prog =~ s%^.*/%%;
+ $prog =~ s/(update|backup)//;
+ $prog .= "c";
+ if ( $dst =~ /infocmp/ ) {
+ next if ( $item ne $prog );
+ }
+ elsif ( $dst =~ /tabs/ ) {
+ next if ( $item ne $prog );
+ }
+ elsif ( $dst =~ /tic/ ) {
+ next if ( &is_tic_code($item) == 0 );
+ }
+ elsif ( $dst =~ /toe/ ) {
+ next if ( $item ne $prog );
+ }
+ elsif ( $dst =~ /tput/ ) {
+ next if ( $item ne $prog );
+ }
+ elsif ( $dst =~ /tset/ ) {
+ next if ( $item ne $prog );
+ }
+ else {
+ next;
+ }
+ }
+ system( sprintf( "cp -a$verbose %s %s/%s", $src_item, $dst, $item ) );
+ &munge_ident("$dst/$item");
+ }
+}
+
+# Checking if nroff supports tables is a long-obsolete issue, and is not really
+# necessary, except to match OpenBSD's source-tree.
+sub uses_tables($) {
+ my $docs = shift;
+ my @docs = &read_file($docs);
+ my $code = 0;
+ for my $n ( 0 .. $#docs ) {
+ if ( $docs[$n] =~ /^[.']\\"\s+t\b.*/ ) {
+ $code = 1;
+ last;
+ }
+ elsif ( $docs[$n] =~ /^\./ ) {
+ last;
+ }
+ }
+ return $code;
+}
+
+sub copy_1doc($$) {
+ my $docs = shift;
+ my $src = "$source_dir/man/$docs";
+ my $dst = "$update_dir/$docs";
+ $src .= "m" if ( -f "${src}m" );
+ $dst =~ s/x$//;
+ if ( $dst =~ /\.3/ ) {
+ $dst =~ s/\bncurses/curses/ if ( $dst =~ /ncurses\./ );
+ $dst =~ s/\bcurs_// if ( $dst =~ /_term(cap|info)\./ );
+ }
+ ©_file( $src, $dst );
+ &munge_docs($dst);
+}
+
+sub copy_docs($) {
+ my $docs = shift;
+ if ( index( $update_dir, "/usr.bin/" ) >= 0 ) {
+ ©_1doc( $docs . ".1" );
+ if ( $docs eq "tic" ) {
+ ©_1doc("captoinfo.1");
+ ©_1doc("infotocap.1");
+ }
+ }
+ else {
+ my @docs = &read_dir("$source_dir/man");
+ if ( $docs eq "curses" ) {
+ for my $n ( 0 .. $#docs ) {
+ next if ( $docs[$n] eq "Makefile" );
+ next if ( $docs[$n] eq "make_sed.sh" );
+ next if ( $docs[$n] eq "man_db.renames" );
+ next if ( $docs[$n] eq "manlinks.sed" );
+ next if ( $docs[$n] =~ /\.(1|head|tail|in)/ );
+ next if ( $docs[$n] =~ /^(form|menu|mitem|panel)/ );
+ ©_1doc( $docs[$n] );
+ }
+ }
+ elsif ( $docs eq "form" ) {
+ for my $n ( 0 .. $#docs ) {
+ next unless ( $docs[$n] =~ /^form/ );
+ ©_1doc( $docs[$n] );
+ }
+ }
+ elsif ( $docs eq "menu" ) {
+ for my $n ( 0 .. $#docs ) {
+ next unless ( $docs[$n] =~ /^(menu|mitem)/ );
+ ©_1doc( $docs[$n] );
+ }
+ }
+ elsif ( $docs eq "panel" ) {
+ for my $n ( 0 .. $#docs ) {
+ next unless ( $docs[$n] =~ /^panel/ );
+ ©_1doc( $docs[$n] );
+ }
+ }
+ }
+}
+
+sub setup_dir($) {
+ my $dst = shift;
+ &failed("no definition for $dst")
+ unless ( defined $setup_dir{$dst} or $opt_r );
+ $target_dir = sprintf( "%s/%s", $opt_d, $dst );
+ $update_dir = $target_dir . ".update";
+ $backup_dir = $target_dir . ".backup";
+ my $result = 0;
+ if ($opt_r) {
+ &remove_dir($update_dir);
+ if ( $target_dir =~ /\/(tabs|toe)$/ ) {
+ &remove_dir($target_dir);
+ }
+ elsif ( -d $backup_dir ) {
+ &remove_dir($target_dir);
+ &rename_dir( $backup_dir, $target_dir );
+ }
+ }
+ else {
+ &remove_dir($update_dir);
+ mkdir $update_dir;
+
+ # reuse the shared-library version, assuming ABI=5 would involve at
+ # most a minor-version bump.
+ ©_file( "$target_dir/shlib_version", $update_dir )
+ if ( $dst =~ /^lib\// );
+ ©_code( $source_dir . "/" . $setup_dir{$dst}, $update_dir )
+ unless ( $setup_dir{$dst} eq "misc" );
+ $result = 1;
+ }
+ return $result;
+}
+
+sub do_build($) {
+ my $command = shift;
+ printf "%% %s\n", $command if ($opt_v);
+ system($command);
+}
+
+sub finish_dir() {
+ printf "** $target_dir\n";
+ system("diff -Naurb $target_dir $update_dir | diffstat -n 30")
+ if ( -d $target_dir );
+ if ($opt_n) {
+ &do_build("cd $update_dir && make -n") if ($opt_x);
+ }
+ else {
+ if ( -d $backup_dir ) {
+ printf STDERR "? backup directory exists: %s\n", $backup_dir;
+ }
+ else {
+ &rename_dir( $target_dir, $backup_dir );
+ &rename_dir( $update_dir, $target_dir );
+ }
+ &do_build("cd $target_dir && make") if ($opt_x);
+ }
+}
+
+################################################################################
+
+sub only_c_files($) {
+ my @data = @{ $_[0] };
+ my %data;
+ for my $n ( 0 .. $#data ) {
+ my $text = $data[$n];
+ $data{$text}++ if ( $text =~ /\.c$/ );
+ }
+ return sort keys %data;
+}
+
+sub makefile_list($$$) {
+ my @data = @{ $_[0] };
+ my $name = $_[1];
+ my $skip = $_[2];
+ my %data;
+ my $state = 0;
+ for my $n ( 0 .. $#data ) {
+ my $text = $data[$n];
+ $text =~ s/^\s+//;
+ next if ( index( $text, $skip ) == 0 );
+ $text =~ s/\s+=/=/;
+ $text =~ s/=\s+/=/;
+ $text =~ s/\s*\\//;
+ $state = 1 if ( $text =~ /^${name}=/ );
+ next unless ( $state == 1 );
+
+ if ( index( $text, "(trace)" ) >= 0 and not $opt_t ) {
+ next unless ( $text =~ /\b(lib_trace|visbuf)\.c$/ );
+ }
+ if ( not $opt_t ) {
+ next if ( $text =~ /\b[fm]_trace\.c$/ );
+ }
+ $text =~ s/^.*=//;
+ $text =~ s/\$o/.o/g;
+ $text =~ s/^.*\///;
+ next if ( $text eq "link_test.c" );
+ next if ( $text eq "mf_common.h" );
+ next if ( $text eq "transform.h" );
+ $data{$text}++ if ( $text ne "" );
+ last if ( $data[$n] !~ /\\$/ );
+ }
+ return sort keys %data;
+}
+
+sub manpage_list($) {
+ my $path = shift;
+ my @data = &read_dir($path);
+ my %data;
+ for my $n ( 0 .. $#data ) {
+ my $text = $data[$n];
+ $data{$text}++ if ( $text =~ /\.\d$/ );
+ }
+ return sort keys %data;
+}
+
+sub columns_of($) {
+ my $string = shift;
+ my $result = 0;
+ for my $n ( 0 .. length($string) - 1 ) {
+ my $c = substr( $string, $n, 1 );
+ if ( $c eq "\t" ) {
+ $result |= 7;
+ $result++;
+ }
+ elsif ( $c eq "\n" ) {
+ $result = 0;
+ }
+ else {
+ ++$result;
+ }
+ }
+ return $result;
+}
+
+sub format_list($$) {
+ my $name = $_[0];
+ my @data = @{ $_[1] };
+ my $keep = ( defined $_[2] ) ? 1 : 0;
+ my $base;
+ my $fill;
+ if ( length($name) >= 9 ) {
+ $fill = " ";
+ $base = length($name) + 1;
+ }
+ else {
+ $base = 9;
+ $fill = "\t";
+ }
+ my $result = sprintf( "%s%s", $name, $fill );
+ if ( $keep == 0 ) {
+ my %data;
+ for my $n ( 0 .. $#data ) {
+ $data{ $data[$n] } = 1 if ( defined $data[$n] );
+ }
+ @data = sort keys %data;
+ }
+ for my $n ( 0 .. $#data ) {
+ my $data = $data[$n];
+ my $col = &columns_of($result);
+ my $add = 1 + length($data);
+ if ( ( $col + $add ) > 76 ) {
+ $result .= " " if ( $col > $base );
+ $base = 9;
+ $fill = "\t";
+ $result .= "\\\n" . $fill . $data;
+ }
+ else {
+ $result .= " " if ( $col > $base );
+ $result .= $data;
+ }
+ }
+ return $result;
+}
+
+################################################################################
+
+sub compare_makefiles($) {
+ if ($opt_v) {
+ my $newfile = shift;
+ my $bakfile =
+ ( -d $backup_dir ? $backup_dir : $target_dir ) . "/Makefile";
+ system("diff -u $bakfile $newfile") if ( -f $bakfile );
+ }
+}
+
+# The curses makefile has to build build-time utilities and generate source.
+sub gen_1st_makefile() {
+ my $libname = "curses";
+ my $oldfile = "$source_dir/n$libname/Makefile";
+ my @oldfile = &read_file($oldfile);
+
+ my $newfile = "$update_dir/Makefile";
+ open( my $fp, ">", $newfile ) || &failed("cannot open $newfile");
+ my @subdirs = (
+ '${.CURDIR}/base', '${.CURDIR}/tinfo',
+ '${.CURDIR}/tty', '${.CURDIR}/widechar'
+ );
+ $subdirs[ $#subdirs + 1 ] = '${.CURDIR}/trace' if ($opt_t);
+ printf $fp <<EOF;
+# $generated_by
+
+LIB= $libname
+
+# Uncomment this to enable tracing in libcurses
+#CURSESTRACE=-DTRACE
+
+# This is used to compile terminal info directly into the library
+FALLBACK_LIST=
+
+# XXX - should be defined elsewhere
+AWK?= /usr/bin/awk
+
+# Search in subdirs
+EOF
+ printf $fp "%s\n", &format_list( ".PATH:", \@subdirs );
+
+ my @autosrc = &makefile_list( \@oldfile, "AUTO_SRC", "?" );
+ my @auto_cc = &only_c_files( \@autosrc );
+ printf $fp "%s\n", &format_list( "SRCS=", \@auto_cc );
+
+ my @sources = &makefile_list( \@oldfile, "C_SRC", "./" );
+ printf $fp "%s\n", &format_list( "SRCS+=", \@sources );
+
+ printf $fp <<EOF;
+
+HOSTCFLAGS?= \${CFLAGS}
+HOSTLDFLAGS?= \${LDFLAGS}
+HOSTCFLAGS+= -I. -I\${.CURDIR} \${CURSESTRACE}
+CFLAGS+= -I. -I\${.CURDIR} \${CURSESTRACE} -D_XOPEN_SOURCE_EXTENDED -DNDEBUG
+
+EOF
+ my @manpages = &manpage_list($update_dir);
+ printf $fp "%s\n", &format_list( "MAN=", \@manpages );
+
+ $autosrc[ $#autosrc++ ] = "make_hash";
+ $autosrc[ $#autosrc++ ] = "make_keys";
+ printf $fp "%s\n", &format_list( "GENERATED=", \@autosrc );
+ printf $fp <<EOF;
+
+CAPLIST = \${.CURDIR}/Caps
+USE_BIG_STRINGS = 1
+
+CLEANFILES+= \${GENERATED}
+
+BUILDFIRST = \${GENERATED}
+
+includes:
+ \@cmp -s \${DESTDIR}/usr/include/ncurses.h \${.CURDIR}/curses.h || \\
+ \${INSTALL} \${INSTALL_COPY} -m 444 -o \$(BINOWN) -g \$(BINGRP) \\
+ \${.CURDIR}/curses.h \${DESTDIR}/usr/include/ncurses.h
+ \@cd \${.CURDIR}; for i in ncurses_dll.h unctrl.h term.h termcap.h; do \\
+ cmp -s \$\$i \${DESTDIR}/usr/include/\$\$i || \\
+ \${INSTALL} \${INSTALL_COPY} -m 444 -o \$(BINOWN) -g \$(BINGRP) \$\$i \\
+ \${DESTDIR}/usr/include; done
+
+keys.list: \${.CURDIR}/tinfo/MKkeys_list.sh
+ sh \${.CURDIR}/tinfo/MKkeys_list.sh \${.CURDIR}/Caps | sort > \${.TARGET}
+
+fallback.c: \${.CURDIR}/tinfo/MKfallback.sh
+ sh \${.CURDIR}/tinfo/MKfallback.sh /usr/share/terminfo \${.CURDIR}/../../share/termtypes/termtypes.master \$(FALLBACK_LIST) > \${.TARGET}
+
+lib_gen.c: \${.CURDIR}/base/MKlib_gen.sh
+ sh \${.CURDIR}/base/MKlib_gen.sh "\${CC} -E -P -I\${.CURDIR}" \\
+ "\${AWK}" generated < \${.CURDIR}/curses.h > lib_gen.c
+
+init_keytry.h: make_keys keys.list
+ ./make_keys keys.list > \${.TARGET}
+
+make_keys: \${.CURDIR}/tinfo/make_keys.c \${.CURDIR}/curses.priv.h names.c
+ \${HOSTCC} \${LDSTATIC} \${HOSTCFLAGS} \${HOSTLDFLAGS} \\
+ -o \${.TARGET} \${.CURDIR}/tinfo/make_keys.c \${LDADD}
+EOF
+
+ if ( &patchdate >= 20090808 ) {
+ printf $fp <<EOF;
+make_hash: \${.CURDIR}/tinfo/make_hash.c \\
+ \${.CURDIR}/curses.priv.h \\
+ \${.CURDIR}/hashsize.h
+ \${HOSTCC} \${LDSTATIC} \${HOSTCFLAGS} -DMAIN_PROGRAM \${HOSTLDFLAGS} \\
+ -o \${.TARGET} \${.CURDIR}/tinfo/make_hash.c \${LDADD}
+EOF
+ }
+ else {
+ printf $fp <<EOF;
+make_hash: \${.CURDIR}/tinfo/comp_hash.c \\
+ \${.CURDIR}/curses.priv.h \\
+ \${.CURDIR}/hashsize.h
+ \${HOSTCC} \${LDSTATIC} \${HOSTCFLAGS} -DMAIN_PROGRAM \${HOSTLDFLAGS} \\
+ -o \${.TARGET} \${.CURDIR}/tinfo/comp_hash.c \${LDADD}
+EOF
+ }
+
+ if ( &patchdate >= 20190309 ) {
+ printf $fp <<EOF;
+CAPLIST += \${.CURDIR}/Caps-ncurses
+
+comp_userdefs.c: make_hash \\
+ \${.CURDIR}/hashsize.h \\
+ \${.CURDIR}/tinfo/MKuserdefs.sh
+ sh \${.CURDIR}/tinfo/MKuserdefs.sh \${AWK} \${USE_BIG_STRINGS} \${CAPLIST} > \${.TARGET}
+EOF
+ }
+ printf $fp <<EOF;
+
+expanded.c: \${.CURDIR}/term.h \${.CURDIR}/curses.priv.h \\
+ \${.CURDIR}/ncurses_cfg.h \${.CURDIR}/tty/MKexpanded.sh
+ sh \${.CURDIR}/tty/MKexpanded.sh "\${CC} -E -P" \${CPPFLAGS} > \${.TARGET}
+
+comp_captab.c: make_hash
+ sh \${.CURDIR}/tinfo/MKcaptab.sh \${AWK} \${USE_BIG_STRINGS} \\
+ \${.CURDIR}/tinfo/MKcaptab.awk \${CAPLIST} > \${.TARGET}
+
+lib_keyname.c: keys.list \${.CURDIR}/base/MKkeyname.awk
+ \${AWK} -f \${.CURDIR}/base/MKkeyname.awk \\
+ bigstrings=\${USE_BIG_STRINGS} \\
+ keys.list > \${.TARGET}
+
+names.c: \${.CURDIR}/tinfo/MKnames.awk
+ \${AWK} -f \${.CURDIR}/tinfo/MKnames.awk \\
+ bigstrings=\${USE_BIG_STRINGS} \\
+ \${CAPLIST} > \${.TARGET}
+codes.c: \${.CURDIR}/tinfo/MKcodes.awk
+ \${AWK} -f \${.CURDIR}/tinfo/MKcodes.awk \\
+ bigstrings=\${USE_BIG_STRINGS} \\
+ \${CAPLIST} > \${.TARGET}
+
+unctrl.c: \${.CURDIR}/base/MKunctrl.awk
+ echo | \${AWK} -f \${.CURDIR}/base/MKunctrl.awk bigstrings=1 > \${.TARGET}
+
+.include <bsd.own.mk>
+
+# Link libtermlib, libtermcap to libcurses so we don't break people's Makefiles
+afterinstall:
+ -cd \${DESTDIR}\${LIBDIR}; \\
+ for i in \${_LIBS}; do \\
+ ln -f \$\$i `echo \$\$i | sed 's/curses/termlib/'`; \\
+ ln -f \$\$i `echo \$\$i | sed 's/curses/termcap/'`; \\
+ ln -f \$\$i `echo \$\$i | sed 's/curses/ncurses/'`; \\
+ ln -f \$\$i `echo \$\$i | sed 's/curses/ncursesw/'`; \\
+ done
+
+.include <bsd.lib.mk>
+EOF
+ close $fp;
+ &compare_makefiles($newfile);
+}
+
+sub gen_lib_makefile($) {
+ my $libname = shift;
+ my $oldfile = "$source_dir/$libname/Makefile";
+ my @oldfile = &read_file($oldfile);
+
+ # in ncurses, header-files are quasi-generated, because the original
+ # header file for form/menu/panel lives in the source-directory, but is
+ # copied to the include-directory with "make sources".
+ my @headers = &makefile_list( \@oldfile, "AUTO_SRC", "?" );
+
+ # The C source is more straightforward.
+ my @sources = &makefile_list( \@oldfile, "C_SRC", "?" );
+ my $newfile = "$update_dir/Makefile";
+ open( my $fp, ">", $newfile ) || &failed("cannot open $newfile");
+ printf $fp <<EOF;
+# $generated_by
+
+LIB= $libname
+EOF
+
+ printf $fp "%s\n", &format_list( "SRCS=", \@sources );
+ printf $fp "%s\n", &format_list( "HDRS=", \@headers );
+ my $includes = '-I${.CURDIR}/../libcurses';
+ $includes .= ' -I${.CURDIR}/../libmenu' if ( $libname eq "form" );
+ printf $fp <<EOF;
+CFLAGS+=$includes -D_XOPEN_SOURCE_EXTENDED -DNDEBUG
+EOF
+ my @manpages = &manpage_list($update_dir);
+ printf $fp "%s\n", &format_list( "MAN=", \@manpages );
+ printf $fp <<EOF;
+
+includes:
+ \@cd \$\{.CURDIR}; for i in \$\{HDRS}; do \\
+ cmp -s \$\$i \${DESTDIR}/usr/include/\$\$i || \\
+ \${INSTALL} \${INSTALL_COPY} -m 444 -o \$(BINOWN) -g \$(BINGRP) \$\$i \\
+ \${DESTDIR}/usr/include; done
+
+.include <bsd.own.mk>
+
+afterinstall:
+ -cd \${DESTDIR}\${LIBDIR}; \\
+ for i in \${_LIBS}; do \\
+ ln -f \$\$i `echo \$\$i | sed 's/${libname}/${libname}w/'`; \\
+ done
+
+.include <bsd.lib.mk>
+EOF
+ close $fp;
+ &compare_makefiles($newfile);
+}
+
+sub gen_bin_makefile($) {
+ my $binname = shift;
+ my $oldfile = "$source_dir/progs/Makefile";
+ my @oldfile = &read_file($oldfile);
+ my $newfile = "$update_dir/Makefile";
+
+ open( my $fp, ">", $newfile ) || &failed("cannot open $newfile");
+ my @sources = ("$binname.c");
+ my @links = ();
+ my @autosrc = &makefile_list( \@oldfile, "AUTO_SRC", "?" );
+
+ my $tput_ver = 0;
+ my $use_dump_entry = 0;
+ my $use_termsort = 0;
+ my $use_tparm_type = 0;
+ my $use_transform = 0;
+
+ $use_dump_entry = 1 if ( $binname eq "infocmp" or $binname eq "tic" );
+ $use_termsort = 1 if ( $use_dump_entry or $binname eq "tput" );
+
+ if ( &patchdate >= 20090314 ) {
+ $use_transform = 1 if ( $binname =~ /^(tic|tput|tset)/ );
+ }
+ if ( &patchdate >= 20140521 ) {
+ $use_tparm_type = 1 if ( $binname =~ /^(tic|tput)$/ );
+ }
+ if ( &patchdate >= 20160806 ) {
+ $tput_ver = &patchdate;
+ }
+
+ $sources[ ++$#sources ] = "dump_entry.c" if ($use_dump_entry);
+ $sources[ ++$#sources ] = "tparm_type.c" if ($use_tparm_type);
+ $sources[ ++$#sources ] = "transform.c" if ($use_transform);
+
+ $autosrc[ ++$#autosrc ] = "termsort.c" if ($use_termsort);
+
+ # transform.h also is generated, but OpenBSD checked-in a copy
+
+ if ( $binname eq "tic" ) {
+ $links[ ++$#links ] = "captoinfo";
+ $links[ ++$#links ] = "infotocap";
+ }
+ elsif ( $binname eq "tabs" ) {
+ $sources[ ++$#sources ] = "tty_settings.c" if ( $tput_ver >= 20161224 );
+ }
+ elsif ( $binname eq "tput" ) {
+ $sources[ ++$#sources ] = "clear_cmd.c" if ( $tput_ver >= 20161022 );
+ $sources[ ++$#sources ] = "reset_cmd.c" if ( $tput_ver >= 20160806 );
+ $sources[ ++$#sources ] = "tty_settings.c" if ( $tput_ver >= 20161224 );
+ $links[ ++$#links ] = "clear";
+ }
+ elsif ( $binname eq "tset" ) {
+ $sources[ ++$#sources ] = "reset_cmd.c" if ( $tput_ver >= 20160806 );
+ $sources[ ++$#sources ] = "tty_settings.c" if ( $tput_ver >= 20161224 );
+ $links[ ++$#links ] = "reset";
+ }
+
+ printf $fp <<EOF;
+# $generated_by
+
+PROG= $binname
+EOF
+ printf $fp "%s\n", &format_list( "SRCS=", \@sources );
+ printf $fp <<EOF;
+CURSES= \${.CURDIR}/../../lib/libcurses
+DPADD= \${LIBCURSES}
+LDADD= -L\${CURSES} -lcurses\t# in-tree link to add _nc_strict_bsd, etc
+EOF
+ if ( $#links >= 0 ) {
+ my @bin_links;
+ for my $n ( 0 .. $#links ) {
+ $bin_links[ ++$#bin_links ] = '${BINDIR}/' . $binname;
+ $bin_links[ ++$#bin_links ] = '${BINDIR}/' . $links[$n];
+ }
+ printf $fp "%s\n", &format_list( "LINKS=", \@bin_links, 1 );
+ }
+ my $ticfix = '${.CURDIR}/';
+ if ( $binname eq "tic" ) {
+ printf $fp <<EOF;
+CFLAGS+= -I\${CURSES} -I\${.CURDIR} -I.
+EOF
+ }
+ else {
+ $ticfix = '${TIC}/';
+ printf $fp <<EOF;
+TIC= \${.CURDIR}/../tic
+CFLAGS+= -I\${CURSES} -I\${TIC} -I\${.CURDIR} -I.
+.PATH: \${TIC}
+EOF
+ }
+ printf $fp "%s\n", &format_list( "CLEANFILES+=", \@autosrc );
+ if ($use_dump_entry) {
+ printf $fp <<EOF;
+
+dump_entry.o: termsort.c
+EOF
+ }
+ if ($use_termsort) {
+ printf $fp <<EOF;
+
+termsort.c: ${ticfix}MKtermsort.sh
+ sh ${ticfix}MKtermsort.sh awk \${CURSES}/Caps > \${.TARGET}
+EOF
+ }
+ printf $fp <<EOF;
+
+.include <bsd.prog.mk>
+EOF
+ close $fp;
+
+ &compare_makefiles($newfile);
+}
+
+################################################################################
+
+sub setup_lib_libcurses() {
+ if ( &setup_dir("lib/libcurses") ) {
+ ©_code( "$source_dir/ncurses/base", "$update_dir/base" );
+ ©_code( "$source_dir/ncurses/tinfo", "$update_dir/tinfo" );
+ ©_code( "$source_dir/ncurses/tty", "$update_dir/tty" );
+ ©_code( "$source_dir/ncurses/widechar", "$update_dir/widechar" );
+ ©_file( "$source_dir/include/Caps", $update_dir );
+ ©_file( "$source_dir/include/capdefaults.c", $update_dir );
+ ©_file( "$source_dir/include/curses.h", $update_dir );
+ ©_file( "$source_dir/include/hashed_db.h", $update_dir );
+ ©_file( "$source_dir/include/hashsize.h", $update_dir );
+ ©_file( "$source_dir/include/nc_alloc.h", $update_dir );
+ ©_file( "$source_dir/include/nc_panel.h", $update_dir );
+ ©_file( "$source_dir/include/nc_tparm.h", $update_dir );
+ ©_file( "$source_dir/include/ncurses_cfg.h", $update_dir );
+ ©_file( "$source_dir/include/ncurses_def.h", $update_dir );
+ ©_file( "$source_dir/include/ncurses_dll.h", $update_dir );
+ ©_file( "$source_dir/include/parametrized.h", $update_dir );
+ ©_file( "$source_dir/include/term.h", $update_dir );
+ ©_file( "$source_dir/include/termcap.h", $update_dir );
+ ©_file( "$source_dir/include/term_entry.h", $update_dir );
+ ©_file( "$source_dir/include/tic.h", $update_dir );
+ ©_file( "$source_dir/include/unctrl.h", $update_dir );
+ ©_file( "$source_dir/man/terminfo.5", $update_dir );
+ ©_docs("curses");
+
+ &verbose(".. work around a bug in /bin/sh in OpenBSD");
+ system( "sed -i"
+ . " -e 's,^shift,test \$# != 0 \\&\\& shift,'"
+ . " $update_dir/tinfo/MKfallback.sh" );
+
+ # OpenBSD dropped support for sys/ttydev.h, without mentioning the
+ # system version. Just trim it.
+ &verbose(".. work around mishandled sys/ttydef.h");
+ system( "sed -i"
+ . " -e '/__FreeBSD_version/s,|| defined(__OpenBSD__),,'"
+ . " $update_dir/tinfo/lib_baudrate.c" );
+
+ if ($opt_t) {
+ ©_code( "$source_dir/ncurses/trace", "$update_dir/trace" );
+ }
+ else {
+ ©_file( "$source_dir/ncurses/trace/lib_trace.c", $update_dir );
+ ©_file( "$source_dir/ncurses/trace/visbuf.c", $update_dir );
+ }
+ ©_file( "$source_dir/include/nc_termios.h", $update_dir )
+ if ( &patchdate >= 20110625 );
+ ©_file( "$source_dir/include/nc_string.h", $update_dir )
+ if ( &patchdate >= 20120222 );
+ ©_file( "$source_dir/include/nc_access.h", $update_dir )
+ if ( &patchdate >= 20210626 );
+ ©_file( "$source_dir/include/Caps-ncurses", $update_dir )
+ if ( &patchdate >= 20190302 );
+ &gen_1st_makefile;
+ &finish_dir;
+ }
+}
+
+sub setup_lib_libform() {
+ if ( &setup_dir("lib/libform") ) {
+ ©_docs("form");
+ &gen_lib_makefile("form");
+ &finish_dir;
+ }
+}
+
+sub setup_lib_libmenu() {
+ if ( &setup_dir("lib/libmenu") ) {
+ ©_docs("menu");
+ &gen_lib_makefile("menu");
+ &finish_dir;
+ }
+}
+
+sub setup_lib_libpanel() {
+ if ( &setup_dir("lib/libpanel") ) {
+ ©_docs("panel");
+ &gen_lib_makefile("panel");
+ &finish_dir;
+ }
+}
+
+sub setup_bin_infocmp() {
+ if ( &setup_dir("usr.bin/infocmp") ) {
+ ©_docs("infocmp");
+ &gen_bin_makefile("infocmp");
+ &finish_dir;
+ }
+}
+
+sub setup_bin_tabs() {
+ if ( &setup_dir("usr.bin/tabs") ) {
+ ©_docs("tabs");
+ &gen_bin_makefile("tabs");
+ &finish_dir;
+ }
+}
+
+sub setup_bin_tic() {
+ if ( &setup_dir("usr.bin/tic") ) {
+ if ( &patchdate >= 20140521 ) {
+ ©_file( "$source_dir/progs/tparm_type.c", $update_dir );
+ ©_file( "$source_dir/progs/tparm_type.h", $update_dir );
+ }
+
+ # shared files for tput/tset
+ if ( &patchdate >= 20160806 ) {
+ ©_file( "$source_dir/progs/reset_cmd.c", $update_dir );
+ ©_file( "$source_dir/progs/reset_cmd.h", $update_dir );
+ }
+ if ( &patchdate >= 20161022 ) {
+ ©_file( "$source_dir/progs/clear_cmd.c", $update_dir );
+ ©_file( "$source_dir/progs/clear_cmd.h", $update_dir );
+ }
+ if ( &patchdate >= 20161224 ) {
+ ©_file( "$source_dir/progs/tty_settings.c", $update_dir );
+ ©_file( "$source_dir/progs/tty_settings.h", $update_dir );
+ }
+ ©_docs("tic");
+ &gen_bin_makefile("tic");
+ &finish_dir;
+ }
+}
+
+sub setup_bin_toe() {
+ if ( &setup_dir("usr.bin/toe") ) {
+ ©_docs("toe");
+ &gen_bin_makefile("toe");
+ &finish_dir;
+ }
+}
+
+sub setup_bin_tput() {
+ if ( &setup_dir("usr.bin/tput") ) {
+ ©_docs("tput");
+ &gen_bin_makefile("tput");
+ &finish_dir;
+ }
+}
+
+sub setup_bin_tset() {
+ if ( &setup_dir("usr.bin/tset") ) {
+ ©_docs("tset");
+ &gen_bin_makefile("tset");
+ &finish_dir;
+ }
+}
+
+sub setup_terminfo() {
+ if ( &setup_dir("share/termtypes") ) {
+ ©_code( $target_dir, $update_dir );
+ ©_file( "$source_dir/misc/terminfo.src",
+ "$update_dir/termtypes.master" );
+
+ # build the terminfo database using the in-tree tic.
+ # This is always best practice, but for ncurses 6.2 in particular is
+ # required.
+ my $prog = abs_path("$target_dir/../../usr.bin/tic");
+ my $libs = abs_path("$target_dir/../../lib/libcurses");
+ if ( defined $prog and defined $libs ) {
+ $prog .= "/tic";
+ &verbose(".. changing makefile to use in-tree tic");
+ system( "sed -i -E "
+ . "-e 's,(TIC=).*,\\1\t$prog,' "
+ . "-e 's,(\\\${TIC}),LD_LIBRARY_PATH=$libs \\1,' "
+ . "$update_dir/Makefile" );
+ }
+ &finish_dir;
+ }
+}
+
+sub configure_tree() {
+ return if ( -f "ncurses/Makefile" );
+ my @search = ( "/usr/share/terminfo", "/usr/local/share/terminfo" );
+ my @prefix = ("./configure");
+ $prefix[ ++$#prefix ] = "--with-abi-version=5"
+ if ( &patchdate >= 20150502 );
+ my @options = (
+ "--with-ospeed=int", #
+ "--with-shared", #
+ "--without-normal", #
+ "--without-debug", #
+ "--with-terminfo-dirs=" . join( ':', @search ), #
+ "--without-ada", #
+ "--disable-hard-tabs", #
+ "--enable-const", #
+ "--enable-getcap", #
+ "--enable-bsdpad", #
+ "--enable-signed-char", #
+ "--enable-termcap", #
+ "--enable-widec"
+ );
+ $options[ ++$#options ] = "--with-trace" if ($opt_t);
+ $options[ ++$#options ] = "--enable-string-hacks"
+ if ( &patchdate >= 20120225 );
+ system( join( ' ', @prefix ) . ' ' . join( ' ', @options ) );
+ &failed("problem with configuring") unless ( -f "ncurses/Makefile" );
+
+ system("make sources");
+
+ # OpenBSD developers edit the generated file and do not regen it when
+ # doing upgrades. This script reflects those edits.
+ system( "sed -i" . " -E"
+ . " -e '/TYPEOF_CHTYPE/s,int,long,'"
+ . " -e '/USE_TERMCAP/d'"
+ . " -e '/HAVE_LIB(FORM|MENU|PANEL)/s,^(.*)\$,/* \\1 */,'"
+ . " -e 's/TERMPATH.*/PURE_TERMINFO 0/'"
+ . " -e '/SYSTEM_NAME/s,\[0-9.\]+,,'"
+ . " include/ncurses_cfg.h" );
+}
+
+sub get_definitions() {
+ my @data = &read_file("dist.mk");
+ for my $n ( 0 .. $#data ) {
+ my $text = $data[$n];
+ $text =~ s/^\s*//;
+ next unless ( $text =~ /^NCURSES.*=/ );
+ $text =~ s/\s*=\s+/=/;
+ my $name = $text;
+ $name =~ s/=.*//;
+ my $value = $text;
+ $value =~ s/^[^=]*=//;
+ $value =~ s/\s.*//;
+ $definitions{$name} = $value;
+ }
+}
+
+sub setup_all_dirs() {
+ printf "** %s all build-directories\n", $opt_r ? "removing" : "setting up";
+ &get_definitions;
+ &configure_tree unless ($opt_r);
+ &setup_lib_libcurses;
+ &setup_lib_libmenu;
+ &setup_lib_libform; # build after libmenu, for mf_common.h
+ &setup_lib_libpanel;
+ &setup_bin_tic; # do this first, for shared headers
+ &setup_bin_infocmp;
+ &setup_bin_tabs if ( -f "$source_dir/progs/tabs.c" );
+ &setup_bin_toe;
+ &setup_bin_tput;
+ &setup_bin_tset;
+ &setup_terminfo;
+}
+
+sub usage() {
+ print <<EOF;
+Usage: ncu2openbsd [options] [sourcetree]
+
+Options:
+ -d DST specify destination (default: /usr/src)
+ -n no-op, do not update destination
+ -r remove update, restore sources from ".orig"
+ -t enable ncurses trace
+ -v verbose
+ -x build each directory after setting up
+EOF
+ exit;
+}
+
+$Getopt::Std::STANDARD_HELP_VERSION = 1;
+&getopts('d:nrtvx') || &usage();
+$opt_d = "/usr/src" unless ($opt_d);
+&usage() unless ( $#ARGV <= 0 );
+
+if ( $#ARGV == 0 ) {
+ if ( -f $ARGV[0] ) {
+ printf "** unpacking sources: %s\n", $ARGV[0];
+ &unpack( $ARGV[0] );
+ }
+ else {
+ &check_sourcedir( $ARGV[0] );
+ }
+}
+else {
+ &check_sourcedir(".");
+}
+
+&setup_all_dirs;
+
+# move out of temp-directory to allow cleanup.
+chdir $current;
+
+1;
#undef attroff
int attroff(
- int z)
+ NCURSES_ATTR_T z)
{ return(*(int *)0); }
#undef attron
int attron(
- int z)
+ NCURSES_ATTR_T z)
{ return(*(int *)0); }
#undef attrset
int attrset(
- int z)
+ NCURSES_ATTR_T z)
{ return(*(int *)0); }
#undef attr_get
#undef attroff
int attroff(
- int z)
+ NCURSES_ATTR_T z)
{ return(*(int *)0); }
#undef attron
int attron(
- int z)
+ NCURSES_ATTR_T z)
{ return(*(int *)0); }
#undef attrset
int attrset(
- int z)
+ NCURSES_ATTR_T z)
{ return(*(int *)0); }
#undef attr_get
#undef attroff
int attroff(
- int z)
+ NCURSES_ATTR_T z)
{ return(*(int *)0); }
#undef attron
int attron(
- int z)
+ NCURSES_ATTR_T z)
{ return(*(int *)0); }
#undef attrset
int attrset(
- int z)
+ NCURSES_ATTR_T z)
{ return(*(int *)0); }
#undef attr_get
#undef attroff
int attroff(
- int z)
+ NCURSES_ATTR_T z)
{ return(*(int *)0); }
#undef attron
int attron(
- int z)
+ NCURSES_ATTR_T z)
{ return(*(int *)0); }
#undef attrset
int attrset(
- int z)
+ NCURSES_ATTR_T z)
{ return(*(int *)0); }
#undef attr_get
-ncurses6 (6.2+20211018) unstable; urgency=low
+ncurses6 (6.3+20211021) unstable; urgency=low
* latest weekly patch
- -- Thomas E. Dickey <dickey@invisible-island.net> Mon, 18 Oct 2021 19:31:58 -0400
+ -- Thomas E. Dickey <dickey@invisible-island.net> Wed, 20 Oct 2021 18:43:08 -0400
ncurses6 (5.9-20131005) unstable; urgency=low
-ncurses6 (6.2+20211018) unstable; urgency=low
+ncurses6 (6.3+20211021) unstable; urgency=low
* latest weekly patch
- -- Thomas E. Dickey <dickey@invisible-island.net> Mon, 18 Oct 2021 19:31:58 -0400
+ -- Thomas E. Dickey <dickey@invisible-island.net> Wed, 20 Oct 2021 18:43:08 -0400
ncurses6 (5.9-20131005) unstable; urgency=low
-ncurses6 (6.2+20211018) unstable; urgency=low
+ncurses6 (6.3+20211021) unstable; urgency=low
* latest weekly patch
- -- Thomas E. Dickey <dickey@invisible-island.net> Mon, 18 Oct 2021 19:31:58 -0400
+ -- Thomas E. Dickey <dickey@invisible-island.net> Wed, 20 Oct 2021 18:43:08 -0400
ncurses6 (5.9-20120608) unstable; urgency=low
-; $Id: mingw-ncurses.nsi,v 1.484 2021/10/18 23:31:58 tom Exp $\r
+; $Id: mingw-ncurses.nsi,v 1.486 2021/10/20 22:43:08 tom Exp $\r
\r
; TODO add examples\r
; TODO bump ABI to 6\r
!define EXENAME "ncurses.exe"\r
\r
!define VERSION_MAJOR "6"\r
-!define VERSION_MINOR "2"\r
+!define VERSION_MINOR "3"\r
!define VERSION_YYYY "2021"\r
-!define VERSION_MMDD "1018"\r
+!define VERSION_MMDD "1021"\r
!define VERSION_PATCH ${VERSION_YYYY}${VERSION_MMDD}\r
\r
!define MY_ABI "5"\r
Summary: shared libraries for terminal handling
Name: mingw32-ncurses6
-Version: 6.2
-Release: 20211018
+Version: 6.3
+Release: 20211021
License: X11
Group: Development/Libraries
Source: ncurses-%{version}-%{release}.tgz
Summary: shared libraries for terminal handling
Name: ncurses6
-Version: 6.2
-Release: 20211018
+Version: 6.3
+Release: 20211021
License: X11
Group: Development/Libraries
Source: ncurses-%{version}-%{release}.tgz
Summary: Curses library with POSIX thread support.
Name: ncursest6
-Version: 6.2
-Release: 20211018
+Version: 6.3
+Release: 20211021
License: X11
Group: Development/Libraries
Source: ncurses-%{version}-%{release}.tgz