add some comments to the macros