私はC++クラスのコメントをdoxygen形式に更新していますが、見栄えはいいですが、名前空間リスト/タブはあまり役に立ちません。親の名前空間はjohn
、次に各ライブラリまたは機能領域のサブネームスペースはjohn::graphics
,john::sound
などです。 Doxygenは1つの名前空間:john
をリストしています。 単に設定を変更する必要がありますか、doxygenが名前空間を取得するために名前空間を文書化することは必須ですか?Doxygenにネストされた名前空間がリストされていない
答えて
一般に、Doxygenが重要であると判断するためには何かを文書化する必要があります。名前空間は含まれています。しかし、それらを特にうまく文書化する必要はありません。 Doxygenがそれらを文書化するためには、それらが何であるかの簡単な記法だけで十分です。
しかし、名前空間には文書化されたクラスが含まれています...名前空間によるリスト表示がコードをナビゲートする明白な方法であるため、これはうまくいかないようです。ああ... –
@ジョン:私が言ったように、それはDoxygenの仕組みです:それは、文書化されていないものだけでなく、文書化されていないものに含まれているものはスキップします。たとえば、グローバル関数を持っている場合、それらを定義するファイルが文書化されていないか、またはそれらがモジュールの一部でない限り、それらは表示されません。 –
EXTRACT_ALLビルドフラグ(http://www.stack.nl/~dimitri/doxygen/config.html#cfg_extract_allを参照)を設定すると、ネストされたネームスペース情報から情報を抽出する必要がなくなります。
私はDoxygenが名前空間がネストされているのを見ていないのと同様の問題がありました。後
/**
* @namespace outer
* @brief the outer namespace
*/
namespace outer
{
/**
* @namespace inner
* @brief the inner namespace
*/
namepsace inner
{
}
}
::前
:私は範囲を指定することによって、それを固定
/**
* @namespace outer
* @brief the outer namespace
*/
namespace outer
{
/**
* @namespace outer::inner
* @brief the inner namespace
*/
namespace inner
{
}
}
- 1. ネストされた名前空間とあいまいなシンボル
- 2. ネストされた名前空間のルート
- 3. 名前空間と同じ名前のモデルにアクセスしているレールのネストされた名前空間
- 4. 名前空間とテンプレートがネストされていません
- 5. どのようにネストされた名前空間
- 6. ネストされたリストの名前付け
- 7. キャッチされていないにReferenceError:CoffeeScriptの中で名前空間をするとき、名前空間が定義されていない
- 8. vuejs名前空間getters定義されていないエラー
- 9. ネストされた名前空間でメソッドフレンドを作る
- 10. 活字体ネストされた名前空間
- 11. ネストされたxml要素内の名前空間
- 12. 参照された名前空間が再連結されていません
- 13. 生成されたSOAPサービスインターフェイスが正しい名前空間にない
- 14. インポートされた名前空間のエイリアス
- 15. ASP.NET Core 2.0:リソース名前空間が表示されない
- 16. Xamarin Microcharts拡張名前空間が認識されない
- 17. アクセス名前空間がXAMLで正確に定義されていない
- 18. xmlが名前空間接頭辞なしで検証されていない
- 19. 名前空間 'ads'がバインドされていません
- 20. 名前空間がインポートされていないにもかかわらず定義されています
- 21. RailsとDevise - 名前空間が初期化されていない定数
- 22. キャッチされていない例外「Firebase名前空間が指定されていません。
- 23. ActionController :: UrlGenerationErrorが付きます。admin名前空間とネストされたリソース
- 24. コンパイラの更新によって名前空間がオートロードされない
- 25. C#でネストされた名前空間を自動的にインポートする
- 26. DataContractSerializer - 名前空間を変更し、古い名前空間にバインドされたファイルの逆シリアル化
- 27. 名前空間とネストされたルートを使用したRailsルーティング
- 28. 名前空間 'ads'はバインドされていません
- 29. リスト内の空のネストされたリストを削除してください
- 30. 異なる名前空間のXSDがサポートされています
私のポストを参照してください: http://stackoverflow.com/questions/2275601/documenting-namespaces -with-doxygen 可能な重複。 –