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. |
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 |
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 |
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 |