Annotation of src/usr.bin/tic/captoinfo.1tbl, Revision 1.1
1.1 ! millert 1: .\" $OpenBSD$
! 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
! 182: \fBcurses\fR(3), \fBinfocmp\fR(1), \fBterminfo\fR(\*n)
! 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: