p2 doc: more on sigs and macros