(help-insert-string): New function. Save buffer

contents in cases where it is impossible to recompute the old
contents.

diff --git a/lisp/help-mode.el b/lisp/help-mode.el
index 9941f0604bd640fc6c9c4f3202537b151ccdff81..2e5bbb9315bfc625354656eed758bfeab7323f90 100644 (file)
--- a/lisp/help-mode.el
+++ b/lisp/help-mode.el
@@ -648,6 +648,15 @@ For the cross-reference format, see `help-make-xrefs'."
                (fboundp sym) (facep sym))
        (help-do-xref pos #'help-xref-interned (list sym))))))
 
+(defun help-insert-string (string)
+  "Insert STRING to the help buffer and install xref info for it.
+This function can be used to restore the old contents of the help buffer
+when going back to the previous topic in the xref stack.  It is needed
+in case when it is impossible to recompute the old contents of the
+help buffer by other means."
+  (setq help-xref-stack-item (list #'help-insert-string string))
+  (with-output-to-temp-buffer (help-buffer)
+    (insert string)))
 
 (provide 'help-mode)