작성한 자바코드를 표준 doclet의 javadoc으로 돌리면, package의 설명이 휑허니 빈칸으로 나온다. 어떻게 주석을 달면, package에 대한 설명을 넣을 수 있을까? package의 entry에 package.html을 작성해 주면 이 문제가 해결된다. 만약 package ab.cd.ef.* 가 존재한다면, 디렉토리가 ab/cd/ef가 존재할 것이다. 따라서, ab/cd/ef/pacakge.html을 작성해주면 javadoc 실행시 package의 description을 채워준다. 이 때, 작성 형식은 매우 간단하다. 다음과 같이 기록하기만 하면 body 부분의 설명이 그대로 반영된다.
www.doclet.com에 소개된 바와 같이 여러 종류의 doclet이 있으나, 그 중 몇몇은 javaodc의 출력 형태를 pdf로 직접 지정할 수 있다. LaTex를 쓰는 방법은 LaTex의 특성상 가독성이 좋은 결과물을 만들 것으로 기대되나, 별도로 변환을 한번 더 해줘야 하는 번거로움이 있으므로 이왕이면 손이 덜 가는 방법을 찾아보게 되었다. www.doclet.com에 소개된 library 중 하나인, AurigaDoclet(http://aurigadoclet.sourceforge.net/)을 사용해 보자. 사용법은 간단하다. ANT에서 지정할 수 있는 설정은, package-names package names source-path path of the java source files aurig..