1 files changed, 7 insertions, 3 deletions

diff --git a/lisp/help-mode.el b/lisp/help-mode.el
index f15ae633edc..47fa3590177 100644
--- a/lisp/help-mode.el
+++ b/lisp/help-mode.el
@@ -501,9 +501,13 @@ buffer after following a reference.  INTERACTIVE-P is non-nil if the
 calling command was invoked interactively.  In this case the stack of
 items for help buffer \"back\" buttons is cleared.
 
-This should be called very early, before the output buffer is cleared,
-because we want to record the \"previous\" position of point so we can
-restore it properly when going back."
+This function also re-enables the major mode of the buffer, thus
+resetting local variables to the values set by the mode and running the
+mode hooks.
+
+So this should be called very early, before the output buffer is
+cleared, also because we want to record the \"previous\" position of
+point so we can restore it properly when going back."
   (with-current-buffer (help-buffer)
     ;; Re-enable major mode, killing all unrelated local vars.
     (funcall major-mode)