DOC: shorten example and provide clarifcation and spelling fixes
Merge pull request #292 from grooverdan/solaris-doc

DOC: shorten example and provide clarification and spelling fix