Re: Documenting CO capability in user_caps(5)

[Thomas Dickey]

On Tue, Dec 31, 2024 at 12:24:50PM +0100, Andrea Pappacoda wrote:
> Hi!
> 
> I've noticed that all the xterm-direct variants contain a "CO" (uppercase
> "c" and uppercase "o") which indicates how many indexed colors alias with
> direct colors.
> 
> Documentation of the option, though, is only found in include/Caps-ncurses
> and misc/terminfo.src.

That's intentional.  It's in Caps-ncurses so that tic can provide proper
diagnostics, and in misc/terminfo.src for informational purposes.
 
> Is there a reason why it hasn't been documented in user_caps(5) alongside
> capabilities like U8 and RGB?

man user_caps:

   Recognized capabilities
       The ncurses library uses the user-definable  capabilities.   While  the
       terminfo  database  may  have  other extensions, ncurses makes explicit
       checks for these:
 
The ncurses library doesn't use that capability, so it's documented only
in the terminfo database.  Those less-documented features do not interfere
with ncurses, but do not help it, either.

> Would this capability ever be useful to users of the terminfo database which
> do not use the curses library?

sure - but presumably those people can read the comments in the database,
because it's on the web.
 
> If appropriate, I can send a patch documenting it.
> 
> Bye :D
> 
> [please Cc me in replies, as I'm not subscribed (yet?)]



-- 
Thomas E. Dickey <dickey@invisible-island.net>
https://invisible-island.net

signature.asc
Description: PGP signature