diff options
Diffstat (limited to 'upstream/debian-bookworm/man1/captoinfo.1')
| -rw-r--r-- | upstream/debian-bookworm/man1/captoinfo.1 | 207 |
1 files changed, 207 insertions, 0 deletions
diff --git a/upstream/debian-bookworm/man1/captoinfo.1 b/upstream/debian-bookworm/man1/captoinfo.1 new file mode 100644 index 00000000..37403d7d --- /dev/null +++ b/upstream/debian-bookworm/man1/captoinfo.1 @@ -0,0 +1,207 @@ +'\" t +.\"*************************************************************************** +.\" Copyright 2018-2021,2022 Thomas E. Dickey * +.\" Copyright 1998-2010,2016 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.33 2022/02/12 20:07:29 tom Exp $ +.TH captoinfo 1 "" +.ds n 5 +.ds d /etc/terminfo +.SH NAME +\fBcaptoinfo\fP \- convert a \fItermcap\fP description into a \fIterminfo\fP description +.SH SYNOPSIS +\fBcaptoinfo\fR [\fB\-v\fIn\fR \fIwidth\fR] [\fB\-V\fR] [\fB\-1\fR] [\fB\-w\fR \fIwidth\fR] \fIfile\fR ... +.SH DESCRIPTION +\fBcaptoinfo\fP looks in each given text +\fIfile\fP for \fBtermcap\fP descriptions. +For each +one found, an equivalent \fBterminfo\fP description is written to standard +output. +Termcap \fBtc\fP capabilities are translated directly to terminfo +\fBuse\fP capabilities. +.PP +If no \fIfile\fP is given, then the environment variable \fBTERMCAP\fP is used +for the filename or entry. +If \fBTERMCAP\fP is a full pathname to a file, only +the terminal whose name is specified in the environment variable \fBTERM\fP is +extracted from that file. +If the environment variable \fBTERMCAP\fP is not +set, then the file \fB\*d\fP is read. +.TP 5 +\fB\-v\fP +print out tracing information on standard error as the program runs. +.TP 5 +\fB\-V\fP +print out the version of the program in use on standard error and exit. +.TP 5 +\fB\-1\fP +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\fP +change the output to \fIwidth\fP 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 \fBcaptoinfo\fP. +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 \fBacsc\fP string. +The double-line capabilities and +\fBGG\fP 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\fP capability will be automatically translated to +an \fBacsc\fP string. +.PP +Hewlett-Packard's terminfo library supports two nonstandard terminfo +capabilities \fBmeml\fP (memory lock) and \fBmemu\fP (memory unlock). +These will be discarded with a warning message. +.SH NOTES +This utility is actually a link to \fBtic\fP(1), running in \fI\-I\fP mode. +You can use other \fBtic\fP options such as \fB\-f\fP and \fB\-x\fP. +.PP +The verbose option is not identical to SVr4's. +Under SVr4, instead of following +the \fB\-v\fP with a trace level n, you repeat it n times. +.SH PORTABILITY +X/Open Curses, Issue 7 (2009) describes \fBtic\fP briefly, +but omits this program. +SVr4 systems provide \fBcaptoinfo\fP as a separate application from \fBtic\fP. +.PP +NetBSD does not provide this application. +.SH SEE ALSO +\fBinfocmp\fP(1), +\fBncurses\fP(3NCURSES), +\fBterminfo\fP(\*n) +.PP +This describes \fBncurses\fP +version 6.4 (patch 20221231). +.SH AUTHOR +Eric S. Raymond <esr@snark.thyrsus.com> +and +.br +Thomas E. Dickey <dickey@invisible-island.net> |