Как заставить Javadoc включать документацию для подпроекта?

Asked
Viewd549

3

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

Изменить : я нашел, как это сделать.В Project Properties> Build> Documenting вы можете установить дополнительные параметры 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

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

  • Я согласен с chb, конечно, это лучшая практика.

    Sheldon20 ноября 2009, 23:00
  • Хорошо, мне нужно разобраться, что нужно для настройки Maven для работы в моем проекте.

    unholysampler17 ноября 2009, 13:38