仕事での話。
「API 一覧表みたいな資料の日本語版ないの?」
という問い。
Doxygen で API リファレンスを自動生成してるんだけど、
担当してる仕事のソースコードはヨーロッパ支社で大半を開発して、
韓国支社がちょこちょこ手を入れたりしてる状況。
\if 〜 \endif で設定によって出力を切り替えられるみたいなんだけど、
英語版 VS6 IDE で日本語が(UTF-8 とかも含めて)使えなかったりした記憶があるので、
その中に日本語のコメントや韓国語のコメントを混ぜること自体に抵抗がある。
こういう場合までは想定してないんだろうなー。
各ドキュメントコメントに ID を割り振って、その ID に対するコメントだけを別ファイルに用意できれば解決なんだろうけど。。。