add @throws annotation to actor life-cycle hooks, see #3188
implement and document Pipelines, see #3174

- heavily inspired by spray.io.Pipeline
- fully functional style: a stage returns the resulting commands and
  events, which makes it impossible to mess with the pipeline from the
  inside
- object allocations are optimized away for emtpy and 1-elem results
- added type-safety, verifying that stages match up
- management commands “from the side” for configuration or async events
- full Java API and docs
Merge pull request #1291 from akka/wip-3174-pipelines-∂π

implement and document Pipelines, see #3174