DOC : make use of autolink

 - will auto-link if a word in `` is a class or function
DOC : added explanatory comments to autolink
Merge pull request #73 from tacaswell/doc_tweak

DOC : make use of autolink