X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=man%2Fcurs_initscr.3x;h=235a5aa715bbc036b979696cf52f14076bbc2b55;hp=0082b03e855f76c9101f67363d291a3c20adad15;hb=a6eb34d7fec8170a8715f9e53ca2f96452dd30dd;hpb=2560bc3dae7f4919060c02c91a593566c908091c diff --git a/man/curs_initscr.3x b/man/curs_initscr.3x index 0082b03e..235a5aa7 100644 --- a/man/curs_initscr.3x +++ b/man/curs_initscr.3x @@ -1,5 +1,6 @@ .\"*************************************************************************** -.\" Copyright (c) 1998-2016,2017 Free Software Foundation, Inc. * +.\" Copyright 2018,2020 Thomas E. Dickey * +.\" Copyright 1998-2016,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 * @@ -26,10 +27,11 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_initscr.3x,v 1.28 2017/05/30 21:12:51 tom Exp $ +.\" $Id: curs_initscr.3x,v 1.33 2020/10/17 23:20:48 tom Exp $ .TH curs_initscr 3X "" .de bP -.IP \(bu 4 +.ie n .IP \(bu 4 +.el .IP \(bu 2 .. .ie \n(.g .ds `` \(lq .el .ds `` `` @@ -52,10 +54,10 @@ \fBWINDOW *initscr(void);\fR .br \fBint endwin(void);\fR -.br +.sp \fBbool isendwin(void);\fR -.br -\fBSCREEN *newterm(char *\fP\fItype\fP\fB, FILE *\fP\fIoutfd\fP\fB, FILE *\fP\fIinfd\fP\fB);\fR +.sp +\fBSCREEN *newterm(const char *\fP\fItype\fP\fB, FILE *\fP\fIoutfd\fP\fB, FILE *\fP\fIinfd\fP\fB);\fR .br \fBSCREEN *set_term(SCREEN *\fP\fInew\fP\fB);\fR .br @@ -73,7 +75,8 @@ For multiple-terminal applications, .PP The initscr code determines the terminal type and initializes all \fBcurses\fR data structures. -\fBinitscr\fR also causes the first call to \fBrefresh\fR(3X) to clear the screen. +\fBinitscr\fR also causes the first call to \fBrefresh\fR(3X) +to clear the screen. If errors occur, \fBinitscr\fR writes an appropriate error message to standard error and exits; otherwise, a pointer is returned to \fBstdscr\fR. @@ -168,7 +171,8 @@ X/Open specifies that portable applications must not call \fBinitscr\fR more than once: .bP The portable way to use \fBinitscr\fP is once only, -using \fBrefresh\fP (see curs_refresh(3X)) to restore the screen after \fBendwin\fP. +using \fBrefresh\fP (see curs_refresh(3X)) +to restore the screen after \fBendwin\fP. .bP This implementation allows using \fBinitscr\fP after \fBendwin\fP. .PP @@ -182,8 +186,8 @@ If the TERM variable is missing or empty, \fBinitscr\fP uses the value \*(``unknown\*('', which normally corresponds to a terminal entry with the \fIgeneric\fP (\fIgn\fP) capability. -Generic entries are detected by \fBsetupterm\fP (see curs_terminfo(3X)) and cannot be -used for full-screen operation. +Generic entries are detected by \fBsetupterm\fP +(see curs_terminfo(3X)) and cannot be used for full-screen operation. Other implementations may handle a missing/empty TERM variable differently. .SS Signal Handlers .PP @@ -199,7 +203,8 @@ if their disposition is \fBSIG_DFL\fP at the time life of the process or until the process changes the disposition of the signal.\fP .PP -\fINone of the Curses functions are required to be safe with respect to signals \fP... +\fINone of the Curses functions are required to be safe +with respect to signals \fP... .RE .PP This implementation establishes signal handlers during initialization, @@ -232,7 +237,8 @@ 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 assuming that it has been completely altered. -It also updates the saved terminal modes with \fBdef_shell_mode\fP (see curs_kernel(3X)). +It also updates the saved terminal modes with \fBdef_shell_mode\fP +(see \fBcurs_kernel\fR(3X)). .TP 5 .B SIGWINCH This handles the window-size changes which were ignored in