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