procyberian/emacs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

* src/keyboard.c (post-command-hook): Extend the docstring

Browse source 
Mainly, explain how to use it without hanging Emacs, or giving the
impression that it is hanging.  Also mention `pre-command-hook'.

(pre-command-hook): Mention `post-command-hook'.
This commit is contained in:
Artur Malabarba 2015-10-25 14:34:18 +00:00
parent 2a85bf6a8e
commit 12941b99d1
1 changed files with 14 additions and 2 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

16
src/keyboard.c
View file

@ -11374,14 +11374,26 @@ Buffer modification stores t in this variable. */);
doc: /* Normal hook run before each command is executed.
If an unhandled error happens in running this hook,
the function in which the error occurred is unconditionally removed, since
otherwise the error might happen repeatedly and make Emacs nonfunctional. */);
otherwise the error might happen repeatedly and make Emacs nonfunctional.
See also `pre-command-hook'. */);
Vpre_command_hook = Qnil;
DEFVAR_LISP ("post-command-hook", Vpost_command_hook,
doc: /* Normal hook run after each command is executed.
If an unhandled error happens in running this hook,
the function in which the error occurred is unconditionally removed, since
otherwise the error might happen repeatedly and make Emacs nonfunctional. */);
otherwise the error might happen repeatedly and make Emacs nonfunctional.
It is usually a bad idea to use this hook for expensive processing.
If unavoidable, `while-no-input' can be used avoid making Emacs
unresponsive while the user types. Furthermore, this hook is run
before redisplay, so the effect of the executed command won't be
displayed on the buffer until after the hook has finished (giving the
impression that Emacs is hanging). You can call `redisplay' inside
`while-no-input' to avoid this.
See also `pre-command-hook'. */);
Vpost_command_hook = Qnil;
#if 0