small missing comments in macro API