Content: * Eschew synecdoche: favor "terminal type" over "terminal" when referring to the contents of the `TERM` environment variable, which does not idiomatically designate or address a specific device. (Back in the day, you'd have a lab full of identical models.) * Clarify application of term "single-line"; it refers to the stroke count of a box-drawing character, not some sort of description of the length of a termcap entry or capability (as viewed in a text editor, for instance). * Consistently present terminfo capability codes in parentheses after their names. * Drop IBM's possessory credit on "AIX"; Microsoft/SCO and whatever their successor-in-interest in XENIX is (if not, in fact, IBM) doesn't get one. * Identify terminfo as an SVr2 feature, not SVr1. I can't find any evidence of a terminfo implementation in the unnumbered "sysv" directories of <https://github.com/ryanwoodsmall/oldsysv.git>. (Maybe someone can throw more light on the provenance of AIX's terminfo.) * Add "EXTENSIONS" section.
Style:
* Stop suppressing hyphenation of "termcap".
* Recast "PORTABILITY" section.
Markup:
* Break long input lines.
* Break input lines at commas.
* Favor man(7) font style macros over *roff font selection escape
sequences, except for man page cross references (because
man/make_sed.sh recognizes only certain patterns when rewriting such
cross references), terms in the "NAME" section (because the generated
edit_man.sh script expects font selection escape sequences when
scraping terms thence to gather names for man page aliases), in
(sub)sectioning macro call arguments, and in (non-text-block) tbl(1)
entries.
* Fix error where hyphenation control sequences at the start of word
were doubled. This could lead to bogus hyphenations like "-
terminfo" (just like that).
* Quote (single-character) trailing punctuation arguments (except for
parentheses) to man(7) font alternation macros. The package does not
require this; it avoids false positives reported by one of Thomas
Dickey's style-checking scripts, per his communication.
---
man/captoinfo.1m | 135 +++++++++++++++++++++++++++++++++--------------
1 file changed, 96 insertions(+), 39 deletions(-)
diff --git a/man/captoinfo.1m b/man/captoinfo.1m
index ce7b93274..7ae406512 100644
--- a/man/captoinfo.1m
+++ b/man/captoinfo.1m
@@ -42,7 +42,8 @@
.\}
.SH NAME
\fB\%@CAPTOINFO@\fP \-
-convert a \fItermcap\fP description into a \fI\%term\%info\fP description
+convert a \fItermcap\fP description into a \fI\%term\%info\fP
+description
.SH SYNOPSIS
.B @CAPTOINFO@
.RI [ tic-option ]
@@ -51,40 +52,66 @@ .SH SYNOPSIS
.P
.B "@CAPTOINFO@ \-V"
.SH DESCRIPTION
-\fB\%@CAPTOINFO@\fP translates terminal descriptions.
-It looks in each given text \fIfile\fP for \fI\%termcap\fP entries and,
+.B \%@CAPTOINFO@
+translates terminal descriptions.
+It looks in each given text
+.I file
+for
+.I termcap
+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.
+writes an equivalent
+.I term\%info
+description to the standard output stream.
+.I termcap
+.B tc
+capabilities translate to
+.I term\%info
+.RB \*(`` use \*(''
+capabilities.
.PP
-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 .
+If no
+.IR file s
+are specified,
+.B \%@CAPTOINFO@
+interprets the content of the environment variable
+.I \%TERMCAP
+as a file name,
+and extracts only the entry for the terminal type named
+in the environment variable
+.I TERM
+from it.
+If the environment variable
+.I \%TERMCAP
+is not set,
+.B \%@CAPTOINFO@
+reads
+.IR \%/etc/termcap "."
.PP
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
+You can use other
+.B \%@TIC@
+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.
+The
+.B \-V
+option reports the version of
+.I \%ncurses
+associated with this program and exits with a successful status.
.SS "Translations from Nonstandard Capabilities"
-\fB\%@CAPTOINFO@\fP translates some obsolete,
+.B \%@CAPTOINFO@
+translates some obsolete,
nonstandard capabilities into standard
-\fI\%\%term\%info\fP capabilities.
+.I term\%info
+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.
@@ -128,7 +155,9 @@ .SS "Translations from Nonstandard Capabilities"
HS mh IRIX enter_dim_mode
.TE
.PP
-XENIX \fI\%termcap\fP had a set of extension capabilities,
+XENIX
+.I termcap
+had a set of extension capabilities,
corresponding to box drawing characters of CCSID
(\*(``code page\*('') 437,
as follows.
@@ -169,15 +198,24 @@ .SS "Translations from Nonstandard Capabilities"
GG ACS magic cookie count
.TE
.PP
-\fB\%@CAPTOINFO@\fP composes single-line capabilities into an \fBacsc\fP
-string,
-and discards \fBGG\fP and double-line capabilities with a warning
+.B \%@CAPTOINFO@
+composes single-line box-drawing capabilities into a
+.I term\%info
+.B \%acs_chars
+.RB \%( acsc )
+string capability,
+and discards
+.B GG
+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,
+AIX has a
+.I term\%info
+facility descended from SVr2
+.IR term\%info ","
but which is incompatible with the SVr4 format.
-\fB\%@CAPTOINFO@\fP translates the following AIX extensions.
+.B \%@CAPTOINFO@
+translates the following AIX extensions.
.PP
.TS
center;
@@ -193,24 +231,43 @@ .SS "Translations from Nonstandard Capabilities"
font3 s3ds
.TE
.PP
-Additionally,
-this program translates the AIX \fBbox1\fP capability to an \fBacsc\fP
-string.
+It furthrmore translates the AIX
+.B box1
+capability to an
+.B \%acs_chars
+.RB \%( acsc )
+string capability.
.PP
-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.
+The HP-UX
+.I \%term\%info
+library supports two nonstandard
+.I \%term\%info
+capabilities:
+.B \%memory_lock
+.RB ( meml )
+and
+.B \%memory_unlock
+.RB ( memu ).
+.B \%@CAPTOINFO@ discards these with a warning message.
.SH FILES
.TP
.I /etc/termcap
-default \fI\%termcap\fP terminal capability database
+default
+.I termcap
+terminal capability database
+.SH EXTENSIONS
+This command is an SVr4
+.I curses
+and
+.I \%ncurses
+extension.
.SH PORTABILITY
-X/Open Curses Issue\ 7 (2009) describes \fBtic\fP briefly,
-but omits this program.
+X/Open Curses Issue\ 7 (2009) does not specify this command.
.PP
-SVr4 systems provide \fB\%captoinfo\fP as a separate application from
-\fBtic\fP.
+SVr4 systems provide
+.I \%captoinfo
+as a separate application from
+.IR \%tic "."
Its
.B \-v
option does not accept a trace level argument
--
2.30.2
signature.asc
Description: PGP signature
