doc/html/man/tic.1m.html

   1 <!--
   2   ****************************************************************************
   3   * Copyright 2018-2019,2020 Thomas E. Dickey                                *
   4   * Copyright 1998-2016,2017 Free Software Foundation, Inc.                  *
   5   *                                                                          *
   6   * Permission is hereby granted, free of charge, to any person obtaining a  *
   7   * copy of this software and associated documentation files (the            *
   8   * "Software"), to deal in the Software without restriction, including      *
   9   * without limitation the rights to use, copy, modify, merge, publish,      *
  10   * distribute, distribute with modifications, sublicense, and/or sell       *
  11   * copies of the Software, and to permit persons to whom the Software is    *
  12   * furnished to do so, subject to the following conditions:                 *
  13   *                                                                          *
  14   * The above copyright notice and this permission notice shall be included  *
  15   * in all copies or substantial portions of the Software.                   *
  16   *                                                                          *
  17   * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS  *
  18   * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF               *
  19   * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.   *
  20   * IN NO EVENT SHALL THE ABOVE COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,   *
  21   * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR    *
  22   * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR    *
  23   * THE USE OR OTHER DEALINGS IN THE SOFTWARE.                               *
  24   *                                                                          *
  25   * Except as contained in this notice, the name(s) of the above copyright   *
  26   * holders shall not be used in advertising or otherwise to promote the     *
  27   * sale, use or other dealings in this Software without prior written       *
  28   * authorization.                                                           *
  29   ****************************************************************************
  30   * @Id: tic.1m,v 1.77 2020/02/02 23:34:34 tom Exp @
  31 -->
  32 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN">
  33 <HTML>
  34 <HEAD>
  35 <meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
  36 <meta name="generator" content="Manpage converted by man2html - see https://invisible-island.net/scripts/readme.html#others_scripts">
  37 <TITLE>tic 1m</TITLE>
  38 <link rel="author" href="mailto:bug-ncurses@gnu.org">
  39 <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
  40 </HEAD>
  41 <BODY>
  42 <H1 class="no-header">tic 1m</H1>
  43 <PRE>
  44 <STRONG><A HREF="tic.1m.html">tic(1m)</A></STRONG>                                                                <STRONG><A HREF="tic.1m.html">tic(1m)</A></STRONG>
  45
  46
  47
  48
  49 </PRE><H2><a name="h2-NAME">NAME</a></H2><PRE>
  50        <STRONG>tic</STRONG> - the <EM>terminfo</EM> entry-description compiler
  51
  52
  53 </PRE><H2><a name="h2-SYNOPSIS">SYNOPSIS</a></H2><PRE>
  54        <STRONG>tic</STRONG>  [<STRONG>-01CDGIKLNTUVWacfgqrstx</STRONG>]  [<STRONG>-e</STRONG> <EM>names</EM>] [<STRONG>-o</STRONG> <EM>dir</EM>] [<STRONG>-Q</STRONG>[<EM>n</EM>]] [<STRONG>-R</STRONG> <EM>subset</EM>]
  55        [<STRONG>-v</STRONG>[<EM>n</EM>]] [<STRONG>-w</STRONG>[<EM>n</EM>]] <EM>file</EM>
  56
  57
  58 </PRE><H2><a name="h2-DESCRIPTION">DESCRIPTION</a></H2><PRE>
  59        The <STRONG>tic</STRONG> command translates a <STRONG>terminfo</STRONG> file from source format into com-
  60        piled  format.   The  compiled  format  is  necessary  for use with the
  61        library routines in <STRONG><A HREF="ncurses.3x.html">ncurses(3x)</A></STRONG>.
  62
  63        As described in <STRONG><A HREF="term.5.html">term(5)</A></STRONG>, the database may be either  a  directory  tree
  64        (one  file  per  terminal  entry)  or a hashed database (one record per
  65        entry).  The <STRONG>tic</STRONG> command writes only one type of  entry,  depending  on
  66        how it was built:
  67
  68        <STRONG>o</STRONG>   For directory trees, the top-level directory, e.g., /usr/share/ter-
  69            minfo, specifies the location of the database.
  70
  71        <STRONG>o</STRONG>   For hashed databases, a filename is needed.  If the given  file  is
  72            not  found  by  that  name,  but  can be found by adding the suffix
  73            ".db", then that is used.
  74
  75            The default name for the hashed database is the same as the default
  76            directory name (only adding a ".db" suffix).
  77
  78        In either case (directory or hashed database), <STRONG>tic</STRONG> will create the con-
  79        tainer if it does not exist.  For a directory, this would be the  "ter-
  80        minfo" leaf, versus a "terminfo.db" file.
  81
  82        The  results  are  normally  placed  in  the  system  terminfo database
  83        <STRONG>/usr/share/terminfo</STRONG>.  The compiled terminal description can  be  placed
  84        in a different terminfo database.  There are two ways to achieve this:
  85
  86        <STRONG>o</STRONG>   First,  you  may override the system default either by using the <STRONG>-o</STRONG>
  87            option, or by setting the variable <STRONG>TERMINFO</STRONG> in your shell  environ-
  88            ment to a valid database location.
  89
  90        <STRONG>o</STRONG>   Secondly,  if  <STRONG>tic</STRONG> cannot write in <EM>/usr/share/terminfo</EM> or the loca-
  91            tion specified using your  TERMINFO  variable,  it  looks  for  the
  92            directory  <EM>$HOME/.terminfo</EM> (or hashed database <EM>$HOME/.terminfo.db)</EM>;
  93            if that location exists, the entry is placed there.
  94
  95        Libraries that read terminfo entries are expected to check  in  succes-
  96        sion
  97
  98        <STRONG>o</STRONG>   a location specified with the TERMINFO environment variable,
  99
 100        <STRONG>o</STRONG>   <EM>$HOME/.terminfo</EM>,
 101
 102        <STRONG>o</STRONG>   directories listed in the TERMINFO_DIRS environment variable,
 103
 104        <STRONG>o</STRONG>   a  compiled-in  list  of directories (/usr/local/ncurses/share/ter-
 105            minfo:/usr/share/terminfo), and
 106
 107        <STRONG>o</STRONG>   the system terminfo database (<EM>/usr/share/terminfo</EM>).
 108
 109
 110 </PRE><H3><a name="h3-ALIASES">ALIASES</a></H3><PRE>
 111        This is the same program as infotocap and captoinfo; usually those  are
 112        linked to, or copied from this program:
 113
 114        <STRONG>o</STRONG>   When invoked as infotocap, tic sets the <STRONG>-I</STRONG> option.
 115
 116        <STRONG>o</STRONG>   When invoked as captoinfo, tic sets the <STRONG>-C</STRONG> option.
 117
 118
 119 </PRE><H3><a name="h3-OPTIONS">OPTIONS</a></H3><PRE>
 120        <STRONG>-0</STRONG>     restricts the output to a single line
 121
 122        <STRONG>-1</STRONG>     restricts the output to a single column
 123
 124        <STRONG>-a</STRONG>     tells  <STRONG>tic</STRONG> to retain commented-out capabilities rather than dis-
 125               carding them.  Capabilities are commented by prefixing them with
 126               a  period.   This sets the <STRONG>-x</STRONG> option, because it treats the com-
 127               mented-out entries as user-defined  names.   If  the  source  is
 128               termcap,  accept  the  2-character  names required by version 6.
 129               Otherwise these are ignored.
 130
 131        <STRONG>-C</STRONG>     Force source translation to termcap format.  Note: this  differs
 132               from  the  <STRONG>-C</STRONG>  option  of <STRONG><A HREF="infocmp.1m.html">infocmp(1m)</A></STRONG> in that it does not merely
 133               translate capability names, but also translates terminfo strings
 134               to  termcap  format.  Capabilities that are not translatable are
 135               left in the entry under their terminfo names but  commented  out
 136               with  two  preceding  dots.  The actual format used incorporates
 137               some improvements for escaped characters from  terminfo  format.
 138               For a stricter BSD-compatible translation, add the <STRONG>-K</STRONG> option.
 139
 140               If  this  is  combined  with  <STRONG>-c</STRONG>, <STRONG>tic</STRONG> makes additional checks to
 141               report cases where the terminfo values  do  not  have  an  exact
 142               equivalent in termcap form.  For example:
 143
 144               <STRONG>o</STRONG>   <STRONG>sgr</STRONG>  usually  will  not  convert,  because termcap lacks the
 145                   ability to work with more than two parameters,  and  because
 146                   termcap  lacks many of the arithmetic/logical operators used
 147                   in terminfo.
 148
 149               <STRONG>o</STRONG>   capabilities with more than one delay or with delays  before
 150                   the end of the string will not convert completely.
 151
 152        <STRONG>-c</STRONG>     tells  <STRONG>tic</STRONG> to only check <EM>file</EM> for errors, including syntax prob-
 153               lems and bad use-links.   If  you  specify  <STRONG>-C</STRONG>  (<STRONG>-I</STRONG>)  with  this
 154               option,  the code will print warnings about entries which, after
 155               use resolution, are more than 1023 (4096) bytes long.  Due to  a
 156               fixed buffer length in older termcap libraries, as well as buggy
 157               checking for the buffer length (and a documented limit  in  ter-
 158               minfo),  these entries may cause core dumps with other implemen-
 159               tations.
 160
 161               <STRONG>tic</STRONG> checks string capabilities to ensure that those with parame-
 162               ters will be valid expressions.  It does this check only for the
 163               predefined string capabilities; those which are defined with the
 164               <STRONG>-x</STRONG> option are ignored.
 165
 166        <STRONG>-D</STRONG>     tells  <STRONG>tic</STRONG>  to print the database locations that it knows about,
 167               and exit.  The first location shown is the one to which it would
 168               write  compiled  terminal  descriptions.   If <STRONG>tic</STRONG> is not able to
 169               find a writable database location according to the rules  summa-
 170               rized  above,  it will print a diagnostic and exit with an error
 171               rather than printing a list of database locations.
 172
 173        <STRONG>-e</STRONG> <EM>names</EM>
 174               Limit writes and translations to the  following  comma-separated
 175               list  of  terminals.  If any name or alias of a terminal matches
 176               one of the names in the list,  the  entry  will  be  written  or
 177               translated as normal.  Otherwise no output will be generated for
 178               it.  The option value is interpreted as a  file  containing  the
 179               list if it contains a '/'.  (Note: depending on how tic was com-
 180               piled, this option may require <STRONG>-I</STRONG> or <STRONG>-C</STRONG>.)
 181
 182        <STRONG>-f</STRONG>     Display    complex    terminfo     strings     which     contain
 183               if/then/else/endif expressions indented for readability.
 184
 185        <STRONG>-G</STRONG>     Display  constant  literals  in  decimal  form rather than their
 186               character equivalents.
 187
 188        <STRONG>-g</STRONG>     Display constant character literals in quoted form  rather  than
 189               their decimal equivalents.
 190
 191        <STRONG>-I</STRONG>     Force source translation to terminfo format.
 192
 193        <STRONG>-K</STRONG>     Suppress some longstanding ncurses extensions to termcap format,
 194               e.g., "\s" for space.
 195
 196        <STRONG>-L</STRONG>     Force source translation to terminfo format  using  the  long  C
 197               variable names listed in &lt;<STRONG>term.h</STRONG>&gt;
 198
 199        <STRONG>-N</STRONG>     Disable smart defaults.  Normally, when translating from termcap
 200               to terminfo, the compiler makes a number  of  assumptions  about
 201               the   defaults   of   string  capabilities  <STRONG>reset1_string</STRONG>,  <STRONG>car-</STRONG>
 202               <STRONG>riage_return</STRONG>,  <STRONG>cursor_left</STRONG>,  <STRONG>cursor_down</STRONG>,  <STRONG>scroll_forward</STRONG>,  <STRONG>tab</STRONG>,
 203               <STRONG>newline</STRONG>, <STRONG>key_backspace</STRONG>, <STRONG>key_left</STRONG>, and <STRONG>key_down</STRONG>, then attempts to
 204               use obsolete termcap capabilities to deduce correct values.   It
 205               also normally suppresses output of obsolete termcap capabilities
 206               such as <STRONG>bs</STRONG>.  This option forces a more literal translation  that
 207               also preserves the obsolete capabilities.
 208
 209        <STRONG>-o</STRONG><EM>dir</EM>  Write  compiled  entries  to given database location.  Overrides
 210               the TERMINFO environment variable.
 211
 212        <STRONG>-Q</STRONG><EM>n</EM>    Rather than show source in terminfo  (text)  format,  print  the
 213               compiled  (binary) format in hexadecimal or base64 form, depend-
 214               ing on the option's value:
 215
 216                1  hexadecimal
 217
 218                2  base64
 219
 220                3  hexadecimal and base64
 221
 222        <STRONG>-q</STRONG>     Suppress  comments  and  blank  lines  when  showing  translated
 223               source.
 224
 225        <STRONG>-R</STRONG><EM>subset</EM>
 226               Restrict  output to a given subset.  This option is for use with
 227               archaic versions of terminfo like  those  on  SVr1,  Ultrix,  or
 228               HP/UX  that  do not support the full set of SVR4/XSI Curses ter-
 229               minfo; and outright broken ports like AIX 3.x  that  have  their
 230               own  extensions  incompatible  with SVr4/XSI.  Available subsets
 231               are "SVr1", "Ultrix", "HP", "BSD" and "AIX"; see <STRONG><A HREF="terminfo.5.html">terminfo(5)</A></STRONG> for
 232               details.
 233
 234        <STRONG>-r</STRONG>     Force  entry  resolution (so there are no remaining tc capabili-
 235               ties) even when doing translation to termcap format.   This  may
 236               be  needed  if  you  are  preparing a termcap file for a termcap
 237               library (such as GNU termcap through version 1.3 or BSD  termcap
 238               through  4.3BSD)  that  does not handle multiple tc capabilities
 239               per entry.
 240
 241        <STRONG>-s</STRONG>     Summarize the compile by  showing  the  database  location  into
 242               which  entries  are written, and the number of entries which are
 243               compiled.
 244
 245        <STRONG>-T</STRONG>     eliminates size-restrictions on the  generated  text.   This  is
 246               mainly  useful  for  testing  and  analysis,  since the compiled
 247               descriptions are limited (e.g., 1023 for termcap, 4096 for  ter-
 248               minfo).
 249
 250        <STRONG>-t</STRONG>     tells  <STRONG>tic</STRONG> to discard commented-out capabilities.  Normally when
 251               translating from terminfo to termcap,  untranslatable  capabili-
 252               ties are commented-out.
 253
 254        <STRONG>-U</STRONG>   tells  <STRONG>tic</STRONG>  to  not post-process the data after parsing the source
 255             file.  Normally, it infers data which is commonly missing in older
 256             terminfo data, or in termcaps.
 257
 258        <STRONG>-V</STRONG>   reports the version of ncurses which was used in this program, and
 259             exits.
 260
 261        <STRONG>-v</STRONG><EM>n</EM>  specifies that (verbose) output be written to standard error trace
 262             information showing <STRONG>tic</STRONG>'s progress.
 263
 264             The  optional  parameter  <EM>n</EM>  is  a number from 1 to 10, inclusive,
 265             indicating the desired level of detail of information.  If ncurses
 266             is  built  without  tracing  support,  the  optional  parameter is
 267             ignored.  If <EM>n</EM> is omitted, the default level is 1.  If <EM>n</EM> is speci-
 268             fied and greater than 1, the level of detail is increased.
 269
 270             The debug flag levels are as follows:
 271
 272             1      Names of files created and linked
 273
 274             2      Information related to the "use" facility
 275
 276             3      Statistics from the hashing algorithm
 277
 278             5      String-table memory allocations
 279
 280             7      Entries into the string-table
 281
 282             8      List of tokens encountered by scanner
 283
 284             9      All values computed in construction of the hash table
 285
 286             If the debug level <EM>n</EM> is not given, it is taken to be one.
 287
 288        <STRONG>-W</STRONG>   By  itself,  the  <STRONG>-w</STRONG>  option  will  not  force  long strings to be
 289             wrapped.  Use the <STRONG>-W</STRONG> option to do this.
 290
 291             If you specify both <STRONG>-f</STRONG> and <STRONG>-W</STRONG> options, the latter is ignored  when
 292             <STRONG>-f</STRONG> has already split the line.
 293
 294        <STRONG>-w</STRONG><EM>n</EM>  specifies the width of the output.  The parameter is optional.  If
 295             it is omitted, it defaults to 60.
 296
 297        <STRONG>-x</STRONG>   Treat unknown capabilities  as  user-defined  (see  <STRONG>user_caps(5)</STRONG>).
 298             That is, if you supply a capability name which <STRONG>tic</STRONG> does not recog-
 299             nize, it will infer its type (boolean, number or string) from  the
 300             syntax  and  make  an extended table entry for that.  User-defined
 301             capability strings whose name begins with "k" are treated as func-
 302             tion keys.
 303
 304
 305 </PRE><H3><a name="h3-PARAMETERS">PARAMETERS</a></H3><PRE>
 306        <EM>file</EM>   contains  one  or  more <STRONG>terminfo</STRONG> terminal descriptions in source
 307               format  [see  <STRONG><A HREF="terminfo.5.html">terminfo(5)</A></STRONG>].   Each  description  in   the   file
 308               describes the capabilities of a particular terminal.
 309
 310               If  <EM>file</EM>  is "-", then the data is read from the standard input.
 311               The <EM>file</EM> parameter may also be the path of a character-device.
 312
 313
 314 </PRE><H3><a name="h3-PROCESSING">PROCESSING</a></H3><PRE>
 315        All but one of the capabilities recognized by  <STRONG>tic</STRONG>  are  documented  in
 316        <STRONG><A HREF="terminfo.5.html">terminfo(5)</A></STRONG>.  The exception is the <STRONG>use</STRONG> capability.
 317
 318        When a <STRONG>use</STRONG>=<EM>entry</EM>-<EM>name</EM> field is discovered in a terminal entry currently
 319        being compiled, <STRONG>tic</STRONG> reads in the  binary  from  <STRONG>/usr/share/terminfo</STRONG>  to
 320        complete  the  entry.   (Entries  created from <EM>file</EM> will be used first.
 321        <STRONG>tic</STRONG> duplicates the capabilities in <EM>entry</EM>-<EM>name</EM> for  the  current  entry,
 322        with the exception of those capabilities that explicitly are defined in
 323        the current entry.
 324
 325        When an entry, e.g., <STRONG>entry_name_1</STRONG>, contains a  <STRONG>use=</STRONG><EM>entry</EM>_<EM>name</EM>_<EM>2</EM>  field,
 326        any   canceled   capabilities  in  <EM>entry</EM>_<EM>name</EM>_<EM>2</EM>  must  also  appear  in
 327        <STRONG>entry_name_1</STRONG> before <STRONG>use=</STRONG> for  these  capabilities  to  be  canceled  in
 328        <STRONG>entry_name_1</STRONG>.
 329
 330        Total compiled entries cannot exceed 4096 bytes.  The name field cannot
 331        exceed 512 bytes.  Terminal names exceeding the  maximum  alias  length
 332        (32 characters on systems with long filenames, 14 characters otherwise)
 333        will be truncated to the maximum alias length  and  a  warning  message
 334        will be printed.
 335
 336
 337 </PRE><H2><a name="h2-HISTORY">HISTORY</a></H2><PRE>
 338        System  V  Release  2  provided  a  <STRONG>tic</STRONG>  utility.  It accepted a single
 339        option: <STRONG>-v</STRONG> (optionally  followed  by  a  number).   According  to  Ross
 340        Ridge's comment in <EM>mytinfo</EM>, this version of <STRONG>tic</STRONG> was unable to represent
 341        cancelled capabilities.
 342
 343        System V Release 3 provided a different <STRONG>tic</STRONG> utility, written  by  Pavel
 344        Curtis,  (originally named "compile" in <EM>pcurses</EM>).  This added an option
 345        <STRONG>-c</STRONG> to check the file for errors, with the caveat that errors in  "use="
 346        links would not be reported.  System V Release 3 documented a few warn-
 347        ing messages which did not appear in <EM>pcurses</EM>.  While the program itself
 348        was  changed  little  as development continued with System V Release 4,
 349        the table of capabilities grew from 180 (<EM>pcurses</EM>) to 464 (Solaris).
 350
 351        In early development of ncurses (1993), Zeyd Ben-Halim used  the  table
 352        from  <EM>mytinfo</EM>  to  extend  the  <EM>pcurses</EM>  table to 469 capabilities (456
 353        matched SVr4, 8 were only in SVr4, 13 were not in SVr4).  Of those  13,
 354        11  were  ultimately  discarded  (perhaps  to match the draft of X/Open
 355        Curses).  The exceptions were <STRONG>memory_lock_above</STRONG> and <STRONG>memory_unlock</STRONG>  (see
 356        <STRONG><A HREF="user_caps.5.html">user_caps(5)</A></STRONG>).
 357
 358        Eric  Raymond  incorporated  parts of <EM>mytinfo</EM> into ncurses to implement
 359        the termcap-to-terminfo source conversion, and extended that  to  begin
 360        development of the corresponding terminfo-to-termcap source conversion,
 361        Thomas Dickey completed that development over  the  course  of  several
 362        years.
 363
 364        In  1999,  Thomas  Dickey  added  the <STRONG>-x</STRONG> option to support user-defined
 365        capabilities.
 366
 367        In 2010, Roy Marples provided a <STRONG>tic</STRONG> program and  terminfo  library  for
 368        NetBSD.   That  implementation  adapts  several  features from ncurses,
 369        including <STRONG>tic</STRONG>'s <STRONG>-x</STRONG> option.
 370
 371        The <STRONG>-c</STRONG> option tells <STRONG>tic</STRONG> to check for problems in  the  terminfo  source
 372        file.  Continued development provides additional checks:
 373
 374        <STRONG>o</STRONG>   <EM>pcurses</EM> had 8 warnings
 375
 376        <STRONG>o</STRONG>   ncurses in 1996 had 16 warnings
 377
 378        <STRONG>o</STRONG>   Solaris (SVr4) curses has 28 warnings
 379
 380        <STRONG>o</STRONG>   NetBSD tic in 2019 has 19 warnings.
 381
 382        <STRONG>o</STRONG>   ncurses in 2019 has 96 warnings
 383
 384        The checking done in ncurses' <STRONG>tic</STRONG> helps with the conversion to termcap,
 385        as well as pointing out errors and inconsistencies.  It is also used to
 386        ensure  consistency  with the user-defined capabilities.  There are 527
 387        distinct capabilities in ncurses' terminal database; 128 of  those  are
 388        user-defined.
 389
 390
 391 </PRE><H2><a name="h2-PORTABILITY">PORTABILITY</a></H2><PRE>
 392        X/Open  Curses, Issue 7 (2009) provides a brief description of <STRONG>tic</STRONG>.  It
 393        lists one option: <STRONG>-c</STRONG>.  The omission of <STRONG>-v</STRONG> is  unexpected.   The  change
 394        history  states  that  the  description  is  derived  from True64 UNIX.
 395        According to its manual  pages,  that  system  also  supported  the  <STRONG>-v</STRONG>
 396        option.
 397
 398        Shortly  after  Issue  7  was  released, Tru64 was discontinued.  As of
 399        2019, the surviving implementations of <STRONG>tic</STRONG> are  SVr4  (AIX,  HP-UX  and
 400        Solaris), ncurses and NetBSD curses.  The SVr4 <STRONG>tic</STRONG> programs all support
 401        the <STRONG>-v</STRONG> option.  The NetBSD <STRONG>tic</STRONG> program follows X/Open's  documentation,
 402        omitting the <STRONG>-v</STRONG> option.
 403
 404        The  X/Open rationale states that some implementations of <STRONG>tic</STRONG> read ter-
 405        minal descriptions from the standard input if  the  <EM>file</EM>  parameter  is
 406        omitted.   None of these implementations do that.  Further, it comments
 407        that some may choose to read from "./terminfo.src" but that is obsoles-
 408        cent  behavior from SVr2, and is not (for example) a documented feature
 409        of SVr3.
 410
 411
 412 </PRE><H3><a name="h3-COMPATIBILITY">COMPATIBILITY</a></H3><PRE>
 413        There is  some  evidence  that  historic  <STRONG>tic</STRONG>  implementations  treated
 414        description  fields with no whitespace in them as additional aliases or
 415        short names.  This <STRONG>tic</STRONG> does not do that, but it does warn when descrip-
 416        tion  fields may be treated that way and check them for dangerous char-
 417        acters.
 418
 419
 420 </PRE><H3><a name="h3-EXTENSIONS">EXTENSIONS</a></H3><PRE>
 421        Unlike the SVr4 <STRONG>tic</STRONG> command, this implementation can  actually  compile
 422        termcap  sources.   In fact, entries in terminfo and termcap syntax can
 423        be mixed in a single source file.  See  <STRONG><A HREF="terminfo.5.html">terminfo(5)</A></STRONG>  for  the  list  of
 424        termcap names taken to be equivalent to terminfo names.
 425
 426        The  SVr4  manual  pages  are not clear on the resolution rules for <STRONG>use</STRONG>
 427        capabilities.  This implementation of <STRONG>tic</STRONG> will find  <STRONG>use</STRONG>  targets  any-
 428        where  in  the source file, or anywhere in the file tree rooted at <STRONG>TER-</STRONG>
 429        <STRONG>MINFO</STRONG> (if <STRONG>TERMINFO</STRONG> is defined), or in the user's <EM>$HOME/.terminfo</EM>  data-
 430        base (if it exists), or (finally) anywhere in the system's file tree of
 431        compiled entries.
 432
 433        The error messages from this <STRONG>tic</STRONG> have the same format as  GNU  C  error
 434        messages, and can be parsed by GNU Emacs's compile facility.
 435
 436        Aside from <STRONG>-c</STRONG> and <STRONG>-v</STRONG>, options are not portable:
 437
 438        <STRONG>o</STRONG>   Most of tic's options are not supported by SVr4 <STRONG>tic</STRONG>:
 439
 440            <STRONG>-0</STRONG> <STRONG>-1</STRONG> <STRONG>-C</STRONG> <STRONG>-G</STRONG> <STRONG>-I</STRONG> <STRONG>-N</STRONG> <STRONG>-R</STRONG> <STRONG>-T</STRONG> <STRONG>-V</STRONG> <STRONG>-a</STRONG> <STRONG>-e</STRONG> <STRONG>-f</STRONG> <STRONG>-g</STRONG> <STRONG>-o</STRONG> <STRONG>-r</STRONG> <STRONG>-s</STRONG> <STRONG>-t</STRONG> <STRONG>-x</STRONG>
 441
 442        <STRONG>o</STRONG>   The NetBSD <STRONG>tic</STRONG>  supports a few of the ncurses options
 443
 444            <STRONG>-a</STRONG> <STRONG>-o</STRONG> <STRONG>-x</STRONG>
 445
 446            and  adds  <STRONG>-S</STRONG>  (a feature which does the same thing as infocmp's <STRONG>-e</STRONG>
 447            and <STRONG>-E</STRONG> options).
 448
 449        The SVr4 <STRONG>-c</STRONG> mode does not report bad "use=" links.
 450
 451        System V does  not  compile  entries  to  or  read  entries  from  your
 452        <EM>$HOME/.terminfo</EM> database unless TERMINFO is explicitly set to it.
 453
 454
 455 </PRE><H2><a name="h2-FILES">FILES</a></H2><PRE>
 456        <STRONG>/usr/share/terminfo/?/*</STRONG>
 457             Compiled terminal description database.
 458
 459
 460 </PRE><H2><a name="h2-SEE-ALSO">SEE ALSO</a></H2><PRE>
 461        <STRONG><A HREF="infocmp.1m.html">infocmp(1m)</A></STRONG>,   <STRONG><A HREF="captoinfo.1m.html">captoinfo(1m)</A></STRONG>,   <STRONG><A HREF="infotocap.1m.html">infotocap(1m)</A></STRONG>,   <STRONG><A HREF="toe.1m.html">toe(1m)</A></STRONG>,   <STRONG><A HREF="ncurses.3x.html">curses(3x)</A></STRONG>,
 462        <STRONG><A HREF="term.5.html">term(5)</A></STRONG>.  <STRONG><A HREF="terminfo.5.html">terminfo(5)</A></STRONG>.  <STRONG><A HREF="user_caps.5.html">user_caps(5)</A></STRONG>.
 463
 464        This describes <STRONG>ncurses</STRONG> version 6.2 (patch 20200215).
 465
 466
 467 </PRE><H2><a name="h2-AUTHOR">AUTHOR</a></H2><PRE>
 468        Eric S. Raymond &lt;esr@snark.thyrsus.com&gt; and
 469        Thomas E. Dickey &lt;dickey@invisible-island.net&gt;
 470
 471
 472
 473                                                                        <STRONG><A HREF="tic.1m.html">tic(1m)</A></STRONG>
 474 </PRE>
 475 <div class="nav">
 476 <ul>
 477 <li><a href="#h2-NAME">NAME</a></li>
 478 <li><a href="#h2-SYNOPSIS">SYNOPSIS</a></li>
 479 <li><a href="#h2-DESCRIPTION">DESCRIPTION</a>
 480 <ul>
 481 <li><a href="#h3-ALIASES">ALIASES</a></li>
 482 <li><a href="#h3-OPTIONS">OPTIONS</a></li>
 483 <li><a href="#h3-PARAMETERS">PARAMETERS</a></li>
 484 <li><a href="#h3-PROCESSING">PROCESSING</a></li>
 485 </ul>
 486 </li>
 487 <li><a href="#h2-HISTORY">HISTORY</a></li>
 488 <li><a href="#h2-PORTABILITY">PORTABILITY</a>
 489 <ul>
 490 <li><a href="#h3-COMPATIBILITY">COMPATIBILITY</a></li>
 491 <li><a href="#h3-EXTENSIONS">EXTENSIONS</a></li>
 492 </ul>
 493 </li>
 494 <li><a href="#h2-FILES">FILES</a></li>
 495 <li><a href="#h2-SEE-ALSO">SEE ALSO</a></li>
 496 <li><a href="#h2-AUTHOR">AUTHOR</a></li>
 497 </ul>
 498 </div>
 499 </BODY>
 500 </HTML>