Add support for removing objects from a Realm directly from the RealmObject

This also clarifies the error message when a deleted object is being 
operated on.
Please add documentation.