2018-12-21 11:20:43 +01:00
|
|
|
<!DOCTYPE html>
|
2006-09-11 04:19:00 +00:00
|
|
|
<!--
|
|
|
|
|
Licensed to the Apache Software Foundation (ASF) under one or more
|
|
|
|
|
contributor license agreements. See the NOTICE file distributed with
|
|
|
|
|
this work for additional information regarding copyright ownership.
|
|
|
|
|
The ASF licenses this file to You under the Apache License, Version 2.0
|
|
|
|
|
(the "License"); you may not use this file except in compliance with
|
|
|
|
|
the License. You may obtain a copy of the License at
|
|
|
|
|
|
2019-05-25 13:41:47 +02:00
|
|
|
https://www.apache.org/licenses/LICENSE-2.0
|
2006-09-11 04:19:00 +00:00
|
|
|
|
|
|
|
|
Unless required by applicable law or agreed to in writing, software
|
|
|
|
|
distributed under the License is distributed on an "AS IS" BASIS,
|
|
|
|
|
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
|
|
|
See the License for the specific language governing permissions and
|
|
|
|
|
limitations under the License.
|
|
|
|
|
-->
|
2018-12-21 11:20:43 +01:00
|
|
|
<html lang="en">
|
2001-02-13 12:32:01 +00:00
|
|
|
|
|
|
|
|
<head>
|
2005-04-29 18:58:16 +00:00
|
|
|
<link rel="stylesheet" type="text/css" href="../stylesheets/style.css">
|
2002-02-03 22:00:42 +00:00
|
|
|
<title>Javadoc Task</title>
|
2001-02-13 12:32:01 +00:00
|
|
|
</head>
|
|
|
|
|
|
|
|
|
|
<body>
|
|
|
|
|
|
2018-02-28 07:58:59 +01:00
|
|
|
<h2 id="javadoc">Javadoc/<em>Javadoc2</em></h2>
|
|
|
|
|
<p><em><u>Deprecation</u>: the <code>javadoc2</code> task simply points to the <code>javadoc</code>
|
|
|
|
|
task and it's there for backwards compatibility reasons. Since this task will be removed in future
|
|
|
|
|
versions, you are strongly encouraged to use <a href="javadoc.html">javadoc</a> instead.</em></p>
|
2001-02-13 12:32:01 +00:00
|
|
|
<h3>Description</h3>
|
2018-03-10 20:17:33 +01:00
|
|
|
<p>Generates code documentation using the <kbd>javadoc</kbd> tool.</p>
|
2018-02-28 07:58:59 +01:00
|
|
|
<p>The source directory will be recursively scanned for Java source files to process but only those
|
|
|
|
|
matching the inclusion rules, and not matching the exclusions rules will be passed to
|
2018-03-10 20:17:33 +01:00
|
|
|
the <kbd>javadoc</kbd> tool. This allows wildcards to be used to choose between package names,
|
2018-02-28 07:58:59 +01:00
|
|
|
reducing verbosity and management costs over time. This task, however, has no notion of
|
|
|
|
|
"changed" files, unlike the <a href="javac.html">javac</a> task. This means all packages
|
|
|
|
|
will be processed each time this task is run. In general, however, this task is used much less
|
|
|
|
|
frequently.</p>
|
2018-03-10 20:17:33 +01:00
|
|
|
<p><strong>Note</strong>: since <kbd>javadoc</kbd>
|
|
|
|
|
calls <code class="code">System.exit()</code>, <kbd>javadoc</kbd> cannot be run inside the same
|
|
|
|
|
JVM as Apache Ant without breaking functionality. For this reason, this task always forks JVM. This
|
|
|
|
|
overhead is not significant since <kbd>javadoc</kbd> is normally a heavy application and will be
|
|
|
|
|
called infrequently.</p>
|
2018-02-28 07:58:59 +01:00
|
|
|
<p><strong>Note</strong>: the <var>packagelist</var> attribute allows you to specify the list of
|
|
|
|
|
packages to document outside of the Ant file. It's a much better practice to include everything
|
|
|
|
|
inside the <code>build.xml</code> file. This option was added in order to make it easier to migrate
|
2018-03-10 20:17:33 +01:00
|
|
|
from regular makefiles, where you would use this option of <kbd>javadoc</kbd>. The packages
|
2018-02-28 07:58:59 +01:00
|
|
|
listed in <var>packagelist</var> are not checked, so the task performs even if some packages are
|
|
|
|
|
missing or broken. Use this option if you wish to convert from an existing makefile. Once things are
|
|
|
|
|
running you should then switch to the regular notation.</p>
|
|
|
|
|
|
|
|
|
|
<p>In the table below, 1.2 means available if your current JVM is exactly of version 1.2 (not 1.3 or
|
|
|
|
|
later), 1.4+ for any JVM of at least version 1.4, otherwise any JVM of at least version 1.2 is
|
2018-03-11 14:17:46 +01:00
|
|
|
acceptable. <em>JDKs prior to 1.4 are no longer supported.</em> If you specify
|
|
|
|
|
the <var>executable</var> attribute it is up to you to ensure that this command supports the
|
|
|
|
|
attributes you wish to use.</p>
|
2018-02-28 07:58:59 +01:00
|
|
|
|
|
|
|
|
<p><strong>Note</strong>: When generating the JavaDocs for classes which contains annotations you
|
2018-03-10 20:17:33 +01:00
|
|
|
maybe get a <code class="output">java.lang.ClassCastException:
|
|
|
|
|
com.sun.tools.javadoc.ClassDocImpl</code>. This is
|
|
|
|
|
due <a href="https://bugs.openjdk.java.net/browse/JDK-6442982" target="_top">bug 6442982</a>. The
|
|
|
|
|
cause is that <kbd>javadoc</kbd> cannot find the implementations of used annotations. The
|
|
|
|
|
workaround is providing the jars with these implementations (like
|
|
|
|
|
JAXBs <code class="code">@XmlType</code>, ...) to <code><javadoc></code>
|
|
|
|
|
using <var>classpath</var>, <var>classpathref</var> attributes or
|
2018-02-28 07:58:59 +01:00
|
|
|
nested <code><classpath></code> element.</p>
|
|
|
|
|
|
2018-03-10 20:17:33 +01:00
|
|
|
<p><strong>Note</strong>: many problems with running <kbd>javadoc</kbd> stem from command lines
|
2018-02-28 07:58:59 +01:00
|
|
|
that have become too long—even though the error message doesn't give the slightest hint this
|
|
|
|
|
may be the problem. If you encounter problems with the task, try to set
|
|
|
|
|
the <var>useexternalfile</var> attribute to <q>true</q> first.</p>
|
|
|
|
|
|
2018-03-10 20:17:33 +01:00
|
|
|
<p>If you use multiple ways to specify where <kbd>javadoc</kbd> should be looking for sources, your
|
|
|
|
|
result will be the union of all specified documentations. If you, e.g., specify
|
2018-02-28 07:58:59 +01:00
|
|
|
a <var>sourcepath</var> attribute and also a nested <code>packageset</code> both pointing at the
|
|
|
|
|
same directory your <var>excludepackagenames</var> attribute won't have any effect unless it agrees
|
|
|
|
|
with the <var>exclude</var> patterns of the <code>packageset</code> (and vice versa).</p>
|
2009-06-19 14:01:23 +00:00
|
|
|
|
2001-02-13 12:32:01 +00:00
|
|
|
<h3>Parameters</h3>
|
2018-02-28 07:58:59 +01:00
|
|
|
<table class="attr">
|
2001-02-13 12:32:01 +00:00
|
|
|
<tr>
|
2018-05-15 10:29:27 +02:00
|
|
|
<th scope="col">Attribute</th>
|
|
|
|
|
<th scope="col">Description</th>
|
|
|
|
|
<th scope="col">Availability on Java</th>
|
|
|
|
|
<th scope="col">Required</th>
|
2001-02-13 12:32:01 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>sourcepath</td>
|
|
|
|
|
<td>Specify where to find source files</td>
|
|
|
|
|
<td>all</td>
|
2018-09-29 18:01:36 +02:00
|
|
|
<td rowspan="4">At least one of the four or
|
2018-09-28 20:42:18 +02:00
|
|
|
nested <code><sourcepath></code>, <code><fileset></code>,
|
2018-09-28 20:27:53 +02:00
|
|
|
<code>module</code> or <code><packageset></code></td>
|
2001-02-13 12:32:01 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>sourcepathref</td>
|
|
|
|
|
<td>Specify where to find source files by <a href="../using.html#references">reference</a> to a
|
|
|
|
|
<var>sourcepath</var> defined elsewhere.</td>
|
|
|
|
|
<td class="left">all</td>
|
2001-02-13 12:32:01 +00:00
|
|
|
</tr>
|
2002-04-26 16:06:52 +00:00
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>sourcefiles</td>
|
|
|
|
|
<td>Comma separated list of source files—see also the nested <code>source</code>
|
|
|
|
|
element.</td>
|
|
|
|
|
<td class="left">all</td>
|
2002-04-26 16:06:52 +00:00
|
|
|
</tr>
|
2018-09-28 20:27:53 +02:00
|
|
|
<tr>
|
2018-09-28 20:42:18 +02:00
|
|
|
<td>modulenames</td>
|
|
|
|
|
<td>Comma separated list of module names -- see also
|
|
|
|
|
the nested <code>module</code> element. <em>since Ant 1.10.6</em></td>
|
|
|
|
|
<td>all</td>
|
2018-09-28 20:27:53 +02:00
|
|
|
</tr>
|
2001-02-13 12:32:01 +00:00
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>destdir</td>
|
|
|
|
|
<td>Destination directory for output files</td>
|
|
|
|
|
<td>all</td>
|
|
|
|
|
<td>Yes, unless a <var>doclet</var> has been specified.</td>
|
2001-02-13 12:32:01 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>maxmemory</td>
|
2018-03-10 20:17:33 +01:00
|
|
|
<td>Max amount of memory to allocate to the <kbd>javadoc</kbd> JVM</td>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>all</td>
|
|
|
|
|
<td>No</td>
|
2001-02-13 12:32:01 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>packagenames</td>
|
|
|
|
|
<td>Comma separated list of package files (with terminating wildcard)—see also the
|
|
|
|
|
nested <code>package</code> element.</td>
|
|
|
|
|
<td>all</td>
|
|
|
|
|
<td>No</td>
|
2001-02-13 12:32:01 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>packageList</td>
|
|
|
|
|
<td>The name of a file containing the packages to process</td>
|
|
|
|
|
<td>all</td>
|
|
|
|
|
<td>No</td>
|
2001-02-13 12:32:01 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>classpath</td>
|
|
|
|
|
<td>Specify where to find user class files</td>
|
|
|
|
|
<td>all</td>
|
|
|
|
|
<td>No</td>
|
2001-02-13 12:32:01 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>Bootclasspath</td>
|
|
|
|
|
<td>Override location of class files loaded by the bootstrap class loader</td>
|
|
|
|
|
<td>all</td>
|
|
|
|
|
<td>No</td>
|
2001-02-13 12:32:01 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>classpathref</td>
|
|
|
|
|
<td>Specify where to find user class files by <a href="../using.html#references">reference</a>
|
|
|
|
|
to a <var>classpath</var> defined elsewhere.</td>
|
|
|
|
|
<td>all</td>
|
|
|
|
|
<td>No</td>
|
2001-02-13 12:32:01 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>bootclasspathref</td>
|
|
|
|
|
<td>Override location of class files loaded by the bootstrap class loader
|
|
|
|
|
by <a href="../using.html#references">reference</a> to a <var>bootclasspath</var> defined
|
|
|
|
|
elsewhere.</td>
|
|
|
|
|
<td>all</td>
|
|
|
|
|
<td>No</td>
|
2001-02-13 12:32:01 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>Extdirs</td>
|
|
|
|
|
<td>Override location of installed extensions</td>
|
|
|
|
|
<td>all</td>
|
|
|
|
|
<td>No</td>
|
2001-02-13 12:32:01 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>Overview</td>
|
|
|
|
|
<td>Read overview documentation from HTML file</td>
|
|
|
|
|
<td>all</td>
|
|
|
|
|
<td>No</td>
|
2001-02-13 12:32:01 +00:00
|
|
|
</tr>
|
2001-05-10 12:14:36 +00:00
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>access</td>
|
|
|
|
|
<td>Access mode: one of <q>public</q>, <q>protected</q>, <q>package</q>, or <q>private</q></td>
|
|
|
|
|
<td>all</td>
|
|
|
|
|
<td>No; default is <q>protected</q></td>
|
2001-05-10 12:14:36 +00:00
|
|
|
</tr>
|
2001-02-13 12:32:01 +00:00
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>Public</td>
|
|
|
|
|
<td>Show only public classes and members</td>
|
|
|
|
|
<td>all</td>
|
|
|
|
|
<td>No</td>
|
2001-02-13 12:32:01 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>Protected</td>
|
|
|
|
|
<td>Show protected/public classes and members (default)</td>
|
|
|
|
|
<td>all</td>
|
|
|
|
|
<td>No</td>
|
2001-02-13 12:32:01 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>Package</td>
|
|
|
|
|
<td>Show package/protected/public classes and members</td>
|
|
|
|
|
<td>all</td>
|
|
|
|
|
<td>No</td>
|
2001-02-13 12:32:01 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>Private</td>
|
|
|
|
|
<td>Show all classes and members</td>
|
|
|
|
|
<td>all</td>
|
|
|
|
|
<td>No</td>
|
2001-02-13 12:32:01 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>Old</td>
|
|
|
|
|
<td>Generate output using JDK 1.1 emulating doclet.<br/><strong>Note</strong>: <em>Since Ant
|
2018-03-10 20:17:33 +01:00
|
|
|
1.8.0</em> this attribute has no effect because <kbd>javadoc</kbd> of Java 1.4 and later
|
|
|
|
|
does not support the <kbd>-1.1</kbd> switch anymore.</td>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>1.2</td>
|
|
|
|
|
<td>No</td>
|
2001-02-13 12:32:01 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>Verbose</td>
|
2018-03-10 20:17:33 +01:00
|
|
|
<td>Output messages about what <kbd>javadoc</kbd> is doing</td>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>all</td>
|
|
|
|
|
<td>No</td>
|
2001-02-13 12:32:01 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>Locale</td>
|
|
|
|
|
<td>Locale to be used, e.g. <q>en_US</q> or <q>en_US_WIN</q></td>
|
|
|
|
|
<td>all</td>
|
|
|
|
|
<td>No</td>
|
2001-02-13 12:32:01 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>Encoding</td>
|
|
|
|
|
<td>Source file encoding name</td>
|
|
|
|
|
<td>all</td>
|
|
|
|
|
<td>No</td>
|
2001-02-13 12:32:01 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>Version</td>
|
|
|
|
|
<td>Include <code>@version</code> paragraphs</td>
|
|
|
|
|
<td>all</td>
|
|
|
|
|
<td>No</td>
|
2001-02-13 12:32:01 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>Use</td>
|
|
|
|
|
<td>Create class and package usage pages</td>
|
|
|
|
|
<td>all</td>
|
|
|
|
|
<td>No</td>
|
2001-02-13 12:32:01 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>Author</td>
|
|
|
|
|
<td>Include <code>@author</code> paragraphs</td>
|
|
|
|
|
<td>all</td>
|
|
|
|
|
<td>No</td>
|
2001-02-13 12:32:01 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>Splitindex</td>
|
|
|
|
|
<td>Split index into one file per letter</td>
|
|
|
|
|
<td>all</td>
|
|
|
|
|
<td>No</td>
|
2001-02-13 12:32:01 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>Windowtitle</td>
|
|
|
|
|
<td>Browser window title for the documentation (text)</td>
|
|
|
|
|
<td>all</td>
|
|
|
|
|
<td>No</td>
|
2001-02-13 12:32:01 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>Doctitle</td>
|
|
|
|
|
<td>Include title for the package index (first) page (HTML code)</td>
|
|
|
|
|
<td>all</td>
|
|
|
|
|
<td>No</td>
|
2001-02-13 12:32:01 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>Header</td>
|
|
|
|
|
<td>Include header text for each page (HTML code)</td>
|
|
|
|
|
<td>all</td>
|
|
|
|
|
<td>No</td>
|
2001-02-13 12:32:01 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>Footer</td>
|
|
|
|
|
<td>Include footer text for each page (HTML code)</td>
|
|
|
|
|
<td>all</td>
|
|
|
|
|
<td>No</td>
|
2001-02-13 12:32:01 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>bottom</td>
|
|
|
|
|
<td>Include bottom text for each page (HTML code)</td>
|
|
|
|
|
<td>all</td>
|
|
|
|
|
<td>No</td>
|
2001-02-13 12:32:01 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>link</td>
|
|
|
|
|
<td>Create links to <code>javadoc</code> output at the given URL—see also the
|
|
|
|
|
nested <code>link</code> element.</td>
|
|
|
|
|
<td>all</td>
|
|
|
|
|
<td>No</td>
|
2001-02-13 12:32:01 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>linkoffline</td>
|
|
|
|
|
<td>Link to docs at <samp><em>url</em></samp> using package list
|
|
|
|
|
at <samp><em>alt-url</em></samp> by specifying a
|
|
|
|
|
value <q><em>url</em> <em>alt-url</em></q> (space as separator). A shorthand for the
|
|
|
|
|
nested <code>link</code> element with <var>offline</var>=<q>true</q>.</td>
|
|
|
|
|
<td>all</td>
|
|
|
|
|
<td>No</td>
|
2001-02-13 12:32:01 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>group</td>
|
|
|
|
|
<td>Group specified packages together in overview page. The format is as
|
|
|
|
|
described <a href="#groupattribute">below</a>—see also the nested <code>group</code>
|
|
|
|
|
element.</td>
|
|
|
|
|
<td>all</td>
|
|
|
|
|
<td>No</td>
|
2001-02-13 12:32:01 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>nodeprecated</td>
|
|
|
|
|
<td>Do not include <code>@deprecated</code> information</td>
|
|
|
|
|
<td>all</td>
|
|
|
|
|
<td>No</td>
|
2001-02-13 12:32:01 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>nodeprecatedlist</td>
|
|
|
|
|
<td>Do not generate deprecated list</td>
|
|
|
|
|
<td>all</td>
|
|
|
|
|
<td>No</td>
|
2001-02-13 12:32:01 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>notree</td>
|
|
|
|
|
<td>Do not generate class hierarchy</td>
|
|
|
|
|
<td>all</td>
|
|
|
|
|
<td>No</td>
|
2001-02-13 12:32:01 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>noindex</td>
|
|
|
|
|
<td>Do not generate index</td>
|
|
|
|
|
<td>all</td>
|
|
|
|
|
<td>No</td>
|
2001-02-13 12:32:01 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>nohelp</td>
|
|
|
|
|
<td>Do not generate help link</td>
|
|
|
|
|
<td>all</td>
|
|
|
|
|
<td>No</td>
|
2001-02-13 12:32:01 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>nonavbar</td>
|
|
|
|
|
<td>Do not generate navigation bar</td>
|
|
|
|
|
<td>all</td>
|
|
|
|
|
<td>No</td>
|
2001-02-13 12:32:01 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>serialwarn</td>
|
|
|
|
|
<td>Generate warning about <code>@serial</code> tag</td>
|
|
|
|
|
<td>all</td>
|
|
|
|
|
<td>No</td>
|
2001-02-13 12:32:01 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>helpfile</td>
|
|
|
|
|
<td>Specifies the HTML help file to use</td>
|
|
|
|
|
<td>all</td>
|
|
|
|
|
<td>No</td>
|
2001-02-13 12:32:01 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>stylesheetfile</td>
|
|
|
|
|
<td>Specifies the CSS stylesheet to use</td>
|
|
|
|
|
<td>all</td>
|
|
|
|
|
<td>No</td>
|
2001-02-13 12:32:01 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>charset</td>
|
|
|
|
|
<td>Charset for cross-platform viewing of generated documentation</td>
|
|
|
|
|
<td>all</td>
|
|
|
|
|
<td>No</td>
|
2001-02-13 12:32:01 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>docencoding</td>
|
|
|
|
|
<td>Output file encoding name</td>
|
|
|
|
|
<td>all</td>
|
|
|
|
|
<td>No</td>
|
2001-02-13 12:32:01 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>doclet</td>
|
|
|
|
|
<td>Specifies the class file that starts the doclet used in generating the
|
|
|
|
|
documentation—see also the nested <code>doclet</code> element.</td>
|
|
|
|
|
<td>all</td>
|
|
|
|
|
<td>No</td>
|
2001-02-13 12:32:01 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>docletpath</td>
|
2018-03-10 20:17:33 +01:00
|
|
|
<td>Specifies the path to the doclet class file that is specified with the <kbd>-doclet</kbd>
|
2018-02-28 07:58:59 +01:00
|
|
|
option.</td>
|
|
|
|
|
<td>all</td>
|
|
|
|
|
<td>No</td>
|
2001-02-13 12:32:01 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>docletpathref</td>
|
2018-03-10 20:17:33 +01:00
|
|
|
<td>Specifies the path to the doclet class file that is specified with the <kbd>-doclet</kbd>
|
|
|
|
|
option by <a href="../using.html#references">reference</a> to a path defined elsewhere.</td>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>all</td>
|
|
|
|
|
<td>No</td>
|
2001-02-13 12:32:01 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>additionalparam</td>
|
2018-03-10 20:17:33 +01:00
|
|
|
<td>Lets you add additional parameters to the <kbd>javadoc</kbd> command line. Useful for
|
2018-02-28 07:58:59 +01:00
|
|
|
doclets. Parameters containing spaces need to be quoted using &quot;—see also the
|
2018-03-10 20:17:33 +01:00
|
|
|
nested <code>arg</code> element.</td>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>all</td>
|
|
|
|
|
<td>No</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td>failonerror</td>
|
2018-03-02 08:23:45 +01:00
|
|
|
<td>Stop the build process if the command exits with a return code other than <q>0</q>.</td>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>all</td>
|
|
|
|
|
<td>No</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td>failonwarning</td>
|
2018-03-10 20:17:33 +01:00
|
|
|
<td>Stop the build process if a warning is emitted—i.e. if <kbd>javadoc</kbd>'s output
|
2018-02-28 07:58:59 +01:00
|
|
|
contains the word <q>warning</q>. <em>since Ant 1.9.4</em></td>
|
|
|
|
|
<td>all</td>
|
|
|
|
|
<td>No</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td>excludepackagenames</td>
|
|
|
|
|
<td>comma separated list of packages you don't want docs for—see also the
|
|
|
|
|
nested <code>excludepackage</code> element.</td>
|
|
|
|
|
<td>all</td>
|
|
|
|
|
<td>No</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td>defaultexcludes</td>
|
|
|
|
|
<td>indicates whether default excludes should be used (<q>yes|no</q>).</td>
|
|
|
|
|
<td>all</td>
|
|
|
|
|
<td>No; defaults to <q>yes</q></td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td>useexternalfile</td>
|
|
|
|
|
<td>indicates whether the source file names specified in <var>srcfiles</var> or as
|
|
|
|
|
nested <code>source</code> elements should be written to a temporary file to make the command
|
|
|
|
|
line shorter. Also applies to the package names specified via the <var>packagenames</var>
|
|
|
|
|
attribute or nested <code>package</code> elements. <em>Since Ant 1.7.0</em>, also applies to
|
2020-05-05 14:51:38 +02:00
|
|
|
all the other command line options. (<q>yes|no</q>).<br/>
|
2020-03-08 17:14:44 +01:00
|
|
|
If enabled, the file will be written to
|
|
|
|
|
the <a href="../running.html#tmpdir">temporary
|
2020-05-05 14:51:38 +02:00
|
|
|
directory</a>.</td>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>all</td>
|
|
|
|
|
<td>No; default is <q>no</q></td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td>source</td>
|
2018-03-10 20:17:33 +01:00
|
|
|
<td>Enable <kbd>javadoc</kbd> to handle Java language features. Set this to <q>1.4</q> to
|
|
|
|
|
document code that compiles using <kbd>javac -source 1.4</kbd>, etc.</td>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>1.4+</td>
|
|
|
|
|
<td>No; default can be provided using the magic
|
|
|
|
|
<a href="../javacprops.html#source"><code>ant.build.javac.source</code></a> property.</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td>linksource</td>
|
|
|
|
|
<td>Generate hyperlinks to source files. <em>since Ant 1.6</em>. (<q>yes|no</q>).</td>
|
|
|
|
|
<td>1.4+</td>
|
|
|
|
|
<td>No; default is <q>no</q></td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td>breakiterator</td>
|
|
|
|
|
<td>Use the new break iterator algorithm. <em>since Ant 1.6</em>. (<q>yes|no</q>).</td>
|
|
|
|
|
<td>1.4+</td>
|
|
|
|
|
<td>No; default is <q>no</q></td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td>noqualifier</td>
|
2018-03-10 20:17:33 +01:00
|
|
|
<td>Enables the <kbd>-noqualifier</kbd> argument—must be <q>all</q> or a colon separated
|
2018-02-28 07:58:59 +01:00
|
|
|
list of packages. <em>since Ant 1.6</em>.</td>
|
|
|
|
|
<td>1.4+</td>
|
|
|
|
|
<td>No</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td>includenosourcepackages</td>
|
|
|
|
|
<td>If set to <q>true</q>, packages that don't contain Java source but
|
|
|
|
|
a <samp>package.html</samp> will get documented as well. <em>since Ant 1.6.3</em>.</td>
|
|
|
|
|
<td>all</td>
|
|
|
|
|
<td>No; default is <q>false</q></td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td>executable</td>
|
2018-03-10 20:17:33 +01:00
|
|
|
<td>Specify a particular <kbd>javadoc</kbd> executable to use in place of the default binary
|
2018-02-28 07:58:59 +01:00
|
|
|
(found in the same JDK as Ant is running in). <em>since Ant 1.6.3</em>.</td>
|
|
|
|
|
<td>all</td>
|
|
|
|
|
<td>No</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td>docfilessubdirs</td>
|
|
|
|
|
<td>Enables deep-copying of <samp>doc-files</samp> subdirectories. <em>since Ant
|
|
|
|
|
1.8.0</em>.</td>
|
|
|
|
|
<td>1.4</td>
|
|
|
|
|
<td>No; defaults to <q>false</q></td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td>excludedocfilessubdir</td>
|
|
|
|
|
<td>Colon-separated list of <samp>doc-files</samp> subdirectories to exclude
|
|
|
|
|
if <var>docfilessubdirs</var> is true. <em>since Ant 1.8.0</em>.</td>
|
|
|
|
|
<td>1.4</td>
|
|
|
|
|
<td>No</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td>postProcessGeneratedJavadocs</td>
|
|
|
|
|
<td>Whether to post-process the generated javadocs in order to mitigate
|
2018-03-02 08:23:45 +01:00
|
|
|
CVE-2013-1571. <em>Since Ant 1.9.2</em><br/> There is a frame injection attack possible in
|
2018-02-28 07:58:59 +01:00
|
|
|
javadocs generated by Oracle JDKs prior to Java 7 update 25
|
|
|
|
|
(<a href="https://www.oracle.com/technetwork/java/javase/7u25-relnotes-1955741.html#jpi-upt"
|
2018-03-08 07:43:53 +01:00
|
|
|
target="_top">details</a>). When this flag is set to <q>true</q>, Ant will check whether the
|
|
|
|
|
docs are vulnerable and will try to fix them.</td>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>1.4</td>
|
|
|
|
|
<td>No; defaults to <q>true</q></td>
|
2013-06-24 15:12:57 +00:00
|
|
|
</tr>
|
2018-09-28 20:27:53 +02:00
|
|
|
<tr>
|
2018-09-28 20:42:18 +02:00
|
|
|
<td>modulesourcepath</td>
|
|
|
|
|
<td>Specify where to find module source files
|
|
|
|
|
<em>since Ant 1.10.6</em></td>
|
|
|
|
|
<td>all</td>
|
|
|
|
|
<td>No</td>
|
2018-09-28 20:27:53 +02:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-09-28 20:42:18 +02:00
|
|
|
<td>modulesourcepathref</td>
|
|
|
|
|
<td>Specify where to find module source files by <a
|
2018-09-28 20:27:53 +02:00
|
|
|
href="../using.html#references">reference</a> to a PATH defined elsewhere.
|
2018-09-28 20:42:18 +02:00
|
|
|
<em>since Ant 1.10.6</em></td>
|
|
|
|
|
<td>all</td>
|
|
|
|
|
<td>No</td>
|
2018-09-28 20:27:53 +02:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-09-28 20:42:18 +02:00
|
|
|
<td>modulepath</td>
|
|
|
|
|
<td>Specify where to find module files
|
|
|
|
|
<em>since Ant 1.10.6</em></td>
|
|
|
|
|
<td>all</td>
|
|
|
|
|
<td>No</td>
|
2018-09-28 20:27:53 +02:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-09-28 20:42:18 +02:00
|
|
|
<td>modulepathref</td>
|
|
|
|
|
<td>Specify where to find module files by <a
|
2018-09-28 20:27:53 +02:00
|
|
|
href="../using.html#references">reference</a> to a PATH defined elsewhere.
|
2018-09-28 20:42:18 +02:00
|
|
|
<em>since Ant 1.10.6</em></td>
|
|
|
|
|
<td>all</td>
|
|
|
|
|
<td>No</td>
|
2018-09-28 20:27:53 +02:00
|
|
|
</tr>
|
2001-02-13 12:32:01 +00:00
|
|
|
</table>
|
|
|
|
|
|
2018-01-22 23:52:21 +01:00
|
|
|
<h4 id="groupattribute">Format of the group attribute</h4>
|
2018-02-28 07:58:59 +01:00
|
|
|
<p>The arguments are comma-delimited. Each single argument is 2 space-delimited strings, where the
|
|
|
|
|
first one is the group's title and the second one a colon delimited list of packages.</p>
|
|
|
|
|
<p>If you need to specify more than one group, or a group whose title contains a comma or a space
|
|
|
|
|
character, using <a href="#groupelement">nested <code>group</code> elements</a> is highly
|
2001-04-18 14:49:52 +00:00
|
|
|
recommended.</p>
|
2004-03-09 15:57:31 +00:00
|
|
|
<p>E.g.:</p>
|
2018-02-28 07:58:59 +01:00
|
|
|
<pre>group="XSLT_Packages org.apache.xalan.xslt*,XPath_Packages org.apache.xalan.xpath*"</pre>
|
2001-04-18 14:49:52 +00:00
|
|
|
|
2001-02-13 12:32:01 +00:00
|
|
|
<h3>Parameters specified as nested elements</h3>
|
2001-05-10 12:14:36 +00:00
|
|
|
|
2002-04-26 16:06:52 +00:00
|
|
|
<h4>packageset</h4>
|
|
|
|
|
|
2018-02-28 07:58:59 +01:00
|
|
|
<p>A <a href="../Types/dirset.html">DirSet</a>. All matched directories that contain Java source
|
2018-03-10 20:17:33 +01:00
|
|
|
files will be passed to <kbd>javadoc</kbd> as package names. Package names are created from the
|
2018-02-28 07:58:59 +01:00
|
|
|
directory names by translating the directory separator into dots. Ant assumes the base directory of
|
|
|
|
|
the <code>packageset</code> points to the root of a package hierarchy.</p>
|
2002-04-26 16:06:52 +00:00
|
|
|
|
2018-02-28 07:58:59 +01:00
|
|
|
<p>The <var>packagenames</var>, <var>excludepackagenames</var> and <var>defaultexcludes</var>
|
|
|
|
|
attributes of the task have no effect on the nested <code><packageset></code> elements.</p>
|
2002-04-26 16:06:52 +00:00
|
|
|
|
|
|
|
|
<h4>fileset</h4>
|
|
|
|
|
|
2018-02-28 07:58:59 +01:00
|
|
|
<p>A <a href="../Types/fileset.html">FileSet</a>. All matched files will be passed
|
2018-03-10 20:17:33 +01:00
|
|
|
to <kbd>javadoc</kbd> as source files. Ant will automatically add the include
|
2018-02-28 07:58:59 +01:00
|
|
|
pattern <samp>**/*.java</samp> (and <samp>**/package.html</samp>
|
|
|
|
|
if <var>includenosourcepackages</var> is <q>true</q>) to these filesets.</p>
|
2002-04-26 16:06:52 +00:00
|
|
|
|
2018-02-28 07:58:59 +01:00
|
|
|
<p>Nested filesets can be used to document sources that are in the default package or if you want to
|
|
|
|
|
exclude certain files from documentation. If you want to document all source files and don't use
|
|
|
|
|
the default package, <code>packageset</code>s should be used instead as this increases performance
|
2018-03-10 20:17:33 +01:00
|
|
|
of <kbd>javadoc</kbd>.</p>
|
2002-04-26 16:06:52 +00:00
|
|
|
|
2018-02-28 07:58:59 +01:00
|
|
|
<p>The <var>packagenames</var>, <var>excludepackagenames</var> and <var>defaultexcludes</var>
|
|
|
|
|
attributes of the task have no effect on the nested <code><fileset></code> elements.</p>
|
2002-04-26 16:06:52 +00:00
|
|
|
|
2006-04-06 18:27:32 +00:00
|
|
|
<h4>sourcefiles</h4>
|
|
|
|
|
|
2018-02-28 07:58:59 +01:00
|
|
|
<p>A container for arbitrary file system based <a href="../Types/resources.html#collection">resource
|
|
|
|
|
collections</a>. All files contained in any of the nested collections (this includes nested
|
|
|
|
|
filesets, filelists or paths) will be passed to javadoc as source files.</p>
|
2006-04-06 18:27:32 +00:00
|
|
|
|
2001-05-10 12:14:36 +00:00
|
|
|
<h4>package</h4>
|
2018-02-28 07:58:59 +01:00
|
|
|
<p>Same as one entry in the list given by <var>packagenames</var>.</p>
|
2001-05-10 12:14:36 +00:00
|
|
|
|
|
|
|
|
<h5>Parameters</h5>
|
2018-02-28 07:58:59 +01:00
|
|
|
<table class="attr">
|
2001-05-10 12:14:36 +00:00
|
|
|
<tr>
|
2018-05-15 10:29:27 +02:00
|
|
|
<th scope="col">Attribute</th>
|
|
|
|
|
<th scope="col">Description</th>
|
|
|
|
|
<th scope="col">Required</th>
|
2001-05-10 12:14:36 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>name</td>
|
|
|
|
|
<td>The package name (may be a wildcard)</td>
|
|
|
|
|
<td>Yes</td>
|
2001-05-10 12:14:36 +00:00
|
|
|
</tr>
|
|
|
|
|
</table>
|
2003-03-05 03:03:11 +00:00
|
|
|
|
2001-05-10 12:14:36 +00:00
|
|
|
<h4>excludepackage</h4>
|
2018-02-28 07:58:59 +01:00
|
|
|
<p>Same as one entry in the list given by <var>excludepackagenames</var>.</p>
|
2001-05-10 12:14:36 +00:00
|
|
|
|
|
|
|
|
<h5>Parameters</h5>
|
|
|
|
|
Same as for <code>package</code>.
|
|
|
|
|
|
2018-09-28 20:27:53 +02:00
|
|
|
<h4>module</h4>
|
2018-09-28 20:42:18 +02:00
|
|
|
<p><em>since Ant 1.10.6</em></p>
|
2018-09-28 20:27:53 +02:00
|
|
|
<p>Same as one entry in the list given by <code>modulenames</code>.</p>
|
|
|
|
|
|
|
|
|
|
<h5>Parameters</h5>
|
2019-03-01 22:34:05 +01:00
|
|
|
<table class="attr">
|
2018-09-28 20:27:53 +02:00
|
|
|
<tr>
|
2019-03-01 22:34:05 +01:00
|
|
|
<th scope="col">Attribute</th>
|
|
|
|
|
<th scope="col">Description</th>
|
|
|
|
|
<th scope="col">Required</th>
|
2018-09-28 20:27:53 +02:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-09-28 20:42:18 +02:00
|
|
|
<td>name</td>
|
|
|
|
|
<td>The module name</td>
|
|
|
|
|
<td>Yes</td>
|
2018-09-28 20:27:53 +02:00
|
|
|
</tr>
|
|
|
|
|
</table>
|
|
|
|
|
|
2001-05-10 12:14:36 +00:00
|
|
|
<h4>source</h4>
|
2018-02-28 07:58:59 +01:00
|
|
|
<p>Same as one entry in the list given by <var>sourcefiles</var>.</p>
|
2001-05-10 12:14:36 +00:00
|
|
|
|
|
|
|
|
<h5>Parameters</h5>
|
2018-02-28 07:58:59 +01:00
|
|
|
<table class="attr">
|
2001-05-10 12:14:36 +00:00
|
|
|
<tr>
|
2018-05-15 10:29:27 +02:00
|
|
|
<th scope="col">Attribute</th>
|
|
|
|
|
<th scope="col">Description</th>
|
|
|
|
|
<th scope="col">Required</th>
|
2001-05-10 12:14:36 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>file</td>
|
|
|
|
|
<td>The source file to document</td>
|
|
|
|
|
<td>Yes</td>
|
2001-05-10 12:14:36 +00:00
|
|
|
</tr>
|
|
|
|
|
</table>
|
|
|
|
|
|
|
|
|
|
<h4>doctitle</h4>
|
|
|
|
|
|
2018-02-28 07:58:59 +01:00
|
|
|
<p>Same as the <var>doctitle</var> attribute, but you can nest text inside the element this way.</p>
|
2001-05-10 12:14:36 +00:00
|
|
|
|
2018-02-28 07:58:59 +01:00
|
|
|
<p>If the nested text contains line breaks, you must use the <var>useexternalfile</var> attribute
|
|
|
|
|
and set it to <q>true</q>.</p>
|
2008-10-10 16:20:54 +00:00
|
|
|
|
2001-05-10 12:14:36 +00:00
|
|
|
<h4>header</h4>
|
|
|
|
|
|
|
|
|
|
<p>Similar to <code><doctitle></code>.</p>
|
|
|
|
|
|
|
|
|
|
<h4>footer</h4>
|
|
|
|
|
|
|
|
|
|
<p>Similar to <code><doctitle></code>.</p>
|
|
|
|
|
|
|
|
|
|
<h4>bottom</h4>
|
|
|
|
|
|
|
|
|
|
<p>Similar to <code><doctitle></code>.</p>
|
|
|
|
|
|
2001-02-13 12:32:01 +00:00
|
|
|
<h4>link</h4>
|
2018-03-10 20:17:33 +01:00
|
|
|
<p>Create link to <kbd>javadoc</kbd> output at the given URL. This performs the same role as
|
2018-02-28 07:58:59 +01:00
|
|
|
the <var>link</var> and <var>linkoffline</var> attributes. You can use either syntax (or both at
|
|
|
|
|
once), but with the nested elements you can easily specify multiple occurrences of the
|
|
|
|
|
arguments.</p>
|
2001-02-13 12:32:01 +00:00
|
|
|
|
2001-05-10 12:14:36 +00:00
|
|
|
<h5>Parameters</h5>
|
2018-02-28 07:58:59 +01:00
|
|
|
<table class="attr">
|
2001-02-13 12:32:01 +00:00
|
|
|
<tr>
|
2018-05-15 10:29:27 +02:00
|
|
|
<th scope="col">Attribute</th>
|
|
|
|
|
<th scope="col">Description</th>
|
|
|
|
|
<th scope="col">Required</th>
|
2001-02-13 12:32:01 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>href</td>
|
|
|
|
|
<td>The URL for the external documentation you wish to link to. This can be an absolute URL, or
|
|
|
|
|
a relative file name.</td>
|
|
|
|
|
<td>Yes</td>
|
2001-02-13 12:32:01 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>offline</td>
|
|
|
|
|
<td><q>true</q> if this link is not available online at the time of generating the
|
|
|
|
|
documentation</td>
|
|
|
|
|
<td>No</td>
|
2001-02-13 12:32:01 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>packagelistLoc</td>
|
|
|
|
|
<td>The location to the directory containing the package-list file for the external
|
|
|
|
|
documentation</td>
|
|
|
|
|
<td rowspan="2">One of the two if the <var>offline</var> attribute is <q>true</q></td>
|
2008-08-20 14:44:14 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>packagelistURL</td>
|
|
|
|
|
<td class="left">The URL of the the directory containing the package-list file for the external
|
|
|
|
|
documentation</td>
|
2001-02-13 12:32:01 +00:00
|
|
|
</tr>
|
2005-03-17 09:06:22 +00:00
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>resolveLink</td>
|
|
|
|
|
<td>If the <var>link</var> attribute is a relative file name, Ant will first try to locate the
|
|
|
|
|
file relative to the current project's <var>basedir</var> and if it finds a file there use an
|
|
|
|
|
absolute URL for the <var>link</var> attribute, otherwise it will pass the file name verbatim
|
2018-03-10 20:17:33 +01:00
|
|
|
to the <kbd>javadoc</kbd> command.</td>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>No; default is <q>false</q></td>
|
2005-03-17 09:06:22 +00:00
|
|
|
</tr>
|
2001-02-13 12:32:01 +00:00
|
|
|
</table>
|
2003-03-05 03:03:11 +00:00
|
|
|
|
2018-01-22 23:52:21 +01:00
|
|
|
<h4 id="groupelement">group</h4>
|
2018-02-28 07:58:59 +01:00
|
|
|
<p>Separates packages on the overview page into whatever groups you specify, one group per
|
|
|
|
|
table. This performs the same role as the <var>group</var> attribute. You can use either syntax (or
|
|
|
|
|
both at once), but with the nested elements you can easily specify multiple occurrences of the
|
2001-02-13 12:32:01 +00:00
|
|
|
arguments.</p>
|
|
|
|
|
|
2001-05-10 12:14:36 +00:00
|
|
|
<h5>Parameters</h5>
|
2018-02-28 07:58:59 +01:00
|
|
|
<table class="attr">
|
2001-02-13 12:32:01 +00:00
|
|
|
<tr>
|
2018-05-15 10:29:27 +02:00
|
|
|
<th scope="col">Attribute</th>
|
|
|
|
|
<th scope="col">Description</th>
|
|
|
|
|
<th scope="col">Required</th>
|
2001-02-13 12:32:01 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>title</td>
|
|
|
|
|
<td>Title of the group</td>
|
|
|
|
|
<td>Yes, unless nested <code><title></code> given</td>
|
2001-02-13 12:32:01 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>packages</td>
|
|
|
|
|
<td>List of packages to include in that group. Multiple packages are separated with <q>:</q>.</td>
|
|
|
|
|
<td>Yes, unless nested <code><package></code>s given</td>
|
2001-02-13 12:32:01 +00:00
|
|
|
</tr>
|
|
|
|
|
</table>
|
|
|
|
|
|
2018-02-28 07:58:59 +01:00
|
|
|
<p>The title may be specified as a nested <code><title></code> element with text contents, and
|
|
|
|
|
the packages may be listed with nested <code><package></code> elements as for the main
|
|
|
|
|
task.</p>
|
2001-05-10 12:14:36 +00:00
|
|
|
|
2001-02-13 12:32:01 +00:00
|
|
|
<h4>doclet</h4>
|
2018-02-28 07:58:59 +01:00
|
|
|
<p>The doclet nested element is used to specify
|
2018-03-08 07:43:53 +01:00
|
|
|
the <a href="https://docs.oracle.com/javase/8/docs/technotes/guides/javadoc/doclet/overview.html"
|
2018-03-10 20:17:33 +01:00
|
|
|
target="_top">doclet</a> that <kbd>javadoc</kbd> will use to process the input source files. A
|
|
|
|
|
number of the standard <kbd>javadoc</kbd> arguments are actually arguments of the standard
|
2018-03-08 07:43:53 +01:00
|
|
|
doclet. If these are specified in the <code>javadoc</code> task's attributes, they will be passed to
|
|
|
|
|
the doclet specified in the <code><doclet></code> nested element. Such attributes should only
|
|
|
|
|
be specified, therefore, if they can be interpreted by the doclet in use.</p>
|
2001-02-13 12:32:01 +00:00
|
|
|
|
2018-02-28 07:58:59 +01:00
|
|
|
<p>If the doclet requires additional parameters, these can be specified
|
|
|
|
|
with <code><param></code> elements within the <code><doclet></code> element. These
|
|
|
|
|
parameters are restricted to simple strings. An example usage of the <code>doclet</code> element is
|
|
|
|
|
shown below:</p>
|
2001-02-13 12:32:01 +00:00
|
|
|
|
2018-02-28 07:58:59 +01:00
|
|
|
<pre>
|
|
|
|
|
<javadoc ... >
|
|
|
|
|
<doclet name="theDoclet"
|
|
|
|
|
path="path/to/theDoclet">
|
|
|
|
|
<param name="-foo" value="foovalue"/>
|
|
|
|
|
<param name="-bar" value="barvalue"/>
|
|
|
|
|
</doclet>
|
|
|
|
|
</javadoc></pre>
|
2001-02-13 12:32:01 +00:00
|
|
|
|
2018-01-22 23:52:21 +01:00
|
|
|
<h4 id="tagelement">tag</h4>
|
2002-04-26 16:06:52 +00:00
|
|
|
|
2018-02-28 07:58:59 +01:00
|
|
|
<p>If you want to specify a standard tag using a nested <code>tag</code> element because you want to
|
|
|
|
|
determine the order the tags are output, you must not set the <var>description</var> attribute for
|
|
|
|
|
those tags.</p>
|
2003-05-14 15:01:12 +00:00
|
|
|
|
2002-02-26 10:39:10 +00:00
|
|
|
<h5>Parameters</h5>
|
2018-02-28 07:58:59 +01:00
|
|
|
<table class="attr">
|
2002-02-26 10:39:10 +00:00
|
|
|
<tr>
|
2018-05-15 10:29:27 +02:00
|
|
|
<th scope="col">Attribute</th>
|
|
|
|
|
<th scope="col">Description</th>
|
|
|
|
|
<th scope="col">Required</th>
|
2002-02-26 10:39:10 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>name</td>
|
|
|
|
|
<td>Name of the tag (e.g. <q>todo</q>)</td>
|
|
|
|
|
<td>Yes, unless the <var>dir</var> attribute is specified</td>
|
2002-02-26 10:39:10 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>description</td>
|
|
|
|
|
<td>Description for tag (e.g. <q>To do:</q>)</td>
|
|
|
|
|
<td>
|
2018-03-10 20:17:33 +01:00
|
|
|
No, the <kbd>javadoc</kbd> executable will pick a default if this is not specified
|
2007-01-02 00:11:48 +00:00
|
|
|
</td>
|
2002-02-26 10:39:10 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>enabled</td>
|
|
|
|
|
<td>Whether or not the tag is enabled</td>
|
|
|
|
|
<td>No; defaults to <q>true</q></td>
|
2002-02-26 10:39:10 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>scope</td>
|
|
|
|
|
<td>Scope for the tag—the elements in which it can be used. This is a comma separated list
|
|
|
|
|
of some of the
|
|
|
|
|
elements: <q>overview</q>, <q>packages</q>, <q>types</q>, <q>constructors</q>, <q>methods</q>, <q>fields</q>
|
|
|
|
|
or the default, <q>all</q>.</td>
|
|
|
|
|
<td>No; defaults to <q>all</q></td>
|
2002-02-26 10:39:10 +00:00
|
|
|
</tr>
|
2003-03-05 03:03:11 +00:00
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>dir</td>
|
|
|
|
|
<td>If this attribute is specified, this element will behave as an
|
|
|
|
|
implicit <a href="../Types/fileset.html">fileset</a>. The files included by this fileset
|
|
|
|
|
should contain each tag definition on a separate line, as described in
|
2018-03-08 07:43:53 +01:00
|
|
|
the <a href="https://docs.oracle.com/javase/8/docs/technotes/tools/windows/javadoc.html#javadoctags"
|
|
|
|
|
target="_top">Javadoc reference guide</a>:
|
2018-02-28 07:58:59 +01:00
|
|
|
<pre>ejb.bean:t:XDoclet EJB Tag
|
2006-11-02 22:52:04 +00:00
|
|
|
todo:a:To Do</pre>
|
2018-02-28 07:58:59 +01:00
|
|
|
<strong>Note</strong>: The Javadoc reference quide has double quotes around the description
|
|
|
|
|
part of the definition. This will not work when used in a file, as the definition is quoted
|
2018-03-10 20:17:33 +01:00
|
|
|
again when given to the <kbd>javadoc</kbd> program.<br/>
|
2018-01-24 21:40:28 +01:00
|
|
|
<strong>Note</strong>: If this attribute is specified, all the other attributes in this
|
2018-02-28 07:58:59 +01:00
|
|
|
element will be ignored.</td>
|
|
|
|
|
<td>No</td>
|
2003-03-05 03:03:11 +00:00
|
|
|
</tr>
|
2002-02-26 10:39:10 +00:00
|
|
|
</table>
|
|
|
|
|
|
2018-01-22 23:52:21 +01:00
|
|
|
<h4 id="tagletelement">taglet</h4>
|
2018-02-28 07:58:59 +01:00
|
|
|
<p>The taglet nested element is used to specify
|
2018-03-08 07:43:53 +01:00
|
|
|
custom <a href="https://docs.oracle.com/javase/8/docs/technotes/guides/javadoc/taglet/overview.html"
|
|
|
|
|
target="_top">taglets</a>
|
2018-02-28 07:58:59 +01:00
|
|
|
beyond <a href="https://docs.oracle.com/javase/8/docs/technotes/tools/windows/javadoc.html#javadoctags"
|
2018-03-08 07:43:53 +01:00
|
|
|
target="_top">the default taglets</a>.</p>
|
2002-04-05 05:42:26 +00:00
|
|
|
|
|
|
|
|
<h5>Parameters</h5>
|
2018-02-28 07:58:59 +01:00
|
|
|
<table class="attr">
|
2002-04-05 05:42:26 +00:00
|
|
|
<tr>
|
2018-05-15 10:29:27 +02:00
|
|
|
<th scope="col">Attribute</th>
|
|
|
|
|
<th scope="col">Description</th>
|
|
|
|
|
<th scope="col">Required</th>
|
2002-04-05 05:42:26 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>name</td>
|
|
|
|
|
<td>The name of the taglet class
|
2018-03-08 07:43:53 +01:00
|
|
|
(e.g. <a href="https://docs.oracle.com/javase/8/docs/technotes/guides/javadoc/taglet/ToDoTaglet.java"
|
|
|
|
|
target="_top"><code>com.sun.tools.doclets.ToDoTaglet</code></a>)</td>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>Yes</td>
|
2002-04-05 05:42:26 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>path</td>
|
|
|
|
|
<td>A path specifying the search path for the taglet class (e.g. <samp>/home/taglets</samp>).
|
|
|
|
|
The path may also be specified by a nested <code><path></code> element</td>
|
|
|
|
|
<td>No</td>
|
2002-04-05 05:42:26 +00:00
|
|
|
</tr>
|
|
|
|
|
</table>
|
|
|
|
|
|
2018-09-28 20:27:53 +02:00
|
|
|
<h4>sourcepath, classpath, bootclasspath, modulepath, modulesourcepath</h4>
|
|
|
|
|
<p><code>Javadoc</code>'s <i>sourcepath</i>, <i>classpath</i>,
|
|
|
|
|
<i>bootclasspath</i>, <i>modulepath</i>, and <i>modulesourcepath</i>
|
|
|
|
|
attributes are <a href="../using.html#path">PATH like structure</a>
|
|
|
|
|
and can also be set via nested <i>sourcepath</i>,
|
|
|
|
|
<i>classpath</i>, <i>bootclasspath</i>, <i>modulepath</i>,
|
|
|
|
|
and <i>modulesourcepath</i> elements respectively.</p>
|
2001-02-13 12:32:01 +00:00
|
|
|
|
2003-05-14 15:01:12 +00:00
|
|
|
<h4>arg</h4>
|
2018-03-04 15:17:41 +01:00
|
|
|
<p><em>Since Ant 1.6</em></p>
|
2018-02-28 07:58:59 +01:00
|
|
|
<p>Use nested <code><arg></code> to specify additional arguments.
|
2018-03-04 15:17:41 +01:00
|
|
|
See <a href="../using.html#arg">Command line arguments</a>.</p>
|
2003-05-14 15:01:12 +00:00
|
|
|
|
2001-02-13 12:32:01 +00:00
|
|
|
<h3>Example</h3>
|
2018-02-28 07:58:59 +01:00
|
|
|
<pre>
|
|
|
|
|
<javadoc packagenames="com.dummy.test.*"
|
|
|
|
|
sourcepath="src"
|
|
|
|
|
excludepackagenames="com.dummy.test.doc-files.*"
|
|
|
|
|
defaultexcludes="yes"
|
|
|
|
|
destdir="docs/api"
|
|
|
|
|
author="true"
|
|
|
|
|
version="true"
|
|
|
|
|
use="true"
|
|
|
|
|
windowtitle="Test API">
|
|
|
|
|
<doctitle><![CDATA[<h1>Test</h1>]]></doctitle>
|
|
|
|
|
<bottom><![CDATA[<i>Copyright &#169; 2000 Dummy Corp. All Rights Reserved.</i>]]></bottom>
|
|
|
|
|
<tag name="todo" scope="all" description="To do:"/>
|
|
|
|
|
<group title="Group 1 Packages" packages="com.dummy.test.a*"/>
|
|
|
|
|
<group title="Group 2 Packages" packages="com.dummy.test.b*:com.dummy.test.c*"/>
|
|
|
|
|
<link offline="true" href="https://docs.oracle.com/javase/8/docs/api/" packagelistLoc="C:\tmp"/>
|
|
|
|
|
<link href="https://docs.oracle.com/javase/8/docs/api/"/>
|
2019-03-01 22:34:05 +01:00
|
|
|
</javadoc></pre>
|
2003-03-05 03:03:11 +00:00
|
|
|
|
2002-04-26 16:06:52 +00:00
|
|
|
<p>is the same as</p>
|
|
|
|
|
|
2018-02-28 07:58:59 +01:00
|
|
|
<pre>
|
|
|
|
|
<javadoc destdir="docs/api"
|
|
|
|
|
author="true"
|
|
|
|
|
version="true"
|
|
|
|
|
use="true"
|
|
|
|
|
windowtitle="Test API">
|
|
|
|
|
|
|
|
|
|
<packageset dir="src" defaultexcludes="yes">
|
|
|
|
|
<include name="com/dummy/test/**"/>
|
|
|
|
|
<exclude name="com/dummy/test/doc-files/**"/>
|
|
|
|
|
</packageset>
|
|
|
|
|
|
|
|
|
|
<doctitle><![CDATA[<h1>Test</h1>]]></doctitle>
|
|
|
|
|
<bottom><![CDATA[<i>Copyright &#169; 2000 Dummy Corp. All Rights Reserved.</i>]]></bottom>
|
|
|
|
|
<tag name="todo" scope="all" description="To do:"/>
|
|
|
|
|
<group title="Group 1 Packages" packages="com.dummy.test.a*"/>
|
|
|
|
|
<group title="Group 2 Packages" packages="com.dummy.test.b*:com.dummy.test.c*"/>
|
|
|
|
|
<link offline="true" href="https://docs.oracle.com/javase/8/docs/api/" packagelistLoc="C:\tmp"/>
|
|
|
|
|
<link href="https://docs.oracle.com/javase/8/docs/api/"/>
|
2019-03-01 22:34:05 +01:00
|
|
|
</javadoc></pre>
|
2002-04-26 16:06:52 +00:00
|
|
|
|
|
|
|
|
<p>or</p>
|
2003-03-05 03:03:11 +00:00
|
|
|
|
2018-02-28 07:58:59 +01:00
|
|
|
<pre>
|
|
|
|
|
<javadoc destdir="docs/api"
|
|
|
|
|
author="true"
|
|
|
|
|
version="true"
|
|
|
|
|
use="true"
|
|
|
|
|
windowtitle="Test API">
|
|
|
|
|
|
|
|
|
|
<fileset dir="src" defaultexcludes="yes">
|
|
|
|
|
<include name="com/dummy/test/**"/>
|
|
|
|
|
<exclude name="com/dummy/test/doc-files/**"/>
|
|
|
|
|
</fileset>
|
|
|
|
|
|
|
|
|
|
<doctitle><![CDATA[<h1>Test</h1>]]></doctitle>
|
|
|
|
|
<bottom><![CDATA[<i>Copyright &#169; 2000 Dummy Corp. All Rights Reserved.</i>]]></bottom>
|
|
|
|
|
<tag name="todo" scope="all" description="To do:"/>
|
|
|
|
|
<group title="Group 1 Packages" packages="com.dummy.test.a*"/>
|
|
|
|
|
<group title="Group 2 Packages" packages="com.dummy.test.b*:com.dummy.test.c*"/>
|
|
|
|
|
<link offline="true" href="https://docs.oracle.com/javase/8/docs/api/" packagelistLoc="C:\tmp"/>
|
|
|
|
|
<link href="https://docs.oracle.com/javase/8/docs/api/"/>
|
2019-03-01 22:34:05 +01:00
|
|
|
</javadoc></pre>
|
2002-04-26 16:06:52 +00:00
|
|
|
|
2001-02-13 12:32:01 +00:00
|
|
|
</body>
|
|
|
|
|
</html>
|
