On Sat, Jan 03, 2026 at 08:17:22PM -0600, G. Branden Robinson wrote:
> At 2026-01-04T02:05:17+0000, Thomas Dickey wrote:
> > 20260103
> [..]
> >     + add NQ to list of user-definable capabilities in user_caps(5) (patch
> >       by Jakub Horky)
> 
> I don't see any changes to any man pages in this Git tag...?

it's referring to the terminfo.src file.  I generally copy the lines of
history from that file to NEWS.

> Incidentally, on my ncurses to-do list for the short term is the
> addition of rv/RV to that same man page, since they are otherwise
> undocumented.  They make recurring appearances in the ncurses change
> log, and featured in the release notes for 6.6.

They're used in tack but not explicitly tested in ncurses.
I've a to-do for tack to document those in tack's manual page.

For ncurses, I have a macro UserCap to keep track of the ones to document:

ncurses/tinfo/tinfo_driver.c:331:                                               
          UserCap(AX))
ncurses/tinfo/tinfo_driver.c:922:    sp->_mouse_xtermcap = 
NCURSES_SP_NAME(tigetstr) (NCURSES_SP_ARGx UserCap(XM));
ncurses/tinfo/lib_setup.c:800:    } else if ((value = tigetnum(UserCap(U8))) >= 
0) {
ncurses/tinfo/lib_tparm.c:1131:     check = tigetstr(UserCap(Cs));
ncurses/tinfo/lib_tparm.c:1135:     check = tigetstr(UserCap(Ms));
ncurses/tinfo/lib_tparm.c:1359:         check = tigetstr(UserCap(xm));
ncurses/tinfo/lib_tparm.c:1363:         check = tigetstr(UserCap(S0));
ncurses/curses.priv.h:372:#define UserCap(name) #name
ncurses/base/lib_mouse.c:390:    sp->_mouse_xtermcap = tigetstr(UserCap(XM));
ncurses/base/lib_mouse.c:419:   int code = tigetnum(UserCap(XM));
ncurses/base/lib_color.c:251:    static NCURSES_CONST char name[] = 
UserCap(RGB);
ncurses/base/lib_dft_fgbg.c:79:     SP_PARM->_has_sgr_39_49 = 
(tigetflag(UserCap(AX)) == TRUE);
progs/clear_cmd.c:59:   char *E3 = tigetstr(UserCap(E3));
test/test_mouse.c:52:    xtermcap = tigetstr(UserCap(XM));
test/parse_rgb.h:61:    if (tigetflag(UserCap(RGB)) > 0) {
test/parse_rgb.h:64:    } else if ((bits = tigetnum(UserCap(RGB))) > 0) {
test/parse_rgb.h:67:    } else if ((data = tigetstr(UserCap(RGB))) != 
ABSENT_STRING
test/test.priv.h:911:#define UserCap(name) #name

...and it appears that Cs, Ms, and S0 may need attention in ncurses.

In a different section of user_caps, though, e.g., "some applications use
these capabilities, ncurses analyzes them to determine the expected number
of parameters").

ncurses doesn't _use_ those, but does syntax checks using the data in
Caps-ncurses to support the check for string-parameters.

-- 
Thomas E. Dickey <[email protected]>
https://invisible-island.net

Attachment: signature.asc
Description: PGP signature

Reply via email to