Я создаю документацию для проекта, используя задачу Ant. В нескольких местах я хотел наследовать документацию от стандартных классов, поэтому использовал {@inheritDoc}, что позволяло мне видеть Javadoc в Eclipse, но не отображалось в файлах HTML. Проблема заключалась в том, что я не включил разархивированный файл src.zip (источник J2SE) в исходный путь. После исправления я теперь получаю несколько сотен предупреждений об использовании проприетарного API Sun в таких файлах, как lib/jdk-src/java/lang/Class.java.
Есть ли способ подавить эти предупреждения? В этом беспорядке трудно найти актуальные проблемы.
Возможное решение, о котором я подумал, состояло в том, чтобы запустить задачу Javadoc один раз, не включая исходный код J2SE в исходный путь, что выявит любые реальные проблемы. Затем я могу запустить Javadoc во второй раз с включенным исходным кодом J2SE, полностью отбросив выходные данные, что создаст документацию с правильно работающими {@inheritDoc}s. Я не совсем уверен, как лучше всего это сделать в Ant, не говоря уже о том, что запуск Javadoc дважды был бы грязным решением.
Какие-либо предложения?
