Miscellaneous changes
Merge pull request #463 from benfitzpatrick/doc.fixes

rose documentation, rose macro: changes following feedback