ソースコードの文書化のために Headerdoc と Doxygen を見てきましたが、どちらも最初に開発者がほとんどの作業を行う必要があるようです。Visual Studio では、型を入力\\\
すると、メソッドが期待するパラメーターを含むドキュメントのスケルトンが生成されます。名前とパラメーターに基づいてメソッドが何をするかを推測するGhostdocもあります。Xcodeに似たものはありますか?
3 に答える
Appledocもあります。これは、Appleのドキュメントと同じように見える、ソース、ドキュメントセット、htmlのコメントからさまざまなドキュメントを作成します。
VVDocumenterプラグインを使用できます。これは、XCode ドキュメント用の非常に便利なプラグインです。
その後、文書化したいメソッド (または任意のコード) を見つけて を入力する///
と、文書が生成され、すべてのパラメーターと戻り値が Javadoc スタイルに抽出されます。これは、Appledoc、Doxygenと互換性があります。 HeaderDoc . インライン プレースホルダー トークンを入力するだけで、ドキュメントを完成させることができます。
次のコマンドで簡単に実行できるXCode パッケージ マネージャー: Alcatrazをダウンロードします。
curl -fsSL https://raw.github.com/supermarin/Alcatraz/master/Scripts/install.sh | sh
XCode を再起動すると、ウィンドウのツールバー メニューに「Package Manager」という新しいオプションが表示されます。そこからVVDocumenterをインストールできます。
VVDocumenter をインストールしたら、XCode を再度再起動する必要がありますが、Xcode をリロードした後、/// と入力すると、後でドキュメントを作成するために使用されるコメントの作成に関するヘルプが表示されます。