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