bug-ncurses
[Top][All Lists]
Advanced

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

[PATCH 079/100] man/curs_addch.3x: Fix content and style nits.


From: G. Branden Robinson
Subject: [PATCH 079/100] man/curs_addch.3x: Fix content and style nits.
Date: Sat, 30 Mar 2024 17:00:57 -0500

Content:
* Include the boilerplate for SVr4 return value uselessness.

Style:
* Align failure boilerplate with curs_insch.3x.

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 from there to gather names for man page aliases).
---
 man/curs_addch.3x | 21 +++++++++++++--------
 1 file changed, 13 insertions(+), 8 deletions(-)

diff --git a/man/curs_addch.3x b/man/curs_addch.3x
index 1b99b6c98..4464cabef 100644
--- a/man/curs_addch.3x
+++ b/man/curs_addch.3x
@@ -58,7 +58,7 @@ .SH NAME
 \fB\%mvwaddch\fP,
 \fB\%echochar\fP,
 \fB\%wechochar\fP \-
-add a \fIcurses\fR character to a window and advance the cursor
+add a \fIcurses\fP character to a window and advance the cursor
 .SH SYNOPSIS
 .nf
 \fB#include <curses.h>
@@ -253,13 +253,11 @@ .SH RETURN VALUE
 if \fB\%scrollok\fP(3X) is not enabled in that event,
 because it is not possible to wrap to a new line.
 .PP
-Functions with a \*(``mv\*('' prefix first perform cursor movement using
-\fB\%wmove\fP(3X) and fail if the position is outside the window,
-or
-(for \*(``mvw\*('' functions)
-if the
-.I \%WINDOW
-pointer is null.
+Functions prefixed with \*(``mv\*('' first perform cursor movement and
+fail if the position
+.RI ( y ,
+.IR x )
+is outside the window.
 .SH NOTES
 .BR \%addch ,
 .BR \%mvaddch ,
@@ -271,6 +269,13 @@ .SH PORTABILITY
 X/Open Curses,
 Issue 4 describes these functions.
 It specifies no error conditions for them.
+.PP
+SVr4
+.I curses
+describes a successful return value only as
+\*(``an integer value other than
+.BR ERR \*(''.
+.PP
 The defaults specified for forms-drawing characters apply in the POSIX
 locale.
 .SS "ACS Symbols"
-- 
2.30.2

Attachment: signature.asc
Description: PGP signature


reply via email to

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