X-Git-Url: http://ncurses.scripts.mit.edu/?a=blobdiff_plain;f=man%2Fcurs_initscr.3x;h=5a54c41f4a56429e2f7e04302ea6b23db79e967a;hb=HEAD;hp=0f460af14eee2c2b7acea94491409a335d7d3a4b;hpb=00dd248b527ad47f0fc3b0776a0889da0ac926d0;p=ncurses.git diff --git a/man/curs_initscr.3x b/man/curs_initscr.3x index 0f460af1..1e30604a 100644 --- a/man/curs_initscr.3x +++ b/man/curs_initscr.3x @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_initscr.3x,v 1.69 2024/04/20 21:24:19 tom Exp $ -.TH curs_initscr 3X 2024-04-20 "ncurses @NCURSES_MAJOR@.@NCURSES_MINOR@" "Library calls" +.\" $Id: curs_initscr.3x,v 1.75 2024/06/08 20:34:23 tom Exp $ +.TH curs_initscr 3X 2024-06-08 "ncurses @NCURSES_MAJOR@.@NCURSES_MINOR@" "Library calls" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq @@ -155,18 +155,23 @@ Routines that return pointers always return \fBNULL\fP on error. X/Open defines no error conditions. In this implementation .bP -\fBendwin\fP returns an error if +\fBendwin\fP returns +.B ERR +if .RS .bP the terminal was not initialized, or .bP \fBendwin\fP is called more than once without updating the screen, or .bP -\fBreset_shell_mode\fP(3X) returns an error. +\fBreset_shell_mode\fP(3X) return +.BR ERR "." .RE .bP \fBnewterm\fP -returns an error if it cannot allocate the data structures for the screen, +returns +.B ERR +if it cannot allocate the data structures for the screen, or for the top-level windows within the screen, i.e., \fBcurscr\fP, \fBnewscr\fP, or \fBstdscr\fP. @@ -303,10 +308,23 @@ It also updates the saved terminal modes with This handles the window-size changes which were ignored in the standardization efforts. The handler sets a (signal-safe) variable -which is later tested in \fB\%wgetch\fP(3X). -If \fBkeypad\fP has been enabled for the corresponding window, -\fBwgetch\fP returns the key symbol \fBKEY_RESIZE\fP. -At the same time, \fBwgetch\fP calls \fBresizeterm\fP to adjust the +that is later tested by \fB\%wgetch\fP(3X) and \fB\%wget_wch\fP(3X). +.RS +.bP +.B \%wgetch +returns the key code +.BR \%KEY_RESIZE "." +.bP +.B \%wget_wch +returns +.B \%KEY_CODE_YES +and sets its +.I wch +parameter to +.BR \%KEY_RESIZE "." +.RE +.IP +At the same time, \fI\%ncurses\fP calls \fBresizeterm\fP to adjust the standard screen \fBstdscr\fP, and update other data such as \fBLINES\fP and \fBCOLS\fP. .SH SEE ALSO