Gitiles
Code Review Sign In
gerrit.omnirom.org / android_external_libncurses / c1bcd6dd9af6865867a3d6716e4c1a45021a90e5 / . / doc / html / man / captoinfo.1m.html
blob: 91b3150dcad464f643971159a874b2ca1904ce1a [file] [log] [blame]
Amit Daniel Kachhape6a01f52011-07-20 11:45:59 +0530[diff] [blame]1<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 2.0//EN">
2<!--
3 * t
4 ****************************************************************************
5 * Copyright (c) 1998-2006,2007 Free Software Foundation, Inc. *
6 * *
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: *
14 * *
15 * The above copyright notice and this permission notice shall be included *
16 * in all copies or substantial portions of the Software. *
17 * *
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. *
25 * *
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 *
29 * authorization. *
30 ****************************************************************************
31 * @Id: captoinfo.1m,v 1.22 2007/06/02 20:40:07 tom Exp @
32-->
33<HTML>
34<HEAD>
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">
38</HEAD>
39<BODY>
40<H1>captoinfo 1m</H1>
41<HR>
42<PRE>
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>
45
46
47
48
49</PRE>
50<H2>NAME</H2><PRE>
51 <STRONG>captoinfo</STRONG> - convert a <EM>termcap</EM> description into a <EM>terminfo</EM>
52 description
53
54
55</PRE>
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> . . .
58
59
60</PRE>
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.
66
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.
73
74 <STRONG>-v</STRONG> print out tracing information on standard error as
75 the program runs.
76
77 <STRONG>-V</STRONG> print out the version of the program in use on stan-
78 dard error and exit.
79
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.
83
84 <STRONG>-w</STRONG> change the output to <EM>width</EM> characters.
85
86
87</PRE>
88<H2>FILES</H2><PRE>
89 /usr/share/terminfo Compiled terminal description
90 database.
91
92
93</PRE>
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.
102
103
104 Nonstd Std From Terminfo
105 name name capability
106 -----------------------------------------------
107 BO mr AT&amp;T enter_reverse_mode
108 CI vi AT&amp;T cursor_invisible
109 CV ve AT&amp;T cursor_normal
110 DS mh AT&amp;T enter_dim_mode
111 EE me AT&amp;T exit_attribute_mode
112 FE LF AT&amp;T label_on
113 FL LO AT&amp;T label_off
114 XS mk AT&amp;T enter_secure_mode
115 EN @7 XENIX key_end
116 GE ae XENIX exit_alt_charset_mode
117 GS as XENIX enter_alt_charset_mode
118 HM kh XENIX key_home
119
120 LD kL XENIX key_dl
121 PD kN XENIX key_npage
122 PN po XENIX prtr_off
123 PS pf XENIX prtr_on
124 PU kP XENIX key_ppage
125 RT @8 XENIX kent
126 UP ku XENIX kcuu1
127 KA k; Tek key_f10
128 KB F1 Tek key_f11
129 KC F2 Tek key_f12
130 KD F3 Tek key_f13
131 KE F4 Tek key_f14
132 KF F5 Tek key_f15
133 BC Sb Tek set_background
134 FC Sf Tek set_foreground
135 HS mh Iris enter_dim_mode
136
137 XENIX termcap also used to have a set of extension capa-
138 bilities for forms drawing, designed to take advantage of
139 the IBM PC high-half graphics. They were as follows:
140
141
142 Cap Graphic
143 -----------------------------
144 G2 upper left
145 G3 lower left
146 G1 upper right
147 G4 lower right
148 GR pointing right
149 GL pointing left
150 GU pointing up
151 GD pointing down
152 GH horizontal line
153 GV vertical line
154 GC intersection
155 G6 upper left
156 G7 lower left
157 G5 upper right
158 G8 lower right
159 Gr tee pointing right
160 Gr tee pointing left
161 Gu tee pointing up
162 Gd tee pointing down
163 Gh horizontal line
164 Gv vertical line
165 Gc intersection
166 GG acs magic cookie count
167
168 If the single-line capabilities occur in an entry, they
169 will automatically be composed into an <EM>acsc</EM> string. The
170 double-line capabilities and <STRONG>GG</STRONG> are discarded with a warn-
171 ing message.
172
173 IBM's AIX has a terminfo facility descended from SVr1 ter-
174 minfo but incompatible with the SVr4 format. The following
175 AIX extensions are automatically translated:
176
177 IBM XSI
178 -------------
179 ksel kslt
180 kbtab kcbt
181 font0 s0ds
182 font1 s1ds
183 font2 s2ds
184 font3 s3ds
185
186 Additionally, the AIX <EM>box1</EM> capability will be automati-
187 cally translated to an <EM>acsc</EM> string.
188
189 Hewlett-Packard's terminfo library supports two nonstan-
190 dard terminfo capabilities <EM>meml</EM> (memory lock) and <EM>memu</EM>
191 (memory unlock). These will be discarded with a warning
192 message.
193
194
195</PRE>
196<H2>NOTES</H2><PRE>
197 This utility is actually a link to <STRONG><A HREF="tic.1m.html">tic(1m)</A></STRONG>, running in <EM>-I</EM>
198 mode. You can use other <STRONG>tic</STRONG> options such as <STRONG>-f</STRONG> and <STRONG>-x</STRONG>.
199
200 The trace option is not identical to SVr4's. Under SVr4,
201 instead of following the <STRONG>-v</STRONG> with a trace level n, you
202 repeat it n times.
203
204
205</PRE>
206<H2>SEE ALSO</H2><PRE>
207 <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>
208
209 This describes <STRONG>ncurses</STRONG> version 5.6 (patch 20081011).
210
211
212</PRE>
213<H2>AUTHOR</H2><PRE>
214 Eric S. Raymond &lt;esr@snark.thyrsus.com&gt;
215
216
217
218 <STRONG><A HREF="captoinfo.1m.html">captoinfo(1m)</A></STRONG>
219</PRE>
220<HR>
221<ADDRESS>
222Man(1) output converted with
223<a href="http://www.oac.uci.edu/indiv/ehood/man2html.html">man2html</a>
224</ADDRESS>
225</BODY>
226</HTML>