X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Finfocmp.1m.html;h=efa54b8a8a2b55aef0f5e24024faae4b56b4f059;hp=b35c733d322814c1cf1411d363a984e979a00206;hb=a90dd7b66fa711acd24d8181ea20e4f57d4b36cd;hpb=b793748293cd1a764b1a858455399ad899b5a8a1 diff --git a/doc/html/man/infocmp.1m.html b/doc/html/man/infocmp.1m.html index b35c733d..efa54b8a 100644 --- a/doc/html/man/infocmp.1m.html +++ b/doc/html/man/infocmp.1m.html @@ -1,7 +1,8 @@ - + infocmp 1m - + @@ -364,34 +365,45 @@ 3 hexadecimal and base64 + For example, this prints the compiled terminfo value as a string + which could be assigned to the TERMINFO environment variable: + + infocmp -0 -q -Q2 + -q This makes the output a little shorter: - o Make the comparison listing shorter by omitting subheadings, + o Make the comparison listing shorter by omitting subheadings, and using "-" for absent capabilities, "@" for canceled rather than "NULL". - o However, show differences between absent and cancelled capa- + o However, show differences between absent and cancelled capa- bilities. 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 such as AIX that have their own extensions incompatible + 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 incompatible 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 recog- - nized by 4.4BSD. + o Available terminfo subsets are "SVr1", "Ultrix", "HP", and + "AIX"; see terminfo(5) for details. + + o You can also choose the subset "BSD" which selects only capa- + bilities with termcap equivalents recognized by 4.4BSD. The + -C option sets the "BSD" subset as a side-effect. + + o If you select any other value for -R, it is the same as no + subset, i.e., all capabilities are used. The -I option like- + wise selects no subset as a side-effect. -s [d|i|l|c] - The -s option sorts the fields within each type according to the + The -s option sorts the fields within each type according to the argument below: - d leave fields in the order that they are stored in the ter- + d leave fields in the order that they are stored in the ter- minfo database. i sort by terminfo name. @@ -400,52 +412,83 @@ 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 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 + If the -s option is not given, the fields printed out 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, respectively. - -T eliminates size-restrictions on the generated text. This is + -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 ter- + descriptions are limited (e.g., 1023 for termcap, 4096 for ter- minfo). - -t tells tic to discard commented-out capabilities. Normally when - translating from terminfo to termcap, untranslatable capabilities + -t tells tic to discard commented-out capabilities. 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 con- - tents of two source files, since it excludes the inferences that + -U tells infocmp to not post-process the data after parsing the + source file. This feature helps when comparing the actual con- + tents 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 + -v n prints out tracing information on standard error as the program runs. - The optional parameter n is a number from 1 to 10, inclusive, + The optional parameter n is a number from 1 to 10, inclusive, indicating the desired level of detail of information. If ncurses - is built without tracing support, the optional parameter is + is built without tracing support, the optional parameter is ignored. - -W By itself, the -w option will not force long strings to be + -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. - -x print information for user-defined capabilities. These are exten- - sions to the terminfo repertoire which can be loaded using the -x - option of tic. + -x print information for user-defined capabilities (see user_caps(5). + These are extensions to the terminfo repertoire which can be + loaded using the -x option of tic.

FILES

        /usr/share/terminfo Compiled terminal description database.
 
 
+

HISTORY

+       Although System V Release 2 provided a terminfo library, it had no doc-
+       umented tool for decompiling the terminal  descriptions.   Tony  Hansen
+       (AT&T) wrote the first infocmp in early 1984, for System V Release 3.
+
+       Eric  Raymond used the AT&T documentation in 1995 to provide an equiva-
+       lent infocmp for ncurses.  In addition, he added  a  few  new  features
+       such as:
+
+       o   the  -e option, to support fallback (compiled-in) terminal descrip-
+           tions
+
+       o   the -i option, to help with analysis
+
+       Later, Thomas Dickey added the -x (user-defined  capabilities)  option,
+       and  the  -E option to support fallback entries with user-defined capa-
+       bilities.
+
+       For a complete list, see the EXTENSIONS section.
+
+       In 2010, Roy Marples provided an infocmp program  for  NetBSD.   It  is
+       less  capable  than  the  SVr4  or ncurses versions (e.g., it lacks the
+       sorting options documented in X/Open), but does include the  -x  option
+       adapted from ncurses.
+
+
+

PORTABILITY

+       X/Open  Curses,  Issue  7 (2009) provides a description of infocmp.  It
+       does not mention the options used for converting to termcap format.
+
+

EXTENSIONS

        The -0, -1, -E, -F, -G, -Q, -R, -T, -V, -a, -e, -f, -g, -i, -l, -p,  -q
        and -t options are not supported in SVr4 curses.
@@ -466,11 +509,11 @@

SEE ALSO

        captoinfo(1m),  infotocap(1m),  tic(1m),  toe(1m),   curses(3x),   ter-
-       minfo(5).
+       minfo(5).  user_caps(5).
 
-       http://invisible-island.net/ncurses/tctest.html
+       https://invisible-island.net/ncurses/tctest.html
 
-       This describes ncurses version 6.0 (patch 20170520).
+       This describes ncurses version 6.2 (patch 20200222).

AUTHOR

@@ -495,6 +538,8 @@
 
 
 
  • FILES
    • 
+
  • HISTORY
    • 
+
  • PORTABILITY
    • 
 
  • EXTENSIONS
    • 
 
  • BUGS
    • 
 
  • SEE ALSO
    •