Improve commentary in simple,el

* lisp/simple.el (next-error-last-buffer): Improve commentary.
(Bug#20489)

diff --git a/lisp/simple.el b/lisp/simple.el
index edcb73ce2e16cfbad94f1dc8e896d3aac01ffa5f..60a00286f89758986981e17baa474ff6531647b3 100644 (file)
--- a/lisp/simple.el
+++ b/lisp/simple.el
@@ -121,6 +121,11 @@ If non-nil, the value is passed directly to `recenter'."
 A buffer becomes most recent when its compilation, grep, or
 similar mode is started, or when it is used with \\[next-error]
 or \\[compile-goto-error].")
+
+;; next-error-last-buffer is made buffer-local to keep the reference
+;; to the parent buffer used to navigate to the current buffer, so the
+;; next call of next-buffer will use the same parent buffer to
+;; continue navigation from it.
 (make-variable-buffer-local 'next-error-last-buffer)
 
 (defvar next-error-function nil