bug-ncurses
[Top][All Lists]
Advanced

[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

Attachment: signature.asc
Description: PGP signature


reply via email to

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