Wilfred / helpful

A better Emacs *help* buffer
1.12k stars 62 forks source link

Customizable Helpful buffer name format #222

Open cole-brown opened 5 years ago

cole-brown commented 5 years ago

The default buffer name format ("helpful : ") is pretty long. It would be nice to have the option to make it shorter.

E.g. in `helm-M-x' (with default Helm settings), you will only see "helpful variable: h..." for the buffer "helpful variable: helpful-max-highlight*", so if looking at a few Helpful buffers you could have trouble knowing which is which.

helm-M-x example

A defcustom for the overall buffer-name format, and another for the helpful--kind-name strings would be nice.

hmelman commented 3 years ago

I agree. For now I'm using this:

(defun helpful--kind-name (symbol callable-p)
  "Describe what kind of symbol this is."
  (cond
   ((not callable-p) "var")
   ((commandp symbol) "cmd")
   ((macrop symbol) "mac")
   ((functionp symbol) "func")
   ((special-form-p symbol) "form")))

but I'd also like a variable that helpful--buffer would use instead of hardcoding "*helpful " in the format string