Terminology: Macro

Alex R. Young
usevim
Published in
1 min readMay 4, 2013

In general terms, a macro is a reusable set of instructions. Intermediate and advanced Vim users use “complex repeats” to record typed characters into registers, then play back the register’s contents later on. Most of us refer to complex repeats as macros, but Vim’s documentation calls key mappings “macros”:

1. Key mapping                *key-mapping* *mapping* *macro*Key mapping is used to change the meaning of typed keys.  The most common use is to define a sequence commands for a function key.:map  a=strftime("%c")

Contrast this to complex repeats, which are initialised by pressing q in Normal mode. I previously wrote about this in Vim 101: A Gentle Introduction to Macros.

Is it correct to call complex repeats macros, given that Vim's documentation distinguishes between them? Well, almost the entire community calls complex repeats macros, as they are technically macros in the broadest sense. However, it's useful to be aware that recording a sequence of characters to a register is referred to as a "complex repeat" by Vim's documentation, should any confusion arise when using both terms together.

I searched on the Vim Wiki for references to both complex repeats and macros, and I found a few cases where authors had duplicated pages by using the terms distinctly:

Here are the manual pages for both concepts:

--

--