[PATCH 5/5] man/infotocap.1m: Align with man/captoinfo.1m.

[G. Branden Robinson]

* Drop man(1) hint comment; there is no need to run the tbl(1)
  preprocessor, because this page contains no tables.
* Define strings for directional double quotation marks.
* Convert synopsis to call man(7) macros for formatting.
* Synopsize "infotocap -V" separately, as a distinct mode of operation.
* Quote a literal in addition to boldfacing it where it is an English
  word that might confuse the reader when font style formatting is
  stripped (e.g., when copy-and-pasting from the man page).
* Protect literals from hyphenation.
* Use active voice more.
* Parallelize language with captoinfo.1m.
* Drop explicit indentation from `TP` call in "FILES" section.
* Set file names in italics.
* Set "ncurses", "termcap", and "terminfo" in italics, not bold.
---
 man/infotocap.1m | 80 ++++++++++++++++++++++++++++--------------------
 1 file changed, 46 insertions(+), 34 deletions(-)

diff --git a/man/infotocap.1m b/man/infotocap.1m
index 1d74088a..3cba7732 100644
--- a/man/infotocap.1m
+++ b/man/infotocap.1m
@@ -1,4 +1,3 @@
-'\" t
 .\"***************************************************************************
 .\" Copyright 2018-2022,2023 Thomas E. Dickey                                *
 .\" Copyright 1999-2010,2016 Free Software Foundation, Inc.                  *
@@ -30,50 +29,63 @@
 .\"
 .\" $Id: infotocap.1m,v 1.26 2023/09/16 23:38:39 tom Exp $
 .TH @INFOTOCAP@ 1M 2023-09-16 "ncurses 6.4" "User commands"
+.ie \n(.g \{\
+.ds `` \(lq
+.ds '' \(rq
+.\}
+.el \{\
+.ie t .ds `` ``
+.el   .ds `` ""
+.ie t .ds '' ''
+.el   .ds '' ""
+.\}
 .ds n 5
 .ds d @TERMINFO@
 .SH NAME
 \fB\%@INFOTOCAP@\fP \-
 convert a \fIterminfo\fR description into a \fItermcap\fR description
 .SH SYNOPSIS
-\fB@INFOTOCAP@\fR [\fB\-v\fIn\fR \fIwidth\fR]  [\fB\-V\fR] [\fB\-1\fR] 
[\fB\-w\fR \fIwidth\fR] \fIfile\fR ...
+.B @INFOTOCAP@
+.RI [ tic-option ]
+.I file
+\&.\|.\|.
+.P
+.B "@INFOTOCAP@ \-V"
 .SH DESCRIPTION
-\fB@INFOTOCAP@\fP looks in each given text
-\fIfile\fP for \fBterminfo\fP descriptions.
-For each terminfo description found,
-an equivalent \fBtermcap\fP description is written to standard output.
-Terminfo \fBuse\fP capabilities are translated directly to termcap
-\fBtc\fP capabilities.
-.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.
+\fB\%@INFOTOCAP@\fP looks in each given text
+\fIfile\fP for \fIterminfo\fP descriptions.
+For each one found,
+it writes an equivalent \fItermcap\fP description to the standard output
+stream.
+\fIterminfo\fP \*(``\fBuse\fP\*('' capabilities are translated directly
+to \fItermcap\fP \fBtc\fP capabilities.
+.PP
+This utility is implemented as a link to \fB\%@TIC@\fP(1M),
+with the latter's
+.B \-C
+option implied.
+You can use other \fB\%@TIC@\fP options such as
+.BR \-1 ,
+.BR \-f ,
+.BR \-v ,
+.BR \-w ,
+and
+.BR \-x .
 .SH FILES
-.TP 20
-\*d
-Compiled terminal description database.
-.SH NOTES
-This utility is actually a link to \fB@TIC@\fP, running in \fI\-C\fP mode.
-You can use other \fB@TIC@\fP options such as \fB\-f\fP and  \fB\-x\fP.
+.TP
+\fI\*d\fP
+compiled terminal description database
 .SH PORTABILITY
-None of X/Open Curses, Issue 7 (2009), SVr4 or NetBSD document this 
application.
+None of X/Open Curses, Issue 7 (2009),
+SVr4,
+or NetBSD document this application.
 .SH SEE ALSO
-\fB@INFOCMP@\fP(1M),
-\fB@TIC@\fP(1M),
-\fBcurses\fP(3X),
-\fBterminfo\fP(\*n)
+\fB\%@INFOCMP@\fP(1M),
+\fB\%@TIC@\fP(1M),
+\fB\%curses\fP(3X),
+\fB\%terminfo\fP(\*n)
 .PP
-This describes \fBncurses\fP
+This describes \fIncurses\fP
 version @NCURSES_MAJOR@.@NCURSES_MINOR@ (patch @NCURSES_PATCH@).
 .SH AUTHOR
 Eric S. Raymond <esr@snark.thyrsus.com>
-- 
2.30.2

signature.asc
Description: PGP signature