2010-03-30 3 views
1

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에서이 작업을 수행하는 가장 좋은 방법은 확실하지 않습니다.

제안 사항?

답변

0

당신이 찾고있는 해결책이 아니지만, 시도해보십시오 -linkextdocURL. 그렇게하면 재정의되거나 구현 된 메소드에 대해 적어도 "Overrides" 또는 "Specified by" 링크를 얻을 수 있습니다. 개발 라이브러리의 경우 -linksource 옵션도 편리합니다.