[PATCH 33/42] Use typographer's quotation marks.

[G. Branden Robinson]

* man/curs_border.3x:
* man/curs_clear.3x:
* man/curs_pad.3x:
* man/curs_slk.3x:
* man/ncurses.3x: Do it.

Also lightly recast, and protect "immedok" literal from hyphenation, and
break lines in more fortuitous places.
---
 man/curs_border.3x   |  5 +++--
 man/curs_clear.3x    | 15 +++++++++++++--
 man/curs_delch.3x    |  7 ++++---
 man/curs_deleteln.3x |  7 ++++---
 man/curs_getyx.3x    |  2 +-
 man/curs_insch.3x    |  8 ++++----
 man/curs_move.3x     |  7 ++++---
 man/curs_overlay.3x  |  7 ++++---
 man/curs_pad.3x      |  8 +++++---
 man/curs_refresh.3x  |  7 ++++---
 man/curs_scr_dump.3x |  4 ++--
 man/curs_scroll.3x   |  6 ++++--
 man/curs_slk.3x      |  6 ++++--
 man/ncurses.3x       |  4 +++-
 14 files changed, 59 insertions(+), 34 deletions(-)

diff --git a/man/curs_border.3x b/man/curs_border.3x
index b8582bfc7..759ff964a 100644
--- a/man/curs_border.3x
+++ b/man/curs_border.3x
@@ -137,8 +137,9 @@ .SH DESCRIPTION
 long, or as many as fit into the window.
 .SH RETURN VALUE
 All routines return the integer \fBOK\fP.
-The SVr4.0 manual says "or a
-non-negative integer if \fBimmedok\fP is set", but this appears to be an error.
+The SVr4.0 manual says
+\*(``or a non-negative integer if \fB\%immedok\fP is set\*('',
+but this appears to be an error.
 .PP
 X/Open does not define any error conditions.
 This implementation returns an error
diff --git a/man/curs_clear.3x b/man/curs_clear.3x
index 978fcb895..ec58279c1 100644
--- a/man/curs_clear.3x
+++ b/man/curs_clear.3x
@@ -29,6 +29,17 @@
 .\"
 .\" $Id: curs_clear.3x,v 1.40 2023/11/25 11:31:27 tom Exp $
 .TH curs_clear 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
@@ -95,8 +106,8 @@ .SH NOTES
 .SH PORTABILITY
 These functions are described in the XSI Curses standard, Issue 4.
 .PP
-The SVr4.0 manual says that these functions could
-return "a non-negative integer if \fBimmedok\fP(3X) is set",
+The SVr4.0 manual says that these functions could return
+\*(``or a non-negative integer if \fB\%immedok\fP is set\*('',
 referring to the return-value of \fBwrefresh\fP.
 In that implementation, \fBwrefresh\fP would return a count of
 the number of characters written to the terminal.
diff --git a/man/curs_delch.3x b/man/curs_delch.3x
index 81028fda1..3577c9847 100644
--- a/man/curs_delch.3x
+++ b/man/curs_delch.3x
@@ -63,9 +63,10 @@ .SH DESCRIPTION
 (This does not
 imply use of the hardware delete character feature.)
 .SH RETURN VALUE
-All routines return the integer \fBERR\fP upon failure and an \fBOK\fP (SVr4
-specifies only "an integer value other than \fBERR\fP") upon successful
-completion.
+All routines return the integer \fBERR\fP upon failure and an \fBOK\fP
+(SVr4 specifies only
+\*(``an integer value other than \fBERR\fP\*('')
+upon successful completion.
 .PP
 Functions with a \*(``mv\*('' prefix first perform a cursor movement using
 \fBwmove\fP, and return an error if the position is outside the window,
diff --git a/man/curs_deleteln.3x b/man/curs_deleteln.3x
index 3ef55d723..160ab356e 100644
--- a/man/curs_deleteln.3x
+++ b/man/curs_deleteln.3x
@@ -69,9 +69,10 @@ .SH DESCRIPTION
 The \fBinsertln\fP and \fBwinsertln\fP routines insert a blank line above the
 current line and the bottom line is lost.
 .SH RETURN VALUE
-All routines return the integer \fBERR\fP upon failure and an \fBOK\fP (SVr4
-specifies only "an integer value other than \fBERR\fP") upon successful
-completion.
+These routines return the integer \fBERR\fP upon failure and an \fBOK\fP
+(SVr4 specifies only
+\*(``an integer value other than \fBERR\fP\*('')
+upon successful completion.
 .PP
 X/Open defines no error conditions.
 In this implementation,
diff --git a/man/curs_getyx.3x b/man/curs_getyx.3x
index a72905ad4..7535dc9c9 100644
--- a/man/curs_getyx.3x
+++ b/man/curs_getyx.3x
@@ -60,7 +60,7 @@ .SH RETURN VALUE
 they should not be used as the right-hand side of assignment statements).
 .SH NOTES
 All of these interfaces are macros.
-A "\fB&\fP" is not necessary before the variables \fIy\fP and \fIx\fP.
+A \*(``&\*('' is not necessary before the variables \fIy\fP and \fIx\fP.
 .SH PORTABILITY
 The
 \fB\%getyx\fP,
diff --git a/man/curs_insch.3x b/man/curs_insch.3x
index 37903968e..276c740c4 100644
--- a/man/curs_insch.3x
+++ b/man/curs_insch.3x
@@ -62,10 +62,10 @@ .SH DESCRIPTION
 right, with the possibility of the rightmost character on the line being lost.
 The insertion operation does not change the cursor position.
 .SH RETURN VALUE
-All routines that return an integer return \fBERR\fP upon failure and \fBOK\fP
-(SVr4 specifies only "an integer value other than \fBERR\fP")
-upon successful completion,
-unless otherwise noted in the preceding routine descriptions.
+These routines return the integer \fBERR\fP upon failure and an \fBOK\fP
+(SVr4 specifies only
+\*(``an integer value other than \fBERR\fP\*('')
+upon successful completion.
 .PP
 Functions with a \*(``mv\*('' prefix first perform a cursor movement using
 \fBwmove\fP, and return an error if the position is outside the window,
diff --git a/man/curs_move.3x b/man/curs_move.3x
index d3d656a09..971b02f49 100644
--- a/man/curs_move.3x
+++ b/man/curs_move.3x
@@ -48,9 +48,10 @@ .SH DESCRIPTION
 The position specified is relative to the upper
 left-hand corner of the window, which is (0,0).
 .SH RETURN VALUE
-These routines return \fBERR\fP upon failure and \fBOK\fP (SVr4
-specifies only "an integer value other than \fBERR\fP") upon successful
-completion.
+These routines return the integer \fBERR\fP upon failure and an \fBOK\fP
+(SVr4 specifies only
+\*(``an integer value other than \fBERR\fP\*('')
+upon successful completion.
 .PP
 Specifically, they return an error
 if the window pointer is null, or
diff --git a/man/curs_overlay.3x b/man/curs_overlay.3x
index 422824b79..0f60439b7 100644
--- a/man/curs_overlay.3x
+++ b/man/curs_overlay.3x
@@ -63,9 +63,10 @@ .SS copywin
 then copying is non-destructive,
 as in \fBoverlay\fP.
 .SH RETURN VALUE
-Routines that return an integer return \fBERR\fP upon failure, and \fBOK\fP
-(SVr4 only specifies "an integer value other than \fBERR\fP") upon successful
-completion.
+These routines return the integer \fBERR\fP upon failure and an \fBOK\fP
+(SVr4 specifies only
+\*(``an integer value other than \fBERR\fP\*('')
+upon successful completion.
 .PP
 X/Open defines no error conditions.
 In this implementation,
diff --git a/man/curs_pad.3x b/man/curs_pad.3x
index a20c1c369..d030161f2 100644
--- a/man/curs_pad.3x
+++ b/man/curs_pad.3x
@@ -126,9 +126,11 @@ .SS pecho_wchar
 It does this by a call to \fB\%wadd_wch\fP followed by a call
 to \fB\%prefresh\fP.
 .SH RETURN VALUE
-Routines that return an integer return \fBERR\fP upon failure and \fBOK\fP
-(SVr4 only specifies "an integer value other than \fBERR\fP") upon successful
-completion.
+Routines that return an integer return \fBERR\fP upon failure and
+\fBOK\fP
+(SVr4 specifies only
+\*(``an integer value other than \fBERR\fP\*('')
+upon successful completion.
 .PP
 Routines that return pointers return \fBNULL\fP on error, and set \fB\%errno\fP
 to \fB\%ENOMEM\fP.
diff --git a/man/curs_refresh.3x b/man/curs_refresh.3x
index a32880df4..4cb0d05b9 100644
--- a/man/curs_refresh.3x
+++ b/man/curs_refresh.3x
@@ -128,9 +128,10 @@ .SS wredrawln/redrawwin
 It touches the indicated lines (marking them changed).
 The routine \fBredrawwin\fP touches the entire window.
 .SH RETURN VALUE
-Routines that return an integer return \fBERR\fP upon failure, and \fBOK\fP
-(SVr4 only specifies "an integer value other than \fBERR\fP") upon successful
-completion.
+These routines return the integer \fBERR\fP upon failure and \fBOK\fP
+(SVr4 specifies only
+\*(``an integer value other than \fBERR\fP\*('')
+upon successful completion.
 .PP
 X/Open does not define any error conditions.
 In this implementation
diff --git a/man/curs_scr_dump.3x b/man/curs_scr_dump.3x
index 1ef95559b..477d28bfa 100644
--- a/man/curs_scr_dump.3x
+++ b/man/curs_scr_dump.3x
@@ -107,8 +107,8 @@ .SH PORTABILITY
 which adds \fI\%const\fP qualifiers to the arguments.
 .PP
 The SVr4 docs merely say under \fBscr_init\fP that the dump data is also
-considered invalid "if the time-stamp of the tty is old" but do not define
-\*(``old\*(''.
+considered invalid \*(``if the time-stamp of the tty is old\*('' but do
+not define \*(``old\*(''.
 .SH SEE ALSO
 \fB\%curses\fP(3X),
 \fB\%curs_initscr\fP(3X),
diff --git a/man/curs_scroll.3x b/man/curs_scroll.3x
index 930dfdb89..6d50d79c3 100644
--- a/man/curs_scroll.3x
+++ b/man/curs_scroll.3x
@@ -70,8 +70,10 @@ .SH DESCRIPTION
 .PP
 For these functions to work, scrolling must be enabled via \fBscrollok\fP(3X).
 .SH RETURN VALUE
-These routines return \fBERR\fP upon failure, and \fBOK\fP (SVr4 only specifies
-"an integer value other than \fBERR\fP") upon successful completion.
+These routines return the integer \fBERR\fP upon failure and \fBOK\fP
+(SVr4 specifies only
+\*(``an integer value other than \fBERR\fP\*('')
+upon successful completion.
 .PP
 X/Open defines no error conditions.
 .PP
diff --git a/man/curs_slk.3x b/man/curs_slk.3x
index a6add7f90..4fd014b29 100644
--- a/man/curs_slk.3x
+++ b/man/curs_slk.3x
@@ -191,8 +191,10 @@ .SS Colors
 \fB\%extended_slk_color\fP which accepts an integer value, e.g., 32-bits.
 .
 .SH RETURN VALUE
-These routines return \fBERR\fP upon failure
-and \fBOK\fP (SVr4 specifies only "an integer value other than \fBERR\fP")
+Routines that return an integer return \fBERR\fP upon failure and
+\fBOK\fP
+(SVr4 specifies only
+\*(``an integer value other than \fBERR\fP\*('')
 upon successful completion.
 .PP
 X/Open defines no error conditions.
diff --git a/man/ncurses.3x b/man/ncurses.3x
index 09187fae5..2872ab785 100644
--- a/man/ncurses.3x
+++ b/man/ncurses.3x
@@ -1680,7 +1680,9 @@ .SS Header files
 Starting with BSD curses, all implementations have included <stdio.h>.
 .IP
 BSD curses included <curses.h> and <unctrl.h> from an internal header
-"curses.ext" ("ext" was a short name for \fIexterns\fP).
+file
+.I \%curses.ext
+(\*(``ext\*('' abbreviated \*(``externs\*('').
 .IP
 BSD curses used <stdio.h> internally (for \fBprintw\fP and \fBscanw\fP),
 but nothing in <curses.h> itself relied upon <stdio.h>.
-- 
2.30.2

signature.asc
Description: PGP signature