1 <!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 2.0//EN">
4 ****************************************************************************
5 * Copyright (c) 1998-2000,2003 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.17 2003/05/11 00:32:53 tom Exp @
35 <TITLE>captoinfo 1m</TITLE>
36 <link rev=made href="mailto:bug-ncurses@gnu.org">
37 <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
43 <!-- Manpage converted by man2html 3.0.1 -->
44 <STRONG><A HREF="captoinfo.1m.html">captoinfo(1m)</A></STRONG> <STRONG><A HREF="captoinfo.1m.html">captoinfo(1m)</A></STRONG>
51 <STRONG>captoinfo</STRONG> - convert a <EM>termcap</EM> description into a <EM>terminfo</EM>
56 <H2>SYNOPSIS</H2><PRE>
57 <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> . . .
61 <H2>DESCRIPTION</H2><PRE>
62 <STRONG>captoinfo</STRONG> looks in <EM>file</EM> for <STRONG>termcap</STRONG> descriptions. For
63 each one found, an equivalent <STRONG>terminfo</STRONG> description is
64 written to standard output. Termcap <STRONG>tc</STRONG> capabilities are
65 translated directly to terminfo <STRONG>use</STRONG> capabilities.
67 If no <EM>file</EM> is given, then the environment variable <STRONG>TERMCAP</STRONG>
68 is used for the filename or entry. If <STRONG>TERMCAP</STRONG> is a full
69 pathname to a file, only the terminal whose name is speci-
70 fied in the environment variable <STRONG>TERM</STRONG> is extracted from
71 that file. If the environment variable <STRONG>TERMCAP</STRONG> is not
72 set, then the file <STRONG>/usr/share/terminfo</STRONG> is read.
74 <STRONG>-v</STRONG> print out tracing information on standard error as
77 <STRONG>-V</STRONG> print out the version of the program in use on stan-
80 <STRONG>-1</STRONG> cause the fields to print out one to a line. Other-
81 wise, the fields will be printed several to a line to
82 a maximum width of 60 characters.
84 <STRONG>-w</STRONG> change the output to <EM>width</EM> characters.
89 /usr/share/terminfo Compiled terminal description
94 <H2>TRANSLATIONS FROM NONSTANDARD CAPABILITIES</H2><PRE>
95 Some obsolete nonstandard capabilities will automatically
96 be translated into standard (SVr4/XSI Curses) terminfo
97 capabilities by <STRONG>captoinfo</STRONG>. Whenever one of these auto-
98 matic translations is done, the program will issue an
99 notification to stderr, inviting the user to check that it
100 has not mistakenly translated a completely unknown and
101 random capability and/or syntax error.
103 Nonstd Std From Terminfo
105 -----------------------------------------------
106 BO mr AT&T enter_reverse_mode
107 CI vi AT&T cursor_invisible
108 CV ve AT&T cursor_normal
109 DS mh AT&T enter_dim_mode
110 EE me AT&T exit_attribute_mode
111 FE LF AT&T label_on
112 FL LO AT&T label_off
113 XS mk AT&T enter_secure_mode
115 GE ae XENIX exit_alt_charset_mode
116 GS as XENIX enter_alt_charset_mode
120 PD kN XENIX key_npage
123 PU kP XENIX key_ppage
132 BC Sb Tek set_background
133 FC Sf Tek set_foreground
134 HS mh Iris enter_dim_mode
136 XENIX termcap also used to have a set of extension capa-
137 bilities for forms drawing, designed to take advantage of
138 the IBM PC high-half graphics. They were as follows:
141 -----------------------------
157 Gr tee pointing right
164 GG acs magic cookie count
166 If the single-line capabilities occur in an entry, they
167 will automatically be composed into an <STRONG>acsc</STRONG> string. The
168 double-line capabilities and <STRONG>GG</STRONG> are discarded with a warn-
171 IBM's AIX has a terminfo facility descended from SVr1 ter-
172 minfo but incompatible with the SVr4 format. The following
173 AIX extensions are automatically translated:
184 Additionally, the AIX <STRONG>box1</STRONG> capability will be automati-
185 cally translated to an <STRONG>acsc</STRONG> string.
187 Hewlett-Packard's terminfo library supports two nonstan-
188 dard terminfo capabilities <STRONG>meml</STRONG> (memory lock) and <STRONG>memu</STRONG>
189 (memory unlock). These will be discarded with a warning
195 This utility is actually a link to <STRONG><A HREF="tic.1m.html">tic(1m)</A></STRONG>, running in <EM>-I</EM>
196 mode. You can use other <EM>tic</EM> options such as <STRONG>-f</STRONG> and <STRONG>-x</STRONG>.
198 The trace option isn't identical to SVr4's. Under SVr4,
199 instead of following the <STRONG>-v</STRONG> with a trace level n, you
204 <H2>SEE ALSO</H2><PRE>
205 <STRONG><A HREF="ncurses.3x.html">curses(3x)</A></STRONG>, <STRONG><A HREF="infocmp.1m.html">infocmp(1m)</A></STRONG>, <STRONG><A HREF="terminfo.5.html">terminfo(5)</A></STRONG>
210 Eric S. Raymond <esr@snark.thyrsus.com>
214 <STRONG><A HREF="captoinfo.1m.html">captoinfo(1m)</A></STRONG>
218 Man(1) output converted with
219 <a href="http://www.oac.uci.edu/indiv/ehood/man2html.html">man2html</a>