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>