readme: unify example syntax
document macros