doxygen에서 lint 주석 사용

Question

문서화를 위해 일반적으로 lint 메시지가 코드 (e.g. /* lint --e228)에서 비활성화되었을 때 수행 한 작업을 설명하는 추가 문서를 작성해야합니다. doxygen과 함께 사용하는 것이 훨씬 쉬울 것입니다.

비록 내가 이걸 사용하여 doxygen을 만드는 방법에 대한 해결책을 찾지 못했습니다. lint 의견. 누구나 시도 했습니까? stric '/*lint'을 사용하는 방법은 없지만 어떻게 든 doxygen에 추가 하시겠습니까?

감사합니다.

Answer 1

lint 표현식 주석으로 확장 할 매크로를 정의하지만 doxygen으로 확장하면 매크로가 다른 주석으로 확장되도록하여이 작업을 수행 할 수 있습니다.

#ifndef LINT_CONTROL 
#define LINT_CONTROL(X) /*lint -save X */ //lint X 
#endif 

int main() { 
    int a; LINT_CONTROL(-e530) 
    return a != a; 
} 

그런 다음 doxygen 구성 파일에서 특정 처리기 매크로의 확장을 가능하게 할 수 있습니다

비결은 PC-보풀 ^TM 또는 FlexeLint ^TM에 -save 명령을 사용하는 것입니다. 특히 LINT_CONTROL을 doxygen으로 대신 확장하여 변경할 수 있습니다. 당신이 FlexeLint ^TM이있는 경우 doxygen이 코멘트는 보풀 제어를 실행하는 데 사용할 수 있도록

ENABLE_PREPROCESSING = YES 
MACRO_EXPANSION  = YES 
EXPAND_ONLY_PREDEF  = YES 
PREDEFINED    = "LINT_CONTROL(X)=//! lint control: X" 

또는, 당신은 가려져 소스를 수정할 수 있습니다. 이 기술은 Gimpel Software Discussion Forum에 설명되어 있습니다.

_{PC-lint 및 FlexeLint는 Gimpel Software의 상표입니다.}