diff options
Diffstat (limited to 'ncurses-5.2/doc/html/man/tic.1m.html')
-rw-r--r-- | ncurses-5.2/doc/html/man/tic.1m.html | 297 |
1 files changed, 0 insertions, 297 deletions
diff --git a/ncurses-5.2/doc/html/man/tic.1m.html b/ncurses-5.2/doc/html/man/tic.1m.html deleted file mode 100644 index eddb819..0000000 --- a/ncurses-5.2/doc/html/man/tic.1m.html +++ /dev/null @@ -1,297 +0,0 @@ -<HTML> -<BODY> -<PRE> -<!-- Manpage converted by man2html 3.0.1 --> - -</PRE> -<H2>NAME</H2><PRE> - <B>tic</B> - the <I>terminfo</I> entry-description compiler - - -</PRE> -<H2>SYNOPSIS</H2><PRE> - <B>tic</B> [<B>-1CINRTVacfrsx</B>] [<B>-e</B> <I>names</I>] [<B>-o</B> <I>dir</I>] [<B>-v</B>[<I>n</I>]] [<B>-w</B>[<I>n</I>]] - <I>file</I> - - -</PRE> -<H2>DESCRIPTION</H2><PRE> - The command <B>tic</B> translates a <B>terminfo</B> file from source - format into compiled format. The compiled format is nec- - essary for use with the library routines in <B><A HREF="ncurses.3x.html">ncurses(3x)</A></B>. - - The results are normally placed in the system terminfo - directory <B>/usr/share/terminfo</B>. There are two ways to - change this behavior. - - First, you may override the system default by setting the - variable <B>TERMINFO</B> in your shell environment to a valid - (existing) directory name. - - Secondly, if <B>tic</B> cannot get access to <I>/usr/share/terminfo</I> - or your TERMINFO directory, it looks for the directory - <I>$HOME/.terminfo</I>; if that directory exists, the entry is - placed there. - - Libraries that read terminfo entries are expected to check - for a TERMINFO directory first, look at <I>$HOME/.terminfo</I> if - TERMINFO is not set, and finally look in <I>/usr/share/ter-</I> - <I>minfo</I>. - - <B>-a</B> tells <B>tic</B> to retain commented-out capabilities - rather than discarding them. Capabilities are com- - mented by prefixing them with a period. This sets - the <B>-x</B> option, because it treats the commented-out - entries as user-defined names. - - <B>-c</B> tells <B>tic</B> to only check <I>file</I> for errors, including - syntax problems and bad use links. If you specify - <B>-C</B> (<B>-I</B>) with this option, the code will print warn- - ings about entries which, after use resolution, are - more than 1023 (4096) bytes long. Due to a fixed - buffer length in older termcap libraries (and a - documented limit in terminfo), these entries may - cause core dumps. - - <B>-v</B><I>n</I> specifies that (verbose) output be written to stan- - dard error trace information showing <B>tic</B>'s - progress. The optional integer <I>n</I> is a number from - 1 to 10, inclusive, indicating the desired level of - detail of information. If <I>n</I> is omitted, the - default level is 1. If <I>n</I> is specified and greater - than 1, the level of detail is increased. - - <B>-o</B><I>dir</I> Write compiled entries to given directory. - Overrides the TERMINFO environment variable. - - <B>-w</B><I>n</I> specifies the width of the output. - - <B>-1</B> restricts the output to a single column - - <B>-C</B> Force source translation to termcap format. Note: - this differs from the -C option of <B><A HREF="infocmp.1m.html">infocmp(1m)</A></B> in - that it does not merely translate capability names, - but also translates terminfo strings to termcap - format. Capabilities that are not translatable are - left in the entry under their terminfo names but - commented out with two preceding dots. - - <B>-G</B> Display constant literals in decimal form rather - than their character equivalents. - - <B>-I</B> Force source translation to terminfo format. - - <B>-L</B> Force source translation to terminfo format using - the long C variable names listed in <<B>term.h</B>> - - <B>-N</B> Disable smart defaults. Normally, when translating - from termcap to terminfo, the compiler makes a num- - ber of assumptions about the defaults of string - capabilities <B>reset1_string</B>, <B>carriage_return</B>, <B>cur-</B> - <B>sor_left</B>, <B>cursor_down</B>, <B>scroll_forward</B>, <B>tab</B>, <B>new-</B> - <B>line</B>, <B>key_backspace</B>, <B>key_left</B>, and <B>key_down</B>, then - attempts to use obsolete termcap capabilities to - deduce correct values. It also normally suppresses - output of obsolete termcap capabilities such as <B>bs</B>. - This option forces a more literal translation that - also preserves the obsolete capabilities. - - <B>-R</B><I>subset</I> - Restrict output to a given subset. This option is - for use with archaic versions of terminfo like - those on SVr1, Ultrix, or HP/UX that don't support - the full set of SVR4/XSI Curses terminfo; and out- - right broken ports like AIX 3.x that have their own - extensions incompatible with SVr4/XSI. Available - subsets are "SVr1", "Ultrix", "HP", "BSD" and - "AIX"; see <B><A HREF="terminfo.5.html">terminfo(5)</A></B> for details. - - <B>-T</B> eliminates size-restrictions on the generated text. - This is mainly useful for testing and analysis, - since the compiled descriptions are limited (e.g., - 1023 for termcap, 4096 for terminfo). - - <B>-V</B> reports the version of ncurses which was used in - this program, and exits. - - <B>-r</B> 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 up to version 1.3 or BSD term- - cap up to 4.3BSD) that doesn't handle multiple tc - capabilities per entry. - - <B>-e</B> Limit writes and translations to the following - comma-separated list of terminals. If any name or - alias of a terminal matches one of the names in the - list, the entry will be written or translated as - normal. Otherwise no output will be generated for - 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.) - - <B>-f</B> Display complex terminfo strings which contain - if/then/else/endif expressions indented for read- - ability. - - <B>-g</B> Display constant character literals in quoted form - rather than their decimal equivalents. - - <B>-s</B> Summarize the compile by showing the directory into - which entries are written, and the number of - entries which are compiled. - - <B>-x</B> Treat unknown capabilities as user-defined. That - is, if you supply a capability name which <B>tic</B> does - not recognize, it will infer its type (boolean, - number or string) from the syntax and make an - extended table entry for that. - - <I>file</I> contains one or more <B>terminfo</B> terminal descriptions - in source format [see <B><A HREF="terminfo.5.html">terminfo(5)</A></B>]. Each descrip- - tion in the file describes the capabilities of a - particular terminal. - - The debug flag levels are as follows: - - 1 Names of files created and linked - - 2 Information related to the ``use'' facility - - 3 Statistics from the hashing algorithm - - 5 String-table memory allocations - - 7 Entries into the string-table - - 8 List of tokens encountered by scanner - - 9 All values computed in construction of the hash - table - - If n is not given, it is taken to be one. - - All but one of the capabilities recognized by <B>tic</B> are doc- - umented in <B><A HREF="terminfo.5.html">terminfo(5)</A></B>. The exception is the <B>use</B> capabil- - ity. - - When a <B>use</B>=<I>entry</I>-<I>name</I> field is discovered in a terminal - entry currently being compiled, <B>tic</B> reads in the binary - from <B>/usr/share/terminfo</B> to complete the entry. (Entries - created from <I>file</I> will be used first. If the environment - variable <B>TERMINFO</B> is set, that directory is searched - instead of <B>/usr/share/terminfo</B>.) <B>tic</B> duplicates the capa- - bilities in <I>entry</I>-<I>name</I> for the current entry, with the - exception of those capabilities that explicitly are - defined in the current entry. - - When an entry, e.g., <B>entry_name_1</B>, contains a - <B>use=</B><I>entry</I>_<I>name</I>_<I>2</I> field, any canceled capabilities in - <I>entry</I>_<I>name</I>_<I>2</I> must also appear in <B>entry_name_1</B> before <B>use=</B> - for these capabilities to be canceled in <B>entry_name_1</B>. - - If the environment variable <B>TERMINFO</B> is set, the compiled - results are placed there instead of <B>/usr/share/terminfo</B>. - - 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 - long filenames, 14 characters otherwise) will be truncated - to the maximum alias length and a warning message will be - printed. - - -</PRE> -<H2>COMPATIBILITY</H2><PRE> - There is some evidence that historic <B>tic</B> implementations - treated description fields with no whitespace in them as - additional aliases or short names. This <B>tic</B> does not do - that, but it does warn when description fields may be - treated that way and check them for dangerous characters. - - -</PRE> -<H2>EXTENSIONS</H2><PRE> - Unlike the stock SVr4 <B>tic</B> 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 <B><A HREF="terminfo.5.html">terminfo(5)</A></B> 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 <B>use</B> capabilities. This implementation of <B>tic</B> - will find <B>use</B> targets anywhere in the source file, or any- - where in the file tree rooted at <B>TERMINFO</B> (if <B>TERMINFO</B> is - defined), or in the user's <I>$HOME/.terminfo</I> directory (if - it exists), or (finally) anywhere in the system's file - tree of compiled entries. - - The error messages from this <B>tic</B> have the same format as - GNU C error messages, and can be parsed by GNU Emacs's - compile facility. - - The <B>-C</B>, <B>-G</B>, <B>-I</B>, <B>-N</B>, <B>-R</B>, <B>-T</B>, <B>-V</B>, <B>-a</B>, <B>-e</B>, <B>-f</B>, <B>-g</B>, <B>-o</B>, <B>-r</B>, <B>-s</B> - and <B>-x</B> options are not supported under SVr4. The SVr4 -c - mode does not report bad use links. - - System V does not compile entries to or read entries from - your <I>$HOME/.terminfo</I> directory unless TERMINFO is explic- - itly set to it. - - -</PRE> -<H2>FILES</H2><PRE> - <B>/usr/share/terminfo/?/*</B> - Compiled terminal description database. - - -</PRE> -<H2>SEE ALSO</H2><PRE> - <B><A HREF="infocmp.1m.html">infocmp(1m)</A></B>, <B><A HREF="captoinfo.1m.html">captoinfo(1m)</A></B>, <B><A HREF="infotocap.1m.html">infotocap(1m)</A></B>, <B><A HREF="toe.1m.html">toe(1m)</A></B>, - <B><A HREF="ncurses.3x.html">curses(3x)</A></B>, <B><A HREF="terminfo.5.html">terminfo(5)</A></B>. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -</PRE> -<HR> -<ADDRESS> -Man(1) output converted with -<a href="http://www.oac.uci.edu/indiv/ehood/man2html.html">man2html</a> -</ADDRESS> -</BODY> -</HTML> |