www.delorie.com/gnu/docs/elisp-manual-21/elisp_664.html

search

	Buy the book!

GNU Emacs Lisp Reference Manual

38.18 Beeping

This section describes how to make Emacs ring the bell (or blink the screen) to attract the user's attention. Be conservative about how often you do this; frequent bells can become irritating. Also be careful not to use just beeping when signaling an error is more appropriate. (See section 10.5.3 Errors.)

Function: ding &optional do-not-terminate

This function beeps, or flashes the screen (see visible-bell below). It also terminates any keyboard macro currently executing unless do-not-terminate is non-nil.

Function: beep &optional do-not-terminate

This is a synonym for ding.

User Option: visible-bell

This variable determines whether Emacs should flash the screen to represent a bell. Non-nil means yes, nil means no. This is effective on a window system, and on a character-only terminal provided the terminal's Termcap entry defines the visible bell capability (`vb').

Variable: ring-bell-function

If this is non-nil, it specifies how Emacs should "ring the bell." Its value should be a function of no arguments. If this is non-nil, it takes precedence over the visible-bell variable.