X-Git-Url: http://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=man%2Fcurs_initscr.3x;h=fcb73d677f53ff02b36fe4f9295b55078b859390;hp=ea9c516a4f0ae006a6dada11b879d07f35028502;hb=d90067f9008bb8338a77c1ed519bc108c275ed04;hpb=b97ea58e03d5faebed2166faa4e0e590f2cdea34 diff --git a/man/curs_initscr.3x b/man/curs_initscr.3x index ea9c516a..fcb73d67 100644 --- a/man/curs_initscr.3x +++ b/man/curs_initscr.3x @@ -27,8 +27,8 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_initscr.3x,v 1.56 2023/12/03 00:09:54 tom Exp $ -.TH curs_initscr 3X 2023-12-02 "ncurses 6.4" "Library calls" +.\" $Id: curs_initscr.3x,v 1.59 2023/12/17 23:56:04 tom Exp $ +.TH curs_initscr 3X 2023-12-17 "ncurses 6.4" "Library calls" .ie \n(.g \{\ .ds `` \(lq .ds '' \(rq @@ -181,7 +181,7 @@ X/Open specifies that portable applications must not call \fBinitscr\fP more than once: .bP The portable way to use \fBinitscr\fP is once only, -using \fBrefresh\fP (see curs_refresh(3X)) +using \fB\%refresh\fP(3X) to restore the screen after \fBendwin\fP. .bP This implementation allows using \fBinitscr\fP after \fBendwin\fP. @@ -208,14 +208,14 @@ SVr4 curses deletes the standard \fBWINDOW\fP structures \fBstdscr\fP and \fBcurscr\fP as well as a work area \fBnewscr\fP. SVr4 curses ignores other windows. .bP -Since version 4.0 (1996), ncurses has maintained a list of all windows -for each screen, +Since version 4.0 (1996), +\fI\%ncurses\fP has maintained a list of all windows for each screen, using that information to delete those windows when \fBdelscreen\fP is called. .bP -NetBSD copied this feature of ncurses in 2001. +NetBSD copied this feature of \fI\%ncurses\fP in 2001. PDCurses follows the SVr4 model, deleting only the standard \fBWINDOW\fP structures. -.SS High-level versus low-level +.SS "High-level versus Low-level" Different implementations may disagree regarding the level of some functions. For example, \fBSCREEN\fP (returned by \fBnewterm\fP) and \fBTERMINAL\fP (returned by \fBsetupterm\fP(3X)) hold file descriptors for @@ -228,16 +228,16 @@ behavior depending on which structure holds the corresponding descriptor. For example .bP NetBSD's \fBbaudrate\fP(3X) function uses the descriptor in \fBTERMINAL\fP. -\fBncurses\fP and SVr4 use the descriptor in \fBSCREEN\fP. +\fI\%ncurses\fP and SVr4 use the descriptor in \fBSCREEN\fP. .bP -NetBSD and \fBncurses\fP use the descriptor +NetBSD and \fI\%ncurses\fP use the descriptor in \fBTERMINAL\fP for terminal I/O modes, e.g., \fBdef_shell_mode\fP(3X), \fBdef_prog_mode\fP(3X). SVr4 curses uses the descriptor in \fBSCREEN\fP. -.SS Unset TERM Variable +.SS "Unset \fITERM\fP Variable" If the \fITERM\fP variable is missing or empty, \fBinitscr\fP uses the value \*(``unknown\*('', which normally corresponds to a terminal entry with the \fIgeneric\fP @@ -245,7 +245,7 @@ which normally corresponds to a terminal entry with the \fIgeneric\fP Generic entries are detected by \fBsetupterm\fP(3X) and cannot be used for full-screen operation. Other implementations may handle a missing/empty \fITERM\fP variable differently. -.SS Signal Handlers +.SS "Signal Handlers" Quoting from X/Open Curses Issue 7, section 3.1.1: .RS 5 .PP @@ -292,16 +292,16 @@ purpose than \fBSIGQUIT\fP (which is used in debugging). .B SIGTSTP This handles the \fIstop\fP signal, used in job control. When resuming the process, this implementation discards pending -input with \fBflushinput\fP (see curs_util(3X)), and repaints the screen +input with \fB\%flushinp\fP(3X), and repaints the screen assuming that it has been completely altered. -It also updates the saved terminal modes with \fBdef_shell_mode\fP -(see \fBcurs_kernel\fP(3X)). +It also updates the saved terminal modes with +\fB\%def_shell_mode\fP(3X). .TP 5 .B SIGWINCH 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 \fBwgetch\fP (see curs_getch(3X)). +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