bug-ncurses
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[PATCH 19/43] man/tabs.1: Fix style nits.


From: G. Branden Robinson
Subject: [PATCH 19/43] man/tabs.1: Fix style nits.
Date: Mon, 9 Sep 2024 09:15:57 -0500

* Prevent break between "Issue" and "7".
* Recast awkward phrasing.
* Recast to avoid a grammatical stumble depending on whether one reads
  "-n" as "dash en" or just "en".  The latter is a justifiable choice
  since the word "option" is adjacent, but it is customary in Unix man
  pages to spell option names with a leading dash even though the word
  "option" in the context of a command line almost invariably implies
  this--an implication even stronger in the 1970s Unix manuals that
  established the practice.  We're nothing if not slaves to tradition.
* Set command names in italics, not bold, when referring to them
  generically (as in the "PORTABILITY" and "HISTORY" sections) as
  opposed to the ncurses topic/implementation.
---
 man/tabs.1 | 30 ++++++++++++++++--------------
 1 file changed, 16 insertions(+), 14 deletions(-)

diff --git a/man/tabs.1 b/man/tabs.1
index 116860399..56d76b55b 100644
--- a/man/tabs.1
+++ b/man/tabs.1
@@ -229,10 +229,10 @@ .SH FILES
 .I @DATADIR@/tabset
 tab stop initialization database
 .SH PORTABILITY
-IEEE Std 1003.1/The Open Group Base Specifications Issue 7
+IEEE Std 1003.1/The Open Group Base Specifications Issue\ 7
 (POSIX.1-2008)
 describes a
-.B tabs
+.I tabs
 utility.
 However,
 .bP
@@ -247,8 +247,9 @@ .SH PORTABILITY
 .RB \%( smglp )
 capabilities needed to support the feature.
 .bP
-There is no counterpart in X/Open Curses Issue 7 for this utility,
-unlike \fB@TPUT@\fP(1).
+Unlike \fItput\fP(1),
+.I tabs
+has no specification in X/Open Curses Issue\ 7.
 .PP
 The
 .B \-d
@@ -259,7 +260,7 @@ .SH PORTABILITY
 extensions not provided by other implementations.
 .SH HISTORY
 A
-.B tabs
+.I tabs
 utility appeared in PWB/Unix 1.0 (1977).
 .\" https://minnie.tuhs.org/cgi-bin/utree.pl?file=PWB1/sys/source/s2/\
 .\"   tabs.c
@@ -270,7 +271,7 @@ .SH HISTORY
 .\" https://minnie.tuhs.org/cgi-bin/utree.pl?file=3BSD/usr/src/cmd/\
 .\"   tabs.c
 (later the same year);
-it supported a \*(``\-n\*('' option to set the first tab stop at the
+it supported an option \*(``\-n\*('' to set the first tab stop at the
 left margin.
 That option is not specified by POSIX.
 .PP
@@ -289,9 +290,9 @@ .SH HISTORY
 but retained the tables to support the printers.
 By this time,
 System\ V
-.B tput
+.I tput
 had incorporated the tab stop initialization feature of BSD's
-.B tset
+.I tset
 from 1982,
 but employed the
 .I \%term\%info
@@ -308,20 +309,21 @@ .SH HISTORY
 \*(``and optionally adjusts the margin\*('' remains,
 overlooked in the removal.
 The
-.B tabs
+.I tabs
 utility documented in Issues 6 and later has no mechanism for setting
 margins.
 The
 .B +m
 option in
 .I \%ncurses
-\fB\%@TABS@\fP differs from the SVr4 feature by using terminal
+.I tabs
+(\fB\%@TABS@\fP) 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;
 the limit is 20 in PWB/Unix's
-.B tabs
+.I tabs
 utility.
 While some terminals may not accept an arbitrary number of tab stops,
 .I \%ncurses
@@ -329,13 +331,13 @@ .SH HISTORY
 list thereof is sufficiently long.
 .PP
 The \*(``Rationale\*('' section of the Issue 6
-.B tabs
+.I tabs
 reference page
 .\" https://pubs.opengroup.org/onlinepubs/009604499/utilities/tabs.html
 details how the committee considered redesigning the
-.B tabs
+.I tabs
 and
-.B tput
+.I tput
 utilities,
 without settling on an improved solution.
 It claims that
-- 
2.30.2

Attachment: signature.asc
Description: PGP signature


reply via email to

[Prev in Thread] Current Thread [Next in Thread]