Maint/puppet 4/document event manager

This adds documentation to `Puppet::Transaction::EventManager` and `Puppet::Resource::Status` and removes some dead attributes from `Status`.
That's in reference to `@real_resource`, is that a better way of explaining this?