| '\" t |
| .\"*************************************************************************** |
| .\" Copyright (c) 1998-2006,2007 Free Software Foundation, Inc. * |
| .\" * |
| .\" Permission is hereby granted, free of charge, to any person obtaining a * |
| .\" copy of this software and associated documentation files (the * |
| .\" "Software"), to deal in the Software without restriction, including * |
| .\" without limitation the rights to use, copy, modify, merge, publish, * |
| .\" distribute, distribute with modifications, sublicense, and/or sell * |
| .\" copies of the Software, and to permit persons to whom the Software is * |
| .\" furnished to do so, subject to the following conditions: * |
| .\" * |
| .\" The above copyright notice and this permission notice shall be included * |
| .\" in all copies or substantial portions of the Software. * |
| .\" * |
| .\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS * |
| .\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF * |
| .\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. * |
| .\" IN NO EVENT SHALL THE ABOVE COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, * |
| .\" DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR * |
| .\" OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR * |
| .\" THE USE OR OTHER DEALINGS IN THE SOFTWARE. * |
| .\" * |
| .\" Except as contained in this notice, the name(s) of the above copyright * |
| .\" holders shall not be used in advertising or otherwise to promote the * |
| .\" sale, use or other dealings in this Software without prior written * |
| .\" authorization. * |
| .\"*************************************************************************** |
| .\" |
| .\" $Id: captoinfo.1m,v 1.22 2007/06/02 20:40:07 tom Exp $ |
| .TH @CAPTOINFO@ 1M "" |
| .ds n 5 |
| .ds d @TERMINFO@ |
| .SH NAME |
| \fB@CAPTOINFO@\fR - convert a \fItermcap\fR description into a \fIterminfo\fR description |
| .SH SYNOPSIS |
| \fB@CAPTOINFO@\fR [\fB-v\fR\fIn\fR \fIwidth\fR] [\fB-V\fR] [\fB-1\fR] [\fB-w\fR \fIwidth\fR] \fIfile\fR . . . |
| .SH DESCRIPTION |
| \fB@CAPTOINFO@\fR looks in \fIfile\fR for \fBtermcap\fR descriptions. For each |
| one found, an equivalent \fBterminfo\fR description is written to standard |
| output. Termcap \fBtc\fR capabilities are translated directly to terminfo |
| \fBuse\fR capabilities. |
| .PP |
| If no \fIfile\fR is given, then the environment variable \fBTERMCAP\fR is used |
| for the filename or entry. If \fBTERMCAP\fR is a full pathname to a file, only |
| the terminal whose name is specified in the environment variable \fBTERM\fR is |
| extracted from that file. If the environment variable \fBTERMCAP\fR is not |
| set, then the file \fB\*d\fR is read. |
| .TP 5 |
| \fB-v\fR |
| print out tracing information on standard error as the program runs. |
| .TP 5 |
| \fB-V\fR |
| print out the version of the program in use on standard error and exit. |
| .TP 5 |
| \fB-1\fR |
| cause the fields to print out one to a line. Otherwise, the fields |
| will be printed several to a line to a maximum width of 60 |
| characters. |
| .TP 5 |
| \fB-w\fR |
| change the output to \fIwidth\fR characters. |
| .SH FILES |
| .TP 20 |
| \*d |
| Compiled terminal description database. |
| .SH TRANSLATIONS FROM NONSTANDARD CAPABILITIES |
| .PP |
| Some obsolete nonstandard capabilities will automatically be translated |
| into standard (SVr4/XSI Curses) terminfo capabilities by \fB@CAPTOINFO@\fR. |
| Whenever one of these automatic translations is done, the program |
| will issue an notification to stderr, inviting the user to check that |
| it has not mistakenly translated a completely unknown and random |
| capability and/or syntax error. |
| .PP |
| .TS H |
| c c c c |
| c c c c |
| l l l l. |
| Nonstd Std From Terminfo |
| name name capability |
| _ |
| BO mr AT&T enter_reverse_mode |
| CI vi AT&T cursor_invisible |
| CV ve AT&T cursor_normal |
| DS mh AT&T enter_dim_mode |
| EE me AT&T exit_attribute_mode |
| FE LF AT&T label_on |
| FL LO AT&T label_off |
| XS mk AT&T enter_secure_mode |
| EN @7 XENIX key_end |
| GE ae XENIX exit_alt_charset_mode |
| GS as XENIX enter_alt_charset_mode |
| HM kh XENIX key_home |
| LD kL XENIX key_dl |
| PD kN XENIX key_npage |
| PN po XENIX prtr_off |
| PS pf XENIX prtr_on |
| PU kP XENIX key_ppage |
| RT @8 XENIX kent |
| UP ku XENIX kcuu1 |
| KA k; Tek key_f10 |
| KB F1 Tek key_f11 |
| KC F2 Tek key_f12 |
| KD F3 Tek key_f13 |
| KE F4 Tek key_f14 |
| KF F5 Tek key_f15 |
| BC Sb Tek set_background |
| FC Sf Tek set_foreground |
| HS mh Iris enter_dim_mode |
| .TE |
| .PP |
| XENIX termcap also used to have a set of extension capabilities |
| for forms drawing, designed to take advantage of the IBM PC |
| high-half graphics. They were as follows: |
| .PP |
| .TS H |
| c c |
| l l. |
| Cap Graphic |
| _ |
| G2 upper left |
| G3 lower left |
| G1 upper right |
| G4 lower right |
| GR pointing right |
| GL pointing left |
| GU pointing up |
| GD pointing down |
| GH horizontal line |
| GV vertical line |
| GC intersection |
| G6 upper left |
| G7 lower left |
| G5 upper right |
| G8 lower right |
| Gr tee pointing right |
| Gr tee pointing left |
| Gu tee pointing up |
| Gd tee pointing down |
| Gh horizontal line |
| Gv vertical line |
| Gc intersection |
| GG acs magic cookie count |
| .TE |
| .PP |
| If the single-line capabilities occur in an entry, they will automatically |
| be composed into an \fIacsc\fR string. The double-line capabilities and |
| \fBGG\fR are discarded with a warning message. |
| .PP |
| IBM's AIX has a terminfo facility descended from SVr1 terminfo but incompatible |
| with the SVr4 format. The following AIX extensions are automatically |
| translated: |
| .TS |
| c c |
| l l. |
| IBM XSI |
| _ |
| ksel kslt |
| kbtab kcbt |
| font0 s0ds |
| font1 s1ds |
| font2 s2ds |
| font3 s3ds |
| .TE |
| .PP |
| Additionally, the AIX \fIbox1\fR capability will be automatically translated to |
| an \fIacsc\fR string. |
| .PP |
| Hewlett-Packard's terminfo library supports two nonstandard terminfo |
| capabilities \fImeml\fR (memory lock) and \fImemu\fR (memory unlock). |
| These will be discarded with a warning message. |
| .SH NOTES |
| This utility is actually a link to \fB@TIC@\fR(1M), running in \fI-I\fR mode. |
| You can use other \fB@TIC@\fR options such as \fB-f\fR and \fB-x\fR. |
| .PP |
| The trace option is not identical to SVr4's. Under SVr4, instead of following |
| the \fB-v\fR with a trace level n, you repeat it n times. |
| .SH SEE ALSO |
| \fB@INFOCMP@\fR(1M), |
| \fBcurses\fR(3X), |
| \fBterminfo\fR(\*n) |
| .PP |
| This describes \fBncurses\fR |
| version @NCURSES_MAJOR@.@NCURSES_MINOR@ (patch @NCURSES_PATCH@). |
| .SH AUTHOR |
| Eric S. Raymond <esr@snark.thyrsus.com> |
| .\"# |
| .\"# The following sets edit modes for GNU EMACS |
| .\"# Local Variables: |
| .\"# mode:nroff |
| .\"# fill-column:79 |
| .\"# End: |