2

私はLuaの半分とC++の半分のコードベースに取り組んでいます。Doxygenを使用してC++コードを文書化します。

さて、Lua部分にもDoxygenを使いたいと思います。しかし、DoxygenはLuaのサポートを欠いています。

LuaによるDoxygenのサポートを追加するプロジェクトがあります。それはPerlで書かれていて、私はそれが何をするのか理解しています。LuaソースファイルをDoxygenが解析できるものに変換するフィルターを実装します。ただし、Doxygenはすべての機能などを認識しているわけではないようです。

だから私の質問は本当にです：Doxygenがフィルターに期待するフォーマットは何ですか？

4

1 に答える 1

4

厳密な答えは、フィルターはdoxygenがサポートする言語で文法的に有効な出力を生成する必要があるということです（使用EXTENSION_MAPPINGする言語のファイル拡張子をサポートされている言語にマップするために使用できます）。

doxygenのパーサーはかなり緩いので（これは字句スキャナーであり、実際にはパーサーではありません）、言語の文法規則に100％従わなくても機能する可能性がありますが、それを見つけるのは道のりとエラーのプロセスになりますどの逸脱が許容され、doxygenの将来のバージョンにアップグレードした場合に破損する可能性があります。

于 2012-05-24T18:32:19.870 に答える