[PATCH 03/12] man/curs_initscr.3x: Revise quoted material.

[G. Branden Robinson]

* Identify which revision of the X/Open standard is cited.
* Stop manipulating adjustment and hyphenation around a block quote.
  These generally don't have to be preserved in quoted material, even in
  (U.S.) legal citations.  Apart from that, "restoring" the hyphenation
  mode does not work as people think it does.  (An `hy` request without
  argument sets a hyphenation mode of "1", which is correct for neither
  AT&T nor groff hyphenation patterns.)
* Nevertheless, prevent hyphenation of signal name macro literals, and
  curses function name, by using the `\%` escape sequence.
* By contrast, restore the standard's use (or not) of stylistic
  emphasis.
* Set ellipses immediately adjacent to quoted material.
---
 man/curs_initscr.3x | 26 ++++++++++++--------------
 1 file changed, 12 insertions(+), 14 deletions(-)

diff --git a/man/curs_initscr.3x b/man/curs_initscr.3x
index 829a50ae..ac1b64b6 100644
--- a/man/curs_initscr.3x
+++ b/man/curs_initscr.3x
@@ -235,25 +235,23 @@ .SS Unset TERM Variable
 and cannot be used for full-screen operation.
 Other implementations may handle a missing/empty TERM variable differently.
 .SS Signal Handlers
-Quoting from X/Open Curses, section 3.1.1:
+Quoting from X/Open Curses Issue 7, section 3.1.1:
 .RS 5
-.hy 0
 .PP
-.I Curses implementations may provide for special handling of the
-.I \fBSIGINT\fP,
-.I \fBSIGQUIT\fP and
-.I \fBSIGTSTP\fP signals
-.I if their disposition is \fBSIG_DFL\fP at the time
-\fBinitscr\fI is called \fR...
+Curses implementations may provide for special handling of the
+\%SIGINT,
+\%SIGQUIT,
+and \%SIGTSTP signals if their disposition is \%SIG_DFL at the time
+.I \%initscr
+is called.\|.\|.
 .PP
-.I Any special handling for these signals may remain in effect for the
-.I life of the process or until the process changes the disposition of
-.I the signal.
+Any special handling for these signals may remain in effect for the
+life of the process or until the process changes the disposition of
+the signal.
 .PP
-.I None of the Curses functions are required to be safe
-.I with respect to signals \fP...
+None of the Curses functions are required to be safe
+with respect to signals.\|.\|.
 .RE
-.hy
 .PP
 This implementation establishes signal handlers during initialization,
 e.g., \fBinitscr\fP or \fBnewterm\fP.
-- 
2.30.2

signature.asc
Description: PGP signature