ncurses 6.0 - patch 20170401
[ncurses.git] / doc / html / man / infocmp.1m.html
1 <!-- 
2   * t
3   ****************************************************************************
4   * Copyright (c) 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: infocmp.1m,v 1.65 2017/02/18 19:21:05 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 http://invisible-island.net/scripts/readme.html#others_scripts">
37 <TITLE>infocmp 1m</TITLE>
38 <link rev=made 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">infocmp 1m</H1>
43 <PRE>
44 <STRONG><A HREF="infocmp.1m.html">infocmp(1m)</A></STRONG>                                                 <STRONG><A HREF="infocmp.1m.html">infocmp(1m)</A></STRONG>
45
46
47
48
49 </PRE><H2><a name="h2-NAME">NAME</a></H2><PRE>
50        <STRONG>infocmp</STRONG> - compare or print out <EM>terminfo</EM> descriptions
51
52
53 </PRE><H2><a name="h2-SYNOPSIS">SYNOPSIS</a></H2><PRE>
54        <STRONG>infocmp</STRONG> [<STRONG>-1CDEFGIKLTUVWcdegilnpqrtux</STRONG>]
55              [<STRONG>-v</STRONG> <EM>n</EM>] [<STRONG>-s</STRONG> <STRONG>d</STRONG>| <STRONG>i</STRONG>| <STRONG>l</STRONG>| <STRONG>c</STRONG>] [<STRONG>-Q</STRONG> <EM>n</EM>] [<STRONG>-R</STRONG> <STRONG>subset</STRONG>]
56              [<STRONG>-w</STRONG> <EM>width</EM>] [<STRONG>-A</STRONG> <EM>directory</EM>] [<STRONG>-B</STRONG> <EM>directory</EM>]
57              [<EM>termname</EM>...]
58
59
60 </PRE><H2><a name="h2-DESCRIPTION">DESCRIPTION</a></H2><PRE>
61        <STRONG>infocmp</STRONG>  can  be  used  to compare a binary <STRONG>terminfo</STRONG> entry
62        with other terminfo entries, rewrite a  <STRONG>terminfo</STRONG>  descrip-
63        tion  to  take  advantage  of  the <STRONG>use=</STRONG> terminfo field, or
64        print out a <STRONG>terminfo</STRONG>  description  from  the  binary  file
65        (<STRONG>term</STRONG>) in a variety of formats.  In all cases, the boolean
66        fields will be printed  first,  followed  by  the  numeric
67        fields, followed by the string fields.
68
69
70 </PRE><H3><a name="h3-Default-Options">Default Options</a></H3><PRE>
71        If  no options are specified and zero or one <EM>termnames</EM> are
72        specified, the <STRONG>-I</STRONG> option will be assumed.   If  more  than
73        one <EM>termname</EM> is specified, the <STRONG>-d</STRONG> option will be assumed.
74
75
76 </PRE><H3><a name="h3-Comparison-Options-_-d_-_-c_-_-n_">Comparison Options [-d] [-c] [-n]</a></H3><PRE>
77        <STRONG>infocmp</STRONG>  compares  the  <STRONG>terminfo</STRONG>  description of the first
78        terminal <EM>termname</EM> with each of the descriptions  given  by
79        the  entries  for  the  other  terminal's <EM>termnames</EM>.  If a
80        capability is defined for only one of the  terminals,  the
81        value returned depends on the type of the capability:
82
83        <STRONG>o</STRONG>   <STRONG>F</STRONG> for missing boolean variables
84
85        <STRONG>o</STRONG>   <STRONG>NULL</STRONG> for missing integer or string variables
86
87        Use  the  <STRONG>-q</STRONG> option to show the distinction between <EM>absent</EM>
88        and <EM>cancelled</EM> capabilities.
89
90        These options produce a list which you can use to  compare
91        two or more terminal descriptions:
92
93        <STRONG>-d</STRONG>   produces  a list of each capability that is <EM>different</EM>
94             between two entries.  Each item in the list shows ":"
95             after the capability name, followed by the capability
96             values, separated by a comma.
97
98        <STRONG>-c</STRONG>   produces a list of each  capability  that  is  <EM>common</EM>
99             between  two  or  more entries.  Missing capabilities
100             are ignored.  Each item in the list shows  "="  after
101             the  capability  name,  followed  by  the  capability
102             value.
103
104             The <STRONG>-u</STRONG> option provides a related output, showing  the
105             first  terminal description rewritten to use the sec-
106             ond as a building block via the "use=" clause.
107
108        <STRONG>-n</STRONG>   produces a list of each capability that is in <EM>none</EM> of
109             the  given  entries.  Each item in the list shows "!"
110             before the capability name.
111
112             Normally  only  the  conventional  capabilities   are
113             shown.   Use the <STRONG>-x</STRONG> option to add the BSD-compatibil-
114             ity capabilities (names prefixed with "OT").
115
116             If no <EM>termnames</EM> are given, <STRONG>infocmp</STRONG> uses the  environ-
117             ment variable <STRONG>TERM</STRONG> for each of the <EM>termnames</EM>.
118
119
120 </PRE><H3><a name="h3-Source-Listing-Options-_-I_-_-L_-_-C_-_-r_">Source Listing Options [-I] [-L] [-C] [-r]</a></H3><PRE>
121        The  <STRONG>-I</STRONG>,  <STRONG>-L</STRONG>, and <STRONG>-C</STRONG> options will produce a source listing
122        for each terminal named.
123
124       <STRONG>-I</STRONG>   use the <STRONG>terminfo</STRONG> names
125       <STRONG>-L</STRONG>   use the long C variable name listed in &lt;<STRONG>term.h</STRONG>&gt;
126       <STRONG>-C</STRONG>   use the <STRONG>termcap</STRONG> names
127       <STRONG>-r</STRONG>   when using <STRONG>-C</STRONG>, put out all capabilities in <STRONG>termcap</STRONG> form
128       <STRONG>-K</STRONG>   modifies the <STRONG>-C</STRONG> option, improving BSD-compatibility.
129
130        If no <EM>termnames</EM> are given, the environment  variable  <STRONG>TERM</STRONG>
131        will be used for the terminal name.
132
133        The  source produced by the <STRONG>-C</STRONG> option may be used directly
134        as a <STRONG>termcap</STRONG> entry, but not all parameterized strings  can
135        be changed to the <STRONG>termcap</STRONG> format.  <STRONG>infocmp</STRONG> will attempt to
136        convert most of the parameterized  information,  and  any-
137        thing  not  converted will be plainly marked in the output
138        and commented out.  These should be edited by hand.
139
140        For best results when converting to  <STRONG>termcap</STRONG>  format,  you
141        should use both <STRONG>-C</STRONG> and <STRONG>-r</STRONG>.  Normally a termcap description
142        is limited to 1023 bytes.  <STRONG>infocmp</STRONG> trims away less  essen-
143        tial  parts  to make it fit.  If you are converting to one
144        of the (rare)  termcap  implementations  which  accept  an
145        unlimited  size  of  termcap,  you  may want to add the <STRONG>-T</STRONG>
146        option.  More often however, you  must  help  the  termcap
147        implementation,  and  trim  excess  whitespace (use the <STRONG>-0</STRONG>
148        option for that).
149
150        All padding information  for  strings  will  be  collected
151        together  and  placed at the beginning of the string where
152        <STRONG>termcap</STRONG> expects it.  Mandatory padding  (padding  informa-
153        tion with a trailing "/") will become optional.
154
155        All <STRONG>termcap</STRONG> variables no longer supported by <STRONG>terminfo</STRONG>, but
156        which are derivable from other <STRONG>terminfo</STRONG> variables, will be
157        output.  Not all <STRONG>terminfo</STRONG> capabilities will be translated;
158        only those variables which were part of <STRONG>termcap</STRONG> will  nor-
159        mally  be  output.  Specifying the <STRONG>-r</STRONG> option will take off
160        this restriction, allowing all capabilities to  be  output
161        in  <EM>termcap</EM>  form.  Normally you would use both the <STRONG>-C</STRONG> and
162        <STRONG>-r</STRONG> options.  The  actual  format  used  incorporates  some
163        improvements  for escaped characters from terminfo format.
164        For a stricter  BSD-compatible  translation,  use  the  <STRONG>-K</STRONG>
165        option rather than <STRONG>-C</STRONG>.
166
167        Note that because padding is collected to the beginning of
168        the capability, not all capabilities are  output.   Manda-
169        tory  padding  is  not supported.  Because <STRONG>termcap</STRONG> strings
170        are not as flexible, it is not always possible to  convert
171        a  <STRONG>terminfo</STRONG>  string  capability into an equivalent <STRONG>termcap</STRONG>
172        format.  A subsequent conversion of the <STRONG>termcap</STRONG> file  back
173        into  <STRONG>terminfo</STRONG>  format  will not necessarily reproduce the
174        original <STRONG>terminfo</STRONG> source.
175
176        Some common <STRONG>terminfo</STRONG> parameter  sequences,  their  <STRONG>termcap</STRONG>
177        equivalents,  and  some terminal types which commonly have
178        such sequences, are:
179
180
181
182      <STRONG>terminfo</STRONG>                    <STRONG>termcap</STRONG>   Representative Terminals
183      ---------------------------------------------------------------
184      <STRONG>%p1%c</STRONG>                       <STRONG>%.</STRONG>        adm
185      <STRONG>%p1%d</STRONG>                       <STRONG>%d</STRONG>        hp, ANSI standard, vt100
186      <STRONG>%p1%'x'%+%c</STRONG>                 <STRONG>%+x</STRONG>       concept
187      <STRONG>%i</STRONG>                          <STRONG>%i</STRONG>q       ANSI standard, vt100
188      <STRONG>%p1%?%'x'%&gt;%t%p1%'y'%+%;</STRONG>    <STRONG>%&gt;xy</STRONG>      concept
189      <STRONG>%p2</STRONG> is printed before <STRONG>%p1</STRONG>   <STRONG>%r</STRONG>        hp
190
191
192 </PRE><H3><a name="h3-Use_-Option-_-u_">Use= Option [-u]</a></H3><PRE>
193        The <STRONG>-u</STRONG> option produces a <STRONG>terminfo</STRONG>  source  description  of
194        the  first  terminal <EM>termname</EM> which is relative to the sum
195        of the descriptions given by the  entries  for  the  other
196        terminals  <EM>termnames</EM>.   It does this by analyzing the dif-
197        ferences  between  the  first  <EM>termname</EM>  and   the   other
198        <EM>termnames</EM> and producing a description with <STRONG>use=</STRONG> fields for
199        the other terminals.  In this manner, it  is  possible  to
200        retrofit   generic  terminfo  entries  into  a  terminal's
201        description.  Or, if two similar terminals exist, but were
202        coded  at  different  times or by different people so that
203        each description is a full description, using <STRONG>infocmp</STRONG> will
204        show what can be done to change one description to be rel-
205        ative to the other.
206
207        A capability will get printed with an at-sign (@) if it no
208        longer  exists in the first <EM>termname</EM>, but one of the other
209        <EM>termname</EM> entries contains a value for it.  A  capability's
210        value  gets  printed if the value in the first <EM>termname</EM> is
211        not found in any of the other <EM>termname</EM> entries, or if  the
212        first of the other <EM>termname</EM> entries that has this capabil-
213        ity gives a different value for the capability  than  that
214        in the first <EM>termname</EM>.
215
216        The  order  of  the other <EM>termname</EM> entries is significant.
217        Since the terminfo compiler <STRONG>tic</STRONG> does a left-to-right  scan
218        of the capabilities, specifying two <STRONG>use=</STRONG> entries that con-
219        tain differing entries for the same capabilities will pro-
220        duce  different  results  depending  on the order that the
221        entries are given in.  <STRONG>infocmp</STRONG> will flag any  such  incon-
222        sistencies  between the other <EM>termname</EM> entries as they are
223        found.
224
225        Alternatively, specifying a capability <EM>after</EM> a <STRONG>use=</STRONG>  entry
226        that contains that capability will cause the second speci-
227        fication to be  ignored.   Using  <STRONG>infocmp</STRONG>  to  recreate  a
228        description can be a useful check to make sure that every-
229        thing was  specified  correctly  in  the  original  source
230        description.
231
232        Another  error  that  does  not  cause  incorrect compiled
233        files, but will slow down the compilation time, is  speci-
234        fying  extra  <STRONG>use=</STRONG>  fields  that are superfluous.  <STRONG>infocmp</STRONG>
235        will flag any other <EM>termname</EM> <EM>use=</EM>  fields  that  were  not
236        needed.
237
238    <STRONG>Changing</STRONG> <STRONG>Databases</STRONG> <STRONG>[-A</STRONG> <EM>directory</EM>] [-B <EM>directory</EM>]
239        Like other <STRONG>ncurses</STRONG> utilities, <STRONG>infocmp</STRONG> looks for the termi-
240        nal descriptions in several places.  You can use the  <STRONG>TER-</STRONG>
241        <STRONG>MINFO</STRONG>  and <STRONG>TERMINFO_DIRS</STRONG> environment variables to override
242        the compiled-in default list  of  places  to  search  (see
243        <STRONG><A HREF="ncurses.3x.html">curses(3x)</A></STRONG> for details).
244
245        You  can  also  use  the options <STRONG>-A</STRONG> and <STRONG>-B</STRONG> to override the
246        list of places to search when comparing terminal  descrip-
247        tions:
248
249        <STRONG>o</STRONG>   The <STRONG>-A</STRONG> option sets the location for the first <EM>termname</EM>
250
251        <STRONG>o</STRONG>   The   <STRONG>-B</STRONG>  option  sets  the  location  for  the  other
252            <EM>termnames</EM>.
253
254        Using these options, it is possible  to  compare  descrip-
255        tions  for  a  terminal  with the same name located in two
256        different databases.  For instance, you can use this  fea-
257        ture for comparing descriptions for the same terminal cre-
258        ated by different people.
259
260
261 </PRE><H3><a name="h3-Other-Options">Other Options</a></H3><PRE>
262        <STRONG>-0</STRONG>   causes the fields to be printed on one line,  without
263             wrapping.
264
265        <STRONG>-1</STRONG>   causes  the  fields  to be printed out one to a line.
266             Otherwise, the fields will be printed  several  to  a
267             line to a maximum width of 60 characters.
268
269        <STRONG>-a</STRONG>   tells  <STRONG>infocmp</STRONG>  to  retain commented-out capabilities
270             rather than discarding them.  Capabilities  are  com-
271             mented by prefixing them with a period.
272
273        <STRONG>-D</STRONG>   tells <STRONG>infocmp</STRONG> to print the database locations that it
274             knows about, and exit.
275
276        <STRONG>-E</STRONG>   Dump  the  capabilities  of  the  given  terminal  as
277             tables,  needed  in  the C initializer for a TERMTYPE
278             structure (the terminal capability structure  in  the
279             <STRONG>&lt;term.h&gt;</STRONG>).   This option is useful for preparing ver-
280             sions of the curses library  hardwired  for  a  given
281             terminal  type.   The tables are all declared static,
282             and are named according to the type and the  name  of
283             the corresponding terminal entry.
284
285             Before  ncurses  5.0, the split between the <STRONG>-e</STRONG> and <STRONG>-E</STRONG>
286             options was not  needed;  but  support  for  extended
287             names required making the arrays of terminal capabil-
288             ities separate from the TERMTYPE structure.
289
290        <STRONG>-e</STRONG>   Dump the capabilities of the given terminal  as  a  C
291             initializer  for  a  TERMTYPE structure (the terminal
292             capability structure in the <STRONG>&lt;term.h&gt;</STRONG>).   This  option
293             is  useful  for  preparing  versions  of  the  curses
294             library hardwired for a given terminal type.
295
296        <STRONG>-F</STRONG>   compare terminfo files.  This assumes that  two  fol-
297             lowing   arguments  are  filenames.   The  files  are
298             searched for pairwise matches between  entries,  with
299             two entries considered to match if any of their names
300             do.  The report  printed  to  standard  output  lists
301             entries  with  no  matches  in  the  other  file, and
302             entries with more than one match.  For  entries  with
303             exactly  one  match  it includes a difference report.
304             Normally, to reduce the volume  of  the  report,  use
305             references  are  not resolved before looking for dif-
306             ferences, but resolution can be forced by also speci-
307             fying <STRONG>-r</STRONG>.
308
309        <STRONG>-f</STRONG>   Display   complex   terminfo  strings  which  contain
310             if/then/else/endif expressions indented for readabil-
311             ity.
312
313        <STRONG>-G</STRONG>   Display constant literals in decimal form rather than
314             their character equivalents.
315
316        <STRONG>-g</STRONG>   Display constant character literals  in  quoted  form
317             rather than their decimal equivalents.
318
319        <STRONG>-i</STRONG>   Analyze the initialization (<STRONG>is1</STRONG>, <STRONG>is2</STRONG>, <STRONG>is3</STRONG>), and reset
320             (<STRONG>rs1</STRONG>, <STRONG>rs2</STRONG>, <STRONG>rs3</STRONG>), strings in the  entry,  as  well  as
321             those  used  for starting/stopping cursor-positioning
322             mode (<STRONG>smcup</STRONG>,  <STRONG>rmcup</STRONG>)  as  well  as  starting/stopping
323             keymap mode (<STRONG>smkx</STRONG>, <STRONG>rmkx</STRONG>).
324
325             For  each  string,  the code tries to analyze it into
326             actions in terms of the  other  capabilities  in  the
327             entry,  certain  X3.64/ISO 6429/ECMA-48 capabilities,
328             and certain DEC VT-series private modes (the  set  of
329             recognized  special  sequences  has been selected for
330             completeness over the  existing  terminfo  database).
331             Each  report  line  consists  of the capability name,
332             followed by a colon and space, followed by  a  print-
333             able expansion of the capability string with sections
334             matching recognized actions translated into {}-brack-
335             eted descriptions.
336
337             Here is a list of the DEC/ANSI special sequences rec-
338             ognized:
339
340                   Action        Meaning
341                   -----------------------------------------
342                   RIS           full reset
343                   SC            save cursor
344                   RC            restore cursor
345                   LL            home-down
346                   RSR           reset scroll region
347                   -----------------------------------------
348                   DECSTR        soft reset (VT320)
349                   S7C1T         7-bit controls (VT220)
350                   -----------------------------------------
351                   ISO DEC G0    enable DEC graphics for G0
352                   ISO UK G0     enable UK chars for G0
353                   ISO US G0     enable US chars for G0
354                   ISO DEC G1    enable DEC graphics for G1
355                   ISO UK G1     enable UK chars for G1
356                   ISO US G1     enable US chars for G1
357                   -----------------------------------------
358                   DECPAM        application keypad mode
359                   DECPNM        normal keypad mode
360                   DECANSI       enter ANSI mode
361                   -----------------------------------------
362                   ECMA[+-]AM    keyboard action mode
363                   ECMA[+-]IRM   insert replace mode
364                   ECMA[+-]SRM   send receive mode
365                   ECMA[+-]LNM   linefeed mode
366                   -----------------------------------------
367                   DEC[+-]CKM    application cursor keys
368                   DEC[+-]ANM    set VT52 mode
369                   DEC[+-]COLM   132-column mode
370                   DEC[+-]SCLM   smooth scroll
371                   DEC[+-]SCNM   reverse video mode
372                   DEC[+-]OM     origin mode
373                   DEC[+-]AWM    wraparound mode
374                   DEC[+-]ARM    auto-repeat mode
375
376             It also recognizes  a  SGR  action  corresponding  to
377             ANSI/ISO  6429/ECMA  Set Graphics Rendition, with the
378             values NORMAL, BOLD, UNDERLINE, BLINK,  and  REVERSE.
379             All but NORMAL may be prefixed with
380
381             <STRONG>o</STRONG>   "+" (turn on) or
382
383             <STRONG>o</STRONG>   "-" (turn off).
384
385             An   SGR0  designates  an  empty  highlight  sequence
386             (equivalent to {SGR:NORMAL}).
387
388        <STRONG>-l</STRONG>   Set output format to terminfo.
389
390        <STRONG>-p</STRONG>   Ignore padding specifications when comparing strings.
391
392        <STRONG>-Q</STRONG> <EM>n</EM> Rather than show source in  terminfo  (text)  format,
393             print  the compiled (binary) format in hexadecimal or
394             base64 form, depending on the option's value:
395
396                1  hexadecimal
397
398                2  base64
399
400                3  hexadecimal and base64
401
402        <STRONG>-q</STRONG>   This makes the output a little shorter:
403
404             <STRONG>o</STRONG>   Make the comparison listing shorter  by  omitting
405                 subheadings,  and  using "-" for absent capabili-
406                 ties, "@" for canceled rather than "NULL".
407
408             <STRONG>o</STRONG>   However, show differences between absent and can-
409                 celled capabilities.
410
411             <STRONG>o</STRONG>   Omit  the "Reconstructed from" comment for source
412                 listings.
413
414        <STRONG>-R</STRONG><EM>subset</EM>
415             Restrict output to a given subset.   This  option  is
416             for  use with archaic versions of terminfo like those
417             on SVr1, Ultrix, or HP/UX that  do  not  support  the
418             full  set  of  SVR4/XSI Curses terminfo; and variants
419             such as AIX that have their own extensions incompati-
420             ble with SVr4/XSI.
421
422             Available  terminfo  subsets  are  "SVr1",  "Ultrix",
423             "HP", and "AIX"; see <STRONG><A HREF="terminfo.5.html">terminfo(5)</A></STRONG>  for  details.   You
424             can  also  choose the subset "BSD" which selects only
425             capabilities with termcap equivalents  recognized  by
426             4.4BSD.
427
428        <STRONG>-s</STRONG> <EM>[d|i|l|c]</EM>
429             The  <STRONG>-s</STRONG>  option  sorts  the  fields  within each type
430             according to the argument below:
431
432             <STRONG>d</STRONG>    leave fields in the order that they  are  stored
433                  in the <EM>terminfo</EM> database.
434
435             <STRONG>i</STRONG>    sort by <EM>terminfo</EM> name.
436
437             <STRONG>l</STRONG>    sort by the long C variable name.
438
439             <STRONG>c</STRONG>    sort by the <EM>termcap</EM> name.
440
441             If the <STRONG>-s</STRONG> option is not given, the fields printed out
442             will be sorted alphabetically by  the  <STRONG>terminfo</STRONG>  name
443             within each type, except in the case of the <STRONG>-C</STRONG> or the
444             <STRONG>-L</STRONG> options, which cause the sorting to be done by the
445             <STRONG>termcap</STRONG>  name  or  the  long C variable name, respec-
446             tively.
447
448        <STRONG>-T</STRONG>   eliminates size-restrictions on the  generated  text.
449             This is mainly useful for testing and analysis, since
450             the compiled descriptions are limited (e.g., 1023 for
451             termcap, 4096 for terminfo).
452
453        <STRONG>-t</STRONG>   tells  <STRONG>tic</STRONG>  to  discard  commented-out  capabilities.
454             Normally when translating from terminfo  to  termcap,
455             untranslatable capabilities are commented-out.
456
457        <STRONG>-U</STRONG>   tells  <STRONG>infocmp</STRONG>  to  not  post-process  the data after
458             parsing the source file.   This  feature  helps  when
459             comparing  the  actual  contents of two source files,
460             since it excludes the inferences that  <STRONG>infocmp</STRONG>  makes
461             to fill in missing data.
462
463        <STRONG>-V</STRONG>   reports the version of ncurses which was used in this
464             program, and exits.
465
466        <STRONG>-v</STRONG> <EM>n</EM> prints out tracing information on standard  error  as
467             the program runs.
468
469             The  optional  parameter  <EM>n</EM> is a number from 1 to 10,
470             inclusive, indicating the desired level of detail  of
471             information.   If  ncurses  is  built without tracing
472             support, the optional parameter is ignored.
473
474        <STRONG>-W</STRONG>   By itself, the <STRONG>-w</STRONG> option will not force long  strings
475             to be wrapped.  Use the <STRONG>-W</STRONG> option to do this.
476
477        <STRONG>-w</STRONG> <EM>width</EM>
478             changes the output to <EM>width</EM> characters.
479
480        <STRONG>-x</STRONG>   print   information  for  user-defined  capabilities.
481             These are extensions to the terminfo repertoire which
482             can be loaded using the <STRONG>-x</STRONG> option of <STRONG>tic</STRONG>.
483
484
485 </PRE><H2><a name="h2-FILES">FILES</a></H2><PRE>
486        /usr/share/terminfo Compiled  terminal  description  data-
487                            base.
488
489
490 </PRE><H2><a name="h2-EXTENSIONS">EXTENSIONS</a></H2><PRE>
491        The <STRONG>-0</STRONG>, <STRONG>-1</STRONG>, <STRONG>-E</STRONG>, <STRONG>-F</STRONG>, <STRONG>-G</STRONG>, <STRONG>-Q</STRONG>, <STRONG>-R</STRONG>, <STRONG>-T</STRONG>, <STRONG>-V</STRONG>, <STRONG>-a</STRONG>,  <STRONG>-e</STRONG>,  <STRONG>-f</STRONG>,  <STRONG>-g</STRONG>,
492        <STRONG>-i</STRONG>,  <STRONG>-l</STRONG>,  <STRONG>-p</STRONG>,  <STRONG>-q</STRONG> and <STRONG>-t</STRONG> options are not supported in SVr4
493        curses.
494
495        SVr4 infocmp does not distinguish between absent and  can-
496        celled capabilities.  Also, it shows missing integer capa-
497        bilities as <STRONG>-1</STRONG> (the internal value used to represent miss-
498        ing integers).  This implementation shows those as "NULL",
499        for consistency with missing strings.
500
501        The <STRONG>-r</STRONG> option's notion of "termcap" capabilities is System
502        V  Release  4's.   Actual  BSD curses versions will have a
503        more restricted set.  To see only the 4.4BSD set,  use  <STRONG>-r</STRONG>
504        <STRONG>-RBSD</STRONG>.
505
506
507 </PRE><H2><a name="h2-BUGS">BUGS</a></H2><PRE>
508        The <STRONG>-F</STRONG> option of <STRONG><A HREF="infocmp.1m.html">infocmp(1m)</A></STRONG> should be a <STRONG><A HREF="toe.1m.html">toe(1m)</A></STRONG> mode.
509
510
511 </PRE><H2><a name="h2-SEE-ALSO">SEE ALSO</a></H2><PRE>
512        <STRONG><A HREF="captoinfo.1m.html">captoinfo(1m)</A></STRONG>,     <STRONG><A HREF="infotocap.1m.html">infotocap(1m)</A></STRONG>,     <STRONG><A HREF="tic.1m.html">tic(1m)</A></STRONG>,    <STRONG><A HREF="toe.1m.html">toe(1m)</A></STRONG>,
513        <STRONG><A HREF="ncurses.3x.html">curses(3x)</A></STRONG>, <STRONG><A HREF="terminfo.5.html">terminfo(5)</A></STRONG>.
514
515        http://invisible-island.net/ncurses/tctest.html
516
517        This describes <STRONG>ncurses</STRONG> version 6.0 (patch 20170401).
518
519
520 </PRE><H2><a name="h2-AUTHOR">AUTHOR</a></H2><PRE>
521        Eric S. Raymond &lt;esr@snark.thyrsus.com&gt; and
522        Thomas E. Dickey &lt;dickey@invisible-island.net&gt;
523
524
525
526                                                             <STRONG><A HREF="infocmp.1m.html">infocmp(1m)</A></STRONG>
527 </PRE>
528 <div class="nav">
529 <ul>
530 <li><a href="#h2-NAME">NAME</a></li>
531 <li><a href="#h2-SYNOPSIS">SYNOPSIS</a></li>
532 <li><a href="#h2-DESCRIPTION">DESCRIPTION</a>
533 <ul>
534 <li><a href="#h3-Default-Options">Default Options</a></li>
535 <li><a href="#h3-Comparison-Options-_-d_-_-c_-_-n_">Comparison Options [-d] [-c] [-n]</a></li>
536 <li><a href="#h3-Source-Listing-Options-_-I_-_-L_-_-C_-_-r_">Source Listing Options [-I] [-L] [-C] [-r]</a></li>
537 <li><a href="#h3-Use_-Option-_-u_">Use= Option [-u]</a></li>
538 <li><a href="#h3-Other-Options">Other Options</a></li>
539 </ul>
540 </li>
541 <li><a href="#h2-FILES">FILES</a></li>
542 <li><a href="#h2-EXTENSIONS">EXTENSIONS</a></li>
543 <li><a href="#h2-BUGS">BUGS</a></li>
544 <li><a href="#h2-SEE-ALSO">SEE ALSO</a></li>
545 <li><a href="#h2-AUTHOR">AUTHOR</a></li>
546 </ul>
547 </div>
548 </BODY>
549 </HTML>