clarify description and example

I think this is more readable.
Merge pull request #328 from ajschumacher/patch-54

clarify description and example