Mercurial > emacs

comparison doc/lispref/display.texi @ 87098:ec0ef12211d9

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Merge from emacs--rel--22 Revision: emacs@sv.gnu.org/emacs--devo--0--patch-943
author Miles Bader <miles@gnu.org>
date Thu, 06 Dec 2007 00:46:18 +0000
parents 591c29778a30
children 107ccd98fa12
comparison
equal deleted inserted replaced
87097:781256628613 87098:ec0ef12211d9
53 53
54 @deffn Command redraw-display 54 @deffn Command redraw-display
55 This function clears and redisplays all visible frames. 55 This function clears and redisplays all visible frames.
56 @end deffn 56 @end deffn
57 57
58 This function calls for redisplay of certain windows, the next time 58 In Emacs, processing user input takes priority over redisplay. If
59 redisplay is done, but does not clear them first. 59 you call these functions when input is available, they don't redisplay
60 60 immediately, but the requested redisplay does happen
61 @defun force-window-update &optional object 61 eventually---after all the input has been processed.
62 This function forces some or all windows to be updated on next redisplay.
63 If @var{object} is a window, it forces redisplay of that window. If
64 @var{object} is a buffer or buffer name, it forces redisplay of all
65 windows displaying that buffer. If @var{object} is @code{nil} (or
66 omitted), it forces redisplay of all windows.
67 @end defun
68
69 Processing user input takes absolute priority over redisplay. If you
70 call these functions when input is available, they do nothing
71 immediately, but a full redisplay does happen eventually---after all the
72 input has been processed.
73 62
74 Normally, suspending and resuming Emacs also refreshes the screen. 63 Normally, suspending and resuming Emacs also refreshes the screen.
75 Some terminal emulators record separate contents for display-oriented 64 Some terminal emulators record separate contents for display-oriented
76 programs such as Emacs and for ordinary sequential display. If you are 65 programs such as Emacs and for ordinary sequential display. If you are
77 using such a terminal, you might want to inhibit the redisplay on 66 using such a terminal, you might want to inhibit the redisplay on
87 76
88 @node Forcing Redisplay 77 @node Forcing Redisplay
89 @section Forcing Redisplay 78 @section Forcing Redisplay
90 @cindex forcing redisplay 79 @cindex forcing redisplay
91 80
81 Emacs normally tries to redisplay the screen whenever it waits for
82 input. With this function you can request an immediate attempt to
83 redisplay, in the middle of Lisp code, without actually waiting for
84 input.
85
86 @defun redisplay &optional force
87 This function tries immediately to redisplay, provided there are no
88 pending input events. It is equivalent to @code{(sit-for 0)}.
89
90 If the optional argument @var{force} is non-@code{nil}, it does all
91 pending redisplay work even if input is available, with no
92 pre-emption.
93
94 The function returns @code{t} if it actually tried to redisplay, and
95 @code{nil} otherwise. A value of @code{t} does not mean that
96 redisplay proceeded to completion; it could have been pre-empted by
97 newly arriving terminal input.
98 @end defun
99
100 @code{redisplay} with no argument tries immediately to redisplay,
101 but has no effect on the usual rules for what parts of the screen to
102 redisplay. By contrast, the following function adds certain windows
103 to the pending redisplay work (as if their contents had completely
104 changed), but doesn't immediately try to do any redisplay work.
105
106 @defun force-window-update &optional object
107 This function forces some or all windows to be updated on next
108 redisplay. If @var{object} is a window, it requires eventual
109 redisplay of that window. If @var{object} is a buffer or buffer name,
110 it requires eventual redisplay of all windows displaying that buffer.
111 If @var{object} is @code{nil} (or omitted), it requires eventual
112 redisplay of all windows.
113 @end defun
114
115 @code{force-window-update} does not do a redisplay immediately.
116 (Emacs will do that when it waits for input.) Rather, its effect is
117 to put more work on the queue to be done by redisplay whenever there
118 is a chance.
119
92 Emacs redisplay normally stops if input arrives, and does not happen 120 Emacs redisplay normally stops if input arrives, and does not happen
93 at all if input is available before it starts. Most of the time, this 121 at all if input is available before it starts. Most of the time, this
94 is exactly what you want. However, you can prevent preemption by 122 is exactly what you want. However, you can prevent preemption by
95 binding @code{redisplay-dont-pause} to a non-@code{nil} value. 123 binding @code{redisplay-dont-pause} to a non-@code{nil} value.
124
125 @defvar redisplay-dont-pause
126 If this variable is non-@code{nil}, pending input does not
127 prevent or halt redisplay; redisplay occurs, and finishes,
128 regardless of whether input is available.
129 @end defvar
96 130
97 @defvar redisplay-preemption-period 131 @defvar redisplay-preemption-period
98 This variable specifies how many seconds Emacs waits between checks 132 This variable specifies how many seconds Emacs waits between checks
99 for new input during redisplay. (The default is 0.1 seconds.) If 133 for new input during redisplay. (The default is 0.1 seconds.) If
100 input has arrived when Emacs checks, it pre-empts redisplay and 134 input has arrived when Emacs checks, it pre-empts redisplay and
104 redisplay, and redisplay cannot be preempted by input. 138 redisplay, and redisplay cannot be preempted by input.
105 139
106 This variable is only obeyed on graphical terminals. For 140 This variable is only obeyed on graphical terminals. For
107 text terminals, see @ref{Terminal Output}. 141 text terminals, see @ref{Terminal Output}.
108 @end defvar 142 @end defvar
109
110 @defvar redisplay-dont-pause
111 If this variable is non-@code{nil}, pending input does not
112 prevent or halt redisplay; redisplay occurs, and finishes,
113 regardless of whether input is available.
114 @end defvar
115
116 @defun redisplay &optional force
117 This function performs an immediate redisplay provided there are no
118 pending input events. This is equivalent to @code{(sit-for 0)}.
119
120 If the optional argument @var{force} is non-@code{nil}, it forces an
121 immediate and complete redisplay even if input is available.
122
123 Returns @code{t} if redisplay was performed, or @code{nil} otherwise.
124 @end defun
125 143
126 @node Truncation 144 @node Truncation
127 @section Truncation 145 @section Truncation
128 @cindex line wrapping 146 @cindex line wrapping
129 @cindex line truncation 147 @cindex line truncation