DOXYGEN을 사용하여 특정 문서 선택하기

Question

은 \ internal 명령으로 수행 할 수있는 작업과 거의 정반대의 작업을하고 싶습니다. 이미 프로젝트에 대한 거대한 doxygen 문서가 있지만, 지금은 아주 작은 수동 몇 블록 (함수, 상수 등)을 골라 내고 싶습니다.

덧글의 99 %를 \ internal로 표시하는 대신 에 내 외부에서 의 의견이 1 % 인 \ external와 같은 명령을 사용하는 것이 좋습니다.

"기본 섹션"(섹션의 일부가 아닌 인 모든 것)을 비활성화하는 것과 같은 것이 물론 작동합니다. 그런 다음 사용할 수 있습니다 ENABLED_SECTIONS ...

불행히도 문제의 의견은 하나의 파일에만 존재하지 않습니다. 또한 이러한 파일에는 다른 주석이 많이 포함되어 있으므로 을 내보낼 수 없습니다.

나는 원래의 위치에 포함될 수있는 별도의 헤더 파일 으로 이러한 주석을 옮길 생각 이었지만 이것은 많은 부분을 재구성하고 파일을 찢어 버리려는 의미 일 것입니다.

아무도 내 문제를 해결하는 방법을 알고 있습니까? 사전에

감사합니다, 니코

Answer 1

나는 ENABLED_SECTIONS 앞으로 방법이라고 생각하지만, 부하를 줄일 수있는 몇 가지가있다.

첫 번째는 특정 요구 사항에 대한 별도의 doxyfile을 작성한 다음 마스터 요구 사항을 조정하지 않고 사용자 정의 할 수 있습니다.

이 새로운 doxyfile에서는 명시 적으로 파일 목록의 INPUT에 필요한 내용이 들어있는 파일 만 나열합니다. 현재 전체 폴더 트리를 가져 오도록 설정되어 있습니다. 개별 파일을 체리로 편집하십시오. 문서의 '구조'를 정의하는 데 필요한 파일을 잊지 말아야합니다.

그런 다음 대응하는 @if <SECTION_NAME>@endif 마커가있는 ENABLED_SECTIONS를 사용하여 파일보다 작은 단위로 선택 범위를 좁히십시오.