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