중첩 된 네임 스페이스가 표시되지 않는 Doxygen

Question

doxygen 형식의 C++ 클래스 주석을 업데이트했으며 멋지게 보이지만 ... 네임 스페이스 목록/탭이 전혀 유용하지 않습니다. 부모 이름 공간이 john 인 경우 각 라이브러리 또는 기능 영역에 대한 하위 네임 스페이스 예 : john::graphics, john::sound 등 Doxygen은 하나의 네임 스페이스 : john 만 나열합니다. 일부 설정을 간단히 변경해야합니까, 아니면 doxygen에서 가져 오기 위해 내 네임 스페이스를 문서화해야합니까?

Answer 1

일반적으로 Doxygen이 중요하다고 결정할 수있는 사항을 문서화해야합니다. 네임 스페이스가 포함되어 있습니다. 그러나 당신은 그들을 잘 문서화 할 필요가 없습니다. Doxygen이 문서를 작성하는 데에는 이들이 사용하는 것에 대한 간단한 표기만으로 충분합니다.

Answer 2

EXTRACT_ALL 빌드 플래그 (http://www.stack.nl/~dimitri/doxygen/config.html#cfg_extract_all 참조)를 설정하면 특별히 문서화 할 필요없이 중첩 된 네임 스페이스 정보에서 정보를 추출합니다.

Answer 3

나는 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 
    { 
    } 
}