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