2013-03-06 6 views
0

doxygen의는 다음과 같이 중첩 C 구조 문서로 사용되는 경우 -Doxygen을 : 명명 중첩 구조

  • 구조체 LEVEL0 : 레벨 1 - 구조물이로 명명

    struct level0 {   
        struct level1 {    
         struct level2 {    
          int data1;    
         } var_level2a;   
    
         struct level2b {  
          int data2;  
          int data3;  
         } var_level2b;  
    
        } var_level1;  
    };  
    

    생성 된 문서 :: level2a

  • 구조체 LEVEL0 : 레벨 1 : level2b

우리가 할 수 단순히 구조물의

  • 구조체 level2a
  • 구조체 level2b

도움을주세요 - 이름이 표시 재 같은 (내부적으로는 범위 해상도 전체 이름 '::'참조를위한 일을 할 수 있습니다). 빠른 응답이 큰 도움이 될 것입니다.

+0

이것은 모호하지 않습니다. 거기에 구조가 명확하게 표시됩니다. –

+0

답장을 보내 주셔서 감사합니다. 실제로 모호성 문제는 안전합니다. 내부 구조에 고유 한 이름이 있으므로 충돌하지 않습니다. 그러나 문제는 doxygen이이 '::'범위 분석을 사용하는 구조체를 정의하는 중첩 스타일을 읽을 때입니다. 이로 인해 구조체 이름이 길어지고 doxygen에 익숙하지 않은 일반 독자는 혼란 스럽습니다. 우리의 요구 사항은 구조체의 짧은 이름 만 RTF 문서에 포함시키는 것입니다. 어떤 방식 으로든이를 달성 할 수 있습니까? ... @ref에서 링크 'labels'을 지정할 수 있습니다. 그러나 이것은 자동 생성 된 링크입니다.이 링크에는 아무런 컨트롤이 없습니다. –

답변

0

HIDE_SCOPE_NAMESYES으로 설정 했습니까?

+0

안녕 Doxygen, 답장을 보내 주셔서 감사합니다. 예, 시도했지만 문제가 해결되지 않았습니다. 사실이 HIDE_SCOPE_NAMES를 YES 또는 NO로 설정하면 출력 문서에서 변경된 사항을 찾을 수 없습니다. 필자의 경험에 비추어 볼 때 설정 파일의 설정 매개 변수가 작동하지 않는 경우가 있습니다. 나는 최신 버전의 Doxygen을 사용하고 있으며이 문제는 Windows와 Linux 버전 모두에 있습니다. 이 도구를 만들었으므로 위에서 말한 것이 작동 할 안정적인 버전 (최신 기능과 거의 동일한 버전)이 있으면 제안 할 수 있습니까? –

+0

문서화되었거나 예상대로 작동하지 않는 것이 발견되면 doxygen의 버그 추적기에 버그 보고서를 제출하고 자체 포함 된 예제 (구성 파일 + 소스를 zip 또는 tar에 포함)를 포함하십시오. 나는 내가 재현 할 수있는 문제 만 고칠 수있다. Doxygen에는 200 가지 이상의 옵션이 있으므로 가능한 모든 설정을 테스트하는 것은 불가능합니다. – doxygen