metomi/rose#816: add macro option to tutorial
metomi/rose#816: tidy and fix
metomi/rose#816: add macro option reference link
metomi/rose#816: changes following review.
Merge pull request #828 from benfitzpatrick/816.macro-option-in-tutorial

#816 - add macro option example to custom macro development tutorial