Improve ScalaDoc/JavaDoc, see #3152

This pull request will consist of several commits to break down this huge task in manageable steps.

First out is:
* Fixed scaladoc warnings in akka-actor, and also changed wrong visibility of SystemMessage subclasses