deprecate (bug docs)
Merge pull request #5 from andymckay/docs

deprecate (bug docs)