diff --git a/build.xml b/build.xml index 1ebce5c5b..b05b0f85a 100644 --- a/build.xml +++ b/build.xml @@ -556,11 +556,12 @@ author="true" version="true" windowtitle="${Name} API" - doctitle="${Name}" - bottom="Copyright © 2000 Apache Software Foundation. All Rights Reserved."> + doctitle="${Name}"> + + Copyright © 1999-2001 Apache Software Foundation. All Rights Reserved. diff --git a/docs/manual/CoreTasks/javadoc.html b/docs/manual/CoreTasks/javadoc.html index 073defe90..0a5ece1c7 100644 --- a/docs/manual/CoreTasks/javadoc.html +++ b/docs/manual/CoreTasks/javadoc.html @@ -75,7 +75,8 @@ instead.

sourcefiles Comma separated list of source files all - at least one of the two + at least one of the two + or nested <source> or <package> packagenames @@ -129,6 +130,13 @@ instead.

1.2 No + + access + Access mode: one of public, protected, + package, or private + all + No (default protected) + Public Show only public classes and members @@ -382,13 +390,71 @@ recommended.

Parameters specified as nested elements

+ +

package

+

Same as one entry in the list given by packagenames.

+ +
Parameters
+ + + + + + + + + + + +
AttributeDescriptionRequired
nameThe package name (may be a wildcard)Yes
+ +

excludepackage

+

Same as one entry in the list given by excludepackagenames.

+ +
Parameters
+Same as for package. + +

source

+

Same as one entry in the list given by sourcefiles.

+ +
Parameters
+ + + + + + + + + + + +
AttributeDescriptionRequired
fileThe source file to documentYes
+ +

doctitle

+ +

Same as the doctitle attribute, but you can nest text +inside the element this way.

+ +

header

+ +

Similar to <doctitle>.

+ +

footer

+ +

Similar to <doctitle>.

+ +

bottom

+ +

Similar to <doctitle>.

+

link

Create link to javadoc output at the given URL. This performs the same role as the link and linkoffline attributes. You can use either syntax (or both at once), but with the nested elements you can easily specify multiple occurrences of the arguments.

-

Parameters

+
Parameters
@@ -421,6 +487,7 @@ attribute. You can use either syntax (or both at once), but with the nested elements you can easily specify multiple occurrences of the arguments.

+
Parameters
Attribute
@@ -430,15 +497,19 @@ arguments.

- + - +
Attribute
title Title of the groupYesYes, unless nested <title> given
packages List of packages to include in that group. Multiple packages are separated with ':'.YesYes, unless nested <package>s given
+

The title may be specified as a nested <title> element +with text contents, and the packages may be listed with nested +<package> elements as for the main task. +

doclet

The doclet nested element is used to specify the doclet that javadoc will use to process the input source files. A number of the standard javadoc arguments @@ -477,9 +548,9 @@ respectively.

author="true" version="true" use="true" - windowtitle="Test API" - doctitle="<h1>Test</h1>" - bottom="<i>Copyright &#169; 2000 Dummy Corp. All Rights Reserved.</i>"> + windowtitle="Test API"> + <doctitle><![CDATA[<h1>Test</h1>]]></doctitle> + <bottom><![CDATA[<i>Copyright &#169; 2000 Dummy Corp. All Rights Reserved.</i>]]></bottom> <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="http://java.sun.com/products/jdk/1.2/docs/api/" packagelistLoc="C:\tmp"/> diff --git a/src/main/org/apache/tools/ant/taskdefs/Javadoc.java b/src/main/org/apache/tools/ant/taskdefs/Javadoc.java index 3fd77252c..f7291dd17 100644 --- a/src/main/org/apache/tools/ant/taskdefs/Javadoc.java +++ b/src/main/org/apache/tools/ant/taskdefs/Javadoc.java @@ -164,6 +164,44 @@ public class Javadoc extends Task { } } + public static class PackageName { + private String name; + public void setName(String name) { + this.name = name; + } + public String getName() { + return name; + } + } + + public static class SourceFile { + private File file; + public void setFile(File file) { + this.file = file; + } + public File getFile() { + return file; + } + } + + public static class Html { + private StringBuffer text = new StringBuffer(); + public void addText(String t) { + text.append(t); + } + public String getText() { + return text.toString(); + } + } + + public static class AccessType extends EnumeratedAttribute { + public String[] getValues() { + // Protected first so if any GUI tool offers a default + // based on enum #0, it will be right. + return new String[] {"protected", "public", "package", "private"}; + } + } + private Commandline cmd = new Commandline(); private static boolean javadoc1 = (Project.getJavaVersion() == Project.JAVA_1_1); @@ -204,9 +242,9 @@ public class Javadoc extends Task { private boolean failOnError = false; private Path sourcePath = null; private File destDir = null; - private String sourceFiles = null; - private String packageNames = null; - private String excludePackageNames = null; + private Vector sourceFiles = new Vector(); + private Vector packageNames = new Vector(5); + private Vector excludePackageNames = new Vector(1); private boolean author = true; private boolean version = true; private DocletInfo doclet = null; @@ -218,6 +256,10 @@ public class Javadoc extends Task { private Vector links = new Vector(2); private Vector groups = new Vector(2); private boolean useDefaultExcludes = true; + private Html doctitle = null; + private Html header = null; + private Html footer = null; + private Html bottom = null; /** * Sets whether default exclusions should be used or not. @@ -269,14 +311,41 @@ public class Javadoc extends Task { cmd.createArgument().setFile(destDir); } public void setSourcefiles(String src) { - sourceFiles = src; + StringTokenizer tok = new StringTokenizer(src, ","); + while (tok.hasMoreTokens()) { + String f = tok.nextToken(); + SourceFile sf = new SourceFile(); + sf.setFile(project.resolveFile(f)); + addSource(sf); + } + } + public void addSource(SourceFile sf) { + sourceFiles.addElement(sf); } public void setPackagenames(String src) { - packageNames = src; + StringTokenizer tok = new StringTokenizer(src, ","); + while (tok.hasMoreTokens()) { + String p = tok.nextToken(); + PackageName pn = new PackageName(); + pn.setName(p); + addPackage(pn); + } + } + public void addPackage(PackageName pn) { + packageNames.addElement(pn); } public void setExcludePackageNames(String src) { - excludePackageNames = src; + StringTokenizer tok = new StringTokenizer(src, ","); + while (tok.hasMoreTokens()) { + String p = tok.nextToken(); + PackageName pn = new PackageName(); + pn.setName(p); + addExcludePackage(pn); + } + } + public void addExcludePackage(PackageName pn) { + excludePackageNames.addElement(pn); } public void setOverview(File f) { @@ -297,6 +366,9 @@ public class Javadoc extends Task { public void setPrivate(boolean b) { addArgIf(b, "-private"); } + public void setAccess(AccessType at) { + cmd.createArgument().setValue("-" + at.getValue()); + } public void setDoclet(String src) { if (doclet == null) { doclet = new DocletInfo(); @@ -403,20 +475,45 @@ public class Javadoc extends Task { add12ArgIfNotEmpty("-windowtitle", src); } public void setDoctitle(String src) { - add12ArgIfNotEmpty("-doctitle", src); + Html h = new Html(); + h.addText(src); + addDoctitle(h); + } + public void addDoctitle(Html text) { + if (!javadoc1) { + doctitle = text; + } } public void setHeader(String src) { - add12ArgIfNotEmpty("-header", src); + Html h = new Html(); + h.addText(src); + addHeader(h); + } + public void addHeader(Html text) { + if (!javadoc1) { + header = text; + } } - public void setFooter(String src) { - add12ArgIfNotEmpty("-footer", src); + Html h = new Html(); + h.addText(src); + addFooter(h); + } + public void addFooter(Html text) { + if (!javadoc1) { + footer = text; + } } - public void setBottom(String src) { - add12ArgIfNotEmpty("-bottom", src); + Html h = new Html(); + h.addText(src); + addBottom(h); + } + public void addBottom(Html text) { + if (!javadoc1) { + bottom = text; + } } - public void setLinkoffline(String src) { if (!javadoc1) { LinkArgument le = createLink(); @@ -531,7 +628,8 @@ public class Javadoc extends Task { public class GroupArgument { private String title; - private String packages; + private Html title2; + private Vector packages = new Vector(3); public GroupArgument() { } @@ -539,17 +637,38 @@ public class Javadoc extends Task { public void setTitle(String src) { title = src; } + public void addTitle(Html text) { + title2 = text; + } public String getTitle() { - return title; + return title2 != null ? title2.getText() : title; } public void setPackages(String src) { - packages = src; + StringTokenizer tok = new StringTokenizer(src, ","); + while (tok.hasMoreTokens()) { + String p = tok.nextToken(); + PackageName pn = new PackageName(); + pn.setName(p); + addPackage(pn); + } + } + public void addPackage(PackageName pn) { + packages.addElement(pn); } public String getPackages() { - return packages; + String p = null; + for (int i = 0; i < packages.size(); i++) { + PackageName pn = (PackageName)packages.elementAt(i); + if (p == null || p.equals("")) { + p = pn.getName(); + } else { + p += ":" + pn.getName(); + } + } + return p; } } @@ -579,6 +698,23 @@ public class Javadoc extends Task { log("Generating Javadoc", Project.MSG_INFO); + if (doctitle != null) { + cmd.createArgument().setValue("-doctitle"); + cmd.createArgument().setValue(doctitle.getText()); + } + if (header != null) { + cmd.createArgument().setValue("-header"); + cmd.createArgument().setValue(header.getText()); + } + if (footer != null) { + cmd.createArgument().setValue("-footer"); + cmd.createArgument().setValue(footer.getText()); + } + if (bottom != null) { + cmd.createArgument().setValue("-bottom"); + cmd.createArgument().setValue(bottom.getText()); + } + Commandline toExecute = (Commandline)cmd.clone(); toExecute.setExecutable("javadoc"); @@ -715,11 +851,12 @@ public class Javadoc extends Task { } - if ((packageNames != null) && (packageNames.length() > 0)) { + if (packageNames.size() > 0) { Vector packages = new Vector(); - StringTokenizer tok = new StringTokenizer(packageNames, ",", false); - while (tok.hasMoreTokens()) { - String name = tok.nextToken().trim(); + Enumeration enum = packageNames.elements(); + while (enum.hasMoreElements()) { + PackageName pn = (PackageName) enum.nextElement(); + String name = pn.getName().trim(); if (name.endsWith(".*")) { packages.addElement(name); } else { @@ -728,10 +865,11 @@ public class Javadoc extends Task { } Vector excludePackages = new Vector(); - if ((excludePackageNames != null) && (excludePackageNames.length() > 0)) { - StringTokenizer exTok = new StringTokenizer(excludePackageNames, ",", false); - while (exTok.hasMoreTokens()) { - excludePackages.addElement(exTok.nextToken().trim()); + if (excludePackageNames.size() > 0) { + enum = excludePackageNames.elements(); + while (enum.hasMoreElements()) { + PackageName pn = (PackageName) enum.nextElement(); + excludePackages.addElement(pn.getName().trim()); } } if (packages.size() > 0) { @@ -739,10 +877,11 @@ public class Javadoc extends Task { } } - if ((sourceFiles != null) && (sourceFiles.length() > 0)) { - StringTokenizer tok = new StringTokenizer(sourceFiles, ",", false); - while (tok.hasMoreTokens()) { - toExecute.createArgument().setValue(tok.nextToken().trim()); + if (sourceFiles.size() > 0) { + Enumeration enum = sourceFiles.elements(); + while (enum.hasMoreElements()) { + SourceFile sf = (SourceFile) enum.nextElement(); + toExecute.createArgument().setValue(sf.getFile().getAbsolutePath()); } }