converted and expanded almost all documentation to make them ready for Xcode 5's autocompletion tool tips
Merge pull request #9 from GhostLyrics/xcode5-documentation

Xcode 5: documentation partly converted to javadoc/appledoc syntax