diff options
| author | Craig Jennings <c@cjennings.net> | 2024-04-07 13:41:34 -0500 |
|---|---|---|
| committer | Craig Jennings <c@cjennings.net> | 2024-04-07 13:41:34 -0500 |
| commit | 754bbf7a25a8dda49b5d08ef0d0443bbf5af0e36 (patch) | |
| tree | f1190704f78f04a2b0b4c977d20fe96a828377f1 /devdocs/elisp/beeping.html | |
new repository
Diffstat (limited to 'devdocs/elisp/beeping.html')
| -rw-r--r-- | devdocs/elisp/beeping.html | 16 |
1 files changed, 16 insertions, 0 deletions
diff --git a/devdocs/elisp/beeping.html b/devdocs/elisp/beeping.html new file mode 100644 index 00000000..ed825b06 --- /dev/null +++ b/devdocs/elisp/beeping.html @@ -0,0 +1,16 @@ + <h3 class="section">Beeping</h3> <p>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 <a href="errors">Errors</a>). </p> <dl> <dt id="ding">Function: <strong>ding</strong> <em>&optional do-not-terminate</em> +</dt> <dd> + <p>This function beeps, or flashes the screen (see <code>visible-bell</code> below). It also terminates any keyboard macro currently executing unless <var>do-not-terminate</var> is non-<code>nil</code>. </p> +</dd> +</dl> <dl> <dt id="beep">Function: <strong>beep</strong> <em>&optional do-not-terminate</em> +</dt> <dd><p>This is a synonym for <code>ding</code>. </p></dd> +</dl> <dl> <dt id="visible-bell">User Option: <strong>visible-bell</strong> +</dt> <dd><p>This variable determines whether Emacs should flash the screen to represent a bell. Non-<code>nil</code> means yes, <code>nil</code> means no. This is effective on graphical displays, and on text terminals provided the terminal’s Termcap entry defines the visible bell capability (‘<samp>vb</samp>’). </p></dd> +</dl> <dl> <dt id="ring-bell-function">User Option: <strong>ring-bell-function</strong> +</dt> <dd><p>If this is non-<code>nil</code>, it specifies how Emacs should ring the bell. Its value should be a function of no arguments. If this is non-<code>nil</code>, it takes precedence over the <code>visible-bell</code> variable. </p></dd> +</dl><div class="_attribution"> + <p class="_attribution-p"> + Copyright © 1990-1996, 1998-2022 Free Software Foundation, Inc. <br>Licensed under the GNU GPL license.<br> + <a href="https://www.gnu.org/software/emacs/manual/html_node/elisp/Beeping.html" class="_attribution-link">https://www.gnu.org/software/emacs/manual/html_node/elisp/Beeping.html</a> + </p> +</div> |