bug-ncurses
[Top][All Lists]
Advanced

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

[PATCH 047/177] man/curs_getyx.3x: Fix content and style nits.


From: G. Branden Robinson
Subject: [PATCH 047/177] man/curs_getyx.3x: Fix content and style nits.
Date: Mon, 13 Jan 2025 11:21:58 -0600

Content:
* The "older versions" of curses accommodated by ncurses's compatibility
  macros `get{beg,cur,max,par}{y,x}` are System V curses libraries.
* Note those macros' non-standardization, even in SVID.

Style:
* Set macro names and other C symbols in italics, not bold, when
  referring to them generically in the "PORTABILITY", as opposed to the
  ncurses topic/implementation.
* Present `y` versions of location macros before `x`, for pedagogical
  reinforcement of this coordinate ordering.
---
 man/curs_getyx.3x | 30 ++++++++++++++++--------------
 1 file changed, 16 insertions(+), 14 deletions(-)

diff --git a/man/curs_getyx.3x b/man/curs_getyx.3x
index d1d0e0369..f0f3bb17d 100644
--- a/man/curs_getyx.3x
+++ b/man/curs_getyx.3x
@@ -113,17 +113,19 @@ .SH PORTABILITY
 .PP
 .I \%ncurses
 also provides functions
-.BR \%getbegx ","
-.BR \%getbegy ","
-.BR \%getcurx ","
-.BR \%getcury ","
-.BR \%getmaxx ","
-.BR \%getmaxy ","
-.BR \%getparx ","
+.IR \%getbegy ","
+.IR \%getbegx ","
+.IR \%getcury ","
+.IR \%getcurx ","
+.IR \%getmaxy ","
+.IR \%getmaxx ","
+.IR \%getpary ","
 and
-.B \%getpary
-for compatibility with older versions of
-.IR curses ";"
+.I \%getparx
+for compatibility with System\ V
+.I curses
+that were not standardized;
+.\" even by SVID 4
 see \fB\%curs_legacy\fP(3X).
 .PP
 Although X/Open Curses does not address the issue,
@@ -139,19 +141,19 @@ .SH PORTABILITY
 .PP
 Besides the problem of opaque structures,
 the data stored in like-named members may not have values of the same
-meaning different implementations.
+meaning across different implementations.
 For example,
 the values of
-.B \%WINDOW._maxx
+.I \%WINDOW._maxx
 and
-.B \%WINDOW._maxy
+.I \%WINDOW._maxy
 in
 .I \%ncurses
 have long
 .\" (at least since its initial release, 1.8.1)
 differed by one from some other implementations.
 The
-.B \%getmaxyx
+.I \%getmaxyx
 macro hides this difference.
 .SH SEE ALSO
 \fB\%curses\fP(3X),
-- 
2.30.2

Attachment: signature.asc
Description: PGP signature


reply via email to

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