elisp: Beeping
37.23 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 (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 graphical displays, and on text terminals provided the
terminal’s Termcap entry defines the visible bell capability
(‘vb’).
-- User Option: 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.