X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Finfocmp.1m.html;h=5e24270058bd4a1756ca7a7049b39403645cdc5a;hp=4d814961e8e8949b8df54ff5f7228176274ed279;hb=62ca6190a9a8ddccb2c4d5ca7b2ef9f88432da65;hpb=34d602f272c394e9a980438e636e1ce4d355f83b;ds=sidebyside diff --git a/doc/html/man/infocmp.1m.html b/doc/html/man/infocmp.1m.html index 4d814961..5e242700 100644 --- a/doc/html/man/infocmp.1m.html +++ b/doc/html/man/infocmp.1m.html @@ -1,8 +1,7 @@ - + + + infocmp 1m -

infocmp 1m

-
+

infocmp 1m

-
 infocmp(1m)                                                 infocmp(1m)
 
 
 
 
-
-

NAME

+

NAME

        infocmp - compare or print out terminfo descriptions
 
 
-
-

SYNOPSIS

-       infocmp [-1CDEFGIKLTUVcdegilnpqrtux]
-             [-v n] [-s d| i| l| c] [-R subset]
+

SYNOPSIS

+       infocmp [-1CDEFGIKLTUVWcdegilnpqrtux]
+             [-v n] [-s d| i| l| c] [-Q n] [-R subset]
              [-w width] [-A directory] [-B directory]
              [termname...]
 
 
-
-

DESCRIPTION

+

DESCRIPTION

        infocmp  can  be  used  to compare a binary terminfo entry
        with other terminfo entries, rewrite a  terminfo  descrip-
        tion  to  take  advantage  of  the use= terminfo field, or
@@ -69,12 +66,14 @@
        fields will be printed  first,  followed  by  the  numeric
        fields, followed by the string fields.
 
-   Default Options
+
+

Default Options

        If  no options are specified and zero or one termnames are
        specified, the -I option will be assumed.   If  more  than
        one termname is specified, the -d option will be assumed.
 
-   Comparison Options [-d] [-c] [-n]
+
+

Comparison Options [-d] [-c] [-n]

        infocmp  compares  the  terminfo  description of the first
        terminal termname with each of the descriptions  given  by
        the  entries  for  the  other  terminal's termnames.  If a
@@ -99,7 +98,8 @@
        termnames.  This can be used as a quick check  to  see  if
        anything was left out of a description.
 
-   Source Listing Options [-I] [-L] [-C] [-r]
+
+

Source Listing Options [-I] [-L] [-C] [-r]

        The  -I,  -L, and -C options will produce a source listing
        for each terminal named.
 
@@ -121,7 +121,7 @@
 
        For best results when converting to  termcap  format,  you
        should use both -C and -r.  Normally a termcap description
-       is limited to 1023 bytes.  infocmp trims away less  essen-
+       is limited to 1023 bytes.  infocmp trims away less  essen-
        tial  parts  to make it fit.  If you are converting to one
        of the (rare)  termcap  implementations  which  accept  an
        unlimited  size  of  termcap,  you  may want to add the -T
@@ -168,7 +168,8 @@
      %p1%?%'x'%>%t%p1%'y'%+%;    %>xy      concept
      %p2 is printed before %p1   %r        hp
 
-   Use= Option [-u]
+
+

Use= Option [-u]

        The -u option produces a terminfo  source  description  of
        the  first  terminal termname which is relative to the sum
        of the descriptions given by the  entries  for  the  other
@@ -215,7 +216,7 @@
        needed.
 
    Changing Databases [-A directory] [-B directory]
-       Like other ncurses utilities, infocmp looks for the termi-
+       Like other ncurses utilities, infocmp looks for the termi-
        nal descriptions in several places.  You can use the  TER-
        MINFO  and TERMINFO_DIRS environment variables to override
        the compiled-in default list  of  places  to  search  (see
@@ -236,7 +237,8 @@
        ture for comparing descriptions for the same terminal cre-
        ated by different people.
 
-   Other Options
+
+

Other Options

        -0   causes the fields to be printed on one line,  without
             wrapping.
 
@@ -295,24 +297,29 @@
             rather than their decimal equivalents.
 
        -i   Analyze the initialization (is1, is2, is3), and reset
-            (rs1, rs2, rs3), strings  in  the  entry.   For  each
-            string,  the code tries to analyze it into actions in
-            terms of the other capabilities in the entry, certain
-            X3.64/ISO  6429/ECMA-48 capabilities, and certain DEC
-            VT-series private modes (the set of  recognized  spe-
-            cial  sequences  has  been  selected for completeness
-            over the existing terminfo  database).   Each  report
-            line  consists  of the capability name, followed by a
-            colon and space, followed by a printable expansion of
-            the  capability  string with sections matching recog-
-            nized actions translated into  {}-bracketed  descrip-
-            tions.   Here  is  a  list  of  the  DEC/ANSI special
-            sequences recognized: i.
+            (rs1, rs2, rs3), strings in the  entry,  as  well  as
+            those  used  for starting/stopping cursor-positioning
+            mode (smcup,  rmcup)  as  well  as  starting/stopping
+            keymap mode (smkx, rmkx).
+
+            For  each  string,  the code tries to analyze it into
+            actions in terms of the  other  capabilities  in  the
+            entry,  certain  X3.64/ISO 6429/ECMA-48 capabilities,
+            and certain DEC VT-series private modes (the  set  of
+            recognized  special  sequences  has been selected for
+            completeness over the  existing  terminfo  database).
+            Each  report  line  consists  of the capability name,
+            followed by a colon and space, followed by  a  print-
+            able expansion of the capability string with sections
+            matching recognized actions translated into {}-brack-
+            eted descriptions.
+
+            Here is a list of the DEC/ANSI special sequences rec-
+            ognized:
 
                   Action        Meaning
                   -----------------------------------------
                   RIS           full reset
-
                   SC            save cursor
                   RC            restore cursor
                   LL            home-down
@@ -359,27 +366,44 @@
 
        -p   Ignore padding specifications when comparing strings.
 
-       -q   Make  the comparison listing shorter by omitting sub-
-            headings, and using "-" for absent capabilities,  "@"
-            for canceled rather than "NULL".
+       -Q n Rather  than  show  source in terminfo (text) format,
+            print the compiled (binary) format in hexadecimal  or
+            base64 form, depending on the option's value:
+
+               1  hexadecimal
+
+               2  base64
+
+               3  hexadecimal and base64
+
+       -q   This makes the output a little shorter:
+
+            o   Make  the  comparison listing shorter by omitting
+                subheadings, and using "-" for  absent  capabili-
+                ties, "@" for canceled rather than "NULL".
+
+            o   Omit  the "Reconstructed from" comment for source
+                listings.
 
        -Rsubset
-            Restrict  output  to  a given subset.  This option is
-            for use with archaic versions of terminfo like  those
-            on  SVr1,  Ultrix,  or  HP/UX that do not support the
-            full set of SVR4/XSI Curses  terminfo;  and  variants
+            Restrict output to a given subset.   This  option  is
+            for  use with archaic versions of terminfo like those
+            on SVr1, Ultrix, or HP/UX that  do  not  support  the
+            full  set  of  SVR4/XSI Curses terminfo; and variants
             such as AIX that have their own extensions incompati-
-            ble with SVr4/XSI.  Available  terminfo  subsets  are
-            "SVr1",  "Ultrix",  "HP",  and "AIX"; see terminfo(5)
-            for details.  You can also choose  the  subset  "BSD"
-            which  selects only capabilities with termcap equiva-
-            lents recognized by 4.4BSD.
+            ble with SVr4/XSI.
+
+            Available  terminfo  subsets  are  "SVr1",  "Ultrix",
+            "HP", and "AIX"; see terminfo(5)  for  details.   You
+            can  also  choose the subset "BSD" which selects only
+            capabilities with termcap equivalents  recognized  by
+            4.4BSD.
 
        -s [d|i|l|c]
-            The -s option  sorts  the  fields  within  each  type
+            The  -s  option  sorts  the  fields  within each type
             according to the argument below:
 
-            d    leave  fields  in the order that they are stored
+            d    leave fields in the order that they  are  stored
                  in the terminfo database.
 
             i    sort by terminfo name.
@@ -389,34 +413,37 @@
             c    sort by the termcap name.
 
             If the -s option is not given, the fields printed out
-            will  be  sorted  alphabetically by the terminfo name
+            will be sorted alphabetically by  the  terminfo  name
             within each type, except in the case of the -C or the
             -L options, which cause the sorting to be done by the
-            termcap name or the long  C  variable  name,  respec-
+            termcap  name  or  the  long C variable name, respec-
             tively.
 
-       -T   eliminates  size-restrictions  on the generated text.
+       -T   eliminates size-restrictions on the  generated  text.
             This is mainly useful for testing and analysis, since
             the compiled descriptions are limited (e.g., 1023 for
             termcap, 4096 for terminfo).
 
        -t   tells  tic  to  discard  commented-out  capabilities.
-            Normally  when  translating from terminfo to termcap,
+            Normally when translating from terminfo  to  termcap,
             untranslatable capabilities are commented-out.
 
-       -U   tells infocmp to  not  post-process  the  data  after
-            parsing  the  source  file.   This feature helps when
-            comparing the actual contents of  two  source  files,
-            since  it  excludes the inferences that infocmp makes
+       -U   tells  infocmp  to  not  post-process  the data after
+            parsing the source file.   This  feature  helps  when
+            comparing  the  actual  contents of two source files,
+            since it excludes the inferences that  infocmp  makes
             to fill in missing data.
 
        -V   reports the version of ncurses which was used in this
             program, and exits.
 
-       -v n prints  out  tracing information on standard error as
-            the program runs.  Higher values of n induce  greater
+       -v n prints out tracing information on standard  error  as
+            the  program runs.  Higher values of n induce greater
             verbosity.
 
+       -W   By itself, the -w option will not force long  strings
+            to be wrapped.  Use the -W option to do this.
+
        -w width
             changes the output to width characters.
 
@@ -425,14 +452,12 @@
             can be loaded using the -x option of tic.
 
 
-
-

FILES

+

FILES

        /usr/share/terminfo Compiled  terminal  description  data-
                            base.
 
 
-
-

EXTENSIONS

+

EXTENSIONS

        The -0, -1, -E, -F, -G, -R, -T, -V, -a, -e,  -f,  -g,  -i,
        -l,  -p,  -q  and  -t  options  are  not supported in SVr4
        curses.
@@ -443,23 +468,20 @@
        -RBSD.
 
 
-
-

BUGS

+

BUGS

        The -F option of infocmp(1m) should be a toe(1m) mode.
 
 
-
-

SEE ALSO

+

SEE ALSO

        captoinfo(1m),     infotocap(1m),     tic(1m),    toe(1m),
        curses(3x), terminfo(5).
 
        http://invisible-island.net/ncurses/tctest.html
 
-       This describes ncurses version 5.9 (patch 20140524).
+       This describes ncurses version 6.0 (patch 20161224).
 
 
-
-

AUTHOR

+

AUTHOR

        Eric S. Raymond <esr@snark.thyrsus.com> and
        Thomas E. Dickey <dickey@invisible-island.net>
 
@@ -467,10 +489,25 @@
 
                                                             infocmp(1m)
 
-
-
-Man(1) output converted with -man2html -
+