X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Ftic.1m.html;h=d68a6aba65d37c6bd29d8ea3a7f4a9b2610f25f8;hp=035afa1ead4e0d34a32d9e0371aeda9ecd85d0c6;hb=a8dfaf0998c91b39c5c0a4913987cd67ca622bff;hpb=9193d076200365eeb5ff932acdbbdcc5e452292c diff --git a/doc/html/man/tic.1m.html b/doc/html/man/tic.1m.html index 035afa1e..d68a6aba 100644 --- a/doc/html/man/tic.1m.html +++ b/doc/html/man/tic.1m.html @@ -26,7 +26,7 @@ * sale, use or other dealings in this Software without prior written * * authorization. * **************************************************************************** - * @Id: tic.1m,v 1.69 2019/05/18 22:48:40 tom Exp @ + * @Id: tic.1m,v 1.74 2019/07/20 17:57:09 tom Exp @ --> @@ -324,35 +324,108 @@ will be printed. -
- There is some evidence that historic tic implementations treated - description fields with no whitespace in them as additional aliases or +
+ System V Release 2 provided a tic utility. It accepted a single + option: -v (optionally followed by a number). According to Ross + Ridge's comment in mytinfo, this version of tic was unable to represent + cancelled capabilities. + + System V Release 3 provided a different tic utility, written by Pavel + Curtis, (originally named "compile" in pcurses). This added an option + -c to check the file for errors, with the caveat that errors in "use=" + links would not be reported. System V Release 3 documented a few warn- + ing messages which did not appear in pcurses. While the program itself + was changed little as development continued with System V Release 4, + the table of capabilities grew from 180 (pcurses) to 464 (Solaris). + + In early development of ncurses (1993), Zeyd Ben-Halim used the table + from mytinfo to extend the pcurses table to 469 capabilities (456 + matched SVr4, 8 were only in SVr4, 13 were not in SVr4). Of those 13, + 11 were ultimately discarded (perhaps to match the draft of X/Open + Curses). The exceptions were memory_lock_above and memory_unlock (see + user_caps(5)). + + Eric Raymond incorporated parts of mytinfo into ncurses to implement + the termcap-to-terminfo source conversion, and extended that to begin + development of the corresponding terminfo-to-termcap source conversion, + Thomas Dickey completed that development over the course of several + years. + + In 1999, Thomas Dickey added the -x option to support user-defined + capabilities. + + In 2010, Roy Marples provided a tic program and terminfo library for + NetBSD. This implementation adapts several features from ncurses, + including tic's -x option. + + The -c option tells tic to check for problems in the terminfo source + file. Continued development provides additional checks: + + o pcurses had 8 warnings + + o ncurses in 1996 had 16 warnings + + o Solaris (SVr4) curses has 28 warnings + + o NetBSD tic in 2019 has 19 warnings. + + o ncurses in 2019 has 96 warnings + + The checking done in ncurses' tic helps with the conversion to termcap, + as well as pointing out errors and inconsistencies. It is also used to + ensure consistency with the user-defined capabilities. There are 527 + distinct capabilities in ncurses' terminal database; 128 of those are + user-defined. + + +
+ X/Open Curses, Issue 7 (2009) provides a brief description of tic. It + lists one option: -c. The omission of -v is unexpected. The change + history states that the description is derived from True64 UNIX. + According to its manual pages, that system also supported the -v + option. + + Shortly after Issue 7 was released, Tru64 was discontinued. As of + 2019, the surviving implementations of tic are SVr4 (AIX, HP-UX and + Solaris), ncurses and NetBSD curses. + + The X/Open rationale states that some implementations of tic read ter- + minal descriptions from the standard input if the file parameter is + omitted. None of these implementations do that. Further, it comments + that some may choose to read from "./terminfo.src" but that is obsoles- + cent behavior from SVr2, and is not (for example) a documented feature + of SVr3. + + +
+ There is some evidence that historic tic implementations treated + description fields with no whitespace in them as additional aliases or short names. This tic does not do that, but it does warn when descrip- - tion fields may be treated that way and check them for dangerous char- + tion fields may be treated that way and check them for dangerous char- acters. -
- Unlike the SVr4 tic command, this implementation can actually compile - termcap sources. In fact, entries in terminfo and termcap syntax can - be mixed in a single source file. See terminfo(5) for the list of +
+ Unlike the SVr4 tic command, this implementation can actually compile + termcap sources. In fact, entries in terminfo and termcap syntax can + be mixed in a single source file. See terminfo(5) for the list of termcap names taken to be equivalent to terminfo names. - The SVr4 manual pages are not clear on the resolution rules for use - capabilities. This implementation of tic will find use targets any- - where in the source file, or anywhere in the file tree rooted at TER- - MINFO (if TERMINFO is defined), or in the user's $HOME/.terminfo data- + The SVr4 manual pages are not clear on the resolution rules for use + capabilities. This implementation of tic will find use targets any- + where in the source file, or anywhere in the file tree rooted at TER- + MINFO (if TERMINFO is defined), or in the user's $HOME/.terminfo data- base (if it exists), or (finally) anywhere in the system's file tree of compiled entries. - The error messages from this tic have the same format as GNU C error + The error messages from this tic have the same format as GNU C error messages, and can be parsed by GNU Emacs's compile facility. - The -0, -1, -C, -G, -I, -N, -R, -T, -V, -a, -e, -f, -g, -o, -r, -s, -t + The -0, -1, -C, -G, -I, -N, -R, -T, -V, -a, -e, -f, -g, -o, -r, -s, -t and -x options are not supported under SVr4. The SVr4 -c mode does not - report bad use links. + report bad "use=" links. - System V does not compile entries to or read entries from your + System V does not compile entries to or read entries from your $HOME/.terminfo database unless TERMINFO is explicitly set to it. @@ -365,7 +438,7 @@ infocmp(1m), captoinfo(1m), infotocap(1m), toe(1m), curses(3x), term(5). terminfo(5). user_caps(5). - This describes ncurses version 6.1 (patch 20190713). + This describes ncurses version 6.1 (patch 20190720).
@@ -387,8 +460,13 @@