Visual Studioには、Javadocスタイルのコメントのhtmlドキュメントを生成するオプションがありますか?もしそうなら、これを達成するためにどのようなステップが必要ですか?
BlueJには、Javadocスタイルのコメントをhtmlファイルに変換するオプションがあります。
次のBlueJを使用したJavaの写真のように、Visual Studioでも同じことをしたいと思います:(ソース:time-tripper.com)
Visual Studioには、Javadocスタイルのコメントのhtmlドキュメントを生成するオプションがありますか?もしそうなら、これを達成するためにどのようなステップが必要ですか?
BlueJには、Javadocスタイルのコメントをhtmlファイルに変換するオプションがあります。
次のBlueJを使用したJavaの写真のように、Visual Studioでも同じことをしたいと思います:(ソース:time-tripper.com)
Javaで実際にJavaDocを意味しますか?もしそうなら、私はそうは思わない-ただjavadoc自体を使用する。VisualStudioは実際にはJavaをサポートしていません。
C#XMLドキュメントのコメントを意味する場合は、プロジェクトのプロパティを変更してXMLファイルを作成し、NDoc(廃止)またはSandcastleを使用してHTML(またはchmなど)を作成できます。確かに、それはそれほど簡単ではありません。
編集:C ++を使用している場合は、おそらくDoxygenを確認する必要があります。Visual Studioプラグインがあるかもしれませんが、ビルドプロセスの一部としてDoxygenを実行するのが最善かもしれません。C ++ / CLIを使用している場合は、C#XMLコメントに相当するものがあるかもしれませんが、私にはわかりません。
Javadoc互換のコメントスタイルを使用して、コメントを手動で入力するか、私のアドインであるAtomineer Pro Documentationを使用して、ほとんどの作業を取り除くことができます。次に、外部ドキュメントを生成するには、javadocを楽しく読み取るdoxygenを使用します。
別の方法は、(Jonが言ったように)XmlDoc形式のコメントを使用することです。これは、Visual Studio(インテリセンスツールチップ用)、Atomineer、Sandcastle、およびDoxygenで使用できます。人間が読める形式ではありませんが、Visual Studio環境内で大きな利点が得られるため、少し柔軟性があります。
どちらのアプローチもC#、C ++、Cで機能します(ただし、C#はインテリセンス側でより適切に機能します)