[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
bug#38818: Dired: mention deleting buffers, not just windows
From: |
Richard Stallman |
Subject: |
bug#38818: Dired: mention deleting buffers, not just windows |
Date: |
Wed, 01 Jan 2020 18:18:44 -0500 |
[[[ To any NSA and FBI agents reading my email: please consider ]]]
[[[ whether defending the US Constitution against all enemies, ]]]
[[[ foreign or domestic, requires you to follow Snowden's example. ]]]
How about this addition?
diff --git a/doc/lispref/modes.texi b/doc/lispref/modes.texi
index 7354eb1..b52871e 100644
--- a/doc/lispref/modes.texi
+++ b/doc/lispref/modes.texi
@@ -135,13 +135,26 @@ non-@code{nil} value, it returns that value; otherwise it
returns
@node Setting Hooks
@subsection Setting Hooks
- Here's an example that uses a mode hook to turn on Auto Fill mode when
-in Lisp Interaction mode:
+ Here's an example that adds a funtion to a mode hook to turn
+on Auto Fill mode when in Lisp Interaction mode:
@example
(add-hook 'lisp-interaction-mode-hook 'auto-fill-mode)
@end example
+ The value of a hook variable should be a list of functions. You can
+manipulate that list using the normal Lisp facilities, but the modular
+way is to use the functions @code{add-hook} and @code{remove-hook},
+defined below. They take care to handle some unusual situations and
+avoid problems.
+
+ It works to put a @code{lambda}-expression function on a hook, but
+we recommend avoiding this because it can lead to confusion. If you
+add the same @code{lambda}-expression a second time but write it
+slightly differently, you will get two equivalent but distinct
+functions on the hook. If you then remove one of them, the other will
+still be on it.
+
@defun add-hook hook function &optional depth local
This function is the handy way to add function @var{function} to hook
variable @var{hook}. You can use it for abnormal hooks as well as for
--
Dr Richard Stallman
Chief GNUisance of the GNU Project (https://gnu.org)
Founder, Free Software Foundation (https://fsf.org)
Internet Hall-of-Famer (https://internethalloffame.org)
- bug#38818: Dired: mention deleting buffers, not just windows, 積丹尼 Dan Jacobson, 2020/01/01
- bug#38818: Dired: mention deleting buffers, not just windows, Michael Heerdegen, 2020/01/01
- bug#38818: Dired: mention deleting buffers, not just windows, Drew Adams, 2020/01/01
- bug#38818: Dired: mention deleting buffers, not just windows, Noam Postavsky, 2020/01/01
- bug#38818: Dired: mention deleting buffers, not just windows,
Richard Stallman <=
- bug#38818: Dired: mention deleting buffers, not just windows, Drew Adams, 2020/01/01
- bug#38818: Dired: mention deleting buffers, not just windows, Richard Stallman, 2020/01/02
- bug#38818: Dired: mention deleting buffers, not just windows, Eli Zaretskii, 2020/01/11