ncurses 6.4 - patch 20231001

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

diff --git a/man/curs_addch.3x b/man/curs_addch.3x
index 875f47f3ccaa7a95a712d3d5075391618fac2c8c..d5d6aff212a2459dc6efa3c988775c2ad2f0ae5d 100644 (file)
--- a/man/curs_addch.3x
+++ b/man/curs_addch.3x
@@ -28,8 +28,8 @@
 .\" authorization.                                                           *
 .\"***************************************************************************
 .\"
-.\" $Id: curs_addch.3x,v 1.60 2023/03/11 20:39:26 tom Exp $
-.TH curs_addch 3X ""
+.\" $Id: curs_addch.3x,v 1.71 2023/09/30 21:38:11 tom Exp $
+.TH curs_addch 3X 2023-09-30 "ncurses 6.4" "Library calls"
 .ie \n(.g .ds `` \(lq
 .el       .ds `` ``
 .ie \n(.g .ds '' \(rq
@@ -39,12 +39,13 @@
 .el    .IP \(bu 2
 ..
 .SH NAME
-\fBaddch\fP,
-\fBwaddch\fP,
-\fBmvaddch\fP,
-\fBmvwaddch\fP,
-\fBechochar\fP,
-\fBwechochar\fP \- add a character (with attributes) to a \fBcurses\fP window, then advance the cursor
+\fB\%addch\fP,
+\fB\%waddch\fP,
+\fB\%mvaddch\fP,
+\fB\%mvwaddch\fP,
+\fB\%echochar\fP,
+\fB\%wechochar\fP \-
+add a \fIcurses\fR character to a window and advance the cursor
 .SH SYNOPSIS
 \fB#include <curses.h>\fP
 .PP
@@ -100,8 +101,9 @@ using the same convention as \fBunctrl\fR(3X):
 .bP
 Control characters are displayed in the \fB^\fIX\fR notation.
 .bP
-Values above 128 are either meta characters (if the screen has not
-been initialized, or if \fBmeta\fP(3X) has been called with a \fBTRUE\fP E parameter),
+Values above 128 are either meta characters
+(if the screen has not been initialized,
+or if \fBmeta\fP(3X) has been called with a \fBTRUE\fP E parameter),
 shown in the \fBM\-\fIX\fR notation, or are displayed as themselves.
 In the latter case, the values may not be printable;
 this follows the X/Open specification.
@@ -117,7 +119,6 @@ using \fBinch\fP(3X) and \fBaddch\fP.)  See the \fBcurs_attr\fP(3X) page for
 values of predefined video attribute constants that can be usefully OR'ed
 into characters.
 .SS Echoing characters
-.PP
 The \fBechochar\fP and \fBwechochar\fP routines are equivalent to a call to
 \fBaddch\fP followed by a call to \fBrefresh\fP(3X), or a call to \fBwaddch\fP
 followed by a call to \fBwrefresh\fP.
@@ -205,7 +206,6 @@ Note that \fBaddch\fP, \fBmvaddch\fP, \fBmvwaddch\fP, and
 All these functions are described in the XSI Curses standard, Issue 4.
 The defaults specified for forms-drawing characters apply in the POSIX locale.
 .SS ACS Symbols
-.LP
 X/Open Curses states that the \fBACS_\fP definitions are \fBchar\fP constants.
 For the wide-character implementation (see \fBcurs_add_wch\fP),
 there are analogous \fBWACS_\fP definitions which are \fBcchar_t\fP constants.
@@ -300,7 +300,6 @@ before attempting call \fBwaddch\fP, and
 .bP
 call \fBwadd_wch\fP for characters which cannot be handled by \fBwaddch\fP.
 .SS TABSIZE
-.LP
 The \fBTABSIZE\fP variable is implemented in SVr4 and other versions of curses,
 but is not part of X/Open curses
 (see \fBcurs_variables\fP(3X) for more details).
@@ -309,15 +308,15 @@ If \fIch\fP is a carriage return,
 the cursor is moved to the beginning of the current row of the window.
 This is true of other implementations, but is not documented.
 .SH SEE ALSO
-\fBcurses\fP(3X),
-\fBcurs_attr\fP(3X),
-\fBcurs_clear\fP(3X),
-\fBcurs_inch\fP(3X),
-\fBcurs_outopts\fP(3X),
-\fBcurs_refresh\fP(3X),
-\fBcurs_variables\fP(3X),
-\fBputc\fP(3).
+\fB\%curses\fP(3X),
+\fB\%curs_attr\fP(3X),
+\fB\%curs_clear\fP(3X),
+\fB\%curs_inch\fP(3X),
+\fB\%curs_outopts\fP(3X),
+\fB\%curs_refresh\fP(3X),
+\fB\%curs_variables\fP(3X),
+\fB\%putc\fP(3)
 .PP
 Comparable functions in the wide-character (ncursesw) library are
 described in
-\fBcurs_add_wch\fP(3X).
+\fB\%curs_add_wch\fP(3X).