www.delorie.com/gnu/docs/elisp-manual-21/elisp_664.html   search  
Buy the book!

GNU Emacs Lisp Reference Manual

[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

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.

  webmaster   donations   bookstore     delorie software   privacy  
  Copyright 2003   by The Free Software Foundation     Updated Jun 2003