Reference manual polishing

Please see suggested changes to the reference manual.

I have signed and agree to the terms of the SpringSource Individual Contributor License Agreement.