C# で
///
VB で
'''
と、コメントを書いて、プロパティの設定をしてあげると、クラス名、メソッド名などに書いたコメントが
XMLファイルとして出力できます。
ま、これはいいとして、その後が問題・・・
そのあと、ドキュメント化したい。といったときに、ハマるので、いろいろ調べた結果をメモします。
.NET Fx 2.0 での XMLコメント ドキュメント化ツール
有名どころは以下の2つあります。
(1) NDoc
(2) A HotDocument
(1)NDocについて
NDocの.NET Fx 2.0 対応版である、NDoc 2.0の開発は中止された模様です。
NDoc 2 is Officially Dead
http://www.charliedigital.com/PermaLink,guid,95b2ab68-ba92-413a-b758-2783cde5df9c.aspx
以下の石坂さんのBlogがわかりやすいです。
NDoc 2 が正式に終了?そしてSandcastle
http://www.isisaka.com/blog/archives/2006/07/ndoc_2_sandcast.html
Sandcastle というツールがMSサイトからダウンロード可能です(CTP版ですが)
Sandcastle - Microsoft CTP of a Help CHM file generator on the tails of the death of NDoc
http://www.hanselman.com/blog/SandcastleMicrosoftCTPOfAHelpCHMFileGeneratorOnTheTailsOfTheDeathOfNDoc.aspx
Sandcastlに関する情報
Sandcastle CTP版 を試した
http://www.naggy.bne.jp/cs.net/2006/07/30/
ですが、
.NET Fx 2.0 に、対応していない、NDocを工夫して使う方法もあるようです。
NDocをVisual Studio 2005
http://www.isisaka.com/blog/archives/2006/01/ndocvisual_stud_1.html
(2) A HotDocument は、以下を参照
http://www.hotdocument.net/product/vb7.html
出力サンプルもダウンロードできます。