[PATCH 28/45] man/curs_window.3x: Revise "PORTABILITY" section.

[G. Branden Robinson]

Content:
* Correct quotation of X/Open admonition regarding `delwin()`.  "It" was
  a pretty misleading pronoun here, implying the library when X/Open
  Curses explicitly says "The application"!
* Restructure to move content out of bulleted paragraphs; several of the
  points thus marked have nothing to do with "what X/Open Curses
  states".
* Refer more specifically to SVr4 documentation, not just "System V",
  since I have SVID 4th Edition at hand to check.

Style:
* Set "curses" and "PDCurses" in italics.
* Protect "PDCurses", "ncurses" and function names from hyphenation.
* Set function names in italics, not bold, when referring to them
  generically as opposed to the ncurses topic/implementation.

Markup:
* Drop definition of page-local `bP` macro, no longer used.
---
 man/curs_window.3x | 70 +++++++++++++++++++++++++++++-----------------
 1 file changed, 44 insertions(+), 26 deletions(-)

diff --git a/man/curs_window.3x b/man/curs_window.3x
index ad8053392..8b548ba4b 100644
--- a/man/curs_window.3x
+++ b/man/curs_window.3x
@@ -29,10 +29,6 @@
 .\"
 .\" $Id: curs_window.3x,v 1.48 2024/04/20 21:20:07 tom Exp $
 .TH curs_window 3X 2024-04-20 "ncurses @NCURSES_MAJOR@.@NCURSES_MINOR@" 
"Library calls"
-.de bP
-.ie n  .IP \(bu 4
-.el    .IP \(bu 2
-..
 .SH NAME
 \fB\%newwin\fP,
 \fB\%delwin\fP,
@@ -235,31 +231,53 @@ .SH NOTES
 .SH PORTABILITY
 X/Open Curses, Issue 4 describes these functions.
 .PP
-X/Open Curses states regarding \fBdelwin\fP:
-.bP
-It must delete subwindows before deleting their parent.
-.bP
-If \fBdelwin\fP is asked to delete a parent window,
-it can only succeed if the curses library keeps a list of the subwindows.
-SVr4 curses kept a count of the number of subwindows rather than a list.
-It simply returned \fBERR\fP when asked to delete a subwindow.
-Solaris X/Open curses does not even make that check,
-and will delete a parent window which still has subwindows.
-.bP
-Since release 4.0 (1996),
-\fI\%ncurses\fP maintains a list of windows for each screen,
-to ensure that a window has no subwindows before allowing deletion.
-.bP
-NetBSD copied this feature of \fI\%ncurses\fP in 2003.
-.br
-PDCurses follows the scheme used in Solaris X/Open curses.
+Regarding
+.IR \%delwin ","
+X/Open Curses states that
+.RS
+.PP
+[t]he application must delete subwindows before deleting the main
+window.
+.RE
+.PP
+If
+.I \%delwin
+is asked to delete a parent window,
+it can succeed only if the
+.I curses
+library keeps a list of its subwindows.
+SVr4
+.I curses
+kept a count of the number of subwindows rather than a list.
+It simply returned
+.B ERR
+when asked to delete a subwindow.
+Solaris X/Open
+.I curses
+.RI ( \%xcurses )
+does not make even that check,
+and will delete a parent window that still has subwindows.
+.I \%PDCurses
+also behaves this way.
+.PP
+.I \%ncurses
+4.0 (1996) and later maintains a list of windows for each screen
+to ensure that a window has no subwindows before allowing its deletion.
+NetBSD
+.I curses
+has followed suit since 2003.
 .PP
-System\ V's \fIcurses\fP documentation is unclear about what
-\fB\%wsyncup\fP and \fB\%wsyncdown\fP actually do.
+SVr4
+.I curses
+documentation is unclear about what
+.I \%wsyncup
+and
+.I \%wsyncdown
+actually do.
 It seems to imply that they are supposed to touch only those lines that
 are affected by changes to a window's ancestors.
-The language here,
-and behavior of \fI\%ncurses\fP,
+The description and behavior of these functions in
+.I \%ncurses
 is patterned on the X/Open Curses standard;
 this approach may result in slower updates.
 .SH SEE ALSO
-- 
2.30.2

signature.asc
Description: PGP signature