ncurses 6.0 - patch 20170506

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

diff --git a/man/curs_addch.3x b/man/curs_addch.3x
index 3ca42c932353aa5fb68b397c74ea47fd5daad903..151c3160c4c8d1322b956a8fdab8f7228807cf16 100644 (file)
--- a/man/curs_addch.3x
+++ b/man/curs_addch.3x
@@ -1,6 +1,6 @@
 '\" t
 .\"***************************************************************************
 '\" t
 .\"***************************************************************************

-.\" Copyright (c) 1998-2014,2015 Free Software Foundation, Inc.              *
+.\" Copyright (c) 1998-2015,2017 Free Software Foundation, Inc.              *

 .\"                                                                          *
 .\" Permission is hereby granted, free of charge, to any person obtaining a  *
 .\" copy of this software and associated documentation files (the            *
 .\"                                                                          *
 .\" Permission is hereby granted, free of charge, to any person obtaining a  *
 .\" copy of this software and associated documentation files (the            *


@@ -27,8 +27,12 @@
 .\" authorization.                                                           *
 .\"***************************************************************************
 .\"
 .\" authorization.                                                           *
 .\"***************************************************************************
 .\"

-.\" $Id: curs_addch.3x,v 1.37 2015/09/05 21:13:25 tom Exp $
+.\" $Id: curs_addch.3x,v 1.41 2017/05/05 18:15:29 tom Exp $

 .TH curs_addch 3X ""
 .TH curs_addch 3X ""

+.ie \n(.g .ds `` \(lq
+.el       .ds `` ``
+.ie \n(.g .ds '' \(rq
+.el       .ds '' ''

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


@@ -58,7 +62,7 @@
 .SS Adding characters
 The \fBaddch\fR, \fBwaddch\fR, \fBmvaddch\fR and \fBmvwaddch\fR routines put
 the character \fIch\fR into the given window at its current window position,
 .SS Adding characters
 The \fBaddch\fR, \fBwaddch\fR, \fBmvaddch\fR and \fBmvwaddch\fR routines put
 the character \fIch\fR into the given window at its current window position,

-which is then advanced.  They are analogous to \fBputchar\fR in \fBstdio\fR(3).
+which is then advanced.  They are analogous to \fBputchar\fR(3) in \fBstdio\fR(3).

 If the advance is at the right margin:
 .bP
 The cursor automatically wraps to the beginning of the next line.
 If the advance is at the right margin:
 .bP
 The cursor automatically wraps to the beginning of the next line.


@@ -95,13 +99,13 @@ the ^-representation of the control character.
 Video attributes can be combined with a character argument passed to
 \fBaddch\fR or related functions by logical-ORing them into the character.
 (Thus, text, including attributes, can be copied from one place to another
 Video attributes can be combined with a character argument passed to
 \fBaddch\fR or related functions by logical-ORing them into the character.
 (Thus, text, including attributes, can be copied from one place to another

-using \fBinch\fR and \fBaddch\fR.)  See the \fBcurs_attr\fR(3X) page for
+using \fBinch\fR(3X) and \fBaddch\fR.)  See the \fBcurs_attr\fR(3X) page for

 values of predefined video attribute constants that can be usefully OR'ed
 into characters.
 .SS Echoing characters
 .PP
 The \fBechochar\fR and \fBwechochar\fR routines are equivalent to a call to
 values of predefined video attribute constants that can be usefully OR'ed
 into characters.
 .SS Echoing characters
 .PP
 The \fBechochar\fR and \fBwechochar\fR routines are equivalent to a call to

-\fBaddch\fR followed by a call to \fBrefresh\fR, or a call to \fBwaddch\fR
+\fBaddch\fR followed by a call to \fBrefresh\fR(3X), or a call to \fBwaddch\fR

 followed by a call to \fBwrefresh\fR.  The knowledge that only a single
 character is being output is used and, for non-control characters, a
 considerable performance gain may be seen by using these routines instead of
 followed by a call to \fBwrefresh\fR.  The knowledge that only a single
 character is being output is used and, for non-control characters, a
 considerable performance gain may be seen by using these routines instead of


@@ -117,50 +121,52 @@ library is unable to use Unicode.
 The names are taken from VT100 nomenclature.
 .PP
 .TS
 The names are taken from VT100 nomenclature.
 .PP
 .TS

-l l l
-_ _ _
-l l l.
-\fIName\fR     \fIDefault\fR   \fIDescription\fR
-ACS_BLOCK      #       solid square block
-ACS_BOARD      #       board of squares
-ACS_BTEE       +       bottom tee
-ACS_BULLET     o       bullet
-ACS_CKBOARD    :       checker board (stipple)
-ACS_DARROW     v       arrow pointing down
-ACS_DEGREE     '       degree symbol
-ACS_DIAMOND    +       diamond
-ACS_GEQUAL     >       greater-than-or-equal-to
-ACS_HLINE      \-      horizontal line
-ACS_LANTERN    #       lantern symbol
-ACS_LARROW     <       arrow pointing left
-ACS_LEQUAL     <       less-than-or-equal-to
-ACS_LLCORNER   +       lower left-hand corner
-ACS_LRCORNER   +       lower right-hand corner
-ACS_LTEE       +       left tee
-ACS_NEQUAL     !       not-equal
-ACS_PI *       greek pi
-ACS_PLMINUS    #       plus/minus
-ACS_PLUS       +       plus
-ACS_RARROW     >       arrow pointing right
-ACS_RTEE       +       right tee
-ACS_S1 \-      scan line 1
-ACS_S3 \-      scan line 3
-ACS_S7 \-      scan line 7
-ACS_S9 \&_     scan line 9
-ACS_STERLING   f       pound-sterling symbol
-ACS_TTEE       +       top tee
-ACS_UARROW     ^       arrow pointing up
-ACS_ULCORNER   +       upper left-hand corner
-ACS_URCORNER   +       upper right-hand corner
-ACS_VLINE      |       vertical line
+l l l l
+l l l l
+_ _ _ _
+l l l l.
+\fBACS\fR      \fBACS\fR       \fBacsc\fP      \fBGlyph\fR
+\fBName\fR     \fBDefault\fR   \fBchar\fP      \fBName\fR
+ACS_BLOCK      #       0       solid square block
+ACS_BOARD      #       h       board of squares
+ACS_BTEE       +       v       bottom tee
+ACS_BULLET     o       ~       bullet
+ACS_CKBOARD    :       a       checker board (stipple)
+ACS_DARROW     v       .       arrow pointing down
+ACS_DEGREE     '       f       degree symbol
+ACS_DIAMOND    +       `       diamond
+ACS_GEQUAL     >       >       greater-than-or-equal-to
+ACS_HLINE      \-      q       horizontal line
+ACS_LANTERN    #       i       lantern symbol
+ACS_LARROW     <       ,       arrow pointing left
+ACS_LEQUAL     <       y       less-than-or-equal-to
+ACS_LLCORNER   +       m       lower left-hand corner
+ACS_LRCORNER   +       j       lower right-hand corner
+ACS_LTEE       +       t       left tee
+ACS_NEQUAL     !       |       not-equal
+ACS_PI *       {       greek pi
+ACS_PLMINUS    #       g       plus/minus
+ACS_PLUS       +       n       plus
+ACS_RARROW     >       +       arrow pointing right
+ACS_RTEE       +       u       right tee
+ACS_S1 \-      o       scan line 1
+ACS_S3 \-      p       scan line 3
+ACS_S7 \-      r       scan line 7
+ACS_S9 \&_     s       scan line 9
+ACS_STERLING   f       }       pound-sterling symbol
+ACS_TTEE       +       w       top tee
+ACS_UARROW     ^       \-      arrow pointing up
+ACS_ULCORNER   +       l       upper left-hand corner
+ACS_URCORNER   +       k       upper right-hand corner
+ACS_VLINE      |       x       vertical line

 .TE
 .SH RETURN VALUE
 All routines return the integer \fBERR\fR upon failure and \fBOK\fR on success
 .TE
 .SH RETURN VALUE
 All routines return the integer \fBERR\fR upon failure and \fBOK\fR on success

-(the SVr4 manuals specify only "an integer value other than \fBERR\fR") upon
-successful completion, unless otherwise noted in the preceding routine
-descriptions.
+(the SVr4 manuals specify only
+\*(``an integer value other than \fBERR\fR\*('') upon successful completion,
+unless otherwise noted in the preceding routine descriptions.

 .PP
 .PP

-Functions with a "mv" prefix first perform a cursor movement using
+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
 \fBwmove\fP, and return an error if the position is outside the window,
 or if the window pointer is null.
 .SH NOTES