javadoc을 거꾸로 해주는 codavaj

JSR에 첨부된 Javadoc은 있는데 코드가 없어서 해당하는 API를 Eclipse 등의 IDE로 볼 수 없어서 아쉬운 경우가 있습니다. 이런 경우 유용한 Javadoc으로부터 원래 Java 코드를 유추해주는 codavaj를 소개합니다.

http://codavaj.sourceforge.net/에서 zip 파일을 받아서 그 안에 든 codavaj.sh 등을 사용해도 되나, Debian이나 Ubuntu는 codavaj-1.2.0.jar만 받고 필요한 패키지들을 깔아서 아래와 같이 쓸 수 있습니다.

sudo apt-get install libdom4j-java libnekohtml-java libxerces-java libjaxen-java

아래와 같이 codavaj 명령을 정의해두고

codavaj() {
    IFS=: jars=(~/bin/codavaj-1.2.0.jar /usr/share/java/{dom4j,nekohtml,xercesImpl,jaxen}.jar)
    java -classpath "${jars[*](*)}" org.codavaj.Main codavaj "$@"
}

Javadoc이 있는 디렉토리(javadoc)와 Java 소스코드를 생성할 위치(src)를 넘겨줘서 사용합니다.

codavaj javadoc src

jar의 manifest에 Main-Class가 왜 없는지 의아하네요. 시간이 허락하면 데비안 패키지도 만들어봐야겠습니다.

java pgmg