Changeset 4220 for trunk/lispref/display.texi

Timestamp:

2008年04月04日 22時04分40秒 (8 months ago)

Author:

miyoshi

Message:

Sync up with Emacs22.2.

Files:

• trunk/lispref/display.texi (modified) (14 diffs)

trunk/lispref/display.texi

@@ -2 +2 @@
-@c This is part of the GNU Emacs Lisp Reference Manual.
-@c Copyright (C) 1990, 1991, 1992, 1993, 1994, 1995, 1998, 1999, 2000, 2001,
-
+, 2008
-@c See the file elisp.texi for copying conditions.
-@setfilename ../info/display
@@ -56 +56 @@
-@end deffn
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
-
-  Normally, suspending and resuming Emacs also refreshes the screen.
@@ -90 +79 @@
-@cindex forcing redisplay
-
+  Emacs normally tries to redisplay the screen whenever it waits for
+input.  With this function you can request an immediate attempt to
+redisplay, in the middle of Lisp code, without actually waiting for
+input.
+
+@defun redisplay &optional force
+This function tries immediately to redisplay, provided there are no
+pending input events.  It is equivalent to @code{(sit-for 0)}.
+
+If the optional argument @var{force} is non-@code{nil}, it does all
+pending redisplay work even if input is available, with no
+pre-emption.
+
+The function returns @code{t} if it actually tried to redisplay, and
+@code{nil} otherwise.  A value of @code{t} does not mean that
+redisplay proceeded to completion; it could have been pre-empted by
+newly arriving terminal input.
+@end defun
+
+  @code{redisplay} with no argument tries immediately to redisplay,
+but has no effect on the usual rules for what parts of the screen to
+redisplay.  By contrast, the following function adds certain windows
+to the pending redisplay work (as if their contents had completely
+changed), but doesn't immediately try to do any redisplay work.
+
+@defun force-window-update &optional object
+This function forces some or all windows to be updated on next
+redisplay.  If @var{object} is a window, it requires eventual
+redisplay of that window.  If @var{object} is a buffer or buffer name,
+it requires eventual redisplay of all windows displaying that buffer.
+If @var{object} is @code{nil} (or omitted), it requires eventual
+redisplay of all windows.
+@end defun
+
+  @code{force-window-update} does not do a redisplay immediately.
+(Emacs will do that when it waits for input.)  Rather, its effect is
+to put more work on the queue to be done by redisplay whenever there
+is a chance.
+
-  Emacs redisplay normally stops if input arrives, and does not happen
-at all if input is available before it starts.  Most of the time, this
-is exactly what you want.  However, you can prevent preemption by
-binding @code{redisplay-dont-pause} to a non-@code{nil} value.
+
+@defvar redisplay-dont-pause
+If this variable is non-@code{nil}, pending input does not
+prevent or halt redisplay; redisplay occurs, and finishes,
+regardless of whether input is available.
+@end defvar
-
-@defvar redisplay-preemption-period
@@ -107 +141 @@
-text terminals, see @ref{Terminal Output}.
-@end defvar
-
-@defvar redisplay-dont-pause
-If this variable is non-@code{nil}, pending input does not
-prevent or halt redisplay; redisplay occurs, and finishes,
-regardless of whether input is available.
-@end defvar
-
-@defun redisplay &optional force
-This function performs an immediate redisplay provided there are no
-pending input events.  This is equivalent to @code{(sit-for 0)}.
-
-If the optional argument @var{force} is non-@code{nil}, it forces an
-immediate and complete redisplay even if input is available.
-
-Returns @code{t} if redisplay was performed, or @code{nil} otherwise.
-@end defun
-
-@node Truncation
@@ -1719 +1737 @@
-@defun facep object
-This function returns @code{t} if @var{object} is a face name string
-
-
+
-@end defun
-
@@ -1760 +1777 @@
-@var{spec}, then uses any customizations that were read from the
-init file (@pxref{Init File}) to override that specification.
+
+When you evaluate a @code{defface} form with @kbd{C-M-x} in Emacs
+Lisp mode (@code{eval-defun}), a special feature of @code{eval-defun}
+overrides any customizations of the face.  This way, the face reflects
+exactly what the @code{defface} says.
-
-The purpose of @var{spec} is to specify how the face should appear on
@@ -2507 +2529 @@
-
-  This hook is used for automatically assigning faces to text in the
-
+
+
-
-@defvar fontification-functions
@@ -3232 +3255 @@
-displays.  The value of the @code{display} property should be a
-display specification, or a list or vector containing several display
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-
-@smallexample
@@ -3268 +3323 @@
-  (dotimes (i 5)
-    (let ((string (concat "A")))
-2+
++ 2
-      (put-text-property (point) (1+ (point)) 'display string)
-      (forward-char 2))))
@@ -3279 +3334 @@
-whether they got this property from a single call to
-@code{put-text-property} or from two different calls.
-
-  The rest of this section describes several kinds of
-display specifications and what they mean.
-
-@menu
-* Specified Space::      Displaying one space with a specified width.
-* Pixel Specification::  Specifying space width or height in pixels.
-* Other Display Specs::  Displaying an image; magnifying text; moving it
-                          up or down on the page; adjusting the width
-                          of spaces within text.
-* Display Margins::     Displaying text or images to the side of the main text.
-@end menu
-
-@node Specified Space
@@ -3530 +3573 @@
-@cindex margins, display
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-
-  Before the display margins can display anything, you must give
@@ -3644 +3690 @@
-@end defvar
-
-
-
-
+
-This function returns non-@code{nil} if image type @var{type} is
-available, i.e., if images of this type can be loaded and displayed in
@@ -4276 +4320 @@
-@cindex image cache
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-
-@defvar image-cache-eviction-delay
@@ -4293 +4367 @@
-debugging.
-@end defvar
-
-@defun clear-image-cache &optional frame
-This function clears the image cache.  If @var{frame} is non-@code{nil},
-only the cache for that frame is cleared.  Otherwise all frames' caches
-are cleared.
-@end defun
-
-@node Buttons