@c -*-texinfo-*-
@c This is part of the XEmacs Lisp Reference Manual.
-@c Copyright (C) 1990, 1991, 1992, 1993, 1994, 1998 Free Software Foundation, Inc.
+@c Copyright (C) 1990, 1991, 1992, 1993, 1994, 1998 Free Software Foundation, Inc.
@c See the file lispref.texi for copying conditions.
@setfilename ../../info/display.info
@node Display, Hash Tables, Annotations, Top
The function @code{redraw-frame} redisplays the entire contents of a
given frame. @xref{Frames}.
-@c Emacs 19 feature
-@defun redraw-frame frame
+@defun redraw-frame &optional frame no-preempt
This function clears and redisplays frame @var{frame}.
+
+@var{frame} defaults to the selected frame if omitted.
+
+Normally, redisplay is preempted as normal if input arrives. However,
+if optional second arg @var{no-preempt} is non-@code{nil}, redisplay
+will not stop for input and is guaranteed to proceed to completion.
@end defun
Even more powerful is @code{redraw-display}:
@code{next-event} or @code{sit-for} is called; however, a display update
will not occur if there is input pending. @xref{Command Loop}.
-@defun force-cursor-redisplay
-This function causes an immediate update of the cursor on the selected
-frame. (This function does not exist in FSF Emacs.)
+@defun force-cursor-redisplay &optional frame
+This function causes an immediate update of the cursor on @var{frame},
+which defaults to the selected frame.
@end defun
@node Truncation
@code{message} primitive, and for echoing keystrokes. It is not the
same as the minibuffer, despite the fact that the minibuffer appears
(when active) in the same place on the screen as the echo area. The
-@cite{XEmacs Reference Manual} specifies the rules for resolving conflicts
+@cite{XEmacs Lisp Reference Manual} specifies the rules for resolving conflicts
between the echo area and the minibuffer for use of that screen space
-(@pxref{Minibuffer,, The Minibuffer, emacs, The XEmacs Reference Manual}).
+(@pxref{Minibuffer,, The Minibuffer, xemacs, The XEmacs Lisp Reference Manual}).
Error messages appear in the echo area; see @ref{Errors}.
You can write output in the echo area by using the Lisp printing
@item @code{progress}---progress indicators like
@samp{Converting... 45%} (not logged by default);
-@item @code{prompt}---prompt-like messages like @samp{Isearch: foo} (not
+@item @code{prompt}---prompt-like messages like @samp{Isearch: foo} (not
logged by default);
-@item @code{command}---helper command messages like @samp{Mark set} (not
+@item @code{command}---helper command messages like @samp{Mark set} (not
logged by default);
@item @code{no-log}---messages that should never be logged
@end itemize
-Several messages may be stacked in the echo area at once. Lisp programs
+Several messages may be stacked in the echo area at once. Lisp programs
may access these messages, or remove them as appropriate, via the
message stack.
If a message remains at the head of the message-stack and
@var{no-restore} is @code{nil}, it will be displayed. The string which
remains in the echo area will be returned, or @code{nil} if the
-message-stack is now empty. If @var{label} is nil, the entire
+message-stack is now empty. If @var{label} is @code{nil}, the entire
message-stack is cleared.
@example
Ordinarily, commands that operate on text or move point do not care
whether the text is invisible. However, the user-level line motion
-commands explicitly ignore invisible newlines.
+commands explicitly ignore invisible newlines. Since this causes a
+slow-down of these commands it is turned off by default, controlled by
+the variable @code{line-move-ignore-invisible}.
@node Selective Display
@section Selective Display
@defvar selective-display
This buffer-local variable enables selective display. This means that
-lines, or portions of lines, may be made invisible.
+lines, or portions of lines, may be made invisible.
@itemize @bullet
@item
good results, but the default is 1, which works on all systems.
@end defvar
-@defun blink-matching-open
+@deffn Command blink-matching-open
This function is the default value of @code{blink-paren-function}. It
assumes that point follows a character with close parenthesis syntax and
moves the cursor momentarily to the matching opening character. If that
@smallexample
@group
(defun interactive-blink-matching-open ()
-@c Do not break this line! -- rms.
-@c The first line of a doc string
-@c must stand alone.
"Indicate momentarily the start of sexp before point."
(interactive)
@end group
(blink-matching-open)))
@end group
@end smallexample
-@end defun
+@end deffn
@node Usual Display
@section Usual Display Conventions
The sound file must be in the Sun/NeXT U-LAW format. @var{sound-name}
should be a symbol, specifying the name of the sound. If @var{volume}
is specified, the sound will be played at that volume; otherwise, the
-value of @var{bell-volume} will be used.
+value of @code{bell-volume} will be used.
@end deffn
@defun play-sound sound &optional volume device