대규모 다중 응용 프로그램 COM 프로젝트에서 Doxygen을 최적으로 설정

Question

시스템에 최대 100 개의 VC++ 프로젝트가 있으며 각각은 DLL 또는 EXE를 출력합니다. 또한 IDL 및 생성 된 .h/.c 파일이있는 많은 COM 구성 요소가 있습니다.

'올바른 방법'또는 적어도 Doxygen으로 이것을 구성하는 좋은 방법은 무엇입니까? 하나의 전체 doxy 프로젝트 또는 프로젝트/솔루션 당 하나? 그리고 코드를 생성 한 COM과 생성 된 HTML 파일을 부 풀릴 '보풀'을 처리하는 올바른 방법은 무엇입니까?

Answer 1

나는 이것을 아직 시험 할 기회가 없었지만, Doxygen은 link to external documentation의 능력을 가지고있다. 아마도 별도의 프로젝트를 수행하고 외부 링크를 사용하여 실험 할 것입니다. 그렇지 않으면 많은 수의 프로젝트를 통해 하나의 doxygen 빌드가 매우 오랜 시간이 걸릴 수 있습니다. 다음과 같이 내가 여러 별도의 doxygen이 선택했다

Answer 2

빌드 :

• 주요 응용 프로그램의 최상위 lib 디렉토리를 구축,
• 구축
• 선택적으로 각 라이브러리에 대해 별도의 "libs와"문서를 작성 라이브러리를 포함하지 모든 것을 가진 "글로벌"doxygen 빌드
• 선택적으로 "Internal"스위치가 켜진 채로 라이브러리를 빌드하십시오.
• 모든 출력은 단일 Doxygen을 폴더 (Doxygen\application, Doxyge\Lib1...)
• 사용하십시오 최상위 LIB 빌드 라이브러리 함수, 예를 들어, 링크가있는 "mainpage"를 사용에 포함 된 <a href="../_Lib1/html/index.html">Lib #1</a>
• libs에는 최상위 레벨 라이브러리 mainpage : 등의 링크가있는 메인 페이지가 있습니다. 는 COM 물건 확실하지 href="../../_TopLevel/html/index.html"

...

스티브

Answer 3

특정 파일이 당신의 Doxygen을 출력에 포함하지 않으려면, 당신은 EXCLUDE_PATTERNS 지시어를 사용할 수 있습니다. 내가 사용하는 한 프로젝트는 Doxygen 출력에 단위 테스트 클래스를 포함시키지 않기 위해

EXCLUDE_PATTERNS = */test/* 

을 사용합니다. 자동 생성 된 COM 파일에 패턴이 있다면이 방법으로 제외시킬 수 있습니다.