Annotation of src/usr.bin/tic/captoinfo.1tbl, Revision 1.2
1.2 ! millert 1: .\" $OpenBSD: captoinfo.1tbl,v 1.1 1998/07/24 19:37:34 millert Exp $
1.1 millert 2: .\"
3: .\"***************************************************************************
4: .\" Copyright (c) 1998 Free Software Foundation, Inc. *
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: .\"***************************************************************************
30: .\"
31: .\" $From: captoinfo.1m,v 1.10 1998/03/11 21:12:53 juergen Exp $
32: '\" t
33: .TH captoinfo 1 ""
34: .ds n 5
35: .ds d /usr/share/terminfo
36: .SH NAME
37: \fBcaptoinfo\fR - convert a \fItermcap\fR description into a \fIterminfo\fR description
38: .SH SYNOPSIS
39: \fBcaptoinfo\fR [\fB-v\fIn\fR \fIwidth\fR] [\fB-V\fR] [\fB-1\fR] [\fB-w\fR \fIwidth\fR] \fIfile\fR . . .
40: .SH DESCRIPTION
41: \fBcaptoinfo\fR looks in \fIfile\fR for \fBtermcap\fR descriptions. For each
42: one found, an equivalent \fBterminfo\fR description is written to standard
43: output. Termcap \fBtc\fR capabilities are translated directly to terminfo
44: \fBuse\fR capabilities.
45:
46: If no \fIfile\fR is given, then the environment variable \fBTERMCAP\fR is used
47: for the filename or entry. If \fBTERMCAP\fR is a full pathname to a file, only
48: the terminal whose name is specified in the environment variable \fBTERM\fR is
49: extracted from that file. If the environment variable \fBTERMCAP\fR is not
50: set, then the file \fB\*d\fR is read.
51: .TP 5
52: \fB-v\fR
53: print out tracing information on standard error as the program runs.
54: .TP 5
55: \fB-V\fR
56: print out the version of the program in use on standard error and exit.
57: .TP 5
58: \fB-1\fR
59: cause the fields to print out one to a line. Otherwise, the fields
60: will be printed several to a line to a maximum width of 60
61: characters.
62: .TP 5
63: \fB-w\fR
64: change the output to \fIwidth\fR characters.
65: .SH FILES
66: .TP 20
67: \*d
68: Compiled terminal description database.
69: .SH TRANSLATIONS FROM NONSTANDARD CAPABILITIES
70: .PP
71: Some obsolete nonstandard capabilities will automatically be translated
72: into standard (SVr4/XSI Curses) terminfo capabilities by \fBcaptoinfo\fR.
73: Whenever one of these automatic translations is done, the program
74: will issue an notification to stderr, inviting the user to check that
75: it has not mistakenly translated a completely unknown and random
76: capability and/or syntax error.
77: .PP
78: .TS H
79: c c c c
80: c c c c
81: l l l l.
82: Nonstd Std From Terminfo
83: name name capability
84: _
85: BO mr AT&T enter_reverse_mode
86: CI vi AT&T cursor_invisible
87: CV ve AT&T cursor_normal
88: DS mh AT&T enter_dim_mode
89: EE me AT&T exit_attribute_mode
90: FE LF AT&T label_on
91: FL LO AT&T label_off
92: XS mk AT&T enter_secure_mode
93: EN @7 XENIX key_end
94: GE ae XENIX exit_alt_charset_mode
95: GS as XENIX enter_alt_charset_mode
96: HM kh XENIX key_home
97: LD kL XENIX key_dl
98: PD kN XENIX key_npage
99: PN po XENIX prtr_off
100: PS pf XENIX prtr_on
101: PU kP XENIX key_ppage
102: RT @8 XENIX kent
103: UP ku XENIX kcuu1
104: KA k; Tek key_f10
105: KB F1 Tek key_f11
106: KC F2 Tek key_f12
107: KD F3 Tek key_f13
108: KE F4 Tek key_f14
109: KF F5 Tek key_f15
110: BC Sb Tek set_background
111: FC Sf Tek set_foreground
112: HS mh Iris enter_dim_mode
113: .TE
114: .PP
115: XENIX termcap also used to have a set of extension capabilities
116: for forms drawing, designed to take advantage of the IBM PC
117: high-half graphics. They were as follows:
118: .PP
119: .TS H
120: c c
121: l l.
122: Cap Graphic
123: _
124: G2 upper left
125: G3 lower left
126: G1 upper right
127: G4 lower right
128: GR pointing right
129: GL pointing left
130: GU pointing up
131: GD pointing down
132: GH horizontal line
133: GV vertical line
134: GC intersection
135: G6 upper left
136: G7 lower left
137: G5 upper right
138: G8 lower right
139: Gr tee pointing right
140: Gr tee pointing left
141: Gu tee pointing up
142: Gd tee pointing down
143: Gh horizontal line
144: Gv vertical line
145: Gc intersection
146: GG acs magic cookie count
147: .TE
148: .PP
149: If the single-line capabilities occur in an entry, they will automatically
150: be composed into an \fBacsc\fR string. The double-line capabilities and
151: \fBGG\fR are discarded with a warning message.
152: .PP
153: IBM's AIX has a terminfo facility descended from SVr1 terminfo but incompatible
154: with the SVr4 format. The following AIX extensions are automatically
155: translated:
156: .PP
157: .TS
158: c c
159: l l.
160: IBM XSI
161: _
162: ksel kslt
163: kbtab kcbt
164: font0 s0ds
165: font1 s1ds
166: font2 s2ds
167: font3 s3ds
168: .TE
169: .PP
170: Additionally, the AIX \fBbox1\fR capability will be automatically translated to
171: an \fBacsc\fR string.
172: .PP
173: Hewlett-Packard's terminfo library supports two nonstandard terminfo
174: capabilities \fBmeml\fR (memory lock) and \fBmemu\fR (memory unlock).
175: These will be discarded with a warning message.
176: .SH NOTES
177: This utility is actually a link to \fItic\fR(1), running in \fI-I\fR mode.
178:
179: The trace option isn't identical to SVr4's. Under SVr4, instead of following
180: the -v with a trace level n, you repeat it n times.
181: .SH SEE ALSO
1.2 ! millert 182: \fBcurses\fR(3), \fBtic\fR(1), \fBterminfo\fR(\*n)
1.1 millert 183: .SH AUTHOR
184: Eric S. Raymond <esr@snark.thyrsus.com>
185: .\"#
186: .\"# The following sets edit modes for GNU EMACS
187: .\"# Local Variables:
188: .\"# mode:nroff
189: .\"# fill-column:79
190: .\"# End: