removing reference. Probably not too classy in docs
minor performance-y changes
adding a bit of documentation
Merge branch 'master' into gh-pages