bug-ncurses
[Top][All Lists]
Advanced

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

[PATCH 099/177] man/curs_in_wchstr.3x: Slightly reorganize.


From: G. Branden Robinson
Subject: [PATCH 099/177] man/curs_in_wchstr.3x: Slightly reorganize.
Date: Mon, 13 Jan 2025 11:30:31 -0600

Content:
* Relocate X/Open Curses's return value (lack of) prescriptions from
  "RETURN VALUE" section to "PORTABILITY".

Style:
* Favor "ncurses" over "this implementation".
* Protect literals from hyphenation.

Markup:
* Favor man(7) font style macros over *roff font selection escape
  sequences, except for man page cross references (because
  man/make_sed.sh recognizes only certain patterns when rewriting such
  cross references) and terms in the "NAME" section (because the
  generated edit_man.sh script expects font selection escape sequences
  when scraping terms thence to gather names for man page aliases).
---
 man/curs_in_wchstr.3x | 13 +++++++------
 1 file changed, 7 insertions(+), 6 deletions(-)

diff --git a/man/curs_in_wchstr.3x b/man/curs_in_wchstr.3x
index 617b89381..5cfdad058 100644
--- a/man/curs_in_wchstr.3x
+++ b/man/curs_in_wchstr.3x
@@ -89,8 +89,8 @@ .SH RETURN VALUE
 Otherwise, they return
 \fBERR\fP.
 .PP
-X/Open Curses defines no error conditions.
-This implementation returns
+.I \%ncurses
+returns
 .B ERR
 .bP
 if the \fIwin\fP parameter is null or
@@ -103,7 +103,9 @@ .SH RETURN VALUE
 .IR x )
 is outside the window boundaries.
 .SH NOTES
-All routines except \fBwin_wchnstr\fP may be macros.
+All of these functions except
+.B \%win_wchnstr
+may be implemented as macros.
 .PP
 Reading a line that overflows the array pointed to by
 \fIwchstr\fP
@@ -121,9 +123,8 @@ .SH NOTES
 \fBwin_wchnstr\fP
 is recommended.
 .SH PORTABILITY
-X/Open Curses defines no error conditions.
-This implementation checks for null pointers,
-returning \fBERR\fP in that case.
+X/Open Curses Issue\ 4 describes these functions.
+It specifies no error conditions for them.
 .SH SEE ALSO
 \fB\%curs_inchstr\fP(3X) describes comparable functions of the
 .I \%ncurses
-- 
2.30.2

Attachment: signature.asc
Description: PGP signature


reply via email to

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