[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
bug#38205: Unhelpful documentation for add-variable-watcher.
From: |
Alan Mackenzie |
Subject: |
bug#38205: Unhelpful documentation for add-variable-watcher. |
Date: |
Thu, 14 Nov 2019 07:38:35 +0000 |
User-agent: |
Mutt/1.10.1 (2018-07-13) |
Hello, Emacs.
The doc string for add-variable-watcher wrongly states:
Cause WATCH-FUNCTION to be called when SYMBOL is set.
. Correct would be either
Cause WATCH-FUNCTION to be called just before SYMBOL is set.
or
Cause WATCH-FUNCTION to be called just after SYMBOL is set.
. I'm guessing that the first of these applies, but I shouldn't have to
guess. The difference is whether one can get the old value from SYMBOL
or not.
The documentation in the Elisp manual is similarly ambiguous. It uses
the conjunction "whenever".
--
Alan Mackenzie (Nuremberg, Germany).
- bug#38205: Unhelpful documentation for add-variable-watcher.,
Alan Mackenzie <=