Как заставить Javadoc включать документацию для подпроекта? - PullRequest
3 голосов
/ 13 ноября 2009

У меня есть два проекта в Netbeans, которые тесно связаны между собой. Это отдельные проекты, потому что один из проектов представляет собой пакет утилит, который может быть использован в будущем для другого проекта. Есть ли способ настроить Netbeans так, чтобы Javadoc, сгенерированный для основного проекта, включал ссылки на объекты, определенные в проекте util, вместо перечисления полного пути пакета?

Редактировать : Я нашел, как это сделать. В «Свойствах проекта»> «Сборка»> «Документирование» вы можете установить дополнительные параметры Javadoc. Можно использовать параметр -link, а затем URL-адрес каталога документации. Тем не менее, я могу заставить его работать только с абсолютной ссылкой, и у меня возникают проблемы с работой относительной ссылки .

-link file:///A:\B\C\Util\dist\javadoc //this works
-link file: ..\..\..\Util\dist\javadoc //this doesn't works

Обе папки проекта находятся в каталоге C, поэтому я думаю, что это должен быть правильный относительный путь, основанный на документации.

1 Ответ

3 голосов
/ 17 ноября 2009

Я понимаю, что это предложение лежит за пределами подразумеваемых ограничений вашего вопроса, но может быть лучше использовать инструмент SCM (а не вашу IDE) для публикации Javadoc, который охватывает зависимые проекты. Например, в Maven есть плагин, специально разработанный для публикации Javadoc для модульных проектов.

...