


tic(1M)                                                   tic(1M)


NNAAMMEE
       ttiicc - _t_e_r_m_i_n_f_o compiler

SSYYNNOOPPSSIISS
       ttiicc [--vv[_n]] [--cc] _f_i_l_e

DDEESSCCRRIIPPTTIIOONN
       The  command  ttiicc  translates  a tteerrmmiinnffoo file from source
       format into compiled format.   The  results  are  normally
       placed in the directory @@TTEERRMMIINNFFOO@@ (but your system admin-
       istrator may have compiled in a  different  location,  and
       the  environment variable TTEERRMMIINNFFOO overrides the default).
       The compiled format is necessary for use with the  library
       routines in nnccuurrsseess(3X).

       --cc     specifies  to only check _f_i_l_e for errors, including
              syntax problems and bad use links.  If you  specify
              --CC (--II) 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.

       --vv_n    specifies that (verbose) output be written to stan-
              dard   error   trace   information   showing  ttiicc'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.

       --II     Force source translation to terminfo format.

       --CC     Force source translation to termcap format.   Note:
              this  differs  from the -C option of _i_n_f_o_c_m_p(1m) 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.

       --pp     Ignore pad prefixes when comparing strings.

       --NN     Disable smart defaults.  Normally, when translating
              from termcap to terminfo, the compiler makes a num-
              ber of assumptions about  the  defaults  of  string
              capabilities  rreesseett11__ssttrriinngg,  ccaarrrriiaaggee__rreettuurrnn, ccuurr--
              ssoorr__lleefftt, ccuurrssoorr__ddoowwnn,  ssccrroollll__ffoorrwwaarrdd,  ttaabb,  nneeww--
              lliinnee,  kkeeyy__bbaacckkssppaaccee,  kkeeyy__lleefftt, and kkeeyy__ddoowwnn, then
              attempts to use obsolete  termcap  capabilities  to
              deduce correct values.  It also normally suppresses
              output of obsolete termcap capabilities such as bbss.
              This  option forces a more literal translation that



                                                                1





tic(1M)                                                   tic(1M)


              also preserves the obsolete capabilities.

       _f_i_l_e   contains one or more tteerrmmiinnffoo terminal descriptions
              in  source format [see tteerrmmiinnffoo(5)].  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 ttiicc are doc-
       umented in tteerrmmiinnffoo(5).  The exception is the uussee capabil-
       ity.

       When a uussee=_e_n_t_r_y-_n_a_m_e field is discovered  in  a  terminal
       entry  currently  being  compiled, ttiicc reads in the binary
       from @@TTEERRMMIINNFFOO@@ to complete the entry.   (Entries  created
       from _f_i_l_e will be used first.  If the environment variable
       TTEERRMMIINNFFOO is set, that directory  is  searched  instead  of
       @@TTEERRMMIINNFFOO@@.)   ttiicc  duplicates  the capabilities in _e_n_t_r_y-
       _n_a_m_e for the current entry, with the  exception  of  those
       capabilities  that  explicitly  are defined in the current
       entry.

       When   an   entry,   e.g.,   eennttrryy__nnaammee__11,   contains    a
       uussee==_e_n_t_r_y__n_a_m_e__2   field,  any  canceled  capabilities  in
       _e_n_t_r_y__n_a_m_e__2 must also appear in eennttrryy__nnaammee__11 before  uussee==
       for these capabilities to be canceled in eennttrryy__nnaammee__11.

       If  the environment variable TTEERRMMIINNFFOO is set, the compiled
       results are placed there instead of @@TTEERRMMIINNFFOO@@.

       Total compiled entries cannot exceed 4096 bytes.  The name
       field  cannot  exceed 128 bytes.  Terminal names exceeding
       14 characters will be truncated to  14  characters  and  a
       warning message will be printed.





                                                                2





tic(1M)                                                   tic(1M)


EEXXTTEENNSSIIOONNSS
       Unlike the stock SVr4 ttiicc 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 tteerrmmiinnffoo(5)  for  the  list  of  termcap
       names taken to be equivalent to terminfo names.

       The SVr4 manual page are not clear on the resolution rules
       for uussee capabilities. This implementation of ttiicc will find
       use  targets  anywhere  in the source file, or anywhere in
       the system's file tree of compiled entries, or anywhere in
       the file tree routed at TTEERRMMIINNFFOO (if TTEERRMMIINNFFOO is defined).

       The -I, -C, and -p options are not supported under SVr4.

FFIILLEESS
       @@TTEERRMMIINNFFOO@@//??//**
            Compiled terminal description database.

SSEEEE AALLSSOO
       ccuurrsseess(3X), tteerrmmiinnffoo(5).




































                                                                3


