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.
It's RealmResults in Java. So it should be the same or Java needs to change
as well. We had endless discussions about it, but found peace with the
plural form ..

Den torsdag den 9. oktober 2014 skrev Thomas Goyne <notifications@github.com
>:

> In Realm/RLMArray.h:
>
> >
> >   @param property    The property name to sort by.
> >   @param ascending   The direction to sort by.
> >
> > - @return    An RLMArray sorted by the specified property.
> > + @return    An RLMResults sorted by the specified property.
>
> "An RLMResults" sounds sufficiently weird that I'm starting to think it
> should just be RLMResult.
>
> —
> Reply to this email directly or view it on GitHub
> <https://github.com/realm/realm-cocoa/pull/993/files#r18658685>.
>