[doc] wrap further code in more abstract macros