ObjCでのメソッドコメントは@param fooのように書いていたが、swiftでは:param:のように書くとXCodeがアノテーションとして認識してくれるらしい。
XCode6にはreStructuredTextというMarkDownのような記法のパーサが含まれているらしいけど、reStructuredTextの記法はほとんどが使えないっぽかった。Bullet ListsとField Listsは使えた。
詳細は↓
Swift Documentation - NSHipster
今やってるプロジェクトではdoxygenでAPIドキュメントを生成しているんだけど、doxygenの記法と違ってくるなぁ。両方でうまくいくようにするにはどうすればいいんだろう。。
