diff options
Diffstat (limited to 'upstream/archlinux/man1/captoinfo.1m')
| -rw-r--r-- | upstream/archlinux/man1/captoinfo.1m | 274 |
1 files changed, 151 insertions, 123 deletions
diff --git a/upstream/archlinux/man1/captoinfo.1m b/upstream/archlinux/man1/captoinfo.1m index da859c43..a9d7d9db 100644 --- a/upstream/archlinux/man1/captoinfo.1m +++ b/upstream/archlinux/man1/captoinfo.1m @@ -1,6 +1,6 @@ '\" t .\"*************************************************************************** -.\" Copyright 2018-2021,2022 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2010,2016 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -28,64 +28,76 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: captoinfo.1m,v 1.33 2022/02/12 20:07:29 tom Exp $ -.TH captoinfo 1M "" -.ds n 5 -.ds d /usr/share/terminfo +.\" $Id: captoinfo.1m,v 1.63 2024/03/23 20:37:25 tom Exp $ +.TH captoinfo 1M 2024-03-23 "ncurses 6.5" "User commands" +.ie \n(.g \{\ +.ds `` \(lq +.ds '' \(rq +.\} +.el \{\ +.ie t .ds `` `` +.el .ds `` "" +.ie t .ds '' '' +.el .ds '' "" +.\} .SH NAME -\fBcaptoinfo\fP \- convert a \fItermcap\fP description into a \fIterminfo\fP description +\fB\%captoinfo\fP \- +convert a \fItermcap\fP description into a \fI\%term\%info\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 ... +.B captoinfo +.RI [ tic-option ] +.RI [ file +\&.\|.\|.] +.P +.B "captoinfo \-V" .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. +\fB\%captoinfo\fP translates terminal descriptions. +It looks in each given text \fIfile\fP for \fI\%termcap\fP entries and, +for each one found, +writes an equivalent \fI\%\%term\%info\fP description to the standard +output stream. +\fI\%termcap\fP \fBtc\fP capabilities translate to \fI\%\%term\%info\fP +\*(``\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 +If no \fIfile\fPs are specified, +\fB\%captoinfo\fP interprets the content of the environment variable +\fI\%TERMCAP\fP as a file name, +and extracts only the entry for the terminal named in the environment +variable \fITERM\fP from it. +If the environment variable \fI\%TERMCAP\fP is not set, +\fB\%captoinfo\fP reads +.IR \%/etc/termcap . .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. +This utility is implemented as a link to \fB\%tic\fP(1M), +with the latter's +.B \-I +option implied. +You can use other \fB\%tic\fP options such as +.BR \-1 , +.BR \-f , +.BR \-v , +.BR \-w , +and +.BR \-x . +The \fB\-V\fP option reports the version of \fI\%ncurses\fP associated +with this program and exits with a successful status. +.SS "Translations from Nonstandard Capabilities" +\fB\%captoinfo\fP translates some obsolete, +nonstandard capabilities into standard +(SVr4/XSI Curses) +\fI\%\%term\%info\fP capabilities. +It issues a diagnostic to the standard error stream for each, +inviting the user to check that it has not mistakenly translated an +unknown or mistyped capability name. .PP -.TS H -c c c c -c c c c -l l l l. -Nonstd Std From Terminfo -name name capability +.\" DWB 3.3 tbl requires the two junk "L" specifiers in the first row. +.TS +center; +Cb S L L +Cb Cb Cb Cb +Cb Cb C Lb. +Name +Obsolete Standard Origin \f(BIterminfo\fP capability _ BO mr AT&T enter_reverse_mode CI vi AT&T cursor_invisible @@ -106,64 +118,72 @@ 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 +KA k; Tektronix key_f10 +KB F1 Tektronix key_f11 +KC F2 Tektronix key_f12 +KD F3 Tektronix key_f13 +KE F4 Tektronix key_f14 +KF F5 Tektronix key_f15 +BC Sb Tektronix set_background +FC Sf Tektronix set_foreground +HS mh IRIX 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: +XENIX \fI\%termcap\fP had a set of extension capabilities, +corresponding to box drawing characters of CCSID +(\*(``code page\*('') 437, +as follows. .PP -.TS H -c c -l l. -Cap Graphic +.TS +center; +cb cb +cb l . +\f(BItermcap\fP Name 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 +G2 upper left corner +G3 lower left corner +G1 upper right corner +G4 lower right corner +GR tee pointing right +GL tee pointing left +GU tee pointing up +GD tee 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 +G6 double upper left corner +G7 double lower left corner +G5 double upper right corner +G8 double lower right corner +Gr double tee pointing right +Gr double tee pointing left +Gu double tee pointing up +Gd double tee pointing down +Gh double horizontal line +Gv double vertical line +Gc double intersection +.\" TODO: There are about 40 box drawing code points in CCSID 437; +.\" were there no XENIX capabilities for the mixed single- and double- +.\" line intersections? +.\" +.\" TODO: GG doesn't seem to fit with the others; explain it. +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. +\fB\%captoinfo\fP composes single-line capabilities into an \fBacsc\fP +string, +and discards \fBGG\fP and double-line capabilities with a warning +diagnostic. +.PP +IBM's AIX has a \fI\%\%term\%info\fP facility descended from SVr1 +\fI\%\%term\%info\fP, +but which is incompatible with the SVr4 format. +\fB\%captoinfo\fP translates the following AIX extensions. .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. +center; +cb cb +l l . IBM XSI _ ksel kslt @@ -174,34 +194,42 @@ font2 s2ds font3 s3ds .TE .PP -Additionally, the AIX \fIbox1\fP capability will be automatically translated to -an \fBacsc\fP string. +Additionally, +this program translates the AIX \fBbox1\fP capability 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(1M), 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. +The HP-UX \fI\%\%term\%info\fP library supports two nonstandard +\fI\%\%term\%info\fP capabilities, +\fBmeml\fP (memory lock) and \fBmemu\fP (memory unlock). +\fB\%captoinfo\fP discards these with a warning message. +.SH FILES +.TP +.I /etc/termcap +default \fI\%termcap\fP terminal capability database .SH PORTABILITY -X/Open Curses, Issue 7 (2009) describes \fBtic\fP briefly, +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(1M), -\fBcurses\fP(3X), -\fBterminfo\fP(\*n) +SVr4 systems provide \fB\%captoinfo\fP as a separate application from +\fBtic\fP. +Its +.B \-v +option does not accept a trace level argument +.IR n ; +repeat +.B \-v +.I n +times instead. .PP -This describes \fBncurses\fP -version 6.4 (patch 20230520). -.SH AUTHOR +NetBSD does not provide this application. +.SH AUTHORS Eric S. Raymond <esr@snark.thyrsus.com> and .br -Thomas E. Dickey <dickey@invisible-island.net> +Thomas E. Dickey <dickey@invisible\-island.net> +.SH SEE ALSO +\fB\%infocmp\fP(1M), +\fB\%tic\fP(1M), +\fB\%curses\fP(3X), +\fB\%terminfo\fP(5) |