remove the deprecation warnings for the old threading API; update the docs

Reviewer: Benjamin Peterson
4 files changed