Fix scaladoc warnings in akka-actor, see #3152

* also change wrong visibility of SystemMessage subclasses
Improve scaladoc in akka-actor, see #3152

* also change visibility of Actor.context
Merge pull request #1602 from akka/wip-3152-scaladoc-patriknw

Improve ScalaDoc/JavaDoc, see #3152