X-Git-Url: http://ncurses.scripts.mit.edu/?a=blobdiff_plain;f=man%2Fcaptoinfo.1m;h=4693b06b36e851424ba1d3cc25bea188a8a15c19;hb=HEAD;hp=819c75c354830c04b2c3bfea91dd0c443d05f8bd;hpb=2882050bf8b296813e7e026b1c5c45d4a23043e3;p=ncurses.git diff --git a/man/captoinfo.1m b/man/captoinfo.1m index 819c75c3..4693b06b 100644 --- a/man/captoinfo.1m +++ b/man/captoinfo.1m @@ -1,6 +1,6 @@ '\" t .\"*************************************************************************** -.\" Copyright 2018-2022,2023 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,27 +28,21 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: captoinfo.1m,v 1.52 2023/10/14 19:25:26 tom Exp $ -.TH @CAPTOINFO@ 1M 2023-10-14 "ncurses 6.4" "User commands" +.\" $Id: captoinfo.1m,v 1.63 2024/03/23 20:37:25 tom Exp $ +.TH @CAPTOINFO@ 1M 2024-03-23 "ncurses @NCURSES_MAJOR@.@NCURSES_MINOR@" "User commands" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq -.ds ' \(aq .\} .el \{\ .ie t .ds `` `` .el .ds `` "" .ie t .ds '' '' .el .ds '' "" -.ie t .ds ' \(aq -.el .ds ' ' .\} -. -.ds n 5 -.ds d /etc/termcap .SH NAME \fB\%@CAPTOINFO@\fP \- -convert a \fItermcap\fR description into a \fIterminfo\fR description +convert a \fItermcap\fP description into a \fI\%term\%info\fP description .SH SYNOPSIS .B @CAPTOINFO@ .RI [ tic-option ] @@ -57,21 +51,22 @@ convert a \fItermcap\fR description into a \fIterminfo\fR description .P .B "@CAPTOINFO@ \-V" .SH DESCRIPTION -\fB\%@CAPTOINFO@\fP looks in each given text -\fIfile\fP for \fItermcap\fP descriptions. -For each one found, -it writes an equivalent \fIterminfo\fP description to the standard +\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. -\fItermcap\fP \fBtc\fP capabilities are translated directly to -\fIterminfo\fP \*(``\fBuse\fP\*('' capabilities. +\fI\%termcap\fP \fBtc\fP capabilities translate to \fI\%\%term\%info\fP +\*(``\fBuse\fP\*('' capabilities. .PP If no \fIfile\fPs are specified, \fB\%@CAPTOINFO@\fP interprets the content of the environment variable -\fB\%TERMCAP\fP as a file name, +\fI\%TERMCAP\fP as a file name, and extracts only the entry for the terminal named in the environment -variable \fB\%TERM\fP from it. -If the environment variable \fB\%TERMCAP\fP is not set, -\fB\%@CAPTOINFO@\fP reads \fI\%\*d\fP. +variable \fITERM\fP from it. +If the environment variable \fI\%TERMCAP\fP is not set, +\fB\%@CAPTOINFO@\fP reads +.IR \%/etc/termcap . .PP This utility is implemented as a link to \fB\%@TIC@\fP(1M), with the latter's @@ -84,22 +79,25 @@ You can use other \fB\%@TIC@\fP options such as .BR \-w , and .BR \-x . -The \fB\-V\fP option reports the version of \fIncurses\fP associated +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" +.SS "Translations from Nonstandard Capabilities" \fB\%@CAPTOINFO@\fP translates some obsolete, -nonstandard capabilities into standard (SVr4/XSI Curses) \fIterminfo\fP -capabilities. +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 +.\" DWB 3.3 tbl requires the two junk "L" specifiers in the first row. .TS -cb cb cb cb -cb cb cb cb -cb cb l lb. -Nonstandard Standard \& \f(BIterminfo\fP -name name From capability +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 @@ -120,28 +118,27 @@ 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 \fItermcap\fP had a set of extension capabilities, +XENIX \fI\%termcap\fP had a set of extension capabilities, corresponding to box drawing characters of CCSID (\*(``code page\*('') 437, as follows. .PP .TS -cb cb +center; cb cb cb l . -Termcap -Name Graphic +\f(BItermcap\fP Name Graphic _ G2 upper left corner G3 lower left corner @@ -173,17 +170,18 @@ Gc double intersection GG ACS magic cookie count .TE .PP -If the single-line capabilities occur in an entry, -they are 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 \fIterminfo\fP facility descended from SVr1 -\fIterminfo\fP, +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 .TS +center; cb cb l l . IBM XSI @@ -200,27 +198,32 @@ Additionally, this program translates the AIX \fBbox1\fP capability to an \fBacsc\fP string. .PP -The HP-UX \fIterminfo\fP library supports two nonstandard \fIterminfo\fP -capabilities, +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 -\fI\*d\fP -default \fItermcap\fP terminal capability database -.SH NOTES -The verbose option is not identical to SVr4's. -Under SVr4, instead of following -the \fB\-v\fP with a trace level \fIn\fP, -you repeat it \fIn\fP times. +.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. +.PP 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 NetBSD does not provide this application. -.SH AUTHOR +.SH AUTHORS Eric S. Raymond and .br @@ -229,4 +232,4 @@ Thomas E. Dickey \fB\%@INFOCMP@\fP(1M), \fB\%@TIC@\fP(1M), \fB\%curses\fP(3X), -\fB\%terminfo\fP(\*n) +\fB\%terminfo\fP(5)