add helpful.el for a better help buffer

settings/general-settings.el

@@ -318,6 +318,33 @@ Version 2016-07-13"
   (setq transient-values-file (concat user-cache-directory "transient/values.el"))
   (setq transient-history-file (concat user-cache-directory "transient/history.el")))
 
+;; A better *Help* buffer
+(use-package helpful
+  :bind
+  (;; Note that the built-in `describe-function' includes both functions
+   ;; and macros. `helpful-function' is functions only, so we provide
+   ;; `helpful-callable' as a drop-in replacement to include `helpful-macro'.
+   ("C-h f" . helpful-callable)
+   ("C-h v" . helpful-variable)
+   ("C-h k" . helpful-key)
+   ;; Lookup the current symbol at point. C-c C-d is a common keybinding
+   ;; for this in lisp modes.
+   ("C-c C-d" . helpful-at-point)
+   ;; Look up *F*unctions (excludes macros).
+   ;; By default, C-h F is bound to `Info-goto-emacs-command-node'. Helpful
+   ;; already links to the manual, if a function is referenced there.
+   ("C-h F" . helpful-function)
+   ;; Look up *C*ommands.
+   ;; By default, C-h C is bound to describe `describe-coding-system'. I
+   ;; don't find this very useful, but it's frequently useful to only
+   ;; look at interactive functions.
+   ("C-h C" . helpful-command))
+  :config
+  (with-eval-after-load 'ivy
+    ;; Ivy users can use Helpful with counsel commands:
+    (setq counsel-describe-function-function #'helpful-callable)
+    (setq counsel-describe-variable-function #'helpful-variable)))
+
 ;;
 ;; keyboard
 ;;