Ant 태스크를 사용하여 프로젝트에 대한 문서를 생성합니다. 여러 곳에서 표준 클래스의 문서를 상속 받기를 원했기 때문에 {@inheritDoc}
을 사용하여 Eclipse에서 Javadoc을 볼 수 있었지만 HTML 파일에는 표시되지 않습니다. 문제는 제가 압축 해제 된 src.zip (J2SE 소스)을 소스 경로에 포함시키지 않았다는 것입니다. 이 문제를 해결하면 lib/jdk-src/java/lang/Class.java
과 같은 파일에서 Sun 고유 API 사용에 대한 수백 가지 경고가 표시됩니다.J2SE 클래스의 {@inheritDoc}을 사용하는 Javadoc Ant 태스크
이러한 경고를 표시하지 않을 방법이 있습니까? 이 난장판에서 관련 문제를 찾기가 어렵습니다.
가능한 해결책은 소스 경로에 J2SE 소스를 포함하지 않고 Javadoc 작업을 한 번 실행하는 것이 었습니다. 그러면 실제 문제가 나타납니다. 그런 다음 J2SE 소스가 포함 된 Javadoc을 두 번 실행하여 출력을 모두 삭제하면 {@inheritDoc}
이 제대로 작동하는 문서가 생성됩니다. Javadoc을 두 번 실행하는 것이 더러운 문제는 아니라고 말하면서 Ant에서이 작업을 수행하는 가장 좋은 방법은 확실하지 않습니다.
제안 사항?