metomi/rose#885: document
Merge pull request #890 from benfitzpatrick/885.doc

#885: document