Style:
* Set command names in italics, not bold, when referring to them
  generically, or to "foreign" implementations; contrast the ncurses
  topic/implementation.
* Favor "ncurses" over "this implementation" (or just "this").
* Set "termcap" in italics, not roman.
* Set "terminfo" in italics, not roman.
* Specify hyphenation breakpoint in "terminfo".
* Favor "man pages" over "manual pages".  (Existing usage in the ncurses
  man pages is mixed about evenly.)
* Consistently quote "use" and set it in bold when referring to the
  terminfo entry inclusion feature.  Drop the trailing equals sign used
  in one instance.
* Replace colon dangling at the end of a sentence with a period.  The
  subsequent use of a bulleted paragraph or indented display makes the
  structure clear.
* Protect file name literals from hyphenation.
* Recast.

Markup:
* Use `PP` macro calls instead of `sp` requests.  When typesetting, `sp`
  puts 1 vee of vertical space on the output, whereas `PP` puts the
  configured inter-paragraph distance.  (All implementations known to me
  use 0.4 vees.)
* 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.
---
 man/tic.1m | 137 ++++++++++++++++++++++++++++++++++-------------------
 1 file changed, 89 insertions(+), 48 deletions(-)

diff --git a/man/tic.1m b/man/tic.1m
index 5b0edf7f3..048afabcc 100644
--- a/man/tic.1m
+++ b/man/tic.1m
@@ -639,20 +639,36 @@ .SH NOTES
 characters.
 .SH EXTENSIONS
 Unlike the SVr4
-.B \%@TIC@
-command, this implementation can actually
-compile termcap sources.
-In fact, entries in terminfo and termcap syntax can
-be mixed in a single source file.
+.I tic
+command,
+.I \%ncurses
+.I tic
+can compile
+.I termcap
+sources.
+In fact,
+entries in
+.I \%term\%info
+and
+.I termcap
+syntax can be mixed in a single source file.
 See \fBterminfo\fP(5) for the list of
-termcap names taken to be equivalent to terminfo names.
+.I termcap
+capability names
+.I \%ncurses
+.B \%@TIC@
+treats as equivalent to
+.I \%term\%info
+names.
 .PP
-The SVr4 manual pages are not clear on the resolution rules for \fBuse\fP
+The SVr4 man pages are not clear on the resolution rules for
+.RB \*(`` use \*(''
 capabilities.
 .IR ncurses 's
 .B \%@TIC@
-finds \fBuse\fP targets anywhere
-in the source file,
+finds
+.RB \*(`` use \*(''
+targets anywhere in the source file,
 or anywhere in the file tree rooted at the location in the
 .I \%TERMINFO
 environment variable
@@ -665,58 +681,83 @@ .SH EXTENSIONS
 (if it exists),
 or (finally) anywhere in the system's collection of compiled entries.
 .PP
-The error messages from this
+The error messages from
+.I \%ncurses
 .B \%@TIC@
-have the same format as GNU C
-error messages, and can be parsed by GNU Emacs's compile facility.
+have the same format as GNU C error messages,
+and can be parsed by GNU Emacs's \*(``compile\*('' facility.
 .PP
-Aside from \fB\-c\fP and \fB\-v\fP, options are not portable:
+Aside from
+.B \-c
+and
+.BR \-v ","
+options are not portable.
 .bP
 Most of
+.I \%ncurses
 .BR \%@TIC@ 's
-options
-are not supported by SVr4 \fBtic\fP:
-.sp
+options are not supported by SVr4
+.IR tic "."
+.PP
 .RS
-\fB\-0\fP
-\fB\-1\fP
-\fB\-C\fP
-\fB\-G\fP
-\fB\-I\fP
-\fB\-N\fP
-\fB\-R\fP
-\fB\-T\fP
-\fB\-V\fP
-\fB\-a\fP
-\fB\-e\fP
-\fB\-f\fP
-\fB\-g\fP
-\fB\-o\fP
-\fB\-r\fP
-\fB\-s\fP
-\fB\-t\fP
-\fB\-x\fP
+.B \-0
+.B \-1
+.B \-C
+.B \-G
+.B \-I
+.B \-N
+.B \-R
+.B \-T
+.B \-V
+.B \-a
+.B \-e
+.B \-f
+.B \-g
+.B \-o
+.B \-r
+.B \-s
+.B \-t
+.B \-x
 .RE
 .bP
-The NetBSD \fBtic\fP supports a few of the \fI\%ncurses\fP options
-.sp
+NetBSD
+.I tic
+supports a few of the
+.I \%ncurses
+.B \%@TIC@
+options.
+.PP
 .RS
-\fB\-a\fP
-\fB\-o\fP
-\fB\-x\fP
+.B \-a
+.B \-o
+.B \-x
 .RE
-.IP
-and adds \fB\-S\fP
-(a feature which does the same thing
-as
+.bP
+NetBSD
+.I tic
+also adds
+.BR \-S ","
+a feature which does the same thing as
+.I \%ncurses
 .BR \%@INFOCMP@ 's
-\fB\-e\fP and \fB\-E\fP options).
+.B \-e
+and
+.B \-E
+options.
 .PP
-The SVr4 \fB\-c\fP mode does not report bad \*(``use=\*('' links.
+SVr4
+.IR tic 's
+.B \-c
+mode does not report bad
+.RB \*(`` use \*(''
+links.
 .PP
-System V does not compile entries to or read entries from your
-\fI$HOME/.terminfo\fP database unless \fI\%TERMINFO\fP is explicitly set
-to it.
+SVr4 does not compile entries to
+or read entries from your
+.I \%$HOME/.terminfo
+database unless the
+.I \%TERMINFO
+environment variable is explicitly set to it.
 .SH PORTABILITY
 X/Open Curses Issue\ 7 (2009) provides a brief description of \fBtic\fP.
 It lists one option: \fB\-c\fP.
-- 
2.30.2

Attachment: signature.asc
Description: PGP signature

Reply via email to