Eclipse에서 javadoc 만들기

Eclipse 에서 힘들게 만든 패키지의 도움말 파일을 만들기 위하여 javadoc을 사용하게 되었습니다.

Project 메뉴에 "Generate Javadoc..."이란 메뉴가 바로 눈에 들어왔습니다. 

실행해 봤는데, 바로 패키지 전체에 대한 javadoc이 만들어지지 않고 특정 클래스 한개만 표시되는 겁니다. Warning이 한개 있어서 그 때문인가 싶어 Warning이 발생하지 않도록 수정하고, 다시 Javadoc을 만들어 봤지만 결과는 마찬가지였습니다.

그래서 구글링을 통해서 "Export..." 메뉴에서 Javadoc을 생성하는 방법을 찾아서 해 밨더니, 정상적으로 잘 생성되었습니다.

1. JDK가 설치된 폴더에서 javadoc.exe를 찾아 선택합니다.
2. javadoc을 생성할 패키지 전체를 선택합니다.
3. javadoc을 만들 범위를 선택합니다.(저는 package 단계까지 생성되도록 하였습니다.)
4. javadoc이 만들어질 위치를 선택합니다.
5. 모든 설정이 끝났으면 "Finish"를 눌러서 javadoc을 생성합니다.

Project 메뉴의 Javadoc을 생성하는 설정창도 위와 동일한 창이였는데... 안되었던 이유는 단지 아래와 같이 패키지 전체가 선택되지 않았기 때문이었습니다.

위 그림의 LA 패키지 선택 체크 박스가 회색으로 모든 파일이 선택된 것이 아니라, 현재 프로젝트에서 활성화된 소스만 선택되어 있고 결국 활성화된 소스만 javadoc으로 만들어졌었던 겁니다. ^^;