ncurses 5.7 - patch 20100925

[ncurses.git] / man / curs_add_wch.3x

diff --git a/man/curs_add_wch.3x b/man/curs_add_wch.3x
index 84092dfd54da56040c8d9e248f5080b89c8d8f95..8d5d640a4aa9d8eda2e1cfe5071f3512c5c29082 100644 (file)
--- a/man/curs_add_wch.3x
+++ b/man/curs_add_wch.3x
@@ -26,8 +26,11 @@
 .\" authorization.                                                           *
 .\"***************************************************************************
 .\"
 .\" authorization.                                                           *
 .\"***************************************************************************
 .\"

-.\" $Id: curs_add_wch.3x,v 1.7 2010/07/31 16:12:01 tom Exp $
+.\" $Id: curs_add_wch.3x,v 1.9 2010/09/18 20:18:34 tom Exp $

 .TH curs_add_wch 3X ""
 .TH curs_add_wch 3X ""

+.de bP
+.IP \(bu 4
+..

 .SH NAME
 \fBadd_wch\fP,
 \fBwadd_wch\fP,
 .SH NAME
 \fBadd_wch\fP,
 \fBwadd_wch\fP,


@@ -63,23 +66,20 @@ window at its current position,
 which is then advanced.
 These functions perform
 wrapping and special-character processing as follows:
 which is then advanced.
 These functions perform
 wrapping and special-character processing as follows:

-.TP 5
-\-
+.bP

 If \fIwch\fP refers to a spacing character,
 then any previous character at that location is removed.
 A new character specified by \fIwch\fP is
 placed at that location with rendition specified by \fIwch\fP.
 The cursor then advances to
 the next spacing character on the screen.
 If \fIwch\fP refers to a spacing character,
 then any previous character at that location is removed.
 A new character specified by \fIwch\fP is
 placed at that location with rendition specified by \fIwch\fP.
 The cursor then advances to
 the next spacing character on the screen.

-.TP 5
-\-
+.bP

 If \fIwch\fP refers to a non-spacing character,
 all previous characters at that location are preserved.
 The non-spacing characters of \fIwch\fP
 are added to the spacing complex character,
 and the rendition specified by \fIwch\fP is ignored.
 If \fIwch\fP refers to a non-spacing character,
 all previous characters at that location are preserved.
 The non-spacing characters of \fIwch\fP
 are added to the spacing complex character,
 and the rendition specified by \fIwch\fP is ignored.

-.TP 5
-\-
+.bP

 If the character part of \fIwch\fP is
 a tab, newline, backspace or other control character,
 the window is updated and the cursor moves as if \fBaddch\fR were called.
 If the character part of \fIwch\fP is
 a tab, newline, backspace or other control character,
 the window is updated and the cursor moves as if \fBaddch\fR were called.


@@ -102,6 +102,10 @@ by using the *\fBecho\fP* functions instead of their equivalents.
 .SH RETURN VALUES
 .PP
 All routines return the integer \fBERR\fR upon failure and \fBOK\fR on success.
 .SH RETURN VALUES
 .PP
 All routines return the integer \fBERR\fR upon failure and \fBOK\fR on success.

+.PP
+Functions with a "mv" prefix first perform a cursor movement using
+\fBwmove\fP, and return an error if the position is outside the window,
+or if the window pointer is null.

 .SH NOTES
 .PP
 Note that
 .SH NOTES
 .PP
 Note that