X-Git-Url: https://ncurses.scripts.mit.edu/?a=blobdiff_plain;f=man%2Fcaptoinfo.1m;h=4c46da67b348ac0a1905ff91db2841e7d3b254da;hb=HEAD;hp=b3983b41e8f2f6ebcefb2747f5845e7e741372d5;hpb=09ed0227b324243f636e31d876e3dc30dfc7a778;p=ncurses.git diff --git a/man/captoinfo.1m b/man/captoinfo.1m index b3983b41..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,26 +28,21 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: captoinfo.1m,v 1.56 2023/12/02 20:51:25 tom Exp $ -.TH @CAPTOINFO@ 1M 2023-12-02 "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 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 ] @@ -59,9 +54,9 @@ convert a \fItermcap\fR description into a \fIterminfo\fR description \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\%terminfo\fP description to the standard output -stream. -\fI\%termcap\fP \fBtc\fP capabilities translate to \fI\%terminfo\fP +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\fPs are specified, @@ -70,7 +65,8 @@ If no \fIfile\fPs are specified, 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 \fI\%\*d\fP. +\fB\%@CAPTOINFO@\fP reads +.IR \%/etc/termcap . .PP This utility is implemented as a link to \fB\%@TIC@\fP(1M), with the latter's @@ -85,17 +81,19 @@ 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" +.SS "Translations from Nonstandard Capabilities" \fB\%@CAPTOINFO@\fP translates some obsolete, nonstandard capabilities into standard (SVr4/XSI Curses) -\fI\%terminfo\fP capabilities. +\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 S +center; +Cb S L L Cb Cb Cb Cb Cb Cb C Lb. Name @@ -137,6 +135,7 @@ corresponding to box drawing characters of CCSID as follows. .PP .TS +center; cb cb cb l . \f(BItermcap\fP Name Graphic @@ -176,12 +175,13 @@ string, and discards \fBGG\fP and double-line capabilities with a warning diagnostic. .PP -IBM's AIX has a \fI\%terminfo\fP facility descended from SVr1 -\fI\%terminfo\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 @@ -198,25 +198,29 @@ Additionally, this program translates the AIX \fBbox1\fP capability to an \fBacsc\fP string. .PP -The HP-UX \fI\%terminfo\fP library supports two nonstandard -\fI\%terminfo\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 -.I \*d +.I /etc/termcap default \fI\%termcap\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. .SH PORTABILITY 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 AUTHORS