Общая команда javadoc, которая всегда генерирует все javadocs в данном дереве?
когда мне нужно создать javadocs для нового, незнакомого проекта, я нахожу, что я трачу много времени, пытаясь просто написать правильную команду, указав все пакеты, все исходные деревья и т. д. Это отнимает много времени и подвержено ошибкам: мне, вероятно, не хватает какого-то источника.
Итак, предположим, у меня есть каталог myproj, и под ним есть несколько пакетов (и различные другие ресурсы и прочее), и под этими каталогами пакетов в конечном итоге есть некоторые src/ каталоги, а затем множество структур типа my/awesome/java/project/package.
есть ли одна команда, которая всегда будет рекурсировать над всем и генерировать все javadocs в одном месте вывода? Мне все равно, сколько времени это займет. Что-то безмозглое, как javadoc -d doc -sourcepath . -subpackages *
было бы здорово. В противном случае, каков самый простой способ генерировать все javadocs, независимо от структуры каталогов?
2 ответов
использовать find
найти все исходные файлы Java, а затем отправить их в javadoc
:
find . -type f -name "*.java" | xargs javadoc -d outputdir
в Windows вы можете сделать это так:
создать список файлов:
dir /s /b *.java > file.lst
сгенерировать javadoc:
javadoc -d outputdir @file.lst