English version of this documents are available.
Doxygen に識別子の日本語対応などの改良を施しています。
Doxygen は以前から日本語にも対応している、と紹介されていましたが、マクロ名・関数名・クラス名などに日本語(ASCII外の文字)を使ったソースコードには対応していませんでした。そこで2013年7月から9月にかけて改良パッチを作成し本家開発者に対して送付しております。
この送付したパッチをすべて適用したものを有償で提供しているのが本作です。
もともと Doxygen は GPL ソフトウェアであり、送付したパッチもすべて公開されています。したがって手間を惜しまなければ本作を購入せずともご自身で改良版 Doxygen をビルドできます。また、当然ながら本家開発にパッチが採用されれば公式リリースとして本作同等のものが入手できるようになります。この場合、本作の購入は本作作業に関した私に対する寄付という位置づけになります。
本作の内容は次の通りです。
- すべてのパッチを適用したソースコード
- 本家未採用部分とすべてを適用したコードの差分を示した UnifiedDiff ファイル
- Windows 用の doxygen および doxywizard の実行可能ファイル
- (↑doxywizard の日本語訳 .qm ファイルが同じフォルダにあります)
- その他関係する雑多なメモ書き
注意
- doxywizard は出力ファイル名に日本語を認める
LIMIT_FNAME_WITH_ASCII
オプションに対応するためだけに同梱しています。
- 現在の所 C++ に対する文書の HTML 化しか見ていません。他のプログラミング言語・他の出力についてはうまく動くかもしれないし、動かないかもしれません。
参考メモ
投稿済み/本作組み込み済みパッチ一覧
現時点では gnome のバグ報告システムにおいて Doxygen に対してしか報告を行ったことがないため、プロジェクトに doxygen 、報告者欄に h12u.com を入れて検索すると下記に相当する一覧を見ることができます。
- Bug 704971 MinGW でビルドできるようにした
- 当初 Vistual Studio 2010 で試みたのですが無理でした…2008ならできるそうですが、日本語環境でもできるのかどうかは不明。
- Bug 704973 Doxywizard のログ表示を非 ASCII 文字対応にした
- ちなみに doxygen 本体の出力は Windows であっても UTF-8 による出力になっていますのでご注意ください。
- Bug 705217 Windows で外部コマンドに ASCII 外の文字を渡せるようにじぃ
- Bug 705218 QRegExp を ASCII 外の文字についても動作するようにじぃ
- doxygen 本体は Qt 2.0 時代の汎用クラスのコードを内包して使っています。doxywizard は Qt 4 を普通に活用しています。
- Bug 705219 C/C++ のマクロに ASCII 外の文字があっても受け付けるようにした
- Bug 705220 出力ファイル名に ASCII 外の文字を許可できるようにした
- LIMIT_FNAME_WITH_ASCII のオプション追加はこのパッチによるものです。
- Bug 705910 索引や検索が非 ASCII 文字名の識別子(関数名・クラス名・その他)を利用できるようにした
- Bug 707102 日本語訳の追加・更新(1.6.0 → 1.8.5)
- Bug 707278 組み込みの Javascript 検索において、検索結果のグループ化に失敗する問題を修正
- Bug 707353 Python の識別子に ASCII 外の文字があっても動作するようにした
- Python は 3.0 からこのような識別子命名を認めています。
- Bug 707389 ツリービューモードの HTML ファイルが Android 3.x のタッチスクロールを拒否する問題の修正について
- 公式サイトを含めた GENERATE_TREEVIEW=YES の場合の挙動についての話です。iOSだけに対応したのが運の尽き。
- Bug 708046 索引用の文字列を別途指定可能にする。要するに読み仮名付与機能。\sk コマンド。
- Bug 719632 doxywizard の国際化。日本語用の .ts ファイルはパッチに .qm ファイルは本作に収録。
更新履歴
- 2013-12-27
- 公式リリース 1.8.6 に対応
- 2013-11-30
- SHA-1: eed0c89f7534b387004da7badcbabdf66570c685
- 2013-09-22
- 初版 SHA-1: 6dbc429a78966233c02b339193c5bb642d281df0