Fixed documentation.
Merge pull request #2 from BenMorel/master

Documentation fixes
Merge remote-tracking branch 'upstream/master'
suggested refinements