Универсальная команда javadoc, которая всегда генерирует все javadocs в данном дереве? - PullRequest
20 голосов
/ 17 января 2011

Когда мне нужно сгенерировать javadoc для нового, незнакомого проекта, я обнаруживаю, что трачу много времени, пытаясь просто написать правильную команду, указав все пакеты, все исходные деревья и т. Д. Это отнимает много времени и приводит к ошибке. -пробный: я, вероятно, пропускаю какой-то источник.

Итак, допустим, у меня есть каталог myproj, и под ним есть несколько пакетов (и различные другие ресурсы и прочее), и в этих каталогах пакетов в конечном итоге есть несколько каталогов src /, а затем много моих / awesome / структуры типа java / project / package.

Существует ли одна команда, которая всегда будет повторяться над ВСЕМ и генерировать ВСЕ javadocs в одном месте вывода? Мне все равно, сколько времени это займет. Что-то умопомрачительное, как javadoc -d doc -sourcepath . -subpackages *, было бы здорово. В противном случае, какой самый простой способ генерировать все javadocs, независимо от структуры каталога?

Ответы [ 2 ]

30 голосов
/ 17 января 2011

Используйте find, чтобы найти все исходные файлы Java, а затем отправить их на javadoc:

find . -type f -name "*.java" | xargs javadoc -d outputdir 
19 голосов
/ 09 февраля 2011

В Windows вы можете сделать это следующим образом:

Создать список файлов:

dir /s /b *.java > file.lst

Создать Javadoc:

javadoc -d outputdir @file.lst
...