Improve header docs

- appledoc no longer ignores RLMProperty
- fix a few doc-related issues

@timanglade @alazier

More PR's coming to improve documentation.
I'll update the Float and Double cases to reflect on which platforms CGFloat applies.