fix errors in documentation

This pull request fixes https://www.assembla.com/spaces/akka/tickets/3796#/activity/ticket: and https://www.assembla.com/spaces/akka/tickets/3634#/activity/ticket: