/[emacs]/emacs/lispref/display.texi
ViewVC logotype

Diff of /emacs/lispref/display.texi

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1.187 by cyd, Sun Sep 18 14:03:55 2005 UTC revision 1.188 by jurta, Thu Sep 29 23:41:05 2005 UTC
# Line 208  explicitly. Line 208  explicitly.
208    This section describes the functions for explicitly producing echo    This section describes the functions for explicitly producing echo
209  area messages.  Many other Emacs features display messages there, too.  area messages.  Many other Emacs features display messages there, too.
210    
211  @defun message string &rest arguments  @defun message format-string &rest arguments
212  This function displays a message in the echo area.  The  This function displays a message in the echo area.  The argument
213  argument @var{string} is similar to a C language @code{printf} control  @var{format-string} is similar to a C language @code{printf} format
214  string.  See @code{format} in @ref{Formatting Strings}, for the details  string.  See @code{format} in @ref{Formatting Strings}, for the details
215  on the conversion specifications.  @code{message} returns the  on the conversion specifications.  @code{message} returns the
216  constructed string.  constructed string.
# Line 218  constructed string. Line 218  constructed string.
218  In batch mode, @code{message} prints the message text on the standard  In batch mode, @code{message} prints the message text on the standard
219  error stream, followed by a newline.  error stream, followed by a newline.
220    
221  If @var{string}, or strings among the @var{arguments}, have @code{face}  If @var{format-string}, or strings among the @var{arguments}, have
222  text properties, these affect the way the message is displayed.  @code{face} text properties, these affect the way the message is displayed.
223    
224  @c Emacs 19 feature  @c Emacs 19 feature
225  If @var{string} is @code{nil}, @code{message} clears the echo area; if  If @var{format-string} is @code{nil} or the empty string,
226  the echo area has been expanded automatically, this brings it back to  @code{message} clears the echo area; if the echo area has been
227  its normal size.  If the minibuffer is active, this brings the  expanded automatically, this brings it back to its normal size.
228  minibuffer contents back onto the screen immediately.  If the minibuffer is active, this brings the minibuffer contents back
229    onto the screen immediately.
230    
231  @example  @example
232  @group  @group
# Line 254  the execution of @var{body}.  It display Line 255  the execution of @var{body}.  It display
255  the previous echo area contents.  the previous echo area contents.
256  @end defmac  @end defmac
257    
258  @defun message-or-box string &rest arguments  @defun message-or-box format-string &rest arguments
259  This function displays a message like @code{message}, but may display it  This function displays a message like @code{message}, but may display it
260  in a dialog box instead of the echo area.  If this function is called in  in a dialog box instead of the echo area.  If this function is called in
261  a command that was invoked using the mouse---more precisely, if  a command that was invoked using the mouse---more precisely, if
# Line 268  You can force use of the mouse or of the Line 269  You can force use of the mouse or of the
269  @code{last-nonmenu-event} to a suitable value around the call.  @code{last-nonmenu-event} to a suitable value around the call.
270  @end defun  @end defun
271    
272  @defun message-box string &rest arguments  @defun message-box format-string &rest arguments
273  This function displays a message like @code{message}, but uses a dialog  This function displays a message like @code{message}, but uses a dialog
274  box (or a pop-up menu) whenever that is possible.  If it is impossible  box (or a pop-up menu) whenever that is possible.  If it is impossible
275  to use a dialog box or pop-up menu, because the terminal does not  to use a dialog box or pop-up menu, because the terminal does not

Legend:
Removed from v.1.187  
changed lines
  Added in v.1.188

savannah-hackers-public@gnu.org
ViewVC Help
Powered by ViewVC 1.1.26