Add documentation to parts of scala.concurrent.
Merge pull request #3787 from tvierling/concurrent-doc-nits

Add documentation to parts of scala.concurrent.