Split RLMArray into RLMArray + RLMResults

Splits RLMArray into separate apis.

The relevant apis should now be updated along with inline docs. All osx tests currently pass. We will still need to update the rest of the docs on the website separately.
FIXME is inaccurate (new Swift API can't really replace the current Swift support in the obj-c API due to requiring iOS 8).