diff options
Diffstat (limited to 'upstream/debian-unstable/man3/outopts.3ncurses')
| -rw-r--r-- | upstream/debian-unstable/man3/outopts.3ncurses | 40 |
1 files changed, 15 insertions, 25 deletions
diff --git a/upstream/debian-unstable/man3/outopts.3ncurses b/upstream/debian-unstable/man3/outopts.3ncurses index f5309159..3397493a 100644 --- a/upstream/debian-unstable/man3/outopts.3ncurses +++ b/upstream/debian-unstable/man3/outopts.3ncurses @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_outopts.3x,v 1.56 2024/01/05 21:46:58 tom Exp $ -.TH outopts 3NCURSES 2024-01-05 "ncurses 6.4" "Library calls" +.\" $Id: curs_outopts.3x,v 1.64 2024/04/20 21:24:19 tom Exp $ +.TH outopts 3NCURSES 2024-04-20 "ncurses 6.5" "Library calls" .de bP .ie n .IP \(bu 4 .el .IP \(bu 2 @@ -143,7 +143,7 @@ and \fBERR\fP upon failure. All other routines that return an integer always return \fBOK\fP. .PP -X/Open Curses does not define any error conditions. +X/Open Curses does not specify any error conditions. .PP In this implementation, .bP @@ -151,11 +151,8 @@ those functions that have a window pointer will return an error if the window pointer is null .bP \fBwsetscrreg\fP -returns an error if the scrolling region limits extend outside the window. -.PP -X/Open does not define any error conditions. -This implementation returns an error -if the window pointer is null. +returns an error if the scrolling region limits extend outside the +window boundaries. .SH NOTES Note that \fBclearok\fP, @@ -167,21 +164,7 @@ Note that The \fBimmedok\fP routine is useful for windows that are used as terminal emulators. .SH PORTABILITY -These functions are described in the XSI Curses standard, Issue 4. -.PP -From the outset, -\fI\%ncurses\fP used \fBnl\fP/\fBnonl\fP to control the conversion of -newlines to carriage return/line-feed on output as well as input. -XSI Curses documents only the use of these functions for input. -This difference arose from converting the \fIpcurses\fP source -(which used \fBioctl\fP calls with the \fBsgttyb\fP structure) -to termios (i.e., the POSIX terminal interface). -In the former, both input and output were controlled via a single -option \fBCRMOD\fP, -while the latter separates these features. -Because that conversion interferes with output optimization, -\fBnl\fP/\fBnonl\fP were amended after \fI\%ncurses\fP 6.2 -to eliminate their effect on output. +These functions are described in X/Open Curses, Issue 4. .PP Some historic curses implementations had, as an undocumented feature, the ability to do the equivalent of \fBclearok(..., 1)\fP by saying @@ -191,14 +174,21 @@ This will not work under \fI\%ncurses\fP. Earlier System V curses implementations specified that with \fBscrollok\fP enabled, any window modification triggering a scroll also forced a physical refresh. -XSI Curses does not require this, and \fI\%ncurses\fP avoids doing +X/Open Curses does not require this, and \fI\%ncurses\fP avoids doing it to perform better vertical-motion optimization at \fBwrefresh\fP time. .PP -The XSI Curses standard does not mention that the cursor should be +X/Open Curses does not mention that the cursor should be made invisible as a side-effect of \fBleaveok\fP. SVr4 curses documentation does this, but the code does not. Use \fBcurs_set\fP to make the cursor invisible. +.SH HISTORY +.I \%ncurses +formerly treated \fB\%nl\fP(3NCURSES) and \fB\%nonl\fP(3NCURSES) as both input +.I and +output options, +but no longer; +see \fB\%inopts\fP(3NCURSES). .SH SEE ALSO \fB\%ncurses\fP(3NCURSES), \fB\%addch\fP(3NCURSES), |