Documenting keyboard macros Can I have a doc string for fset the same way as defun

Question

I often create and save elaborate keyboard macros that I wish to use later, and hope to be prompted for the proper context to use them. I note that if I manually write a function to use as a command I can have a doc string

(defun my-handy-command ()
  "Some helpful guidance on when to use this"

However keyboard macros get saved as

(fset `my-named-kbd-macro
  (kmacro-lambda-form 

can I supply a docstring somehow. If I can't apply a docstring to fset what is the quickest and easiest way to go from a recorded keyboard macro to a usable emacs command with a docstring?

Answer 1

You can use defalias instead of fset. You use it like fset but it takes a docstring as third argument.

eg:

(defalias 'pastebelow
  (kmacro-lambda-form [?y ?y ?p] 0 "%d")
  "This is my keyboard macro.")

for Emacs version < 29

or

(defalias 'pastebelow
  (kmacro "y y p")
  "This is my keyboard macro.")

for Emacs version >= 29.

(y y p because I am an evil user).

Of course you can use M-x insert-kbd-macro after saving it with kmacro-name-last-macro (C-x C-k n).