Quote (single-character) trailing punctuation arguments to man(7) font alternation macros. The package does not require this; it avoids false positives reported by one of Thomas Dickey's style-checking scripts, per his communication. --- man/tput.1 | 82 +++++++++++++++++++++++++++--------------------------- 1 file changed, 41 insertions(+), 41 deletions(-)
diff --git a/man/tput.1 b/man/tput.1
index 0bcca8020..6d40b0a29 100644
--- a/man/tput.1
+++ b/man/tput.1
@@ -75,11 +75,11 @@ .SH DESCRIPTION
(or specified)
terminal type.
Terminal capabilities are accessed by
-.IR cap-code .
+.IR cap-code "."
.PP
\fB\%terminfo\fP(5) discusses terminal capabilities at length
and presents a complete list of standardized
-.IR cap-codes .
+.IR cap-codes "."
\fB\%user_caps\fP(5) presents other widely used
but non-standard capabilities.
.PP
@@ -91,7 +91,7 @@ .SH DESCRIPTION
sets its exit status to
.B 0
if the terminal possesses
-.IR cap-code ,
+.IR cap-code ","
and
.B 1
if it does not.
@@ -114,22 +114,22 @@ .SH DESCRIPTION
.PP
Before using a value returned on the standard output,
the application should test
-.BR \%@TPUT@ "'s"
+.BR \%@TPUT@ 's
exit status
to be sure it is 0;
see section \*(``EXIT STATUS\*('' below.
.SS Operands
Generally,
an operand is a
-.IR cap-code ,
+.IR cap-code ","
a capability code from the terminal database,
or a parameter thereto.
Three others are specially recognized by
.BR \%@TPUT@ ":"
-.BR init ,
-.BR \%reset ,
+.BR init ","
+.BR \%reset ","
and
-.BR \%longname .
+.BR \%longname "."
Although these resemble capability codes,
they in fact receive special handling;
we term them \*(``pseudo-capabilities\*(''.
@@ -295,10 +295,10 @@ .SS Aliases
If
.B \%@TPUT@
is invoked via link with any of the names
-.BR clear ,
-.BR init ,
+.BR clear ","
+.BR init ","
or
-.BR \%reset ,
+.BR \%reset ","
it operates as if run with the corresponding (pseudo-)capability
operand.
For example,
@@ -324,7 +324,7 @@ .SS Aliases
.B \%reset
is provided
by the \fB\%@TSET@\fP(1) utility (also via a link named
-.BR \%reset ")."
+.BR \%reset ).
.SS "Terminal Size"
Besides the pseudo-capabilities
(such as
@@ -354,7 +354,7 @@ .SS "Terminal Size"
it inspects the environment variables
.I LINES
and
-.IR \%COLUMNS ,
+.IR \%COLUMNS ","
which may override the terminal size.
.PP
If the
@@ -362,7 +362,7 @@ .SS "Terminal Size"
option is given,
.B \%@TPUT@
ignores the environment variables by calling
-.BR \%use_tioctl(TRUE) ,
+.BR \%use_tioctl(TRUE) ","
relying upon the operating system
(or,
ultimately,
@@ -397,7 +397,7 @@ .SH OPTIONS
.TP
.BI \-T\ type
indicates the terminal's
-.IR type .
+.IR type "."
Normally this option is unnecessary,
because a default is taken from the
.I TERM
@@ -508,11 +508,11 @@ .SH PORTABILITY
and
.B \%reset
operands use logic from 4.1cBSD
-.IR tset ,
+.IR tset ","
manipulating terminal modes.
It checks the same file descriptors
(and
-.IR \%/dev/tty )
+.IR \%/dev/tty ")"
for association with a terminal device as
.I \%ncurses
now does,
@@ -575,7 +575,7 @@ .SH PORTABILITY
.IR termcap -based
.I tput
to
-.IR \%term\%info ,
+.IR \%term\%info ","
and modified it to interpret multiple
.I cap-codes
(and parameters)
@@ -618,17 +618,17 @@ .SH PORTABILITY
but
.B \%parm_delete_line
to
-.IR \%term\%info .
+.IR \%term\%info "."
.I termcap
uses the code
.B DL
for
-.BR \%parm_delete_line .
+.BR \%parm_delete_line "."
.I \%term\%info
uses the code
.B dl1
for
-.BR \%delete_line .
+.BR \%delete_line "."
.bP
The
.I cap-code
@@ -640,17 +640,17 @@ .SH PORTABILITY
but
.B \%clr_eos
to
-.IR \%term\%info .
+.IR \%term\%info "."
.I termcap
uses the code
.B cd
for
-.BR \%clr_eos .
+.BR \%clr_eos "."
.I \%term\%info
uses the code
.B rmdc
for
-.BR \%exit_delete_mode .
+.BR \%exit_delete_mode "."
.PP
The
.B \%longname
@@ -666,7 +666,7 @@ .SH PORTABILITY
before SVr4 (1989).
Later,
4.3BSD-Reno (1990) added support for
-.BR \%longname ,
+.BR \%longname ","
.\" longname was added in October 1989.
and in 1994,
NetBSD added support for the parameter-substitution features.
@@ -674,8 +674,8 @@ .SH PORTABILITY
IEEE Std 1003.1/The Open Group Base Specifications Issue\ 7
(POSIX.1-2008)
documents only the
-.BR clear ,
-.BR init ,
+.BR clear ","
+.BR init ","
and
.B \%reset
operands.
@@ -685,11 +685,11 @@ .SH PORTABILITY
supports
.B clear
as it does any other standard
-.IR cap-code .
+.IR cap-code "."
The others
.RB ( init
and
-.BR \%longname )
+.BR \%longname ")"
do not correspond to terminal capabilities.
.bP
The
@@ -725,7 +725,7 @@ .SH PORTABILITY
Beginning in 2021,
FreeBSD uses
.I \%ncurses
-.BR tput ,
+.BR tput ","
configured for both
.I \%term\%info
(tested first)
@@ -747,7 +747,7 @@ .SH PORTABILITY
.bP
That is,
there are two standards for
-.IR tput :
+.IR tput ":"
POSIX (a subset) and X/Open Curses (the full implementation).
POSIX documents a subset to avoid the complication of including
X/Open Curses and the terminal capability database.
@@ -755,13 +755,13 @@ .SH PORTABILITY
While it is certainly possible to write a
.I tput
program without using
-.IR curses ,
+.IR curses ","
no system with a
.I curses
implementation provides a
.I tput
utility that does not also support standard
-.IR cap-codes .
+.IR cap-codes "."
.PP
X/Open Curses Issue\ 7 (2009) is the first version to document utilities.
However that part of X/Open Curses does not follow existing practice
@@ -791,7 +791,7 @@ .SH PORTABILITY
HP-UX,
Solaris)
use the same exit statuses as
-.IR \%ncurses .
+.IR \%ncurses "."
.PP
NetBSD
.I curses
@@ -858,11 +858,11 @@ .SH HISTORY
by accepting some parameters named for
.I \%term\%info
(pseudo-)capabilities:
-.BR clear ,
-.BR init ,
-.BR \%longname ,
+.BR clear ","
+.BR init ","
+.BR \%longname ","
and
-.BR \%reset .
+.BR \%reset "."
However,
because he had only
.I termcap
@@ -882,7 +882,7 @@ .SH HISTORY
to clear the screen.
.\"
https://minnie.tuhs.org/cgi-bin/utree.pl?file=4.3BSD-Reno/src/usr.bin/tput/clear.sh
These became the \*(``modern\*('' BSD implementation of
-.IR tput .
+.IR tput "."
.PP
The origin of
.I \%ncurses
@@ -900,7 +900,7 @@ .SH HISTORY
.I tput
program
(and other parts of
-.IR \%mytinfo )
+.IR \%mytinfo ")"
in
.I \%ncurses
in June 1995.
@@ -1013,7 +1013,7 @@ .SH EXAMPLES
Set shell variables to capability values:
.B strong
and
-.BR normal ,
+.BR normal ","
to begin and end,
respectively,
stand-out mode for the terminal.
--
2.30.2
signature.asc
Description: PGP signature
