JavaDoc에서와 같이 DOC++의 문서에는 자바, C 또는 C++ 주석이 특별한 형태로 들어간다. 이 주석의 형식은 다음과 같다:/** ... * /주의할 것으로, 두개의 애스터리스크 `/**'가 오는 경우에만 DOC++ 주석이 된다. 이러한 부분을 DOC++ 주석으로 인식한다. 각각의 DOC++ 주석은 뒤에 오는 선언(변수, 클래스 등의)에 대한 문서를 지정하는데 쓰인다.모든 DOC++ 주석에서는 메뉴얼 엔트리를 정의한다. 메뉴얼 엔트리는 DOC++에서 제공하는 문서와 뒤에 오는 선언에 대한 정보로 구성되어 있다.
메뉴얼 엔트리는 다양한 필드로 구성되어 있다. 그중 몇몇은 DOC++ 에서 스스로 채우고 다른 것은 문서 작성하는 사람이 지정할 수 있다. 여기에 메뉴얼 엔트리의 필드가 있다:
필드 이름 지정하는 곳 설명 @type DOC++ 소스 코드에 따라 다르다 @name 둘다 소스 코드에 따라 다르다 @args DOC++ 소스 코드에 따라 다르다 @memo 사용자 짧은 문서 @doc 사용자 긴 문서 @return 사용자 함수의 리턴값에 대한 문서화 @param 사용자 함수의 매개변수에 대한 문서화 @exception 사용자 함수에서 던지는 예외에 대한 문서화 @see 사용자 상호 참조 @author 사용자 작성자 @version user 버전 명시적으로 지정되는 매뉴얼 엔트리를 제외하고, 첫 부분의 세 필드는 보통 DOC++에서 자동으로 생성된다. 여기에 들어가는 내용은 메뉴얼 엔트리의 category에 따라 다르다, 이 카테고리는 DOC++ 주석 다음에 오는 소스코드에 의해서 결정된다. 일반적으로 여기에는 뒤에 오는 선언에 대한 서명 전체를 담고 있다. 다음에 나오는 테이블에는 메뉴얼 엔트리의 모든 카테고리와 그 필드를 채우는 방법이 나열되어 있다.
@name에는 항상 문서화될 선언의 이름이 들어간다. 여기에는 목차도 포함된다.
Category @type @name @args macro #define name [매개변수 리스트] variable Type name - function/method Return type name 매개변수 리스트 [예외] union/enum union/enum name - class/struct class/struct name [분화된 클래스] interface interface name [확장된 인터페이스] 남은 필드는 DOC++ 주석에 있는 내용으로 채우게 된다. @doc과 @memo필드를 제외하고, 필드 이름 바로 뒤에 오는 텍스트부터는 이 필드에 쓰인다. 필드 @name에서 같은 줄에 남은 텍스트가 필드를 채우기 위하여 사용될 때만은 예외이다. 예를 들어
@author Snoopy는 `@author' 필드를 ``Snoopy''로 지정하는데 쓰인다.필드 이름이 붙지 않은 텍스트는 `@doc' 필드에 쓰인다. DOC++ 주석처음부터 글자 `.' 까지는 가 처음으로 나온 `@memo' 필드에도 복사된다. 여기서 `@memo'를 명시적으로 지정함으로써 오버라이드할 수도 있다. 이러한 경우 `.'도 포함된다.
`@type', `@args', `@doc' 필드는 강제로 써넣을 수 없다
Alphabetic index Hierarchy of classes