DoxyCommentの日本語対応
まず、プロジェクトのURLはこちら。
SourceForge.net: DoxyComment
http://sourceforge.net/projects/doxycomment/
DoxyCommentは、Doxygenで認識できるスタイルの
コメントを書くための補助をするVisual Studio 2005の
アドインです。
具体的には、ファイル先頭にファイルの概要を書くための
コメントを出力したり、関数やクラスを選択して、
引数や関数名に対応したコメントを生成してくれます。
（よく確認していないので、もしかしたら若干違うかも）
しかし、このソフト、日本語で使うことができません。
そこで、とりあえず、DoxyCommentのSubversionのリポジトリを
コミットしてみて、ざっと見渡してみて、そんなに行数も
無かったので、（最初の目的は）日本語対応をしてみました。
（以下、間違った内容を含んでいることを覚悟してください
また、情報が古くなっている可能性があるので、プロジェクトの方の
サイトを確認してから、作業を行ってください）
環境は以下のとおり。
Visual Studio 2005 Professional
Windows XP Professional SP2
DoxyComment リビジョン26
作業内容は中略として、不具合の状況はといいますと、
DoxyCommentでは国際対応が簡単に行えるように（だと思う）
リソースファイルを各言語ごとに読み込めるように設計されています。
具体的には、日本語の.NET Framework上で動かす場合には、
AddInが入ったディレクトリの「ja-JP」フォルダの
「DoxyComment.resources.dll」を参照します。
しかし、標準ではこのファイルは入っていません。
もちろん、ファイルが存在しなくても読み込めるような
手立てはされているのですが、その回避機構が
正常に動いていない、というのが原因のようです。
修正方法。
DoxyCommentAddIn.csの70行目付近、以下の記述を
catch (Exception)
{
// Failed to load localized language try to load us-EN version
OutputMessage("Warning: Failed to load satellite assembly for culture + ci.Name + - defaulting to English version.");
}
このように変更。
catch (Exception)
{
// Failed to load localized language try to load us-EN version
OutputMessage("Warning: Failed to load satellite assembly for culture + ci.Name + - defaulting to English version.");
}
おそらく、これで日本語でも使えるようになります。
いろいろと書きたいことはあったのですが、書こうとする瞬間に
忘れていってしまうので、覚えていることだけかいつまんで説明します。
修正を行って変更を反映する方法ですが、これでコンパイルしてバイナリを
差し替えればいい、というわけにはいきません。というのも、
どうやら、ツールバーへの登録は失敗、成功にかかわらず
一度行ってしまったら、それ以降は登録した内容は変更できないようです。
（正確には、再登録する手段がDoxyComment側から
提供されてないって言うのが正しいんだと思う）
そこで、変更を反映するには、まず、アンインストールを
「プログラムの追加と削除」から行ってください。
次に、再インストールする前にVisual Studioを起動して、
「ユーザー設定」のなかの「ツールバー」で
「DoxyComment」を削除してください。
その後、再インストールを行って、Visual Studioを起動する前に
修正済みのファイルを上書きしてください。
あと、上記の説明でピンときた方もいるかも知れませんが、
リソースファイルが存在しないのがエラーの原因なので、
自分でリソースファイルを作成するという手もあります。
以上、先日に書いた文で、それ以降の追記情報。
どうやら、自分が修正を行っている間に、作者側でも対策を行われたらしく、
別の方法によって、対策がなされています。
まだ、バイナリはアップされていませんが、そのうちアップされると思います。
以上、不明な点等ありましたら、コメントからメッセージを送信してください。
