]> code.delx.au - gnu-emacs/commitdiff
* src/keyboard.c (post-command-hook): Shorten docstring
authorArtur Malabarba <bruce.connor.am@gmail.com>
Mon, 26 Oct 2015 10:05:09 +0000 (10:05 +0000)
committerArtur Malabarba <bruce.connor.am@gmail.com>
Mon, 26 Oct 2015 10:05:09 +0000 (10:05 +0000)
src/keyboard.c

index 4ea0f97e77ff46bb5d552e25ca71b3829e6302aa..851207874db1bb3c8163df5282eadba95f6353a9 100644 (file)
@@ -11385,13 +11385,9 @@ 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.
 
-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.
+It is a bad idea to use this hook for expensive processing.  If
+unavoidable, wrap your code in `(while-no-input (redisplay) CODE)' to
+avoid making Emacs unresponsive while the user types.
 
 See also `pre-command-hook'.  */);
   Vpost_command_hook = Qnil;