Перенос javadoc в задачу ant: Как реализовать опцию «[@files]»?

Question

Я пытаюсь добавить javadoc в процесс сборки муравья, на самом деле не знаю, как "преобразовать" один из вариантов javadoc в задачу ant "". Вот использование Javadoc:

usage: javadoc [options] [packagenames] [sourcefiles] [@files]

Это то, что я уже пробовал:

    <javadoc sourcefiles="build/sourcefiles.txt">
    </javadoc>

И я хочу иметь опцию [@files] в моей задаче муравья, но не могу найти подходящий способ сделать это ... может быть, у вас есть идея?

Заранее спасибо ...

Answer 1

Простейшим (примитивным) способом было бы использование подэлемента arg для предоставления большего количества аргументов командной строки.

<javadoc>
  <arg value="@build/sourcefiles.txt" />
</javadoc>

Но я полагаю, что это не сработает, так как javadocЗадача хочет, чтобы были заданы как минимум обязательные атрибуты.

Чтобы взять список файлов из файла, может помочь коллекция ресурсов filelist вместе с задачей loadfile:

<loadfile property="sourcefiles-list"
          srcFile="build/sourcefiles.txt"
          encoding="US-ASCII" />
<javadoc destdir="...">
  <sourcefiles>
    <filelist files="${sourcefiles-list}"/>
  </sourcefiles>
</javadoc>

---

На самом деле, атрибут packagelist может быть тем, что вам нужно:

<javadoc destdir="..." sourcepath="..."
         packageList="build/sourcefiles.txt">
</javadoc>

Попробуйте сначала (я не уверен, что он также принимает имена файлов).

Answer 2

Зачем портировать его, когда он доступен?

http://ant.apache.org/manual/Tasks/javadoc.html