[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[PATCH 156/177] man/curs_terminfo.3x: Fix markup nit.
From: |
G. Branden Robinson |
Subject: |
[PATCH 156/177] man/curs_terminfo.3x: Fix markup nit. |
Date: |
Mon, 13 Jan 2025 11:41:59 -0600 |
Quote 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/curs_terminfo.3x | 64 ++++++++++++++++++++++----------------------
1 file changed, 32 insertions(+), 32 deletions(-)
diff --git a/man/curs_terminfo.3x b/man/curs_terminfo.3x
index 9107ba11d..344e344f7 100644
--- a/man/curs_terminfo.3x
+++ b/man/curs_terminfo.3x
@@ -211,7 +211,7 @@ .SS Initialization
.I \%term\%info
structures,
but does not set up the output virtualization structures used by
-.IR curses .
+.IR curses "."
Its parameters follow.
.RS 3
.TP 5
@@ -233,9 +233,9 @@ .SS Initialization
passing an output
.I stream
rather than a
-.IR descriptor .
+.IR descriptor "."
In
-.IR curses ,
+.IR curses ","
the two are the same because \fB\%newterm\fP calls \fB\%setupterm\fP,
passing the file descriptor derived from its output stream parameter.
.TP 5
@@ -252,7 +252,7 @@ .SS Initialization
or
.B ERR
and stores a status value in the integer pointed to by
-.IR errret .
+.IR errret "."
A return value of
.B OK
combined with status of
@@ -265,7 +265,7 @@ .SS Initialization
.B ERR
is returned,
examine
-.I errret:
+.IR errret "."
.RS
.TP 5
.B 1
@@ -313,7 +313,7 @@ .SS Initialization
.RE
.IP
which uses all the defaults and sends the output to
-.IR stdout .
+.IR stdout "."
.RE
.\" ********************************************************************
.SS "The Terminal State"
@@ -392,7 +392,7 @@ .SS "Formatting Output"
\fB\%tparm\fP instantiates the string
.I str
with parameters
-.IR pi .
+.IR pi "."
A pointer is returned to the result of
.I str
with the parameters applied.
@@ -448,7 +448,7 @@ .SS "Formatting Output"
.\" ********************************************************************
.SS "Output Functions"
String capabilities can contain
-.IR padding ,
+.IR padding ","
a time delay
(accommodating performance limitations of hardware terminals)
expressed as \fB$<\fIn\fB>\fR,
@@ -492,19 +492,19 @@ .SS "Output Functions"
.IB str ", 1, putchar)\c"
\*(''.
The output of \fB\%putp\fP always goes to
-.IR stdout ,
+.IR stdout ","
rather than the
.I \%file\%des
specified in \fB\%setupterm\fP.
.PP
\fB\%vidputs\fP displays the string on the terminal in the video
attribute mode
-.IR attrs ,
+.IR attrs ","
which is any combination of the attributes listed in \fB\%curses\fP(3X).
The characters are passed to the
.IR \%putchar -like
function
-.IR putc .
+.IR putc "."
.PP
\fB\%vidattr\fP is like \fB\%vidputs\fP,
except that it outputs through \fI\%putchar\fP(3).
@@ -515,20 +515,20 @@ .SS "Output Functions"
correspond to
.B \%vidattr
and
-.BR \%vidputs ,
+.BR \%vidputs ","
respectively.
They use multiple parameters to represent the character attributes and
color;
namely,
.bP
-.IR \%attrs ,
+.IR \%attrs ","
of type
-.IR \%attr_t ,
+.IR \%attr_t ","
for the attributes and
.bP
-.IR pair ,
+.IR pair ","
of type
-.IR short ,
+.IR short ","
for the color pair number.
.PP
Use the attribute constants prefixed with
@@ -536,7 +536,7 @@ .SS "Output Functions"
with
.B \%vid_attr
and
-.BR \%vid_puts .
+.BR \%vid_puts "."
.PP
X/Open Curses reserves the
.I opts
@@ -559,9 +559,9 @@ .SS "Terminal Capability Functions"
and \fB\%tigetstr\fP return the value of the capability corresponding to
the
.I \%term\%info
-.IR cap-code ,
+.IR cap-code ","
such as
-.BR xenl ,
+.BR xenl ","
passed to them.
The
.I cap-code
@@ -671,7 +671,7 @@ .SS "Releasing Memory"
.SH RETURN VALUE
X/Open Curses defines no failure conditions.
In
-.IR \%ncurses ,
+.IR \%ncurses ","
.TP 5
.B del_curtem
fails if its terminal parameter is null.
@@ -688,9 +688,9 @@ .SH RETURN VALUE
fails if it cannot allocate enough memory,
or create the initial windows
.RB \%( stdscr ,
-.BR \%curscr ,
+.BR \%curscr ","
and
-.BR \%newscr ).
+.BR \%newscr ")."
Other error conditions are documented above.
.TP 5
.B tparm
@@ -725,11 +725,11 @@ .SH NOTES
.\" ********************************************************************
.SH EXTENSIONS
The functions marked as extensions were designed for
-.IR \%ncurses ,
+.IR \%ncurses ","
and are not found in SVr4
-.IR curses ,
+.IR curses ","
4.4BSD
-.IR curses ,
+.IR curses ","
or any other previous
.I curses
implementation.
@@ -738,7 +738,7 @@ .SH EXTENSIONS
allows
.I opts
to be a pointer to
-.IR int ,
+.IR int ","
which overrides the
.I pair
.RI ( short )
@@ -780,7 +780,7 @@ .SS "Compatibility Macros"
.PP
In SVr4,
these are found in
-.IR \%curses.h ,
+.IR \%curses.h ","
but except for
.IR \%setterm ","
are likewise macros.
@@ -833,16 +833,16 @@ .SS "Output Buffering"
In addition to the limitation that the terminal was left in
block-buffered mode on exit
(like System\ V
-.IR curses ),
+.IR curses "),"
it was problematic because
.I \%ncurses
did not allow a reliable way to clean up on receiving
-.BR SIGTSTP .
+.BR SIGTSTP "."
.PP
.I \%ncurses
.RI 6. x
uses output buffers managed directly by
-.IR \%ncurses .
+.IR \%ncurses "."
Some of the low-level functions described in this manual page write
to the standard output.
They are not signal-safe.
@@ -863,7 +863,7 @@ .SS "Function Prototypes"
sometimes applying it needlessly to values that are already constant,
and in most cases overlooking parameters that normally would benefit
from
-.IR \%const .
+.IR \%const "."
Passing
.IR \%const -qualified
parameters to functions that do not declare them
@@ -923,7 +923,7 @@ .SS "Function Prototypes"
before C was standardized.
Since ANSI\ C (1989),
C language standards do not require a pointer to fit in a
-.IR long ).
+.IR long ")."
.bP
Providing the right number of parameters for a variadic function
such as
--
2.30.2
signature.asc
Description: PGP signature
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [PATCH 156/177] man/curs_terminfo.3x: Fix markup nit.,
G. Branden Robinson <=