mirror of
https://github.com/ThomasDickey/ncurses-snapshots.git
synced 2026-01-26 11:04:35 +00:00
215 lines
14 KiB
HTML
215 lines
14 KiB
HTML
<!--
|
|
* t
|
|
****************************************************************************
|
|
* Copyright 2018-2024,2025 Thomas E. Dickey *
|
|
* Copyright 1998-2010,2016 Free Software Foundation, Inc. *
|
|
* *
|
|
* Permission is hereby granted, free of charge, to any person obtaining a *
|
|
* copy of this software and associated documentation files (the *
|
|
* "Software"), to deal in the Software without restriction, including *
|
|
* without limitation the rights to use, copy, modify, merge, publish, *
|
|
* distribute, distribute with modifications, sublicense, and/or sell *
|
|
* copies of the Software, and to permit persons to whom the Software is *
|
|
* furnished to do so, subject to the following conditions: *
|
|
* *
|
|
* The above copyright notice and this permission notice shall be included *
|
|
* in all copies or substantial portions of the Software. *
|
|
* *
|
|
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS *
|
|
* OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF *
|
|
* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. *
|
|
* IN NO EVENT SHALL THE ABOVE COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, *
|
|
* DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR *
|
|
* OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR *
|
|
* THE USE OR OTHER DEALINGS IN THE SOFTWARE. *
|
|
* *
|
|
* Except as contained in this notice, the name(s) of the above copyright *
|
|
* holders shall not be used in advertising or otherwise to promote the *
|
|
* sale, use or other dealings in this Software without prior written *
|
|
* authorization. *
|
|
****************************************************************************
|
|
* @Id: captoinfo.1m,v 1.77 2025/11/12 01:03:56 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>captoinfo 1m 2025-11-11 ncurses 6.6 User commands</TITLE>
|
|
<link rel="author" href="mailto:bug-ncurses@gnu.org">
|
|
|
|
</HEAD>
|
|
<BODY>
|
|
<H1 class="no-header">captoinfo 1m 2025-11-11 ncurses 6.6 User commands</H1>
|
|
<PRE>
|
|
<STRONG><A HREF="captoinfo.1m.html">captoinfo(1m)</A></STRONG> User commands <STRONG><A HREF="captoinfo.1m.html">captoinfo(1m)</A></STRONG>
|
|
|
|
|
|
</PRE><H2><a name="h2-NAME">NAME</a></H2><PRE>
|
|
<STRONG>captoinfo</STRONG> - convert a <EM>termcap</EM> description into a <EM>terminfo</EM> description
|
|
|
|
|
|
</PRE><H2><a name="h2-SYNOPSIS">SYNOPSIS</a></H2><PRE>
|
|
<STRONG>captoinfo</STRONG> [<EM>tic-option</EM>] [<EM>file</EM> ...]
|
|
|
|
<STRONG>captoinfo</STRONG> <STRONG>-V</STRONG>
|
|
|
|
|
|
</PRE><H2><a name="h2-DESCRIPTION">DESCRIPTION</a></H2><PRE>
|
|
<STRONG>captoinfo</STRONG> translates terminal descriptions. It looks in each given
|
|
text <EM>file</EM> for <EM>termcap</EM> entries and, for each one found, writes an
|
|
equivalent <EM>terminfo</EM> description to the standard output stream. <EM>termcap</EM>
|
|
<STRONG>tc</STRONG> capabilities translate to <EM>terminfo</EM> "<STRONG>use</STRONG>" capabilities.
|
|
|
|
If no <EM>file</EM>s are specified, <STRONG>captoinfo</STRONG> interprets the content of the
|
|
environment variable <EM>TERMCAP</EM> as a file name, and extracts only the
|
|
entry for the terminal type named in the environment variable <EM>TERM</EM> from
|
|
it. If the environment variable <EM>TERMCAP</EM> is not set, <STRONG>captoinfo</STRONG> reads
|
|
<EM>/etc/termcap</EM>.
|
|
|
|
This utility is implemented as a link to <STRONG><A HREF="tic.1m.html">tic(1m)</A></STRONG>, with the latter's <STRONG>-I</STRONG>
|
|
option implied. You can use other <STRONG>tic</STRONG> options such as <STRONG>-1</STRONG>, <STRONG>-f</STRONG>, <STRONG>-v</STRONG>, <STRONG>-w</STRONG>,
|
|
and <STRONG>-x</STRONG>. The <STRONG>-V</STRONG> option reports the version of <EM>ncurses</EM> associated with
|
|
this program and exits with a successful status.
|
|
|
|
|
|
</PRE><H3><a name="h3-Translations-from-Nonstandard-Capabilities">Translations from Nonstandard Capabilities</a></H3><PRE>
|
|
<STRONG>captoinfo</STRONG> translates some obsolete, nonstandard capabilities into
|
|
standard <EM>terminfo</EM> capabilities. It issues a diagnostic to the standard
|
|
error stream for each, inviting the user to check that it has not
|
|
mistakenly translated an unknown or mistyped capability name.
|
|
|
|
<STRONG><EM>termcap</EM></STRONG> <STRONG>Code</STRONG>
|
|
<STRONG>Obsolete</STRONG> <STRONG>Standard</STRONG> <STRONG>Origin</STRONG> <STRONG><EM>terminfo</EM></STRONG> <STRONG>capability</STRONG>
|
|
---------------------------------------------------------
|
|
<STRONG>BO</STRONG> <STRONG>mr</STRONG> AT&T <STRONG>enter_reverse_mode</STRONG>
|
|
<STRONG>CI</STRONG> <STRONG>vi</STRONG> AT&T <STRONG>cursor_invisible</STRONG>
|
|
<STRONG>CV</STRONG> <STRONG>ve</STRONG> AT&T <STRONG>cursor_normal</STRONG>
|
|
<STRONG>DS</STRONG> <STRONG>mh</STRONG> AT&T <STRONG>enter_dim_mode</STRONG>
|
|
<STRONG>EE</STRONG> <STRONG>me</STRONG> AT&T <STRONG>exit_attribute_mode</STRONG>
|
|
<STRONG>FE</STRONG> <STRONG>LF</STRONG> AT&T <STRONG>label_on</STRONG>
|
|
<STRONG>FL</STRONG> <STRONG>LO</STRONG> AT&T <STRONG>label_off</STRONG>
|
|
<STRONG>XS</STRONG> <STRONG>mk</STRONG> AT&T <STRONG>enter_secure_mode</STRONG>
|
|
<STRONG>EN</STRONG> <STRONG>@7</STRONG> XENIX <STRONG>key_end</STRONG>
|
|
<STRONG>GE</STRONG> <STRONG>ae</STRONG> XENIX <STRONG>exit_alt_charset_mode</STRONG>
|
|
<STRONG>GS</STRONG> <STRONG>as</STRONG> XENIX <STRONG>enter_alt_charset_mode</STRONG>
|
|
<STRONG>HM</STRONG> <STRONG>kh</STRONG> XENIX <STRONG>key_home</STRONG>
|
|
<STRONG>LD</STRONG> <STRONG>kL</STRONG> XENIX <STRONG>key_dl</STRONG>
|
|
<STRONG>PD</STRONG> <STRONG>kN</STRONG> XENIX <STRONG>key_npage</STRONG>
|
|
<STRONG>PN</STRONG> <STRONG>po</STRONG> XENIX <STRONG>prtr_off</STRONG>
|
|
<STRONG>PS</STRONG> <STRONG>pf</STRONG> XENIX <STRONG>prtr_on</STRONG>
|
|
<STRONG>PU</STRONG> <STRONG>kP</STRONG> XENIX <STRONG>key_ppage</STRONG>
|
|
<STRONG>RT</STRONG> <STRONG>@8</STRONG> XENIX <STRONG>kent</STRONG>
|
|
<STRONG>UP</STRONG> <STRONG>ku</STRONG> XENIX <STRONG>kcuu1</STRONG>
|
|
<STRONG>KA</STRONG> <STRONG>k;</STRONG> Tektronix <STRONG>key_f10</STRONG>
|
|
<STRONG>KB</STRONG> <STRONG>F1</STRONG> Tektronix <STRONG>key_f11</STRONG>
|
|
<STRONG>KC</STRONG> <STRONG>F2</STRONG> Tektronix <STRONG>key_f12</STRONG>
|
|
<STRONG>KD</STRONG> <STRONG>F3</STRONG> Tektronix <STRONG>key_f13</STRONG>
|
|
<STRONG>KE</STRONG> <STRONG>F4</STRONG> Tektronix <STRONG>key_f14</STRONG>
|
|
<STRONG>KF</STRONG> <STRONG>F5</STRONG> Tektronix <STRONG>key_f15</STRONG>
|
|
<STRONG>BC</STRONG> <STRONG>Sb</STRONG> Tektronix <STRONG>set_background</STRONG>
|
|
<STRONG>FC</STRONG> <STRONG>Sf</STRONG> Tektronix <STRONG>set_foreground</STRONG>
|
|
<STRONG>HS</STRONG> <STRONG>mh</STRONG> IRIX <STRONG>enter_dim_mode</STRONG>
|
|
|
|
XENIX <EM>termcap</EM> had a set of extension capabilities, corresponding to box
|
|
drawing characters of CCSID ("code page") 437, as follows.
|
|
|
|
<STRONG><EM>termcap</EM></STRONG> <STRONG>Code</STRONG> <STRONG>Graphic</STRONG>
|
|
-----------------------------------------
|
|
<STRONG>G2</STRONG> upper left corner
|
|
<STRONG>G3</STRONG> lower left corner
|
|
<STRONG>G1</STRONG> upper right corner
|
|
<STRONG>G4</STRONG> lower right corner
|
|
<STRONG>GR</STRONG> tee pointing right
|
|
<STRONG>GL</STRONG> tee pointing left
|
|
<STRONG>GU</STRONG> tee pointing up
|
|
<STRONG>GD</STRONG> tee pointing down
|
|
<STRONG>GH</STRONG> horizontal line
|
|
<STRONG>GV</STRONG> vertical line
|
|
<STRONG>GC</STRONG> intersection
|
|
<STRONG>G6</STRONG> double upper left corner
|
|
<STRONG>G7</STRONG> double lower left corner
|
|
<STRONG>G5</STRONG> double upper right corner
|
|
<STRONG>G8</STRONG> double lower right corner
|
|
<STRONG>Gr</STRONG> double tee pointing right
|
|
<STRONG>Gr</STRONG> double tee pointing left
|
|
<STRONG>Gu</STRONG> double tee pointing up
|
|
<STRONG>Gd</STRONG> double tee pointing down
|
|
<STRONG>Gh</STRONG> double horizontal line
|
|
<STRONG>Gv</STRONG> double vertical line
|
|
<STRONG>Gc</STRONG> double intersection
|
|
<STRONG>GG</STRONG> ACS magic cookie count
|
|
|
|
<STRONG>captoinfo</STRONG> composes single-line box-drawing capabilities into a <EM>terminfo</EM>
|
|
<STRONG>acs_chars</STRONG> (<STRONG>acsc</STRONG>) string capability, and discards <STRONG>GG</STRONG> and double-line
|
|
capabilities with a warning diagnostic.
|
|
|
|
AIX has a <EM>terminfo</EM> facility descended from SVr2 <EM>terminfo</EM>, but which is
|
|
incompatible with the SVr4 format. <STRONG>captoinfo</STRONG> translates the following
|
|
AIX extensions.
|
|
|
|
<STRONG>IBM</STRONG> <STRONG>X/Open</STRONG>
|
|
---------------
|
|
ksel kslt
|
|
kbtab kcbt
|
|
font0 s0ds
|
|
font1 s1ds
|
|
font2 s2ds
|
|
font3 s3ds
|
|
|
|
It furthermore translates the AIX <STRONG>box1</STRONG> capability to an <STRONG>acs_chars</STRONG>
|
|
(<STRONG>acsc</STRONG>) string capability.
|
|
|
|
The HP-UX <EM>terminfo</EM> library supports two nonstandard <EM>terminfo</EM>
|
|
capabilities: <STRONG>memory_lock</STRONG> (<STRONG>meml</STRONG>) and <STRONG>memory_unlock</STRONG> (<STRONG>memu</STRONG>). <STRONG>captoinfo</STRONG>
|
|
discards these with a warning message.
|
|
|
|
|
|
</PRE><H2><a name="h2-FILES">FILES</a></H2><PRE>
|
|
<EM>/etc/termcap</EM>
|
|
default <EM>termcap</EM> terminal capability database
|
|
|
|
|
|
</PRE><H2><a name="h2-EXTENSIONS">EXTENSIONS</a></H2><PRE>
|
|
This command is an SVr4 <EM>curses</EM> and <EM>ncurses</EM> extension.
|
|
|
|
|
|
</PRE><H2><a name="h2-PORTABILITY">PORTABILITY</a></H2><PRE>
|
|
X/Open Curses Issue 7 (2009) does not specify this command.
|
|
|
|
SVr4 systems provide <EM>captoinfo</EM> as a separate application from <EM>tic</EM>. Its
|
|
<STRONG>-v</STRONG> option does not accept a trace level argument <EM>n</EM>; repeat <STRONG>-v</STRONG> <EM>n</EM> times
|
|
instead.
|
|
|
|
NetBSD does not provide this application.
|
|
|
|
|
|
</PRE><H2><a name="h2-AUTHORS">AUTHORS</a></H2><PRE>
|
|
Eric S. Raymond <esr@snark.thyrsus.com> and
|
|
Thomas E. Dickey <dickey@invisible-island.net>
|
|
|
|
|
|
</PRE><H2><a name="h2-SEE-ALSO">SEE ALSO</a></H2><PRE>
|
|
<STRONG><A HREF="infocmp.1m.html">infocmp(1m)</A></STRONG>, <STRONG><A HREF="tic.1m.html">tic(1m)</A></STRONG>, <STRONG><A HREF="ncurses.3x.html">curses(3x)</A></STRONG>, <STRONG><A HREF="terminfo.5.html">terminfo(5)</A></STRONG>
|
|
|
|
ncurses 6.6 2025-11-11 <STRONG><A HREF="captoinfo.1m.html">captoinfo(1m)</A></STRONG>
|
|
</PRE>
|
|
<div class="nav">
|
|
<ul>
|
|
<li><a href="#h2-NAME">NAME</a></li>
|
|
<li><a href="#h2-SYNOPSIS">SYNOPSIS</a></li>
|
|
<li><a href="#h2-DESCRIPTION">DESCRIPTION</a>
|
|
<ul>
|
|
<li><a href="#h3-Translations-from-Nonstandard-Capabilities">Translations from Nonstandard Capabilities</a></li>
|
|
</ul>
|
|
</li>
|
|
<li><a href="#h2-FILES">FILES</a></li>
|
|
<li><a href="#h2-EXTENSIONS">EXTENSIONS</a></li>
|
|
<li><a href="#h2-PORTABILITY">PORTABILITY</a></li>
|
|
<li><a href="#h2-AUTHORS">AUTHORS</a></li>
|
|
<li><a href="#h2-SEE-ALSO">SEE ALSO</a></li>
|
|
</ul>
|
|
</div>
|
|
</BODY>
|
|
</HTML>
|