Improve header docs

- appledoc no longer ignores RLMProperty
- fix a few doc-related issues

@timanglade @alazier

More PR's coming to improve documentation.