The addch, waddch, mvaddch and mvwaddch routines put the character ch
into the given window at its current window position, which is then
- advanced. They are analogous to putchar(3) in stdio(3). If the
- advance is at the right margin:
+ advanced. They are analogous to the standard C library's putchar(3).
+ If the advance is at the right margin:
o The cursor automatically wraps to the beginning of the next line.
@@ -79,7 +79,7 @@
o If scrollok(3x) is not enabled, writing a character at the lower
right margin succeeds. However, an error is returned because it is
- not possible to wrap to a new line
+ not possible to wrap to a new line.
If ch is a tab, newline, carriage return or backspace, the cursor is
moved appropriately within the window:
@@ -119,7 +119,7 @@
OR'ed into characters.
-
The echochar and wechochar routines are equivalent to a call to addch
followed by a call to refresh(3x), or a call to waddch followed by a
call to wrefresh. The knowledge that only a single character is being
@@ -190,7 +190,7 @@
o If scrollok(3x) is not enabled, writing a character at the lower
right margin succeeds. However, an error is returned because it is
- not possible to wrap to a new line
+ not possible to wrap to a new line.
o If an error is detected when converting a multibyte character to a
sequence of bytes, or if it is not possible to add all of the
@@ -202,8 +202,8 @@
- All these functions are described in the XSI Curses standard, Issue 4.
- The defaults specified for forms-drawing characters apply in the POSIX
+ These functions are described in the XSI Curses standard, Issue 4. The
+ defaults specified for forms-drawing characters apply in the POSIX
locale.
@@ -220,8 +220,8 @@
NetBSD also uses an array, actually named _acs_char, with a #define
for compatibility.
- o HPUX curses equates some of the ACS_ symbols to the analogous WACS_
- symbols as if the ACS_ symbols were wide characters. The
+ o HP-UX curses equates some of the ACS_ symbols to the analogous
+ WACS_ symbols as if the ACS_ symbols were wide characters. The
misdefined symbols are the arrows and other symbols which are not
used for line-drawing.
@@ -245,7 +245,7 @@
The displayed values for the ACS_ and WACS_ constants depend on
- o the library configuration, i.e., ncurses versus ncursesw, where the
+ o the library configuration, i.e., ncurses versus ncursesw, where the
latter is capable of displaying Unicode while the former is not,
and
@@ -266,19 +266,19 @@
character information which is packed in a chtype to pass to waddch.
In this implementation, chtype holds an eight-bit character. But
- ncurses allows multibyte characters to be passed in a succession of
+ ncurses allows multibyte characters to be passed in a succession of
calls to waddch. The other implementations do not do this; a call to
waddch passes exactly one character which may be rendered as one or
more cells on the screen depending on whether it is printable.
- Depending on the locale settings, ncurses will inspect the byte passed
+ Depending on the locale settings, ncurses will inspect the byte passed
in each call to waddch, and check if the latest call will continue a
- multibyte sequence. When a character is complete, ncurses displays the
+ multibyte sequence. When a character is complete, ncurses displays the
character and moves to the next position in the screen.
If the calling application interrupts the succession of bytes in a
multibyte character by moving the current location (e.g., using wmove),
- ncurses discards the partially built character, starting over again.
+ ncurses discards the partially built character, starting over again.
For portability to other implementations, do not rely upon this
behavior:
@@ -308,7 +308,7 @@
-ncurses 6.4 2023-10-07 curs_addch(3x)
+ncurses 6.4 2023-12-23 curs_addch(3x)