기본 인수가있는 Doxygen 반복 C++ 함수

Question

일부 코드를 문서화하기 위해 Doxygen을 사용하고 있습니다.

unsigned int CountColumns(const std::string&,const std::string& delim=""); 

와 같은 소스 파일에서 해당 구현 : 나는 헤더 예에 지정된 기본 인수를 사용하는 기능을 가지고

unsigned int CountColumns(const string& input,const string& delim) 
{ 
    ... 
} 

내가 생성 Doxygen을 사용할 때

unsigned int CountColumns (const string &input, const string &delim) 
unsigned int CountColumns (const std::string &, const std::string &delim="") 

이 어떻게 피할 수 있습니다 : 기본 값을 포함 하나, 그리고없이 하나 - 내 문서, CountColumns 두 가지 항목이 있습니다? 여러 함수 정의가 내 설명서를 혼란스럽게하는 것은 원하지 않습니다.

EDIT : 내가 아래에 나와있는 답변에서 언급 한 것처럼 문제는 헤더 파일에서 인수에 'std :: string'을 사용하고 소스 파일에 'std :: string '문을 사용하고 인수에'string '을 사용합니다. 함수 정의를 소스 파일에서 'std :: string'을 사용하도록 변경하면 Doxygen은 헤더에서 선언 된 것과 동일한 함수로 인식합니다.

Answer 1

설정 파일에 BUILTIN_STL_SUPPORT ~ YES을 설정하면 doxygen이 std에 정의 된 클래스라는 것을 알고있다. 네임 스페이스.

Answer 2

문서에서 추가 기능을 제외하는 방법은 무엇입니까?

이

은

는 "어떻게 몇 가지 코드 조각을 무시 Doxygen을 만들 수 있으며, Doxygen을 FAQ에서입니까?

새롭고 쉬운 방법은 시작과 일에 \cond 명령을 사용하여 하나 개의 주석 블록을 추가하는 것입니다 .. 무시해야 코드의 조각의 끝에 \endcond 명령을 주석 블록은이

물론 같은 파일 내에 있어야하지만 당신은이에 대한 Doxygen을의 프리 프로세서를 사용할 수 있습니다 : 당신이

,369을 넣으면

#ifndef DOXYGEN_SHOULD_SKIP_THIS 

    /* code that must be skipped by Doxygen */ 

#endif /* DOXYGEN_SHOULD_SKIP_THIS */ 
around the blocks that should be hidden and put: 

    PREDEFINED = DOXYGEN_SHOULD_SKIP_THIS 
in the config file then all blocks should be skipped by Doxygen as long as 

PREPROCESSING = YES. "

Answer 3

문제 때문에 소스 파일은 다음 '를 사용하여 표준 : : 문자열'문을 포함하고있는 동안 헤더 파일이 인수에서 '표준 : : 문자열'을 사용한다는 사실을 것으로 보인다 '는 문자열을 사용 '인수에서. 함수 파일의'std :: string '을 사용하도록 함수 정의를 변경하면 Doxygen은 헤더에 선언 된 함수와 동일하게 인식합니다.

이상적인 것은 아니지만 해결책이 너무 어렵지 않다.