X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fresizeterm.3x.html;h=ebf6c55ccfd626380e62edcd4d469d83cc33c4c6;hp=638d50456a0354e908aabd7f10b265a75cf3dadd;hb=HEAD;hpb=d79ff7b4d5f5ac63e7d9d7e76706d95a1ddb243c diff --git a/doc/html/man/resizeterm.3x.html b/doc/html/man/resizeterm.3x.html index 638d5045..23491462 100644 --- a/doc/html/man/resizeterm.3x.html +++ b/doc/html/man/resizeterm.3x.html @@ -1,6 +1,6 @@
-resizeterm(3x) Library calls resizeterm(3x) @@ -48,8 +48,8 @@
- is_term_resized, resize_term, resizeterm - change the curses terminal - size + is_term_resized, resize_term, resizeterm - manage the terminal + dimensions understood by curses
@@ -61,21 +61,21 @@
- This is an extension to the curses library. It provides callers with a - hook into the ncurses data to resize windows, primarily for use by + This is an extension to the curses library. It provides callers with a + hook into the ncurses data to resize windows, primarily for use by programs running in an X Window terminal (e.g., xterm) when the terminal's screen size is changed by the user: - o Curses windows cannot extend outside the screen. If the terminal - is shrunk, curses windows must be shrunk to fit. + o curses windows cannot extend outside the screen. If the terminal + is shrunk, curses windows must be shrunk to fit. o If the terminal is stretched, rows and/or columns can be added to existing windows. The added cells should match the current attributes of the windows. If the calling program has not set up a handler for SIGWINCH when it - initializes ncurses (e.g., using initscr(3x) or newterm(3x)), then - ncurses sets a handler for SIGWINCH which notifies the library when a + initializes ncurses (e.g., using initscr(3x) or newterm(3x)), then + ncurses sets a handler for SIGWINCH which notifies the library when a window-size event has occurred. The library checks for this notification @@ -99,7 +99,7 @@
The function resizeterm resizes the standard and current windows (i.e., stdscr and curscr) to the specified dimensions, and adjusts other - bookkeeping data used by the ncurses library that record the window + bookkeeping data used by the ncurses library that record the window dimensions such as the LINES and COLS variables. @@ -144,7 +144,7 @@ them in a context where malloc or realloc may have been interrupted, since it uses those functions. - If ncurses is configured to supply its own SIGWINCH handler, + If ncurses is configured to supply its own SIGWINCH handler, o on receipt of a SIGWINCH, the handler sets a flag @@ -161,38 +161,38 @@ Calling resizeterm or resize_term directly from a signal handler is unsafe. This indirect method is used to provide a safe way to - resize the ncurses data structures. + resize the ncurses data structures. - If the environment variables LINES or COLUMNS are set, this overrides + If the environment variables LINES or COLUMNS are set, this overrides the library's use of the window size obtained from the operating system. Thus, even if a SIGWINCH is received, no screen size change may be recorded.
- It is possible to resize the screen with SVr4 curses, by + It is possible to resize the screen with SVr4 curses, by - o exiting curses with endwin(3x) and + o exiting curses with endwin(3x) and o resuming using refresh(3x). Doing that clears the screen and is visually distracting. - This extension of ncurses was introduced in mid-1995. It was adopted - in NetBSD curses (2001) and PDCurses (2003). + This extension of ncurses was introduced in mid-1995. It was adopted + in NetBSD curses (2001) and PDCurses (2003). -
- curs_getch(3x), curs_variables(3x), wresize(3x). +
+ Thomas Dickey (from an equivalent function written in 1988 for BSD + curses) -
- Thomas Dickey (from an equivalent function written in 1988 for BSD - curses). +
+ curs_getch(3x), curs_variables(3x), wresize(3x) -ncurses 6.4 2023-07-01 resizeterm(3x) +ncurses 6.5 2024-03-16 resizeterm(3x)