[PATCH 16/19] man/tabs.1: Fix style and markup nits.

[G. Branden Robinson]

Style:
* Recast to avoid saying "tabs (tabs)" in ncurses builds where the tabs
  utility is not installed under a different name.
* Set command names in italics, not bold, when referring to them
  generically in the "PORTABILITY" and "HISTORY" sections as opposed to
  the ncurses topic/implementation.

Markup:
* Avoid hyphenation error.  Use of `\%` as a hyphenation suppressor
  _must_ come at the beginning of a word.  Font selection escape
  sequences do not change the formatter's idea of where word boundaries
  are.

Observe the hyphen after a parenthesis in the following, using the
previous version of the page).

$ nroff -rLL=70n -man -T ascii ~/ncurses-HEAD/share/man/man1/tabs.1 \
    | sed -n '/The.*option.*was.*documented/,/^$/p'
     The +m option was documented in the POSIX Base Specifications Is-
     sue 5 (Unix98, 1997), then omitted  in  Issue  6  (Unix03,  2004)
     without  express  motivation, though an introductory comment "and
     optionally adjusts the margin" remains,  overlooked  in  the  re-
     moval.   The tabs utility documented in Issues 6 and later has no
     mechanism for setting margins.  The +m option in ncurses tabs  (-
     tabs)  differs  from the SVr4 feature by using terminal capabili-
     ties rather than built-in tables.
---
 man/tabs.1 | 17 +++++++++--------
 1 file changed, 9 insertions(+), 8 deletions(-)

diff --git a/man/tabs.1 b/man/tabs.1
index 5147211c2..5cc9cc11c 100644
--- a/man/tabs.1
+++ b/man/tabs.1
@@ -247,7 +247,8 @@ .SH PORTABILITY
 .RB \%( smglp )
 capabilities needed to support the feature.
 .bP
-Unlike \fB@TPUT@\fP(1),
+Unlike
+.IR tput ,
 .I tabs
 has no specification in X/Open Curses Issue\ 7.
 .PP
@@ -276,7 +277,7 @@ .SH HISTORY
 That option is not specified by POSIX.
 .PP
 The PWB/Unix
-.B tabs
+.I tabs
 utility returned in System III (1980),
 and used built-in tables
 to support a half-dozen hardcopy terminal (printer) types.
@@ -315,10 +316,10 @@ .SH HISTORY
 The
 .B +m
 option in
-.I \%ncurses
-.I tabs
-(\fB\%@TABS@\fP) differs from the SVr4 feature by using terminal
-capabilities rather than built-in tables.
+.IR \%ncurses 's
+implementation
+differs from the SVr4 feature by using terminal capabilities
+rather than built-in tables.
 .PP
 POSIX documents no limit on the number of tab stops.
 Other implementations impose one;
@@ -327,8 +328,8 @@ .SH HISTORY
 utility.
 While some terminals may not accept an arbitrary number of tab stops,
 .I \%ncurses
-\fB\%@TABS@\fP attempts to set tab stops up to the right margin if the
-list thereof is sufficiently long.
+attempts to set tab stops up to the right margin
+if the list thereof is sufficiently long.
 .PP
 The \*(``Rationale\*('' section of the Issue 6
 .I tabs
-- 
2.30.2

signature.asc
Description: PGP signature