Subject: bug#20694: 25.0.50; Please bind `p' and `n' in apropos-mode

From: Justin Timmons <[email-masked]>
Date: Mon, 12 Dec 2016 21:18:11 -0500

I wrote up a quick set of functions which accomplishes this and added them
to the apropos-mode keymap - see the attached patch file.

The functions search forward (or backwards) for the 'apropos-symbol
face; there could be a cleaner way to do this, but this seems to work
pretty well.

diff --git a/lisp/apropos.el b/lisp/apropos.el
index 7c9ec12..d5a9a3a 100644
--- a/lisp/apropos.el
+++ b/lisp/apropos.el
@@ -160,6 +160,10 @@ If value is `verbose', the computed score is shown for each match."
     ;; definition of RET, so that users can use it anywhere in an
     ;; apropos item, not just on top of a button.
     (define-key map "\C-m" 'apropos-follow)
+
+    ;; Movement keys
+    (define-key map "n" 'apropos-next-symbol)
+    (define-key map "p" 'apropos-previous-symbol)
     map)
   "Keymap used in Apropos mode.")
 
@@ -1209,6 +1213,24 @@ as a heading."
        (error "There is nothing to follow here"))))

+(defun apropos-next-symbol ()
+  "Move cursor down to the next symbol in an apropos-mode buffer."
+  (interactive)
+  (forward-line)
+  (while (and (not (eq (face-at-point) 'apropos-symbol))
+	      (< (point) (point-max)))
+    (forward-line)))
+
+
+(defun apropos-previous-symbol ()
+  "Move cursor back to the last symbol in an apropos-mode buffer."
+  (interactive)
+  (forward-line -1)
+  (while (and (not (eq (face-at-point) 'apropos-symbol))
+	      (> (point) (point-min)))
+    (forward-line -1)))
+
+
 (defun apropos-describe-plist (symbol)
   "Display a pretty listing of SYMBOL's plist."
   (help-setup-xref (list 'apropos-describe-plist symbol)