Set libc symbol `SIGWINCH` in italics, not bold, just as we would a standard C library (not ncurses) function or other symbol name. --- man/curs_getch.3x | 2 +- man/curs_util.3x | 2 +- man/resizeterm.3x | 27 ++++++++++++++++++++------- 3 files changed, 22 insertions(+), 9 deletions(-)
diff --git a/man/curs_getch.3x b/man/curs_getch.3x index bedad6ded..2dc0d23fc 100644 --- a/man/curs_getch.3x +++ b/man/curs_getch.3x @@ -448,7 +448,7 @@ .SS "Predefined Key Codes" if .I \%ncurses has handled a -.B \%SIGWINCH +.I \%SIGWINCH signal since .B \%wgetch was called; diff --git a/man/curs_util.3x b/man/curs_util.3x index 184514ad1..f6cb6729c 100644 --- a/man/curs_util.3x +++ b/man/curs_util.3x @@ -231,7 +231,7 @@ .SS use_env .IP .I curses also updates the screen size in response to -\fBSIGWINCH\fP, +.IR \%SIGWINCH "," unless overridden by the \fILINES\fP or \fI\%COLUMNS\fP environment variables, .SS use_tioctl diff --git a/man/resizeterm.3x b/man/resizeterm.3x index dcfc599d9..f67bd7af7 100644 --- a/man/resizeterm.3x +++ b/man/resizeterm.3x @@ -86,9 +86,13 @@ .SH DESCRIPTION When the library has found that the terminal's window-size has changed, it calls \fB\%resizeterm\fP to update its data structures. .PP -An application which establishes its own \fB\%SIGWINCH\fP handler +An application which establishes its own +.I \%SIGWINCH +handler can call \fB\%resizeterm\fP, but in that case, the library will not -see \fB\%SIGWINCH\fP, and proper layout will rely upon the application. +see +.IR \%SIGWINCH "," +and proper layout will rely upon the application. .SS resizeterm The function \fB\%resizeterm\fP resizes the standard and current windows (i.e., \fB\%stdscr\fP and \fB\%curscr\fP) @@ -99,7 +103,9 @@ .SS resize_term Most of the work for \fB\%resizeterm\fP is done by the inner function \fB\%resize_term\fP. The outer function \fB\%resizeterm\fP adds bookkeeping -for the \fB\%SIGWINCH\fP handler, +for the +.I \%SIGWINCH +handler, as well as repainting the soft-key area (see \fB\%slk_touch\fP(3X)). .PP The \fB\%resize_term\fP function attempts to resize all windows. @@ -132,14 +138,19 @@ .SH RETURN VALUE or if an error occurs while (re)allocating memory for the windows. .SH NOTES While these functions are intended to be used to support a signal handler -(i.e., for \fB\%SIGWINCH\fP), care should be taken to avoid invoking them in a +(i.e., for +.IR \%SIGWINCH ")," +care should be taken to avoid invoking them in a context where \fB\%malloc\fP or \fB\%realloc\fP may have been interrupted, since it uses those functions. .PP -If \fI\%ncurses\fP is configured to supply its own \fB\%SIGWINCH\fP +If \fI\%ncurses\fP is configured to supply its own +.I \%SIGWINCH handler, .bP -on receipt of a \fB\%SIGWINCH\fP, the handler sets a flag +on receipt of a +.IR \%SIGWINCH "," +the handler sets a flag .bP which is tested in \fB\%wgetch\fP(3X), @@ -163,7 +174,9 @@ .SH NOTES If the environment variables \fILINES\fP or \fI\%COLUMNS\fP are set, this overrides the library's use of the window size obtained from the operating system. -Thus, even if a \fB\%SIGWINCH\fP is received, +Thus, even if a +.I \%SIGWINCH +is received, no screen size change may be recorded. .SH PORTABILITY It is possible to resize the screen with SVr4 \fIcurses\fP, -- 2.30.2
signature.asc
Description: PGP signature
