Buttonize function values in help (and add a blank line)

* lisp/help-fns.el (describe-variable): Add a newline for better
readability (bug#46702).  This also has the side effect of
buttonizing `function-references-like-this' in the "Its value is"
part.

* lisp/help-mode.el (help-make-xrefs): Adjust comments.

diff --git a/lisp/help-fns.el b/lisp/help-fns.el
index ceb6bc0901577be8ae47bf33877a9b1f50205609..724469509483878a7eab1656db9ceeea75b0bd4e 100644 (file)
--- a/lisp/help-fns.el
+++ b/lisp/help-fns.el
@@ -1026,7 +1026,7 @@ it is displayed along with the global value."
              (princ (if file-name
                         (progn
                           (princ (format-message
-                                   " is a variable defined in `%s'.\n"
+                                   " is a variable defined in `%s'.\n\n"
                                    (if (eq file-name 'C-source)
                                        "C source code"
                                      (help-fns-short-filename file-name))))

diff --git a/lisp/help-mode.el b/lisp/help-mode.el
index 30a1ce053c104820845b14221c3c3bcb69cfdbe0..6fd3d40fe3c5431f7ae89449e6bb15cad231a0cd 100644 (file)
--- a/lisp/help-mode.el
+++ b/lisp/help-mode.el
@@ -476,8 +476,7 @@ that."
   (with-current-buffer (or buffer (current-buffer))
     (save-excursion
       (goto-char (point-min))
-      ;; Skip the header-type info, though it might be useful to parse
-      ;; it at some stage (e.g. "function in `library'").
+      ;; Skip the first bit, which has already been buttonized.
       (forward-paragraph)
       (let ((old-modified (buffer-modified-p)))
         (let ((stab (syntax-table))