Doxygenの複数のソースファイルの例

Question

Doxygenを使用して連携するクラスのグループを文書化していて、複数のソースファイルに分散されたサンプルを作成しました（すべてEXAMPLE_PATH参照）。より正確には、私は次のように書いた：

/*************************************//** 
* Some context... 
* @example Source1.cpp 
* 
* More context... 
* @example Source2.cpp 
****************************************/ 

問題は、出力はDoxygenの（ソース1用のページ、ソース2のための別）によって生成された例のページで半分に広がっているということです。これを実現する方法はあり

Some context... 
|----------------------------------------------| 
| int main()         | 
| {           | 
| //...          | 
| }           | 
|----------------------------------------------| 

More context... 
|----------------------------------------------| 
| bool fct()         | 
| {           | 
| //...          | 
| }           | 
|----------------------------------------------| 

：私は1つのチュートリアルとして一緒にコンテキストと例のコードで、それは同じHTMLページ上のすべてになりたいですか？私はDoxygen 1.8.11を使用しています。

よろしく

Answer 1

私は半合法的な解決策を見つけた：あなたは、最初に@exampleタグを追加し、その後@include Sを使用している場合、それは動作します：

/*************************************//** 
* @example "My tutorial" 
* 
* Some context... 
* @include Source1.cpp 
* 
* More context... 
* @include Source2.cpp 
****************************************/ 

をしかし、からのエラー出力を見てDoxygen私は次のメッセージを受け取ります：warning: included file My is not found. Check your EXAMPLE_PATH

解決策は清潔ではありませんが、当面使用可能です。より良い提案（警告の削除）があれば、それを共有してください。私はそれを受け入れます。