Annotation of src/usr.bin/tic/captoinfo.1tbl, Revision 1.7
1.3 millert 1: '\" t
1.7 ! millert 2: .\" $OpenBSD: captoinfo.1tbl,v 1.6 2000/07/24 04:06:12 millert Exp $
1.1 millert 3: .\"
4: .\"***************************************************************************
1.5 millert 5: .\" Copyright (c) 1998,2000 Free Software Foundation, Inc. *
1.1 millert 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: .\"
1.7 ! millert 32: .\" $From: From: captoinfo.1m,v 1.16 2000/08/13 01:56:49 tom Exp $
1.1 millert 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
1.4 millert 39: \fBcaptoinfo\fR [\fB-v\fR\fIn\fR \fIwidth\fR] [\fB-V\fR] [\fB-1\fR] [\fB-w\fR \fIwidth\fR] \fIfile\fR . . .
1.1 millert 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
1.4 millert 52: \fB-v\fR
1.1 millert 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
1.4 millert 89: EE me AT&T exit_attribute_mode
1.1 millert 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
1.4 millert 173: Hewlett-Packard's terminfo library supports two nonstandard terminfo
1.1 millert 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.
1.5 millert 178: You can use other \fItic\fR options such as \fB-f\fR and \fB-x\fR.
1.1 millert 179:
180: The trace option isn't identical to SVr4's. Under SVr4, instead of following
181: the -v with a trace level n, you repeat it n times.
182: .SH SEE ALSO
1.2 millert 183: \fBcurses\fR(3), \fBtic\fR(1), \fBterminfo\fR(\*n)
1.1 millert 184: .SH AUTHOR
185: Eric S. Raymond <esr@snark.thyrsus.com>
186: .\"#
187: .\"# The following sets edit modes for GNU EMACS
188: .\"# Local Variables:
189: .\"# mode:nroff
190: .\"# fill-column:79
191: .\"# End: