Xcode 5: documentation partly converted to javadoc/appledoc syntax

Since Xcode 5 supports javadoc/appledoc syntax for its Quickhelp and autocompletion tool tips I converted and slightly expanded the provided documentation.
(I wasn't sure on some tiny parts though, so I left them out for now)