3 ****************************************************************************
4 * Copyright 2018-2019,2020 Thomas E. Dickey *
5 * Copyright 1998-2010,2016 Free Software Foundation, Inc. *
7 * Permission is hereby granted, free of charge, to any person obtaining a *
8 * copy of this software and associated documentation files (the *
9 * "Software"), to deal in the Software without restriction, including *
10 * without limitation the rights to use, copy, modify, merge, publish, *
11 * distribute, distribute with modifications, sublicense, and/or sell *
12 * copies of the Software, and to permit persons to whom the Software is *
13 * furnished to do so, subject to the following conditions: *
15 * The above copyright notice and this permission notice shall be included *
16 * in all copies or substantial portions of the Software. *
18 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS *
19 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF *
20 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. *
21 * IN NO EVENT SHALL THE ABOVE COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, *
22 * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR *
23 * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR *
24 * THE USE OR OTHER DEALINGS IN THE SOFTWARE. *
26 * Except as contained in this notice, the name(s) of the above copyright *
27 * holders shall not be used in advertising or otherwise to promote the *
28 * sale, use or other dealings in this Software without prior written *
30 ****************************************************************************
31 * @Id: captoinfo.1m,v 1.30 2020/02/02 23:34:34 tom Exp @
33 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN">
36 <meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
37 <meta name="generator" content="Manpage converted by man2html - see https://invisible-island.net/scripts/readme.html#others_scripts">
38 <TITLE>@CAPTOINFO@ 1M</TITLE>
39 <link rel="author" href="mailto:bug-ncurses@gnu.org">
40 <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
43 <H1 class="no-header">@CAPTOINFO@ 1M</H1>
45 <B><A HREF="captoinfo.1M.html">captoinfo(1M)</A></B> <B><A HREF="captoinfo.1M.html">captoinfo(1M)</A></B>
50 </PRE><H2><a name="h2-NAME">NAME</a></H2><PRE>
51 <B>captoinfo</B> - convert a <I>termcap</I> description into a <I>terminfo</I> description
54 </PRE><H2><a name="h2-SYNOPSIS">SYNOPSIS</a></H2><PRE>
55 <B>captoinfo</B> [<B>-v</B><I>n</I> <I>width</I>] [<B>-V</B>] [<B>-1</B>] [<B>-w</B> <I>width</I>] <I>file</I> ...
58 </PRE><H2><a name="h2-DESCRIPTION">DESCRIPTION</a></H2><PRE>
59 <B>captoinfo</B> looks in each given text <I>file</I> for <B>termcap</B> descriptions. For
60 each one found, an equivalent <B>terminfo</B> description is written to
61 standard output. Termcap <B>tc</B> capabilities are translated directly to
62 terminfo <B>use</B> capabilities.
64 If no <I>file</I> is given, then the environment variable <B>TERMCAP</B> is used for
65 the filename or entry. If <B>TERMCAP</B> is a full pathname to a file, only
66 the terminal whose name is specified in the environment variable <B>TERM</B>
67 is extracted from that file. If the environment variable <B>TERMCAP</B> is
68 not set, then the file <B>/usr/share/terminfo</B> is read.
70 <B>-v</B> print out tracing information on standard error as the program
73 <B>-V</B> print out the version of the program in use on standard error and
76 <B>-1</B> cause the fields to print out one to a line. Otherwise, the
77 fields will be printed several to a line to a maximum width of 60
80 <B>-w</B> change the output to <I>width</I> characters.
83 </PRE><H2><a name="h2-FILES">FILES</a></H2><PRE>
84 /usr/share/terminfo Compiled terminal description database.
87 </PRE><H2><a name="h2-TRANSLATIONS-FROM-NONSTANDARD-CAPABILITIES">TRANSLATIONS FROM NONSTANDARD CAPABILITIES</a></H2><PRE>
88 Some obsolete nonstandard capabilities will automatically be translated
89 into standard (SVr4/XSI Curses) terminfo capabilities by <B>captoinfo</B>.
90 Whenever one of these automatic translations is done, the program will
91 issue an notification to stderr, inviting the user to check that it has
92 not mistakenly translated a completely unknown and random capability
95 Nonstd Std From Terminfo
97 -----------------------------------------------
98 BO mr AT&T enter_reverse_mode
99 CI vi AT&T cursor_invisible
100 CV ve AT&T cursor_normal
101 DS mh AT&T enter_dim_mode
102 EE me AT&T exit_attribute_mode
103 FE LF AT&T label_on
104 FL LO AT&T label_off
105 XS mk AT&T enter_secure_mode
107 GE ae XENIX exit_alt_charset_mode
108 GS as XENIX enter_alt_charset_mode
111 PD kN XENIX key_npage
114 PU kP XENIX key_ppage
124 BC Sb Tek set_background
125 FC Sf Tek set_foreground
126 HS mh Iris enter_dim_mode
128 XENIX termcap also used to have a set of extension capabilities for
129 forms drawing, designed to take advantage of the IBM PC high-half
130 graphics. They were as follows:
133 -----------------------------
149 Gr tee pointing right
156 GG acs magic cookie count
158 If the single-line capabilities occur in an entry, they will
159 automatically be composed into an <B>acsc</B> string. The double-line
160 capabilities and <B>GG</B> are discarded with a warning message.
162 IBM's AIX has a terminfo facility descended from SVr1 terminfo but
163 incompatible with the SVr4 format. The following AIX extensions are
164 automatically translated:
175 Additionally, the AIX <I>box1</I> capability will be automatically translated
176 to an <B>acsc</B> string.
178 Hewlett-Packard's terminfo library supports two nonstandard terminfo
179 capabilities <B>meml</B> (memory lock) and <B>memu</B> (memory unlock). These will
180 be discarded with a warning message.
183 </PRE><H2><a name="h2-NOTES">NOTES</a></H2><PRE>
184 This utility is actually a link to <B><A HREF="tic.1M.html">tic(1M)</A></B>, running in <I>-I</I> mode. You
185 can use other <B>tic</B> options such as <B>-f</B> and <B>-x</B>.
187 The verbose option is not identical to SVr4's. Under SVr4, instead of
188 following the <B>-v</B> with a trace level n, you repeat it n times.
191 </PRE><H2><a name="h2-PORTABILITY">PORTABILITY</a></H2><PRE>
192 X/Open Curses, Issue 7 (2009) describes <B>tic</B> briefly, but omits this
193 program. SVr4 systems provide <B>captoinfo</B> as a separate application from
196 NetBSD does not provide this application.
199 </PRE><H2><a name="h2-SEE-ALSO">SEE ALSO</a></H2><PRE>
200 <B><A HREF="infocmp.1M.html">infocmp(1M)</A></B>, <B><A HREF="curses.3X.html">curses(3X)</A></B>, <B><A HREF="terminfo.5.html">terminfo(5)</A></B>
202 This describes <B>ncurses</B> version 6.2 (patch 20210612).
205 </PRE><H2><a name="h2-AUTHOR">AUTHOR</a></H2><PRE>
206 Eric S. Raymond <esr@snark.thyrsus.com> and
207 Thomas E. Dickey <dickey@invisible-island.net>
211 <B><A HREF="captoinfo.1M.html">captoinfo(1M)</A></B>
215 <li><a href="#h2-NAME">NAME</a></li>
216 <li><a href="#h2-SYNOPSIS">SYNOPSIS</a></li>
217 <li><a href="#h2-DESCRIPTION">DESCRIPTION</a></li>
218 <li><a href="#h2-FILES">FILES</a></li>
219 <li><a href="#h2-TRANSLATIONS-FROM-NONSTANDARD-CAPABILITIES">TRANSLATIONS FROM NONSTANDARD CAPABILITIES</a></li>
220 <li><a href="#h2-NOTES">NOTES</a></li>
221 <li><a href="#h2-PORTABILITY">PORTABILITY</a></li>
222 <li><a href="#h2-SEE-ALSO">SEE ALSO</a></li>
223 <li><a href="#h2-AUTHOR">AUTHOR</a></li>