Задача Javadoc через Ant с {@inheritDoc} из классов J2SE
Я создаю документацию для проекта, используя задачу 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 было бы грязным решением.
Какие-либо предложения?
1 ответ
Это не решение, которое вы ищете, но вы можете попробовать -link extdocURL. Таким образом, вы по крайней мере получите ссылки "Переопределение" или "Указано" для переопределенных или реализованных методов соответственно. Для библиотек разработки, -linksource вариант тоже удобен.