C＃/API Document

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ヘルプがビルドできないアセンブリもあります。