X-Git-Url: http://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 @@
PROCESSING
-COMPATIBILITY
-EXTENSIONS
+HISTORY
+PORTABILITY
+
+
FILES
SEE ALSO
AUTHOR