Is there a way to display a macro list similar to displaying your mappings in Vim?

Question

I know there is a way to list mappings via :map (or :imap, :cmap, etc.), but I can't find a way to list macros I have stored in my vimrc file (as in let @a = 'blahblah').

Is there a way to do this without having to manually looking inside it (via :split [myvimrcfile] or whatever way)?

Also, if it is possible, is there a way to attach some sort of documentation that would display with the macro to explain what it is for? I have a handful that I use quite a bit, but about 6 weeks apart. It would be nice to just quickly list them along with a comment that tells me what the macro does (or even just a name so I make sure I use the right one).

Thanks

Answer 1

In vim, the macros are just stored in registers. You can recall the content of any register and execute it as a macro (which is what the @ does). To see a list of what is in your registers, use :reg.

Answer 2

You can see the contents of all the registers using the

:reg 

command. Or an argument string like this

:reg ahx 

will show you the contents of registers a, h, and x.

That way you can at least see what sequence of commands will be run and hopefully that will be clear enough for you to tell one from another.

The registers simply contain text. You can paste the command sequence in as text or you can copy text into a register and then run it as a command, depending on how you access the register.

I have not found any direct way to edit the contents of a register, but you can paste it into the file, edit it, and then save it back to the same register.

IHTH.