bug-ncurses
[Top][All Lists]
Advanced

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

[PATCH 14/14] man/curs_bkgd.3x: Fix style nits.


From: G. Branden Robinson
Subject: [PATCH 14/14] man/curs_bkgd.3x: Fix style nits.
Date: Fri, 1 Dec 2023 17:34:13 -0600

* Define `` and '' *roff strings for typographer's quotation marks.
* Use them instead of U+002D.
* Say "ncurses" instead of "this implementation".
* Set "ncurses" and "curses" in italics, not roman.
* Protect "ncurses" and function name literals from hyphenation.
* Break input lines after commas.
---
 man/curs_bkgd.3x | 36 ++++++++++++++++++++++++++----------
 1 file changed, 26 insertions(+), 10 deletions(-)

diff --git a/man/curs_bkgd.3x b/man/curs_bkgd.3x
index 3125620f..c5459668 100644
--- a/man/curs_bkgd.3x
+++ b/man/curs_bkgd.3x
@@ -29,6 +29,17 @@
 .\"
 .\" $Id: curs_bkgd.3x,v 1.49 2023/11/25 14:01:49 tom Exp $
 .TH curs_bkgd 3X 2023-11-25 "ncurses 6.4" "Library calls"
+.ie \n(.g \{\
+.ds `` \(lq
+.ds '' \(rq
+.\}
+.el \{\
+.ie t .ds `` ``
+.el   .ds `` ""
+.ie t .ds '' ''
+.el   .ds '' ""
+.\}
+.
 .de bP
 .ie n  .IP \(bu 4
 .el    .IP \(bu 2
@@ -88,10 +99,12 @@ .SS bkgd
 the way the rendition of characters on the screen is updated when
 \fBbkgd\fP or \fBwbkgd\fP is used to change the background character.
 .PP
-This implementation, like SVr4 curses, does not store the background
-and window attribute contributions to each cell separately.
-It updates the rendition by comparing the character, non-color attributes and
-colors contained in the background.
+\fI\%ncurses\fP,
+like SVr4 \fIcurses\fP,
+does not store the background and window attribute contributions to each
+cell separately.
+It updates the rendition by comparing the character,
+non-color attributes and colors contained in the background.
 For each cell in the window, whether or not it is blank:
 .bP
 The library first compares the \fIcharacter\fP,
@@ -137,13 +150,14 @@ .SH RETURN VALUE
 pointer argument is null.
 .PP
 In contrast,
-the SVr4.0 manual says \fBbkgd\fP and \fBwbkgd\fP may return \fBOK\fP
-"or a non-negative integer if \fBimmedok\fP is set",
-which refers to the return value from \fBwrefresh\fP
+the SVr4.0 manual says \fB\%bkgd\fP and \fB\%wbkgd\fP may return
+\fBOK\fP
+\*(``or a non-negative integer if \fB\%immedok\fP is set\*('',
+which refers to the return value from \fB\%wrefresh\fP
 (used to implement the immediate repainting).
-The SVr4 curses \fBwrefresh\fP returns the number of characters
+SVr4 \fIcurses\fP \fB\%wrefresh\fP returns the number of characters
 written to the screen during the refresh.
-This implementation does not do that.
+\fI\%ncurses\fP does not do that.
 .SH NOTES
 Unusually,
 there is no \fB\%wgetbkgd\fP function;
@@ -154,7 +168,9 @@ .SH NOTES
 .PP
 X/Open Curses mentions that the character part of the background must
 be a single-byte value.
-This implementation, like SVr4, checks to ensure that,
+\fI\%ncurses\fP,
+like SVr4 \fIcurses\fP,
+checks to ensure that,
 and will reuse the old background character if the check fails.
 .SH PORTABILITY
 These functions are described in the XSI Curses standard, Issue 4.
-- 
2.30.2

Attachment: signature.asc
Description: PGP signature


reply via email to

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