X-Git-Url: http://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=man%2Fcurs_addch.3x;h=15d859b653a51f04290a7afa51660defb3d3f0f2;hp=e45048793a1e17294d24d4f63ec43635ab3fd65c;hb=02f02dcd4464143580e783ae32c822d8eb8cdcbf;hpb=34d602f272c394e9a980438e636e1ce4d355f83b diff --git a/man/curs_addch.3x b/man/curs_addch.3x index e4504879..15d859b6 100644 --- a/man/curs_addch.3x +++ b/man/curs_addch.3x @@ -1,6 +1,6 @@ '\" t .\"*************************************************************************** -.\" Copyright (c) 1998-2011,2014 Free Software Foundation, Inc. * +.\" Copyright (c) 1998-2014,2015 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 * @@ -27,7 +27,7 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_addch.3x,v 1.33 2014/05/24 19:47:41 tom Exp $ +.\" $Id: curs_addch.3x,v 1.36 2015/07/16 09:14:44 tom Exp $ .TH curs_addch 3X "" .de bP .IP \(bu 4 @@ -55,6 +55,7 @@ \fBint wechochar(WINDOW *win, const chtype ch);\fR .br .SH DESCRIPTION +.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). @@ -71,12 +72,14 @@ 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 .PP -If \fIch\fR is a tab, newline, or backspace, +If \fIch\fR is a tab, newline, carriage return or backspace, the cursor is moved appropriately within the window: .bP Backspace moves the cursor one character left; at the left edge of a window it does nothing. .bP +Carriage return moves the cursor to the window left margin on the current line. +.bP Newline does a \fBclrtoeol\fR, then moves the cursor to the window left margin on the next line, scrolling the window if on the last line. @@ -84,7 +87,7 @@ scrolling the window if on the last line. Tabs are considered to be at every eighth column. The tab interval may be altered by setting the \fBTABSIZE\fR variable. .PP -If \fIch\fR is any control character other than tab, newline, or backspace, it +If \fIch\fR is any other control character, it is drawn in \fB^\fR\fIX\fR notation. Calling \fBwinch\fR after adding a control character does not return the character itself, but instead returns the ^-representation of the control character. @@ -95,6 +98,7 @@ Video attributes can be combined with a character argument passed to using \fBinch\fR 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 \fBaddch\fR followed by a call to \fBrefresh\fR, or a call to \fBwaddch\fR