<!--
* t
****************************************************************************
- * Copyright 2018-2022,2023 Thomas E. Dickey *
+ * Copyright 2018-2023,2024 Thomas E. Dickey *
* Copyright 1998-2017,2018 Free Software Foundation, Inc. *
* *
* Permission is hereby granted, free of charge, to any person obtaining a *
* sale, use or other dealings in this Software without prior written *
* authorization. *
****************************************************************************
- * @Id: infocmp.1m,v 1.99 2023/11/25 17:10:25 tom Exp @
+ * @Id: infocmp.1m,v 1.109 2024/03/16 15:35:01 tom Exp @
-->
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN">
<HTML>
<HEAD>
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
<meta name="generator" content="Manpage converted by man2html - see https://invisible-island.net/scripts/readme.html#others_scripts">
-<TITLE>infocmp 1m 2023-11-25 ncurses 6.4 User commands</TITLE>
+<TITLE>infocmp 1m 2024-03-16 ncurses 6.4 User commands</TITLE>
<link rel="author" href="mailto:bug-ncurses@gnu.org">
</HEAD>
<BODY>
-<H1 class="no-header">infocmp 1m 2023-11-25 ncurses 6.4 User commands</H1>
+<H1 class="no-header">infocmp 1m 2024-03-16 ncurses 6.4 User commands</H1>
<PRE>
<STRONG><A HREF="infocmp.1m.html">infocmp(1m)</A></STRONG> User commands <STRONG><A HREF="infocmp.1m.html">infocmp(1m)</A></STRONG>
<STRONG>infocmp</STRONG> can be used to compare a binary <STRONG>terminfo</STRONG> entry with other
terminfo entries, rewrite a <STRONG>terminfo</STRONG> description to take advantage of
the <STRONG>use=</STRONG> terminfo field, or print out a <STRONG>terminfo</STRONG> description from the
- binary file (<STRONG>term</STRONG>) in a variety of formats. In all cases, the boolean
+ binary file (<STRONG>term</STRONG>) in a variety of formats. In all cases, the Boolean
fields will be printed first, followed by the numeric fields, followed
by the string fields.
<EM>type</EM> is specified, the <STRONG>-d</STRONG> option will be assumed.
-</PRE><H3><a name="h3-Comparison-Options
-_-d_-_-c_-_-n_">Comparison Options [-d] [-c] [-n]</a></H3><PRE>
+</PRE><H3><a name="h3-Comparison-Options
_d_c_n_">Comparison Options [-d] [-c] [-n]</a></H3><PRE>
<STRONG>infocmp</STRONG> compares the <STRONG>terminfo</STRONG> description of the first terminal
<EM>terminal-type</EM> with each of the descriptions given by the entries for
the other terminal's <EM>terminal-types</EM>. If a capability is defined for
only one of the terminals, the value returned depends on the type of
the capability:
- <STRONG>o</STRONG> <STRONG>F</STRONG> for missing boolean variables
+ <STRONG>o</STRONG> <STRONG>F</STRONG> for missing Boolean variables
<STRONG>o</STRONG> <STRONG>NULL</STRONG> for missing integer or string variables
with "OT").
If no <EM>terminal-types</EM> are given, <STRONG>infocmp</STRONG> uses the environment
- variable <STRONG>TERM</STRONG> for each of the <EM>terminal-types</EM>.
+ variable <EM>TERM</EM> for each of the <EM>terminal-types</EM>.
-</PRE><H3><a name="h3-Source-Listing-Options
-_-I_-_-L_-_-C_-_-r_">Source Listing Options [-I] [-L] [-C] [-r]</a></H3><PRE>
+</PRE><H3><a name="h3-Source-Listing-Options
_I_L_C_r_">Source Listing Options [-I] [-L] [-C] [-r]</a></H3><PRE>
The <STRONG>-I</STRONG>, <STRONG>-L</STRONG>, and <STRONG>-C</STRONG> options will produce a source listing for each
terminal named.
- <STRONG>-I</STRONG> use the <STRONG>terminfo</STRONG> names
- <STRONG>-L</STRONG> use the long C variable name listed in <<STRONG>term.h</STRONG>>
- <STRONG>-C</STRONG> use the <STRONG>termcap</STRONG> names
- <STRONG>-r</STRONG> when using <STRONG>-C</STRONG>, put out all capabilities in <STRONG>termcap</STRONG> form
- <STRONG>-K</STRONG> modifies the <STRONG>-C</STRONG> option, improving BSD-compatibility.
+ <STRONG>-I</STRONG> use <EM>terminfo</EM> capability codes
+ <STRONG>-L</STRONG> use "long" capability names
+ <STRONG>-C</STRONG> use <EM>termcap</EM> capability codes
+ <STRONG>-r</STRONG> with <STRONG>-C</STRONG>, include nonstandard capabilities
+ <STRONG>-K</STRONG> with <STRONG>-C</STRONG>, improve BSD compatibility
- If no <EM>terminal-types</EM> are given, the environment variable <STRONG>TERM</STRONG> will be
+ If no <EM>terminal-types</EM> are given, the environment variable <EM>TERM</EM> will be
used for the terminal name.
The source produced by the <STRONG>-C</STRONG> option may be used directly as a <STRONG>termcap</STRONG>
Some common <STRONG>terminfo</STRONG> parameter sequences, their <STRONG>termcap</STRONG> equivalents,
and some terminal types which commonly have such sequences, are:
- <STRONG>terminfo</STRONG> <STRONG>termcap</STRONG> Representative Terminals
- ---------------------------------------------------------------
- <STRONG>%p1%c</STRONG> <STRONG>%.</STRONG> adm
- <STRONG>%p1%d</STRONG> <STRONG>%d</STRONG> hp, ANSI standard, vt100
- <STRONG>%p1%'x'%+%c</STRONG> <STRONG>%+x</STRONG> concept
- <STRONG>%i</STRONG> <STRONG>%i</STRONG>q ANSI standard, vt100
- <STRONG>%p1%?%'x'%>%t%p1%'y'%+%;</STRONG> <STRONG>%>xy</STRONG> concept
- <STRONG>%p2</STRONG> is printed before <STRONG>%p1</STRONG> <STRONG>%r</STRONG> hp
+ <STRONG><EM>terminfo</EM></STRONG> <STRONG><EM>termcap</EM></STRONG> Terminal Types
+ ----------------------------------------------------
+ <STRONG>%p1%c</STRONG> <STRONG>%.</STRONG> ansi-m
+ <STRONG>%p1%d</STRONG> <STRONG>%d</STRONG> ansi, vt100
+ <STRONG>%p1%'</STRONG> <STRONG>'%+%c</STRONG> <STRONG>%+x</STRONG> vt52
+ <STRONG>%i</STRONG> <STRONG>%iq</STRONG> ansi, vt100
+ <STRONG>%p1%?%'x'%>%t%p1%'y'%+%;</STRONG> <STRONG>%>xy</STRONG> annarbor4080
+ <STRONG>%p2</STRONG>...<STRONG>%p1</STRONG> <STRONG>%r</STRONG> hpgeneric
-</PRE><H3><a name="h3-Use_
-Option-_-u_">Use= Option [-u]</a></H3><PRE>
+</PRE><H3><a name="h3-Use_
Option_u_">Use= Option [-u]</a></H3><PRE>
The <STRONG>-u</STRONG> option produces a <STRONG>terminfo</STRONG> source description of the first
terminal <EM>terminal-type</EM> which is relative to the sum of the descriptions
given by the entries for the other <EM>terminal-types</EM>. It does this by
that were not needed.
<STRONG>Changing</STRONG> <STRONG>Databases</STRONG> <STRONG>[-A</STRONG> <EM>directory</EM>] [-B <EM>directory</EM>]
- Like other <STRONG>ncurses</STRONG> utilities, <STRONG>infocmp</STRONG> looks for the terminal
- descriptions in several places. You can use the <STRONG>TERMINFO</STRONG> and
- <STRONG>TERMINFO_DIRS</STRONG> environment variables to override the compiled-in default
+ Like other <EM>ncurses</EM> utilities, <STRONG>infocmp</STRONG> looks for the terminal
+ descriptions in several places. You can use the <EM>TERMINFO</EM> and
+ <EM>TERMINFO</EM><STRONG>_</STRONG><EM>DIRS</EM> environment variables to override the compiled-in default
list of places to search. See <STRONG><A HREF="ncurses.3x.html">curses(3x)</A></STRONG>, as well as the <EM>Fetching</EM>
<EM>Compiled</EM> <EM>Descriptions</EM> section in <STRONG><A HREF="terminfo.5.html">terminfo(5)</A></STRONG>.
according to the type and the name of the corresponding terminal
entry.
- Before ncurses 5.0, the split between the <STRONG>-e</STRONG> and <STRONG>-E</STRONG> options was
+ Before <EM>ncurses</EM> 5.0, the split between the <STRONG>-e</STRONG> and <STRONG>-E</STRONG> options was
not needed; but support for extended names required making the
arrays of terminal capabilities separate from the TERMTYPE
structure.
3 hexadecimal and base64
For example, this prints the compiled terminfo value as a string
- which could be assigned to the <STRONG>TERMINFO</STRONG> environment variable:
+ which could be assigned to the <EM>TERMINFO</EM> environment variable:
infocmp -0 -q -Q2
contents of two source files, since it excludes the inferences
that <STRONG>infocmp</STRONG> makes to fill in missing data.
- <STRONG>-V</STRONG> reports the version of ncurses which was used in this program, and
+ <STRONG>-V</STRONG> reports the version of <EM>ncurses</EM> which was used in this program, and
exits.
<STRONG>-v</STRONG> <EM>n</EM> prints out tracing information on standard error as the program
runs.
The optional parameter <EM>n</EM> is a number from 1 to 10, inclusive,
- indicating the desired level of detail of information. If ncurses
+ indicating the desired level of detail of information. If <EM>ncurses</EM>
is built without tracing support, the optional parameter is
ignored.
(AT&T) wrote the first <STRONG>infocmp</STRONG> in early 1984, for System V Release 3.
Eric Raymond used the AT&T documentation in 1995 to provide an
- equivalent <STRONG>infocmp</STRONG> for ncurses. In addition, he added a few new
+ equivalent <STRONG>infocmp</STRONG> for <EM>ncurses</EM>. In addition, he added a few new
features such as:
<STRONG>o</STRONG> the <STRONG>-e</STRONG> option, to support <EM>fallback</EM> (compiled-in) terminal
For a complete list, see the <EM>EXTENSIONS</EM> section.
In 2010, Roy Marples provided an <STRONG>infocmp</STRONG> program for NetBSD. It is
- less capable than the SVr4 or ncurses versions (e.g., it lacks the
+ less capable than the SVr4 or <EM>ncurses</EM> versions (e.g., it lacks the
sorting options documented in X/Open), but does include the <STRONG>-x</STRONG> option
- adapted from ncurses.
+ adapted from <EM>ncurses</EM>.
</PRE><H2><a name="h2-BUGS">BUGS</a></H2><PRE>
-ncurses 6.4 202
3-11-25 <STRONG><A HREF="infocmp.1m.html">infocmp(1m)</A></STRONG>
+ncurses 6.4 202
4-03-16 <STRONG><A HREF="infocmp.1m.html">infocmp(1m)</A></STRONG>
</PRE>
<div class="nav">
<ul>
<li><a href="#h2-DESCRIPTION">DESCRIPTION</a>
<ul>
<li><a href="#h3-Default-Options">Default Options</a></li>
-<li><a href="#h3-Comparison-Options-_-d_-_-c_-_-n_">Comparison Options [-d] [-c] [-n]</a></li>
-<li><a href="#h3-Source-Listing-Options-_-I_-_-L_-_-C_-_-r_">Source Listing Options [-I] [-L] [-C] [-r]</a></li>
-<li><a href="#h3-Use_-Option-_-u_">Use= Option [-u]</a></li>
+<li><a href="#h3-Comparison-Options_d_c_n_">Comparison Options [-d] [-c] [-n]</a></li>
+<li><a href="#h3-Source-Listing-Options_I_L_C_r_">Source Listing Options [-I] [-L] [-C] [-r]</a></li>
+<li><a href="#h3-Use_Option_u_">Use= Option [-u]</a></li>
<li><a href="#h3-Other-Options">Other Options</a></li>
</ul>
</li>
projects / ncurses.git / blobdiff