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