Я создаю документацию для проекта, используя задачу 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 было бы грязным решением.
Есть предложения?