APIリファレンスの作成
VisualStudio.NET2003のメニューから「ツール」「Webページのビルドコメント」を選択すると、HTML形式の"コードコメントWebレポート"が作成されます。
[注意点]
- enum のメンバを一行に複数記述すると、エラーになるようです。各メンバは、行を分けて書きましょう。
NDocの利用
Ndoc日本語版を使うと、MSDNライクな見栄えのHTMLヘルプが作成できます。NdocにはGUI、CUIともにあり、青柳様のC#Tipsで紹介されているように、ビルド毎に更新するようにしておくと、便利かも。
[注意点]
- NDocのmsiインストーラを実行すると、基となる他のmsiインストーラをDownloadしようとします。つまり、インターネット接続環境でないとセットアップは成功しません。
- NDoc1.2-rc1-jp0.1をVisualStudio.NET2003でビルドしようとすると、LinearHtmlDocumenter.csの1179行目でエラーになります。「XslTransformクラスのTransfrom()メソッドの引数が古い形式」らしいです。引数の最後に、new XmlUrlResolver() を付け加えてあげれば正常動作するんじゃないでしょうか?(^^;;
- まだ原因の特定ができていないのですが、「型を読み込めませんでした」というエラーになり、HTMLヘルプがビルドできないアセンブリもあります。