Как мне сделать так, чтобы класс Ant Javadoc исключал два файла?

Я документирую некоторые веб-службы Java и поддерживающие их типы данных. Есть две службы, которые я не хочу документировать. Каков правильный способ исключить небольшое количество файлов из задачи Ant javadoc?

Я пробовал несколько итераций, используя файлы или наборы файлов, вложенные в исходный путь или исходные файлы с различными комбинациями включения и исключения.

Базовая цель, которую я определил правильно, документирует все мои веб-службы:

    <target name="javadoc.webservices" description="Generate the documentation for companyproject webservices">
    <delete dir="docs/webservices" failonerror="true"/>
    <mkdir dir="docs/webservices"/>
    <javadoc packagenames="com.company.project.webservices,com.company.project.models.*"
             defaultexcludes="yes"
             destdir="docs/webservices"
             author="true"
             version="true"
             use="true"
             windowtitle="company project Webservices">
        <doctitle><![CDATA[<h1>company project Webservices</h1>]]></doctitle>
        <bottom><![CDATA[<i>Copyright &#169; 2011 company Corp. All Rights Reserved.</i>]]></bottom>
        <sourcepath>
            <path location="companyproject-ejb/src/java"/>
            <path location="companyproject-models/src"/>
        </sourcepath>
        <classpath>
            <path refid="companyproject-models.module.classpath"/>
            <path refid="companyproject-ejb.module.classpath"/>
            <pathelement location="${companyproject-ejb.output.dir}"/>
        </classpath>
    </javadoc>
</target>

Некоторые варианты, которые я пробовал, включают:

<sourcefiles>
            <fileset dir="companyproject-ejb/src/java">
                <include name="**/*.java"/>
                <exclude name="**/*IntegrationTestWS*, **/*NhinInterfaceWS*"/>
            </fileset>
        </sourcefiles>

Эта ошибка с javadoc.exe Ошибка CreateProcess = 87, параметр неверен

<sourcepath>
            <fileset dir="companyproject-ejb/src/java">
                <include name="**/*.java"/>
                <exclude name="**/*IntegrationTestWS*, **/*NhinInterfaceWS*"/>
            </fileset>
        </sourcepath>

Та же ошибка, что и исходные файлы, но есть много сообщений о том, что пропускается , поскольку это не каталог .

Я пробовал аналогичные варианты, используя вместо ] <набор файлов> .

Думаю, мне не хватает базового понимания того, как работает включает / исключает. Спасибо за вашу помощь!

AlexR не совсем понял, но подошел близко. Я удалил и добавил

<fileset dir="./Companyproject-ejb/src/java/">
<include name="com/Company/project/webservices/*"/>
<exclude name="**/IntegrationTestWS*"/>
<exclude name="**/NhinInterfaceWS*"/>
</fileset>
<packageset dir="./Companyproject-models/src/">
    <include name="com/Company/project/models/**"/>
</packageset>

Из-за наличия только набора файлов javadoc жаловался, что не может найти никаких пакетов. Packageset ведет себя как dirset, поэтому он не может исключать отдельные файлы, только каталоги. В этом случае я смог определить набор пакетов для одного набора документов и набор файлов для ограниченного набора и обойти это.

9
задан Freiheit 20 May 2011 в 09:57
поделиться