[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
signature.asc
Description: PGP signature
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [PATCH 19/43] man/tabs.1: Fix style nits.,
G. Branden Robinson <=