Document support of hooks when programming macros (Issue 820)

This is the continuation of work from the Documentation Camp. It fixes #820 (closed). @sardana-org/integrators its ready for review. Thanks!