X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Ftic.1m.html;h=742160ede535786ee8f76b474ac578d0fe87a3b3;hp=e7963e618abc9af37e431837fc4ce4f0a32fedf6;hb=77afe78361875f531dc2bf8d73f2e781c8e76176;hpb=46722468f47c2b77b3987729b4bcf2321cccfd01;ds=sidebyside diff --git a/doc/html/man/tic.1m.html b/doc/html/man/tic.1m.html index e7963e61..742160ed 100644 --- a/doc/html/man/tic.1m.html +++ b/doc/html/man/tic.1m.html @@ -1,7 +1,7 @@
@@ -40,6 +40,10 @@+tic(1m) tic(1m) + + +
@@ -48,7 +52,7 @@
- tic [-1CGILNTVacfgrstx] [-e names] [-o dir] [-R subset] + tic [-1CGILNTUVacfgrstx] [-e names] [-o dir] [-R subset] [-v[n]] [-w[n]] file @@ -82,10 +86,12 @@ rather than discarding them. Capabilities are com- mented by prefixing them with a period. This sets the -x option, because it treats the commented-out - entries as user-defined names. + entries as user-defined names. If the source is + termcap, accept the 2-character names required by + version 6. Otherwise these are ignored. -C Force source translation to termcap format. Note: - this differs from the -C option of infocmp(1m) in + this differs from the -C option of infocmp(1m) in that it does not merely translate capability names, but also translates terminfo strings to termcap format. Capabilities that are not translatable are @@ -110,7 +116,7 @@ it. The option value is interpreted as a file con- taining the list if it contains a '/'. (Note: depending on how tic was compiled, this option may - require -I or -C.) + require -I or -C.) -f Display complex terminfo strings which contain if/then/else/endif expressions indented for read- @@ -154,11 +160,11 @@ -r Force entry resolution (so there are no remaining tc capabilities) even when doing translation to - termcap format. This may be needed if you are - preparing a termcap file for a termcap library - (such as GNU termcap through version 1.3 or BSD - termcap through 4.3BSD) that does not handle multi- - ple tc capabilities per entry. + termcap format. This may be needed if you are pre- + paring a termcap file for a termcap library (such + as GNU termcap through version 1.3 or BSD termcap + through 4.3BSD) that does not handle multiple tc + capabilities per entry. -s Summarize the compile by showing the directory into which entries are written, and the number of @@ -173,29 +179,37 @@ Normally when translating from terminfo to termcap, untranslatable capabilities are commented-out. - -V reports the version of ncurses which was used in - this program, and exits. - - -vn specifies that (verbose) output be written to stan- - dard error trace information showing tic's - progress. The optional integer n is a number from - 1 to 10, inclusive, indicating the desired level of - detail of information. If n is omitted, the - default level is 1. If n is specified and greater - than 1, the level of detail is increased. - - -wn specifies the width of the output. - - -x Treat unknown capabilities as user-defined. That - is, if you supply a capability name which tic does - not recognize, it will infer its type (boolean, - number or string) from the syntax and make an - extended table entry for that. - - file contains one or more terminfo terminal descriptions - in source format [see terminfo(5)]. Each descrip- - tion in the file describes the capabilities of a - particular terminal. + -U tells tic to not post-process the data after parsing + the source file. Normally, it infers data which is + commonly missing in older terminfo data, or in term- + caps. + + -V reports the version of ncurses which was used in this + program, and exits. + + -vn specifies that (verbose) output be written to stan- + dard error trace information showing tic's progress. + The optional parameter n is a number from 1 to 10, + inclusive, indicating the desired level of detail of + information. If n is omitted, the default level is + 1. If n is specified and greater than 1, the level + of detail is increased. + + -wn specifies the width of the output. The parameter is + optional. If it is omitted, it defaults to 60. + + -x Treat unknown capabilities as user-defined. That is, + if you supply a capability name which tic does not + recognize, it will infer its type (boolean, number or + string) from the syntax and make an extended table + entry for that. User-defined capability strings + whose name begins with ``k'' are treated as function + keys. + + file contains one or more terminfo terminal descriptions + in source format [see terminfo(5)]. Each description + in the file describes the capabilities of a particu- + lar terminal. The debug flag levels are as follows: @@ -211,48 +225,48 @@ 8 List of tokens encountered by scanner - 9 All values computed in construction of the hash - table + 9 All values computed in construction of the hash ta- + ble - If the debug level n is not given, it is taken to be one. + If the debug level n is not given, it is taken to be one. All but one of the capabilities recognized by tic are doc- umented in terminfo(5). The exception is the use capabil- ity. - When a use=entry-name field is discovered in a terminal - entry currently being compiled, tic reads in the binary - from /usr/share/terminfo to complete the entry. (Entries - created from file will be used first. If the environment - variable TERMINFO is set, that directory is searched + When a use=entry-name field is discovered in a terminal + entry currently being compiled, tic reads in the binary + from /usr/share/terminfo to complete the entry. (Entries + created from file will be used first. If the environment + variable TERMINFO is set, that directory is searched instead of /usr/share/terminfo.) tic duplicates the capa- - bilities in entry-name for the current entry, with the - exception of those capabilities that explicitly are + bilities in entry-name for the current entry, with the + exception of those capabilities that explicitly are defined in the current entry. - When an entry, e.g., entry_name_1, contains a - use=entry_name_2 field, any canceled capabilities in - entry_name_2 must also appear in entry_name_1 before use= + When an entry, e.g., entry_name_1, contains a + use=entry_name_2 field, any canceled capabilities in + entry_name_2 must also appear in entry_name_1 before use= for these capabilities to be canceled in entry_name_1. - If the environment variable TERMINFO is set, the compiled + If the environment variable TERMINFO is set, the compiled results are placed there instead of /usr/share/terminfo. Total compiled entries cannot exceed 4096 bytes. The name - field cannot exceed 512 bytes. Terminal names exceeding - the maximum alias length (32 characters on systems with + field cannot exceed 512 bytes. Terminal names exceeding + the maximum alias length (32 characters on systems with long filenames, 14 characters otherwise) will be truncated - to the maximum alias length and a warning message will be + to the maximum alias length and a warning message will be printed.
- 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 description fields may be - treated that way and check them for dangerous characters. + 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 description fields may be + treated that way and check them for dangerous characters.@@ -277,7 +291,7 @@ The -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. + SVr4 -c mode does not report bad use links. System V does not compile entries to or read entries from your $HOME/.terminfo directory unless TERMINFO is explic- @@ -295,36 +309,11 @@ infocmp(1m), captoinfo(1m), infotocap(1m), toe(1m), curses(3x), terminfo(5). + This describes ncurses version 5.7 (patch 20100109). - - - - - - - - - - - - - - - - - - - - - - - - - - - + tic(1m)