start documenting convenience macros