~ubuntu-branches/debian/sid/ncurses/sid

« back to all changes in this revision

Viewing changes to man/resizeterm.3x

  • Committer: Package Import Robot
  • Author(s): Sven Joachim
  • Date: 2015-08-17 18:01:53 UTC
  • mfrom: (1.32.11)
  • Revision ID: package-import@ubuntu.com-20150817180153-ywf02awpkuzvqwdv
Tags: 6.0+20150810-1
* New upstream release.
  - Fix comparison against "/usr/include" in misc/gen-pkgconfig.in
    (Closes: #790548).
* Configure with "--with-abi-version=5", upstream defaults to abi 6 now.
* Configure with "--with-versioned-syms" (Closes: #788610).
  - Bump minimal versions of all symbols as well as shlibs to 6.
* After building the wide library, install it into a temporary
  scratchdir so that test/configure can find the necessary auxiliary
  files (see #786436).
* Drop the libncursesw5-dev build-dependency.

Show diffs side-by-side

added added

removed removed

Lines of Context:
28
28
.\"
29
29
.\" Author: Thomas E. Dickey 1996-on
30
30
.\"
31
 
.\" $Id: resizeterm.3x,v 1.18 2015/04/11 10:23:49 tom Exp $
 
31
.\" $Id: resizeterm.3x,v 1.19 2015/06/06 23:38:18 tom Exp $
32
32
.TH resizeterm 3X ""
33
33
.SH NAME
34
34
\fBis_term_resized\fR,
43
43
.br
44
44
\fBint resizeterm(int lines, int columns);\fR
45
45
.SH DESCRIPTION
 
46
.PP
46
47
This is an extension to the curses library.
47
48
It provides callers with a hook into the \fBncurses\fR data to resize windows,
48
49
primarily for use by programs running in an X Window terminal (e.g., xterm).
 
50
.SS resizeterm
 
51
.PP
49
52
The function \fBresizeterm\fR resizes the standard and current windows
50
53
to the specified dimensions, and adjusts other bookkeeping data used by
51
54
the \fBncurses\fR library that record the window dimensions
52
55
such as the \fBLINES\fP and \fBCOLS\fP variables.
53
 
.LP
 
56
.SS resize_term
 
57
.PP
54
58
Most of the work is done by the inner function \fBresize_term\fR.
55
59
The outer function \fBresizeterm\fR adds bookkeeping for the SIGWINCH handler.
56
60
When resizing the windows,
60
64
However, due to the calling convention of pads,
61
65
it is not possible to resize these
62
66
without additional interaction with the application.
63
 
.LP
 
67
.SS is_term_resized
 
68
.PP
64
69
A support function \fBis_term_resized\fR is provided so that applications
65
70
can check if the \fBresize_term\fR function would modify the window structures.
66
71
It returns \fBTRUE\fP if the windows would be modified, and \fBFALSE\fP otherwise.