Many languages support documentation comments to allow a generator (like javadoc
or doxygen) to generate code documentation by parsing that sam
Maybe it's a good idea to have an eye on AppleDoc or Apple's own HeaderDoc which isn't recognized very much. I can still find some HeaderDoc hints in 10.9 Mavericks terminal (headerdoc2html)
I recommend to read the latest "What's New In Xcode"* (not sure if it's still under NDA) *The link points to the Xcode 5.1 version wich contains infos about HeaderDoc too.