Improved router documentation. Fixes #2874
  * Edit of basic usage and design.
  * Rearranged order of sections.
  * Added more information on special message types.
  * Added receiveN to JavaTestKit.
Merge pull request #1095 from akka/wip-2874-router-doc-rich

Document router handling of PoisonPill messages. Fixes #2874