Gitiles
Code Review Sign In
gerrit.omnirom.org / android_external_libncurses / b2cef93693cf7cfd01098c9b69603c90f0f4b803 / . / doc / html / man / captoinfo.1m.html
blob: c0cdbf9c32d9fb0f255f8474dd283460495d09d7 [file] [log] [blame]
Amit Daniel Kachhape6a01f52011-07-20 11:45:59 +0530[diff] [blame]1<!--
2 * t
3 ****************************************************************************
Steve Kondikae271bc2015-11-15 02:50:53 +0100[diff] [blame]4 * Copyright (c) 1998-2007,2010 Free Software Foundation, Inc. *
Amit Daniel Kachhape6a01f52011-07-20 11:45:59 +0530[diff] [blame]5 * *
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: *
13 * *
14 * The above copyright notice and this permission notice shall be included *
15 * in all copies or substantial portions of the Software. *
16 * *
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. *
24 * *
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 *
28 * authorization. *
29 ****************************************************************************
Steve Kondikae271bc2015-11-15 02:50:53 +0100[diff] [blame]30 * @Id: captoinfo.1m,v 1.25 2010/12/04 18:36:44 tom Exp @
Amit Daniel Kachhape6a01f52011-07-20 11:45:59 +0530[diff] [blame]31-->
Steve Kondikae271bc2015-11-15 02:50:53 +0100[diff] [blame]32<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN">
Amit Daniel Kachhape6a01f52011-07-20 11:45:59 +0530[diff] [blame]33<HTML>
34<HEAD>
Steve Kondikae271bc2015-11-15 02:50:53 +0100[diff] [blame]35<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
36<meta name="generator" content="Manpage converted by man2html - see http://invisible-island.net/scripts/readme.html#others_scripts">
Amit Daniel Kachhape6a01f52011-07-20 11:45:59 +0530[diff] [blame]37<TITLE>captoinfo 1m</TITLE>
38<link rev=made href="mailto:bug-ncurses@gnu.org">
39<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
40</HEAD>
41<BODY>
Steve Kondikae271bc2015-11-15 02:50:53 +0100[diff] [blame]42<H1 class="no-header">captoinfo 1m</H1>
Amit Daniel Kachhape6a01f52011-07-20 11:45:59 +0530[diff] [blame]43<PRE>
Amit Daniel Kachhape6a01f52011-07-20 11:45:59 +0530[diff] [blame]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>
Steve Kondikae271bc2015-11-15 02:50:53 +0100[diff] [blame]50<H2><a name="h2-NAME">NAME</a></H2><PRE>
Amit Daniel Kachhape6a01f52011-07-20 11:45:59 +0530[diff] [blame]51 <STRONG>captoinfo</STRONG> - convert a <EM>termcap</EM> description into a <EM>terminfo</EM>
52 description
53
54
55</PRE>
Steve Kondikae271bc2015-11-15 02:50:53 +0100[diff] [blame]56<H2><a name="h2-SYNOPSIS">SYNOPSIS</a></H2><PRE>
Amit Daniel Kachhape6a01f52011-07-20 11:45:59 +0530[diff] [blame]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>
Steve Kondikae271bc2015-11-15 02:50:53 +0100[diff] [blame]61<H2><a name="h2-DESCRIPTION">DESCRIPTION</a></H2><PRE>
62 <STRONG>captoinfo</STRONG> looks in each given text <EM>file</EM> for <STRONG>termcap</STRONG>
63 descriptions. For each one found, an equivalent <STRONG>terminfo</STRONG>
64 description is written to standard output. Termcap <STRONG>tc</STRONG>
65 capabilities are translated directly to terminfo <STRONG>use</STRONG> capa-
66 bilities.
Amit Daniel Kachhape6a01f52011-07-20 11:45:59 +0530[diff] [blame]67
68 If no <EM>file</EM> is given, then the environment variable <STRONG>TERMCAP</STRONG>
Steve Kondikae271bc2015-11-15 02:50:53 +0100[diff] [blame]69 is used for the filename or entry. If <STRONG>TERMCAP</STRONG> is a full
Amit Daniel Kachhape6a01f52011-07-20 11:45:59 +0530[diff] [blame]70 pathname to a file, only the terminal whose name is speci-
Steve Kondikae271bc2015-11-15 02:50:53 +0100[diff] [blame]71 fied in the environment variable <STRONG>TERM</STRONG> is extracted from
72 that file. If the environment variable <STRONG>TERMCAP</STRONG> is not
Amit Daniel Kachhape6a01f52011-07-20 11:45:59 +0530[diff] [blame]73 set, then the file <STRONG>/usr/share/terminfo</STRONG> is read.
74
Steve Kondikae271bc2015-11-15 02:50:53 +0100[diff] [blame]75 <STRONG>-v</STRONG> print out tracing information on standard error as
Amit Daniel Kachhape6a01f52011-07-20 11:45:59 +0530[diff] [blame]76 the program runs.
77
Steve Kondikae271bc2015-11-15 02:50:53 +0100[diff] [blame]78 <STRONG>-V</STRONG> print out the version of the program in use on stan-
Amit Daniel Kachhape6a01f52011-07-20 11:45:59 +0530[diff] [blame]79 dard error and exit.
80
Steve Kondikae271bc2015-11-15 02:50:53 +0100[diff] [blame]81 <STRONG>-1</STRONG> cause the fields to print out one to a line. Other-
Amit Daniel Kachhape6a01f52011-07-20 11:45:59 +0530[diff] [blame]82 wise, the fields will be printed several to a line to
83 a maximum width of 60 characters.
84
85 <STRONG>-w</STRONG> change the output to <EM>width</EM> characters.
86
87
88</PRE>
Steve Kondikae271bc2015-11-15 02:50:53 +0100[diff] [blame]89<H2><a name="h2-FILES">FILES</a></H2><PRE>
90 /usr/share/terminfo Compiled terminal description data-
91 base.
Amit Daniel Kachhape6a01f52011-07-20 11:45:59 +0530[diff] [blame]92
93
94</PRE>
Steve Kondikae271bc2015-11-15 02:50:53 +0100[diff] [blame]95<H2><a name="h2-TRANSLATIONS-FROM-NONSTANDARD-CAPABILITIES">TRANSLATIONS FROM NONSTANDARD CAPABILITIES</a></H2><PRE>
96 Some obsolete nonstandard capabilities will automatically
97 be translated into standard (SVr4/XSI Curses) terminfo
98 capabilities by <STRONG>captoinfo</STRONG>. Whenever one of these auto-
99 matic translations is done, the program will issue an
Amit Daniel Kachhape6a01f52011-07-20 11:45:59 +0530[diff] [blame]100 notification to stderr, inviting the user to check that it
Steve Kondikae271bc2015-11-15 02:50:53 +0100[diff] [blame]101 has not mistakenly translated a completely unknown and
Amit Daniel Kachhape6a01f52011-07-20 11:45:59 +0530[diff] [blame]102 random capability and/or syntax error.
103
Amit Daniel Kachhape6a01f52011-07-20 11:45:59 +0530[diff] [blame]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
Steve Kondikae271bc2015-11-15 02:50:53 +0100[diff] [blame]137 XENIX termcap also used to have a set of extension capa-
138 bilities for forms drawing, designed to take advantage of
Amit Daniel Kachhape6a01f52011-07-20 11:45:59 +0530[diff] [blame]139 the IBM PC high-half graphics. They were as follows:
140
Amit Daniel Kachhape6a01f52011-07-20 11:45:59 +0530[diff] [blame]141 Cap Graphic
142 -----------------------------
143 G2 upper left
144 G3 lower left
145 G1 upper right
146 G4 lower right
147 GR pointing right
148 GL pointing left
149 GU pointing up
150 GD pointing down
151 GH horizontal line
152 GV vertical line
153 GC intersection
154 G6 upper left
155 G7 lower left
156 G5 upper right
157 G8 lower right
158 Gr tee pointing right
159 Gr tee pointing left
160 Gu tee pointing up
161 Gd tee pointing down
162 Gh horizontal line
163 Gv vertical line
164 Gc intersection
165 GG acs magic cookie count
166
Steve Kondikae271bc2015-11-15 02:50:53 +0100[diff] [blame]167 If the single-line capabilities occur in an entry, they
168 will automatically be composed into an <EM>acsc</EM> string. The
Amit Daniel Kachhape6a01f52011-07-20 11:45:59 +0530[diff] [blame]169 double-line capabilities and <STRONG>GG</STRONG> are discarded with a warn-
170 ing message.
171
172 IBM's AIX has a terminfo facility descended from SVr1 ter-
Steve Kondikae271bc2015-11-15 02:50:53 +0100[diff] [blame]173 minfo but incompatible with the SVr4 format. The follow-
174 ing AIX extensions are automatically translated:
Amit Daniel Kachhape6a01f52011-07-20 11:45:59 +0530[diff] [blame]175
176 IBM XSI
177 -------------
178 ksel kslt
179 kbtab kcbt
180 font0 s0ds
181 font1 s1ds
182 font2 s2ds
183 font3 s3ds
184
Steve Kondikae271bc2015-11-15 02:50:53 +0100[diff] [blame]185 Additionally, the AIX <EM>box1</EM> capability will be automati-
Amit Daniel Kachhape6a01f52011-07-20 11:45:59 +0530[diff] [blame]186 cally translated to an <EM>acsc</EM> string.
187
Steve Kondikae271bc2015-11-15 02:50:53 +0100[diff] [blame]188 Hewlett-Packard's terminfo library supports two nonstan-
189 dard terminfo capabilities <EM>meml</EM> (memory lock) and <EM>memu</EM>
190 (memory unlock). These will be discarded with a warning
Amit Daniel Kachhape6a01f52011-07-20 11:45:59 +0530[diff] [blame]191 message.
192
193
194</PRE>
Steve Kondikae271bc2015-11-15 02:50:53 +0100[diff] [blame]195<H2><a name="h2-NOTES">NOTES</a></H2><PRE>
196 This utility is actually a link to <STRONG><A HREF="tic.1m.html">tic(1m)</A></STRONG>, running in <EM>-I</EM>
Amit Daniel Kachhape6a01f52011-07-20 11:45:59 +0530[diff] [blame]197 mode. You can use other <STRONG>tic</STRONG> options such as <STRONG>-f</STRONG> and <STRONG>-x</STRONG>.
198
Steve Kondikae271bc2015-11-15 02:50:53 +0100[diff] [blame]199 The trace option is not identical to SVr4's. Under SVr4,
200 instead of following the <STRONG>-v</STRONG> with a trace level n, you
Amit Daniel Kachhape6a01f52011-07-20 11:45:59 +0530[diff] [blame]201 repeat it n times.
202
203
204</PRE>
Steve Kondikae271bc2015-11-15 02:50:53 +0100[diff] [blame]205<H2><a name="h2-SEE-ALSO">SEE ALSO</a></H2><PRE>
Amit Daniel Kachhape6a01f52011-07-20 11:45:59 +0530[diff] [blame]206 <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>
207
Steve Kondikae271bc2015-11-15 02:50:53 +0100[diff] [blame]208 This describes <STRONG>ncurses</STRONG> version 6.0 (patch 20150808).
Amit Daniel Kachhape6a01f52011-07-20 11:45:59 +0530[diff] [blame]209
210
211</PRE>
Steve Kondikae271bc2015-11-15 02:50:53 +0100[diff] [blame]212<H2><a name="h2-AUTHOR">AUTHOR</a></H2><PRE>
213 Eric S. Raymond &lt;esr@snark.thyrsus.com&gt; and
214 Thomas E. Dickey &lt;dickey@invisible-island.net&gt;
Amit Daniel Kachhape6a01f52011-07-20 11:45:59 +0530[diff] [blame]215
216
217
218 <STRONG><A HREF="captoinfo.1m.html">captoinfo(1m)</A></STRONG>
219</PRE>
Steve Kondikae271bc2015-11-15 02:50:53 +0100[diff] [blame]220<div class="nav">
221<ul>
222<li><a href="#h2-NAME">NAME</a></li>
223<li><a href="#h2-SYNOPSIS">SYNOPSIS</a></li>
224<li><a href="#h2-DESCRIPTION">DESCRIPTION</a></li>
225<li><a href="#h2-FILES">FILES</a></li>
226<li><a href="#h2-TRANSLATIONS-FROM-NONSTANDARD-CAPABILITIES">TRANSLATIONS FROM NONSTANDARD CAPABILITIES</a></li>
227<li><a href="#h2-NOTES">NOTES</a></li>
228<li><a href="#h2-SEE-ALSO">SEE ALSO</a></li>
229<li><a href="#h2-AUTHOR">AUTHOR</a></li>
230</ul>
231</div>
Amit Daniel Kachhape6a01f52011-07-20 11:45:59 +0530[diff] [blame]232</BODY>
233</HTML>