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