[Emacs-diffs] Changes to emacs/lispref/display.texi,v

[Eli Zaretskii]

CVSROOT:        /cvsroot/emacs
Module name:    emacs
Changes by:     Eli Zaretskii <eliz>    06/07/08 18:11:49

Index: display.texi
===================================================================
RCS file: /cvsroot/emacs/emacs/lispref/display.texi,v
retrieving revision 1.226
retrieving revision 1.227
diff -u -b -r1.226 -r1.227
--- display.texi        7 Jul 2006 13:31:23 -0000       1.226
+++ display.texi        8 Jul 2006 18:11:49 -0000       1.227
@@ -94,7 +94,6 @@
 is exactly what you want.  However, you can prevent preemption by
 binding @code{redisplay-dont-pause} to a address@hidden value.
 
address@hidden redisplay-preemption-period
 @defvar redisplay-preemption-period
 This variable specifies how many seconds Emacs waits between checks
 for new input during redisplay.  (The default is 0.1 seconds.)  If
@@ -108,14 +107,13 @@
 with support for sub-second timers.
 @end defvar
 
address@hidden redisplay-dont-pause
 @defvar redisplay-dont-pause
 If this variable is address@hidden, pending input does not
 prevent or halt redisplay; redisplay occurs, and finishes,
 regardless of whether input is available.
 @end defvar
 
address@hidden sit-for
address@hidden sit-for
   You can request a display update, but only if no input is pending,
 with @code{(sit-for 0)}.  To force a display update even when input is
 pending, use @code{(sit-for -1)}.
@@ -257,7 +255,6 @@
 depending on its size, use @code{display-message-or-buffer} (see below).
 @end defun
 
address@hidden with-temp-message
 @defmac with-temp-message message &rest body
 This construct displays a message in the echo area temporarily, during
 the execution of @var{body}.  It displays @var{message}, executes
@@ -288,7 +285,6 @@
 @end defun
 
 @defun display-message-or-buffer message &optional buffer-name not-this-window 
frame
address@hidden display-message-or-buffer
 This function displays the message @var{message}, which may be either a
 string or a buffer.  If it is shorter than the maximum height of the
 echo area, as defined by @code{max-mini-window-height}, it is displayed
@@ -1027,7 +1023,6 @@
 @end defvar
 
 @defvar temp-buffer-setup-hook
address@hidden temp-buffer-setup-hook
 This normal hook is run by @code{with-output-to-temp-buffer} before
 evaluating @var{body}.  When the hook runs, the temporary buffer is
 current.  This hook is normally set up with a function to put the
@@ -2055,7 +2050,6 @@
 otherwise, they affect all frames as well as the defaults that apply to
 new frames.
 
address@hidden set-face-attribute
 @defun set-face-attribute face frame &rest arguments
 This function sets one or more attributes of face @var{face}
 for frame @var{frame}.  If @var{frame} is @code{nil}, it sets
@@ -2078,7 +2072,6 @@
 to the corresponding values.
 @end defun
 
address@hidden face-attribute
 @defun face-attribute face attribute &optional frame inherit
 This returns the value of the @var{attribute} attribute of face
 @var{face} on @var{frame}.  If @var{frame} is @code{nil},
@@ -2114,7 +2107,6 @@
 with older Emacs versions, you can use the following functions to set
 and examine the face attributes which existed in those versions.
 
address@hidden face-attribute-relative-p
 @defun face-attribute-relative-p attribute value
 This function returns address@hidden if @var{value}, when used as the
 value of the face attribute @var{attribute}, is relative.  This means
@@ -2134,7 +2126,6 @@
 prompts with @samp{Describe face (default = `default' face): }.
 @end defun
 
address@hidden merge-face-attribute
 @defun merge-face-attribute attribute value1 value2
 If @var{value1} is a relative value for the face attribute
 @var{attribute}, returns it merged with the underlying value
@@ -2323,7 +2314,6 @@
 try.
 
 @defvar face-font-selection-order
address@hidden face-font-selection-order
 This variable specifies the order of importance of the face attributes
 @code{:width}, @code{:height}, @code{:weight}, and @code{:slant}.  The
 value should be a list containing those four symbols, in order of
@@ -2353,7 +2343,6 @@
 @end defvar
 
 @defvar face-font-family-alternatives
address@hidden face-font-family-alternatives
 This variable lets you specify alternative font families to try, if a
 given family is specified and doesn't exist.  Each element should have
 this form:
@@ -2368,7 +2357,6 @@
 @end defvar
 
 @defvar face-font-registry-alternatives
address@hidden face-font-registry-alternatives
 This variable lets you specify alternative font registries to try, if a
 given registry is specified and doesn't exist.  Each element should have
 this form:
@@ -2387,7 +2375,6 @@
 XFree86 servers.
 
 @defvar scalable-fonts-allowed
address@hidden scalable-fonts-allowed
 This variable controls which scalable fonts to use.  A value of
 @code{nil}, the default, means do not use scalable fonts.  @code{t}
 means to use any scalable font that seems appropriate for the text.
@@ -2488,7 +2475,6 @@
   This hook is used for automatically assigning faces to text in the
 buffer.  It is part of the implementation of Font-Lock mode.
 
address@hidden fontification-functions
 @defvar fontification-functions
 This variable holds a list of functions that are called by Emacs
 redisplay as needed to assign faces automatically to text in the buffer.
@@ -2538,7 +2524,6 @@
 @end defun
 
 @defun x-family-fonts &optional family frame
address@hidden x-family-fonts
 This function returns a list describing the available fonts for family
 @var{family} on @var{frame}.  If @var{family} is omitted or @code{nil},
 this list applies to all families, and therefore, it contains all
@@ -2569,7 +2554,6 @@
 @end defun
 
 @defun x-font-family-list &optional frame
address@hidden x-font-family-list
 This function returns a list of the font families available for
 @var{frame}'s display.  If @var{frame} is omitted or @code{nil}, it
 describes the selected frame's display (@pxref{Input Focus}).
@@ -2586,7 +2570,6 @@
 @end defun
 
 @defvar font-list-limit
address@hidden font-list-limit
 This variable specifies maximum number of fonts to consider in font
 matching.  The function @code{x-family-fonts} will not return more than
 that many fonts, and font selection will consider only that many fonts
@@ -2803,7 +2786,6 @@
 continued lines, buffer boundaries, overlay arrow, etc.
 
 @defopt indicate-empty-lines
address@hidden indicate-empty-lines
 @cindex fringes, and empty line indication
 When this is address@hidden, Emacs displays a special glyph in the
 fringe of each empty line at the end of the buffer, on graphical
@@ -3533,13 +3515,11 @@
 variables:
 
 @defvar left-margin-width
address@hidden left-margin-width
 This variable specifies the width of the left margin.
 It is buffer-local in all buffers.
 @end defvar
 
 @defvar right-margin-width
address@hidden right-margin-width
 This variable specifies the width of the right margin.
 It is buffer-local in all buffers.
 @end defvar
@@ -3552,14 +3532,12 @@
   You can also set the margin widths immediately.
 
 @defun set-window-margins window left &optional right
address@hidden set-window-margins
 This function specifies the margin widths for window @var{window}.
 The argument @var{left} controls the left margin and
 @var{right} controls the right margin (default @code{0}).
 @end defun
 
 @defun window-margins &optional window
address@hidden window-margins
 This function returns the left and right margins of @var{window}
 as a cons cell of the form @code{(@var{left} . @var{right})}.
 If @var{window} is @code{nil}, the selected window is used.
@@ -3842,7 +3820,6 @@
 @end table
 
 @defun image-mask-p spec &optional frame
address@hidden image-mask-p
 This function returns @code{t} if image @var{spec} has a mask bitmap.
 @var{frame} is the frame on which the image will be displayed.
 @var{frame} @code{nil} or omitted means to use the selected frame
@@ -4026,7 +4003,6 @@
 @code{find-image} provide convenient ways to create image descriptors.
 
 @defun create-image file-or-data &optional type data-p &rest props
address@hidden create-image
 This function creates and returns an image descriptor which uses the
 data in @var{file-or-data}.  @var{file-or-data} can be a file name or
 a string containing the image data; @var{data-p} should be @code{nil}
@@ -4049,7 +4025,6 @@
 @end defun
 
 @defmac defimage symbol specs &optional doc
address@hidden defimage
 This macro defines @var{symbol} as an image name.  The arguments
 @var{specs} is a list which specifies how to display the image.
 The third argument, @var{doc}, is an optional documentation string.
@@ -4078,7 +4053,6 @@
 @end defmac
 
 @defun find-image specs
address@hidden find-image
 This function provides a convenient way to find an image satisfying one
 of a list of image specifications @var{specs}.
 
@@ -4096,7 +4070,6 @@
 @end defun
 
 @defvar image-load-path
address@hidden image-load-path
 This variable's value is a list of locations in which to search for
 image files.  If an element is a string or a variable symbol whose
 value is a string, the string is taken to be the name of a directory
@@ -4118,7 +4091,6 @@
 @end defvar
 
 @defun image-load-path-for-library library image &optional path no-error
address@hidden image-load-path-for-library
 This function returns a suitable search path for images used by the
 Lisp package @var{library}.
 
@@ -4225,7 +4197,6 @@
 @end defun
 
 @defun image-size spec &optional pixels frame
address@hidden image-size
 This function returns the size of an image as a pair
 @address@hidden(@var{width} . @var{height})}}.  @var{spec} is an image
 specification.  @var{pixels} address@hidden means return sizes
@@ -4237,7 +4208,6 @@
 @end defun
 
 @defvar max-image-size
address@hidden max-image-size
 This variable is used to define the maximum size of image that Emacs
 will load.  Emacs will refuse to load (and display) any image that is
 larger than this limit.
@@ -4267,7 +4237,6 @@
 all images with equal specifications share the same image in the cache.
 
 @defvar image-cache-eviction-delay
address@hidden image-cache-eviction-delay
 This variable specifies the number of seconds an image can remain in the
 cache without being displayed.  When an image is not displayed for this
 length of time, Emacs removes it from the image cache.
@@ -4278,7 +4247,6 @@
 @end defvar
 
 @defun clear-image-cache &optional frame
address@hidden clear-image-cache
 This function clears the image cache.  If @var{frame} is address@hidden,
 only the cache for that frame is cleared.  Otherwise all frames' caches
 are cleared.
@@ -4400,7 +4368,6 @@
 specific tasks.
 
 @defun define-button-type name &rest properties
address@hidden define-button-type
 Define a `button type' called @var{name}.  The remaining arguments
 form a sequence of @var{property value} pairs, specifying default
 property values for buttons with this type (a button's type may be set
@@ -4449,13 +4416,11 @@
 (@pxref{Overlays}) to hold the button properties:
 
 @defun make-button beg end &rest properties
address@hidden make-button
 This makes a button from @var{beg} to @var{end} in the
 current buffer, and returns it.
 @end defun
 
 @defun insert-button label &rest properties
address@hidden insert-button
 This insert a button with the label @var{label} at point,
 and returns it.
 @end defun
@@ -4469,13 +4434,11 @@
 of the new button:
 
 @defun make-text-button beg end &rest properties
address@hidden make-text-button
 This makes a button from @var{beg} to @var{end} in the current buffer, using
 text properties.
 @end defun
 
 @defun insert-text-button label &rest properties
address@hidden insert-text-button
 This inserts a button with the label @var{label} at point, using text
 properties.
 @end defun
@@ -4495,27 +4458,22 @@
 invocation function when it is invoked.
 
 @defun button-start button
address@hidden button-start
 Return the position at which @var{button} starts.
 @end defun
 
 @defun button-end button
address@hidden button-end
 Return the position at which @var{button} ends.
 @end defun
 
 @defun button-get button prop
address@hidden button-get
 Get the property of button @var{button} named @var{prop}.
 @end defun
 
 @defun button-put button prop val
address@hidden button-put
 Set @var{button}'s @var{prop} property to @var{val}.
 @end defun
 
 @defun button-activate button &optional use-mouse-action
address@hidden button-activate
 Call @var{button}'s @code{action} property (i.e., invoke it).  If
 @var{use-mouse-action} is address@hidden, try to invoke the button's
 @code{mouse-action} property instead of @code{action}; if the button
@@ -4523,38 +4481,31 @@
 @end defun
 
 @defun button-label button
address@hidden button-label
 Return @var{button}'s text label.
 @end defun
 
 @defun button-type button
address@hidden button-type
 Return @var{button}'s button-type.
 @end defun
 
 @defun button-has-type-p button type
address@hidden button-has-type-p
 Return @code{t} if @var{button} has button-type @var{type}, or one of
 @var{type}'s subtypes.
 @end defun
 
 @defun button-at pos
address@hidden button-at
 Return the button at position @var{pos} in the current buffer, or @code{nil}.
 @end defun
 
 @defun button-type-put type prop val
address@hidden button-type-put
 Set the button-type @var{type}'s @var{prop} property to @var{val}.
 @end defun
 
 @defun button-type-get type prop
address@hidden button-type-get
 Get the property of button-type @var{type} named @var{prop}.
 @end defun
 
 @defun button-type-subtype-p type supertype
address@hidden button-type-subtype-p
 Return @code{t} if button-type @var{type} is a subtype of @var{supertype}.
 @end defun
 
@@ -4580,7 +4531,6 @@
 @xref{Links and Mouse-1}.
 
 @deffn Command push-button &optional pos use-mouse-action
address@hidden push-button
 Perform the action specified by a button at location @var{pos}.
 @var{pos} may be either a buffer position or a mouse-event.  If
 @var{use-mouse-action} is address@hidden, or @var{pos} is a
@@ -4594,7 +4544,6 @@
 @end deffn
 
 @deffn Command forward-button n &optional wrap display-message
address@hidden forward-button
 Move to the @var{n}th next button, or @var{n}th previous button if
 @var{n} is negative.  If @var{n} is zero, move to the start of any
 button at point.  If @var{wrap} is address@hidden, moving past either
@@ -4605,7 +4554,6 @@
 @end deffn
 
 @deffn Command backward-button n &optional wrap display-message
address@hidden backward-button
 Move to the @var{n}th previous button, or @var{n}th next button if
 @var{n} is negative.  If @var{n} is zero, move to the start of any
 button at point.  If @var{wrap} is address@hidden, moving past either
@@ -4616,14 +4564,12 @@
 @end deffn
 
 @defun next-button pos &optional count-current
address@hidden next-button
 Return the next button after position @var{pos} in the current buffer.
 If @var{count-current} is address@hidden, count any button at
 @var{pos} in the search, instead of starting at the next button.
 @end defun
 
 @defun previous-button pos &optional count-current
address@hidden previous-button
 Return the @var{n}th button before position @var{pos} in the current
 buffer.  If @var{count-current} is address@hidden, count any button at
 @var{pos} in the search, instead of starting at the next button.
@@ -5216,13 +5162,11 @@
 @end defun
 
 @defun describe-display-table display-table
address@hidden describe-display-table
 This function displays a description of the display table
 @var{display-table} in a help buffer.
 @end defun
 
 @deffn Command describe-current-display-table
address@hidden describe-current-display-table
 This command displays a description of the current display table in a
 help buffer.
 @end deffn
@@ -5328,7 +5272,6 @@
 @end table
 
 @defun create-glyph string
address@hidden create-glyph
 This function returns a newly-allocated glyph code which is set up to
 display by sending @var{string} to the terminal.
 @end defun