fights bit rot in macro docs

review @eed3si9n