You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@commons.apache.org by ol...@apache.org on 2013/01/11 15:32:47 UTC
svn commit: r846168 [12/14] - in
/websites/production/commons/content/propers/commons-attributes: ./
ant_demo/ api/ api/org/ api/org/apache/ api/org/apache/commons/
api/org/apache/commons/attributes/
api/org/apache/commons/attributes/class-use/ api/org...
Added: websites/production/commons/content/propers/commons-attributes/api/stylesheet.css
==============================================================================
--- websites/production/commons/content/propers/commons-attributes/api/stylesheet.css (added)
+++ websites/production/commons/content/propers/commons-attributes/api/stylesheet.css Fri Jan 11 14:32:44 2013
@@ -0,0 +1,29 @@
+/* Javadoc style sheet */
+
+/* Define colors, fonts and other style attributes here to override the defaults */
+
+/* Page background color */
+body { background-color: #FFFFFF }
+
+/* Headings */
+h1 { font-size: 145% }
+
+/* Table colors */
+.TableHeadingColor { background: #CCCCFF } /* Dark mauve */
+.TableSubHeadingColor { background: #EEEEFF } /* Light mauve */
+.TableRowColor { background: #FFFFFF } /* White */
+
+/* Font used in left-hand frame lists */
+.FrameTitleFont { font-size: 100%; font-family: Helvetica, Arial, sans-serif }
+.FrameHeadingFont { font-size: 90%; font-family: Helvetica, Arial, sans-serif }
+.FrameItemFont { font-size: 90%; font-family: Helvetica, Arial, sans-serif }
+
+/* Navigation bar fonts and colors */
+.NavBarCell1 { background-color:#EEEEFF;} /* Light mauve */
+.NavBarCell1Rev { background-color:#00008B;} /* Dark Blue */
+.NavBarFont1 { font-family: Arial, Helvetica, sans-serif; color:#000000;}
+.NavBarFont1Rev { font-family: Arial, Helvetica, sans-serif; color:#FFFFFF;}
+
+.NavBarCell2 { font-family: Arial, Helvetica, sans-serif; background-color:#FFFFFF;}
+.NavBarCell3 { font-family: Arial, Helvetica, sans-serif; background-color:#FFFFFF;}
+
Added: websites/production/commons/content/propers/commons-attributes/attributes-logo-blue.gif
==============================================================================
Binary file - no diff available.
Propchange: websites/production/commons/content/propers/commons-attributes/attributes-logo-blue.gif
------------------------------------------------------------------------------
svn:mime-type = image/gif
Added: websites/production/commons/content/propers/commons-attributes/attributes-logo.gif
==============================================================================
Binary file - no diff available.
Propchange: websites/production/commons/content/propers/commons-attributes/attributes-logo.gif
------------------------------------------------------------------------------
svn:mime-type = image/gif
Added: websites/production/commons/content/propers/commons-attributes/changelog.html
==============================================================================
--- websites/production/commons/content/propers/commons-attributes/changelog.html (added)
+++ websites/production/commons/content/propers/commons-attributes/changelog.html Fri Jan 11 14:32:44 2013
@@ -0,0 +1,240 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html><head><title>Changelog - Commons Attributes</title><style type="text/css" media="all">
+ @import url("./style/maven-base.css");
+
+ @import url("./style/maven-theme.css");@import url("./style/project.css");</style><link rel="stylesheet" href="./style/print.css" type="text/css" media="print"></link><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"></meta><meta name="author" content="Apache Commons Development Team"></meta><meta name="email" content="dev@commons.apache.org"></meta></head><body class="composite"><div id="banner"><a href="http://commons.apache.org/" id="organizationLogo"><img alt="The Apache Software Foundation" src="http://commons.apache.org/images/logo.png"></img></a><a href="http://commons.apache.org/attributes/" id="projectLogo"><img alt="Commons Attributes Site" src="./images/attributes-logo-white.png"></img></a><div class="clear"><hr></hr></div></div><div id="breadcrumbs"><div class="xleft">Last published: 01 August 2007
+ <span class="separator">|</span> Doc for 2.2
+ </div><div class="xright">
+
+ <a href="http://commons.apache.org/" class="externalLink" title="External Link">Apache Commons</a>
+ </div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuCommons Attributes"><h5>Commons Attributes</h5><ul><li class="none"><a href="index.html">Overview</a></li><li class="none"><a href="http://commons.apache.org/downloads/download_attributes.cgi" class="externalLink" title="External Link">Download</a></li><li class="none"><a href="api/index.html">API</a></li><li class="expanded"><a href="tutorial.html">Tutorial</a><ul><li class="none"><a href="ant_demo.html">Ant Demo</a></li><li class="none"><a href="maven_demo.html">Maven Demo</a></li></ul></li><li class="expanded"><a href="reference.html">Reference</a><ul><li class="none"><a href="declaring.html">Declaring and Using</a></li><li class="none"><a href="compiler.html">Compiling</a></li><li class="none"><a href="indexer.html">Indexing</a></li><li class="none"><a href="validator.html">Validating</a></li><li class="none"><a href="documenting.html">Documenting</a></li></ul></li
><li class="none"><a href="faq.html">FAQ</a></li><li class="none"><strong><a href="changelog.html">Changelog</a></strong></li></ul></div><div id="menuDevelopment"><h5>Development</h5><ul><li class="none"><a href="mail-lists.html">Mailing Lists</a></li><li class="none"><a href="team-list.html">Team</a></li></ul></div><div id="menuProject_Documentation"><h5>Project Documentation</h5><ul><li class="none"><a href="index.html">About</a></li><li class="collapsed"><a href="project-info.html">Project Info</a></li><li class="collapsed"><a href="maven-reports.html">Project Reports</a></li><li class="none"><a href="http://commons.apache.org/charter.html" class="externalLink" title="External Link">Development Process</a></li></ul></div><div id="menuCommons"><h5>Commons</h5><ul><li class="none"><a href="http://jakarta.apache.org/commons/" class="externalLink" title="External Link">Home</a></li><li class="collapsed"><a href="http://jakarta.apache.org/commons/components.html" class="extern
alLink" title="External Link">Components</a></li><li class="collapsed"><a href="http://jakarta.apache.org/commons/sandbox/index.html" class="externalLink" title="External Link">Sandbox</a></li><li class="collapsed"><a href="http://jakarta.apache.org/commons/dormant/index.html" class="externalLink" title="External Link">Dormant</a></li><li class="none"><a href="http://jakarta.apache.org/commons/volunteering.html" class="externalLink" title="External Link">Volunteering</a></li><li class="none"><a href="http://jakarta.apache.org/commons/patches.html" class="externalLink" title="External Link">Contributing Patches</a></li><li class="none"><a href="http://jakarta.apache.org/commons/building.html" class="externalLink" title="External Link">Building Components</a></li><li class="none"><a href="http://jakarta.apache.org/commons/releases/index.html" class="externalLink" title="External Link">Releasing Components</a></li><li class="none"><a href="http://wiki.apache.org/jakarta-commons
/FrontPage" class="externalLink" title="External Link">Wiki</a></li></ul></div><div id="legend"><h5>Legend</h5><ul><li class="externalLink">External Link</li><li class="newWindow">Opens in a new window</li></ul></div><a href="http://maven.apache.org/" title="Built by Maven" id="poweredBy"><img alt="Built by Maven" src="./images/logos/maven-feather.png"></img></a></div></div><div id="bodyColumn"><div class="contentBox"><div class="section"><a name="2006-06-29"></a><h2>2006-06-29</h2>
+ <ul>
+ <li>
+ <p>
+ Fixed a potential bug in RuntimeAttributeRepository - the seal() method and the
+ checkSealed() method weren't synchronized properly.
+ </p>
+ </li>
+ </ul>
+ </div><div class="section"><a name="2005-10-26"></a><h2>2005-10-26</h2>
+ <ul>
+ <li>
+ <p>
+ Added support for attribute packages (<a href="http://issues.apache.org/jira/browse/ATTRIBUTES-4" class="externalLink" title="External Link">Issue ATTRIBUTES-4</a>):
+ </p>
+
+ <blockquote>
+ <p>When the ant:attribute-compiler is used in ant, there is no way for maven to
+ pass a value for the attributepackages property.</p>
+
+ <p>It would be nice if it were possible to add a property in the project.properties
+ of the current project that specifies the attributepackages. E.g.</p>
+
+
+ <div class="source"><pre>project.properties:
+[...]
+org.apache.commons.attributes.packages=my.package
+[...</pre></div>
+
+
+ <p>which is then used in the maven plugin:</p>
+
+
+ <div class="source"><pre>[...]
+<ant:attribute-compiler inMaven="true" sourcepathref="maven.compile.src.set"
+ attributepackages="${org.apache.commons.attributes.packages}"
+ destdir="${maven.build.dir}/commons-attributes"/>
+[...]</pre></div>
+
+
+ </blockquote>
+ <p>And that is exactly what was implemented.</p>
+ </li>
+ </ul>
+ </div><div class="section"><a name="2004-09-11"></a><h2>2004-09-11</h2>
+ <ul>
+ <li>
+ <p>
+ <span style="color: #a00000; font-weight:bold;">BUG:</span> Checks for Target specifications would go unnoticed for attributes
+ attached to fields, methods and constructors. The following code would
+ <b>not</b> result in an <a href="api/org/apache/commons/attributes/InvalidAttributeTargetError.html">InvalidAttributeTargetError</a>.
+ The bug is fixed in current CVS.
+ </p>
+
+
+ <div class="source"><pre>/**
+ * @@Target(Target.METHOD)
+ */
+public class AttributeWithTargetMethod {}
+
+public class FieldAttributes1 {
+ /**
+ * @@AttributeWithTargetMethod()
+ */
+ private Object o;
+}</pre></div>
+
+ </li>
+ </ul>
+ </div><div class="section"><a name="2004-09-10"></a><h2>2004-09-10</h2>
+ <ul>
+ <li>
+ <p>
+ Ported the code to qDox. XJavadoc had an annoying bug where it would silently rewrite the value of
+ a JavaDoc tag, making the resulting expression unparseable by the attribute compiler.
+ </p>
+ </li>
+ </ul>
+ </div><div class="section"><a name="2004-08-27"></a><h2>2004-08-27</h2>
+ <ul>
+ <li>
+ <p>
+ <a href="api/org/apache/commons/attributes/CircularDependencyError.html">CircularDependencyError</a>
+ now expects a list of Class instances instead of a list of any object type. The old behavior is still
+ supported and will remain so.
+ </p>
+ </li>
+ <li>
+ <p>
+ <a href="api/org/apache/commons/attributes/CircularDependencyError.html">CircularDependencyError</a>
+ now shows the full circle of dependencies.
+ </p>
+ </li>
+ <li>
+ <p>
+ Added a <a href="api/org/apache/commons/attributes/ParameterIndexOutOfBoundsException.html">ParameterIndexOutOfBoundsException</a> to be thrown when
+ the client tries to retrieve attributes from a parameter of a
+ constructor or method and the parameter index is out of bounds.
+ </p>
+ </li>
+ <li>
+ <p>
+ Added a <a href="api/org/apache/commons/attributes/SealedAttributeException.html">SealedAttributeException</a>
+ to be thrown when an attempt to
+ modify a sealed attribute is made. The exception is a subclass
+ of the IllegalStateException that used to be thrown.
+ </p>
+ </li>
+ </ul>
+ </div><div class="section"><a name="2004-08-26"></a><h2>2004-08-26</h2>
+ <ul>
+ <li>
+ <p>
+ Added
+ <div class="source"><pre>getCause()</pre></div>
+ to applicable Throwables, making them
+ compliant with the standard Java2 1.4 nested throwable spec.
+ </p>
+ </li>
+ <li>
+ <p>
+ CVS version number is now 2.2.
+ </p>
+ </li>
+ </ul>
+ </div><div class="section"><a name="2004-07-24"></a><h2>2004-07-24</h2>
+ <ul>
+ <li>
+ <p>
+ Made the Maven plugin only run the attribute compiler if
+ a project property named org.apache.commons.attributes.enabled
+ was set to 'true'. Likewise, the attribute indexer will only run if
+ a project property named org.apache.commons.attributes.index.enabled
+ is set to 'true'. This to keep these two tasks to be run on
+ every single project being built.
+ </p>
+ </li>
+ <li>
+ <p>
+ Created a Maven demo.
+ </p>
+ </li>
+ </ul>
+ </div><div class="section"><a name="2004-07-06"></a><h2>2004-07-06</h2>
+ <ul>
+ <li>
+ <p>
+ <span style="color: #a00000; font-weight:bold;">BUG:</span>
+ Fixed bug in the compiler that made it impossible to add
+ attributes to a method that took a parameter whose type
+ was an inner class. The bug would manifest itself thus:
+ </p>
+
+
+ <div class="source"><pre>public class Outer {
+ public static class Inner {}
+
+ /**
+ * @@SomeAttribute()
+ */
+ public void method (Inner inner) {}
+}
+
+...
+
+Method method =
+ Outer.class.getMethod(
+ "method",
+ new Class[]{ Outer.Inner.class });
+
+Collection methodAttributes =
+ Attributes.getAttributes (method);
+
+// Prints 0, not 1
+System.out.println (methodAttributes.size ()); </pre></div>
+
+
+ <p>The bug is fixed in current CVS.</p>
+ </li>
+ <li>
+ <p>
+ Bumped version number to 2.1. The rationale for this is as follows: Many people had told me that
+ a 2.0 release was required in order for them to get on with their own releases
+ that could only depend on released versions of libraries. Since I could not move Attributes
+ through the promotion and release process fast enough, and since the existing code appeared to
+ work for people, I recommended that the jars simply be renamed from -2.0alpha to -2.0. After all,
+ it was my intent to release the current CVS unchanged as 2.0.
+ Then the bug above popped up and something had to be done. If I release the fixed version
+ as 2.0, we have two "versions" of 2.0 - the one with the bug and the one without - clearly
+ an undesirable state. Therefore the version number went from 2.0alpha to 2.1alpha.
+ </p>
+ </li>
+ </ul>
+ </div><div class="section"><a name="2004-05-04"></a><h2>2004-05-04</h2>
+ <ul>
+ <li>
+ <p>
+ Added a Taglet for Javadoc 1.4 and later.
+ </p>
+ </li>
+ <li>
+ <p>
+ Added a the attribute-validator task.
+ </p>
+ </li>
+ </ul>
+ </div><div class="section"><a name="2004-03-21"></a><h2>2004-03-21</h2>
+
+ <ul>
+ <li>
+ <p>
+ Fixed bug where attributes would be inherited from
+ private methods. Since the methods themselves aren't
+ inherited, the attributes shouldn't be either.
+ </p>
+ </li>
+ </ul>
+
+ </div><div class="section"><a name="2004-03-19"></a><h2>2004-03-19</h2>
+
+ <ul>
+ <li>
+ <p>
+ Changed the way AttributeIndexes are implemented. Previously,
+ any attributes that were both Indexed and Inheritable would
+ not work as expected - the index would not find the class that
+ had inherited the indexed attribute, only the class declaring it.
+ </p>
+ </li>
+ </ul>
+
+ </div></div></div><div class="clear"><hr></hr></div><div id="footer"><div class="xright">© 2003-2007, The Apache Software Foundation</div><div class="clear"><hr></hr></div></div></body></html>
\ No newline at end of file
Added: websites/production/commons/content/propers/commons-attributes/compiler.html
==============================================================================
--- websites/production/commons/content/propers/commons-attributes/compiler.html (added)
+++ websites/production/commons/content/propers/commons-attributes/compiler.html Fri Jan 11 14:32:44 2013
@@ -0,0 +1,130 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html><head><title>Reference - Compiling - Commons Attributes</title><style type="text/css" media="all">
+ @import url("./style/maven-base.css");
+
+ @import url("./style/maven-theme.css");@import url("./style/project.css");</style><link rel="stylesheet" href="./style/print.css" type="text/css" media="print"></link><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"></meta><meta name="author" content="Apache Commons Development Team"></meta><meta name="email" content="dev@commons.apache.org"></meta></head><body class="composite"><div id="banner"><a href="http://commons.apache.org/" id="organizationLogo"><img alt="The Apache Software Foundation" src="http://commons.apache.org/images/logo.png"></img></a><a href="http://commons.apache.org/attributes/" id="projectLogo"><img alt="Commons Attributes Site" src="./images/attributes-logo-white.png"></img></a><div class="clear"><hr></hr></div></div><div id="breadcrumbs"><div class="xleft">Last published: 01 August 2007
+ <span class="separator">|</span> Doc for 2.2
+ </div><div class="xright">
+
+ <a href="http://commons.apache.org/" class="externalLink" title="External Link">Apache Commons</a>
+ </div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuCommons Attributes"><h5>Commons Attributes</h5><ul><li class="none"><a href="index.html">Overview</a></li><li class="none"><a href="http://commons.apache.org/downloads/download_attributes.cgi" class="externalLink" title="External Link">Download</a></li><li class="none"><a href="api/index.html">API</a></li><li class="expanded"><a href="tutorial.html">Tutorial</a><ul><li class="none"><a href="ant_demo.html">Ant Demo</a></li><li class="none"><a href="maven_demo.html">Maven Demo</a></li></ul></li><li class="expanded"><a href="reference.html">Reference</a><ul><li class="none"><a href="declaring.html">Declaring and Using</a></li><li class="none"><strong><a href="compiler.html">Compiling</a></strong></li><li class="none"><a href="indexer.html">Indexing</a></li><li class="none"><a href="validator.html">Validating</a></li><li class="none"><a href="documenting.html">Documenting<
/a></li></ul></li><li class="none"><a href="faq.html">FAQ</a></li><li class="none"><a href="changelog.html">Changelog</a></li></ul></div><div id="menuDevelopment"><h5>Development</h5><ul><li class="none"><a href="mail-lists.html">Mailing Lists</a></li><li class="none"><a href="team-list.html">Team</a></li></ul></div><div id="menuProject_Documentation"><h5>Project Documentation</h5><ul><li class="none"><a href="index.html">About</a></li><li class="collapsed"><a href="project-info.html">Project Info</a></li><li class="collapsed"><a href="maven-reports.html">Project Reports</a></li><li class="none"><a href="http://commons.apache.org/charter.html" class="externalLink" title="External Link">Development Process</a></li></ul></div><div id="menuCommons"><h5>Commons</h5><ul><li class="none"><a href="http://jakarta.apache.org/commons/" class="externalLink" title="External Link">Home</a></li><li class="collapsed"><a href="http://jakarta.apache.org/commons/components.html" class="extern
alLink" title="External Link">Components</a></li><li class="collapsed"><a href="http://jakarta.apache.org/commons/sandbox/index.html" class="externalLink" title="External Link">Sandbox</a></li><li class="collapsed"><a href="http://jakarta.apache.org/commons/dormant/index.html" class="externalLink" title="External Link">Dormant</a></li><li class="none"><a href="http://jakarta.apache.org/commons/volunteering.html" class="externalLink" title="External Link">Volunteering</a></li><li class="none"><a href="http://jakarta.apache.org/commons/patches.html" class="externalLink" title="External Link">Contributing Patches</a></li><li class="none"><a href="http://jakarta.apache.org/commons/building.html" class="externalLink" title="External Link">Building Components</a></li><li class="none"><a href="http://jakarta.apache.org/commons/releases/index.html" class="externalLink" title="External Link">Releasing Components</a></li><li class="none"><a href="http://wiki.apache.org/jakarta-commons
/FrontPage" class="externalLink" title="External Link">Wiki</a></li></ul></div><div id="legend"><h5>Legend</h5><ul><li class="externalLink">External Link</li><li class="newWindow">Opens in a new window</li></ul></div><a href="http://maven.apache.org/" title="Built by Maven" id="poweredBy"><img alt="Built by Maven" src="./images/logos/maven-feather.png"></img></a></div></div><div id="bodyColumn"><div class="contentBox"><div class="section"><a name="The_AttributeCompiler_Ant_Task"></a><h2>The AttributeCompiler Ant Task</h2>
+
+ <p>This is the process your source files have to go through:</p>
+
+
+ <div class="source"><pre>+------------+ +--------------------+
+|Java Sources|----> Attribute Compiler ---->|Generated Java Files|
++------------+ +--------------------+
+ | |
+ | |
+ | +-------------+ |
+ +-------------->|Java Compiler|<------------------+
+ +-------------+
+ |
+ v
+ +-----------------+
+ |Java .class files|
+ +-----------------+</pre></div>
+
+
+ <p>
+ This section will focus on the "Attribute Compiler" step. As is implied by the diagram,
+ the Attribute Compiler compiles Java source files into other Java source files.
+ </p>
+
+ <p>
+ This is how the compiler is used:
+ </p>
+
+
+ <div class="source"><pre><taskdef resource="org/apache/commons/attributes/anttasks.properties"/>
+
+<attribute-compiler
+ destdir="temp/"
+ attributepackages="my.attributes;my.otherattributes">
+ <fileset dir="src/" includes="*.java"/>
+</attribute-compiler></pre></div>
+
+
+ <table class="bodyTable">
+ <tr class="a">
+ <th>
+ Parameter
+ </th>
+ <th>
+ Required
+ </th>
+ <th>
+ Description
+ </th>
+ </tr>
+ <tr class="b">
+ <td>
+ destdir
+ </td>
+ <td>
+ Yes
+ </td>
+ <td>
+ Destination directory for generated source files
+ </td>
+ </tr>
+ <tr class="a">
+ <td>
+ attributepackages
+ </td>
+ <td>
+ No
+ </td>
+ <td>
+ A semi-colon separated list of package names. Attributes in these packages
+ can be used without specifying their fully-qualified names, even if they are not
+ in the same package as the class they are being attached to, and even if they
+ are not imported. (The compiler generates import statements in the generated
+ source files.)
+ </td>
+ </tr>
+ </table>
+
+ <p>
+ After the attribute compiler has generated the new source files, you should
+ feed them <b>and your own source files</b> to the Java compiler.
+ </p>
+
+ </div><div class="section"><a name="Do_I_Have_to_Use_the_Attribute_Compiler_"></a><h2>Do I Have to Use the Attribute Compiler?</h2>
+
+ <p>
+ No, you don't. You can add attributes to a class by programmatically
+ creating an attribute repository in the class's static initializer.
+
+ See the Javadoc for
+ <a href="api/org/apache/commons/attributes/RuntimeAttributeRepository.html">RuntimeAttributeRepository</a>
+ for an example. <i>It's not pretty, but it works.</i>
+ </p>
+
+ </div><div class="section"><a name="How_Do_I_Use_It_With_Maven_"></a><h2>How Do I Use It With Maven?</h2>
+ <p>
+ If you use Maven you can just install the Commons-Attributes plugin and add the following lines
+ to your project.properties:
+ </p>
+
+
+ <div class="source"><pre>######################################################################
+# Commons-Attributes
+######################################################################
+org.apache.commons.attributes.enable=true
+
+#
+# Optional, enables attribute indexing
+#
+org.apache.commons.attributes.index.enable=true
+
+#
+# Optional, equivalent to specifying attributepackages for the compiler
+#
+org.apache.commons.attributes.attributepackages=mypackage;myotherpackage</pre></div>
+
+
+ <p>
+ Attribute compilation will happen automatically.
+ </p>
+ </div></div></div><div class="clear"><hr></hr></div><div id="footer"><div class="xright">© 2003-2007, The Apache Software Foundation</div><div class="clear"><hr></hr></div></div></body></html>
\ No newline at end of file
Added: websites/production/commons/content/propers/commons-attributes/cvs-usage.html
==============================================================================
--- websites/production/commons/content/propers/commons-attributes/cvs-usage.html (added)
+++ websites/production/commons/content/propers/commons-attributes/cvs-usage.html Fri Jan 11 14:32:44 2013
@@ -0,0 +1,13 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html><head><title>CVS - Commons Attributes</title><style type="text/css" media="all">
+ @import url("./style/maven-base.css");
+
+ @import url("./style/maven-theme.css");@import url("./style/project.css");</style><link rel="stylesheet" href="./style/print.css" type="text/css" media="print"></link><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"></meta></head><body class="composite"><div id="banner"><a href="http://commons.apache.org/" id="organizationLogo"><img alt="The Apache Software Foundation" src="http://commons.apache.org/images/logo.png"></img></a><a href="http://commons.apache.org/attributes/" id="projectLogo"><img alt="Commons Attributes Site" src="./images/attributes-logo-white.png"></img></a><div class="clear"><hr></hr></div></div><div id="breadcrumbs"><div class="xleft">Last published: 01 August 2007
+ <span class="separator">|</span> Doc for 2.2
+ </div><div class="xright">
+
+ <a href="http://commons.apache.org/" class="externalLink" title="External Link">Apache Commons</a>
+ </div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuCommons Attributes"><h5>Commons Attributes</h5><ul><li class="none"><a href="index.html">Overview</a></li><li class="none"><a href="http://commons.apache.org/downloads/download_attributes.cgi" class="externalLink" title="External Link">Download</a></li><li class="none"><a href="api/index.html">API</a></li><li class="expanded"><a href="tutorial.html">Tutorial</a><ul><li class="none"><a href="ant_demo.html">Ant Demo</a></li><li class="none"><a href="maven_demo.html">Maven Demo</a></li></ul></li><li class="expanded"><a href="reference.html">Reference</a><ul><li class="none"><a href="declaring.html">Declaring and Using</a></li><li class="none"><a href="compiler.html">Compiling</a></li><li class="none"><a href="indexer.html">Indexing</a></li><li class="none"><a href="validator.html">Validating</a></li><li class="none"><a href="documenting.html">Documenting</a></li></ul></li
><li class="none"><a href="faq.html">FAQ</a></li><li class="none"><a href="changelog.html">Changelog</a></li></ul></div><div id="menuDevelopment"><h5>Development</h5><ul><li class="none"><a href="mail-lists.html">Mailing Lists</a></li><li class="none"><a href="team-list.html">Team</a></li></ul></div><div id="menuProject_Documentation"><h5>Project Documentation</h5><ul><li class="none"><a href="index.html">About</a></li><li class="expanded"><a href="project-info.html">Project Info</a><ul><li class="none"><a href="mail-lists.html">Mailing Lists</a></li><li class="none"><a href="team-list.html">Project Team</a></li><li class="none"><a href="dependencies.html">Dependencies</a></li><li class="none"><strong><a href="cvs-usage.html">Source Repository</a></strong></li><li class="none"><a href="issue-tracking.html">Issue Tracking</a></li></ul></li><li class="collapsed"><a href="maven-reports.html">Project Reports</a></li><li class="none"><a href="http://commons.apache.org/charter.htm
l" class="externalLink" title="External Link">Development Process</a></li></ul></div><div id="menuCommons"><h5>Commons</h5><ul><li class="none"><a href="http://jakarta.apache.org/commons/" class="externalLink" title="External Link">Home</a></li><li class="collapsed"><a href="http://jakarta.apache.org/commons/components.html" class="externalLink" title="External Link">Components</a></li><li class="collapsed"><a href="http://jakarta.apache.org/commons/sandbox/index.html" class="externalLink" title="External Link">Sandbox</a></li><li class="collapsed"><a href="http://jakarta.apache.org/commons/dormant/index.html" class="externalLink" title="External Link">Dormant</a></li><li class="none"><a href="http://jakarta.apache.org/commons/volunteering.html" class="externalLink" title="External Link">Volunteering</a></li><li class="none"><a href="http://jakarta.apache.org/commons/patches.html" class="externalLink" title="External Link">Contributing Patches</a></li><li class="none"><a hre
f="http://jakarta.apache.org/commons/building.html" class="externalLink" title="External Link">Building Components</a></li><li class="none"><a href="http://jakarta.apache.org/commons/releases/index.html" class="externalLink" title="External Link">Releasing Components</a></li><li class="none"><a href="http://wiki.apache.org/jakarta-commons/FrontPage" class="externalLink" title="External Link">Wiki</a></li></ul></div><div id="legend"><h5>Legend</h5><ul><li class="externalLink">External Link</li><li class="newWindow">Opens in a new window</li></ul></div><a href="http://maven.apache.org/" title="Built by Maven" id="poweredBy"><img alt="Built by Maven" src="./images/logos/maven-feather.png"></img></a></div></div><div id="bodyColumn"><div class="contentBox"><div class="section"><a name="Web_Access"></a><h2>Web Access</h2>
+ <p>
+ <a href="http://svn.apache.org/repos/asf/commons/proper/attributes/trunk/" class="externalLink" title="External Link">http://svn.apache.org/repos/asf/commons/proper/attributes/trunk/</a>
+ </p>
+ </div></div></div><div class="clear"><hr></hr></div><div id="footer"><div class="xright">© 2003-2007, The Apache Software Foundation</div><div class="clear"><hr></hr></div></div></body></html>
\ No newline at end of file
Added: websites/production/commons/content/propers/commons-attributes/declaring.html
==============================================================================
--- websites/production/commons/content/propers/commons-attributes/declaring.html (added)
+++ websites/production/commons/content/propers/commons-attributes/declaring.html Fri Jan 11 14:32:44 2013
@@ -0,0 +1,266 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html><head><title>Reference - Declaring and Using - Commons Attributes</title><style type="text/css" media="all">
+ @import url("./style/maven-base.css");
+
+ @import url("./style/maven-theme.css");@import url("./style/project.css");</style><link rel="stylesheet" href="./style/print.css" type="text/css" media="print"></link><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"></meta><meta name="author" content="Apache Commons Development Team"></meta><meta name="email" content="dev@commons.apache.org"></meta></head><body class="composite"><div id="banner"><a href="http://commons.apache.org/" id="organizationLogo"><img alt="The Apache Software Foundation" src="http://commons.apache.org/images/logo.png"></img></a><a href="http://commons.apache.org/attributes/" id="projectLogo"><img alt="Commons Attributes Site" src="./images/attributes-logo-white.png"></img></a><div class="clear"><hr></hr></div></div><div id="breadcrumbs"><div class="xleft">Last published: 01 August 2007
+ <span class="separator">|</span> Doc for 2.2
+ </div><div class="xright">
+
+ <a href="http://commons.apache.org/" class="externalLink" title="External Link">Apache Commons</a>
+ </div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuCommons Attributes"><h5>Commons Attributes</h5><ul><li class="none"><a href="index.html">Overview</a></li><li class="none"><a href="http://commons.apache.org/downloads/download_attributes.cgi" class="externalLink" title="External Link">Download</a></li><li class="none"><a href="api/index.html">API</a></li><li class="expanded"><a href="tutorial.html">Tutorial</a><ul><li class="none"><a href="ant_demo.html">Ant Demo</a></li><li class="none"><a href="maven_demo.html">Maven Demo</a></li></ul></li><li class="expanded"><a href="reference.html">Reference</a><ul><li class="none"><strong><a href="declaring.html">Declaring and Using</a></strong></li><li class="none"><a href="compiler.html">Compiling</a></li><li class="none"><a href="indexer.html">Indexing</a></li><li class="none"><a href="validator.html">Validating</a></li><li class="none"><a href="documenting.html">Documenting<
/a></li></ul></li><li class="none"><a href="faq.html">FAQ</a></li><li class="none"><a href="changelog.html">Changelog</a></li></ul></div><div id="menuDevelopment"><h5>Development</h5><ul><li class="none"><a href="mail-lists.html">Mailing Lists</a></li><li class="none"><a href="team-list.html">Team</a></li></ul></div><div id="menuProject_Documentation"><h5>Project Documentation</h5><ul><li class="none"><a href="index.html">About</a></li><li class="collapsed"><a href="project-info.html">Project Info</a></li><li class="collapsed"><a href="maven-reports.html">Project Reports</a></li><li class="none"><a href="http://commons.apache.org/charter.html" class="externalLink" title="External Link">Development Process</a></li></ul></div><div id="menuCommons"><h5>Commons</h5><ul><li class="none"><a href="http://jakarta.apache.org/commons/" class="externalLink" title="External Link">Home</a></li><li class="collapsed"><a href="http://jakarta.apache.org/commons/components.html" class="extern
alLink" title="External Link">Components</a></li><li class="collapsed"><a href="http://jakarta.apache.org/commons/sandbox/index.html" class="externalLink" title="External Link">Sandbox</a></li><li class="collapsed"><a href="http://jakarta.apache.org/commons/dormant/index.html" class="externalLink" title="External Link">Dormant</a></li><li class="none"><a href="http://jakarta.apache.org/commons/volunteering.html" class="externalLink" title="External Link">Volunteering</a></li><li class="none"><a href="http://jakarta.apache.org/commons/patches.html" class="externalLink" title="External Link">Contributing Patches</a></li><li class="none"><a href="http://jakarta.apache.org/commons/building.html" class="externalLink" title="External Link">Building Components</a></li><li class="none"><a href="http://jakarta.apache.org/commons/releases/index.html" class="externalLink" title="External Link">Releasing Components</a></li><li class="none"><a href="http://wiki.apache.org/jakarta-commons
/FrontPage" class="externalLink" title="External Link">Wiki</a></li></ul></div><div id="legend"><h5>Legend</h5><ul><li class="externalLink">External Link</li><li class="newWindow">Opens in a new window</li></ul></div><a href="http://maven.apache.org/" title="Built by Maven" id="poweredBy"><img alt="Built by Maven" src="./images/logos/maven-feather.png"></img></a></div></div><div id="bodyColumn"><div class="contentBox"><div class="section"><a name="What_are_Attributes_"></a><h2>What are Attributes?</h2>
+
+ <p>Attributes are value objects that can be added to language elements such as
+ classes, methods and fields.</p>
+
+ <div class="subsection"><a name="Value_Objects"></a><h3>Value Objects</h3>
+
+ <p>What is a value object? Simply stated, a value object is an object that is
+ read-only, constant and can be replaced with another object of the same value
+ without it making any difference. For example, instances of the class
+ <code>java.lang.Integer</code> are value objects. You can replace any instance
+ of that class with any other instance, provided that they are equal. An
+ <code>java.io.Socket</code> is not a value object, as you can't replace an
+ instance of a socket with another - it corresponds to a real resource, in
+ this case a connection.</p>
+
+ <p>You should therefore not allow your attribute classes to be mutable, and not
+ use Sockets or similar classes as attributes.</p>
+
+ </div>
+ </div><div class="section"><a name="How_Are_They_Added_"></a><h2>How Are They Added?</h2>
+
+ <p>Let's look at the way attributes are added to the code. The general form of the
+ attribute expression is (optional parts are in [brackets]):</p>
+
+
+ <div class="source"><pre>@@[target] ClassName ([constructor args] [named args])</pre></div>
+
+
+ <div class="subsection"><a name="target"></a><h3>target</h3>
+ <p>This name indicates what sub-element the attribute is to be applied to.
+ Classes and fields have no sub-elements, but methods do. The sub-elements
+ of a method are (1) the arguments and (2) the return value. In order to
+ apply an element to a method argument, you let the target be <code>.argument name</code>.
+ For example:</p>
+
+
+ <div class="source"><pre>/**
+ * @@.arg1 MyAttribute()
+ */
+public Object myMethod (int arg1) { ... }</pre></div>
+
+
+ <p>Will attach MyAttribute to the first argument of the method - not to
+ the method itself. The attribute can be retrieved via
+ <code>Attributes.getParameterAttributes(Method,int)</code>.</p>
+
+ <p>Adding an attribute to the return value is done by the reserved target
+ name <code>.return</code>:</p>
+
+
+ <div class="source"><pre>/**
+ * @@.return MyAttribute()
+ */
+public Object myMethod (int arg1) { ... }</pre></div>
+
+
+ <p>The attribute can then be retrieved via <code>Attributes.getReturnAttributes(Method)</code>.</p>
+ </div>
+
+
+ <div class="subsection"><a name="ClassName"></a><h3>ClassName</h3>
+ <p>This is the name of the attribute class. You can use a qualified or
+ unqualified name here - but if you use the unqualified name one of
+ the following must be true:</p>
+
+ <ul>
+ <li>
+ <p>
+ The attribute class is in the same package as the class
+ you are attaching it to. (Standard Java rules for when
+ you need to import a class.)
+ </p>
+ </li>
+ <li>
+ <p>
+ You have an import statement that imports the attribute class.
+ </p>
+ </li>
+ <li>
+ <p>
+ You have listed the package the attribute class is in in the attributePackages
+ attribute of the attribute compiler in your build script. <a href="compiler.html">See
+ here.</a>
+ </p>
+ </li>
+ </ul>
+
+ </div>
+
+ <div class="subsection"><a name="constructor_args"></a><h3>constructor args</h3>
+ <p>
+ This is simply a list of arguments to pass to the constructor when
+ instantiating the attribute class. For example, given an attribute:</p>
+
+
+ <div class="source"><pre>class MyAttribute {
+ private final String name;
+
+ public MyAttribute(String name) { this.name = name };
+
+ public String getName() { return name; }
+}</pre></div>
+
+
+ <p>You would specify the name by including it as a constructor argument:</p>
+
+
+ <div class="source"><pre>/**
+ * @@MyAttribute("this is a name")
+ */</pre></div>
+
+
+ </div>
+
+ <div class="subsection"><a name="named_arguments"></a><h3>named arguments</h3>
+ <p>Commons Attributes provides a simple way of having named arguments.
+ This is done by having setter metods in the attribute class. Adding a
+ field and two methods to the attribute class above we get:</p>
+
+
+ <div class="source"><pre>class MyAttribute {
+ private final String name;
+ private boolean optional = false;
+
+ public MyAttribute(String name) { this.name = name };
+
+ public String getName() { return name; }
+
+ public boolean isOptional { return optional; }
+
+ public void setOptional (boolean optional) { this.optional = optional; }
+}</pre></div>
+
+
+ <p>We can now set the <code>optional</code> field by using a named parameter:</p>
+
+
+ <div class="source"><pre>/**
+ * @@MyAttribute("this is a name", optional=true)
+ */</pre></div>
+
+
+ <p>The attribute compiler will pass any parameter up to the first one that is
+ on the form <code><i>name</i> = <i>expression</i></code> to the constructor.
+ For the remaining parameters, it will invoke a method named
+ <code>setName(expression)</code> on the attribute instance.
+ So for our example above, the following code will be generated:</p>
+
+
+ <div class="source"><pre>MyAttribute attr = new MyAttribute("this is a name");
+attr.setOptional(true);</pre></div>
+
+
+ <p>Named parameters are always optional.</p>
+
+ </div>
+ </div><div class="section"><a name="How_are_they_Retrieved_"></a><h2>How are they Retrieved?</h2>
+
+ <p>You retrieve attributes by using the methods in the org.apache.commons.attributes.Attributes
+ class. See the <a href="api/index.html">JavaDoc</a> for a description of methods in this class.</p>
+
+ </div><div class="section"><a name="How_are_Attributes_Stored_"></a><h2>How are Attributes Stored?</h2>
+
+ <p>
+ See the <a href="compiler.html">Compiling</a> section of the reference.
+ </p>
+
+ </div><div class="section"><a name="Gotchas_and_Other_Questions"></a><h2>Gotchas and Other Questions</h2>
+ <div class="subsection"><a name="What_happens_if_I_add_the_same_attribute_twice_"></a><h3>What happens if I add the same attribute twice?</h3>
+
+ <p>Let's define the question via a use case. Suppose you have an attribute (MyAttribute), and you have a class MyClass:</p>
+
+
+ <div class="source"><pre>/**
+ * @@MyAttribute()
+ * @@MyAttribute()
+ */
+public class MyClass {}</pre></div>
+
+
+ <p>The question is now, will the collection returned by Attributes.getAttributes (MyClass.class) have one or
+ two elements? The answer is that it depends on the way MyAttribute handles equality. The attributes associated
+ with a class, method or field always for a Set, meaning that there are no duplicates. So if MyAttribute is
+ implemented this way:</p>
+
+
+ <div class="source"><pre>public class MyAttribute {}</pre></div>
+
+
+ <p>Then you will get two elements, since each instance of MyAttribute is different from every other instance.
+ However, if MyAttribute is implemented like this:</p>
+
+
+ <div class="source"><pre>public class MyAttribute {
+ public int hashCode () { return 0; }
+ public boolean equals (Object o) { return o instanceof MyAttribute; }
+}</pre></div>
+
+
+ <p>That is, every instance of MyAttribute is equal to any other instance of the class, then you will only get
+ one element in the collection.</p>
+
+ <p>The above also holds true if the attribute has been inherited.</p>
+
+ </div>
+
+ <div class="subsection"><a name="What_are_the_requirements_for_an_attribute_class_"></a><h3>What are the requirements for an attribute class?</h3>
+
+ <p>It must have a public constructor. That's all.</p>
+
+ </div>
+
+ <div class="subsection"><a name="I_tried_adding_attributes_to_an_anonymous_class_and_it_didn_t_work_"></a><h3>I tried adding attributes to an anonymous class and it didn't work.</h3>
+
+ <p>That's not supported (yet). It is also very hard to implement since the class name is decided by the Java compiler.</p>
+
+ </div>
+
+ <div class="subsection"><a name="I_want_to_add_a_constant_value_as_an_attribute_"></a><h3>I want to add a constant value as an attribute.</h3>
+
+ <p>So you have this</p>
+
+
+ <div class="source"><pre>public class Values {
+ public static final Integer ONE = new Integer (1);
+}</pre></div>
+
+
+ <p>and now you'd like to add ONE as an attribute like this:</p>
+
+
+ <div class="source"><pre>/**
+ * @@Values.ONE
+ */
+public class MyClass { ... }</pre></div>
+
+
+ <p>how can this be done?</p>
+
+ <p>The best that can be offered is:</p>
+
+
+ <div class="source"><pre>/**
+ * @@Integer(Values.ONE)
+ */
+public class MyClass { ... }</pre></div>
+
+
+ <p>I'm afraid. The expression follwing the @@ must fit the template "new (expression)" optionally suffixed by "()". This makes the compiler much simpler, and the loss of functionality was considered worth it. You can also define a separate ONE class:</p>
+
+
+ <div class="source"><pre>public class One {}</pre></div>
+
+
+ <p>and use it.</p>
+ </div>
+ </div></div></div><div class="clear"><hr></hr></div><div id="footer"><div class="xright">© 2003-2007, The Apache Software Foundation</div><div class="clear"><hr></hr></div></div></body></html>
\ No newline at end of file
Added: websites/production/commons/content/propers/commons-attributes/dependencies.html
==============================================================================
--- websites/production/commons/content/propers/commons-attributes/dependencies.html (added)
+++ websites/production/commons/content/propers/commons-attributes/dependencies.html Fri Jan 11 14:32:44 2013
@@ -0,0 +1,89 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html><head><title>Dependencies - Commons Attributes</title><style type="text/css" media="all">
+ @import url("./style/maven-base.css");
+
+ @import url("./style/maven-theme.css");@import url("./style/project.css");</style><link rel="stylesheet" href="./style/print.css" type="text/css" media="print"></link><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"></meta></head><body class="composite"><div id="banner"><a href="http://commons.apache.org/" id="organizationLogo"><img alt="The Apache Software Foundation" src="http://commons.apache.org/images/logo.png"></img></a><a href="http://commons.apache.org/attributes/" id="projectLogo"><img alt="Commons Attributes Site" src="./images/attributes-logo-white.png"></img></a><div class="clear"><hr></hr></div></div><div id="breadcrumbs"><div class="xleft">Last published: 01 August 2007
+ <span class="separator">|</span> Doc for 2.2
+ </div><div class="xright">
+
+ <a href="http://commons.apache.org/" class="externalLink" title="External Link">Apache Commons</a>
+ </div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuCommons Attributes"><h5>Commons Attributes</h5><ul><li class="none"><a href="index.html">Overview</a></li><li class="none"><a href="http://commons.apache.org/downloads/download_attributes.cgi" class="externalLink" title="External Link">Download</a></li><li class="none"><a href="api/index.html">API</a></li><li class="expanded"><a href="tutorial.html">Tutorial</a><ul><li class="none"><a href="ant_demo.html">Ant Demo</a></li><li class="none"><a href="maven_demo.html">Maven Demo</a></li></ul></li><li class="expanded"><a href="reference.html">Reference</a><ul><li class="none"><a href="declaring.html">Declaring and Using</a></li><li class="none"><a href="compiler.html">Compiling</a></li><li class="none"><a href="indexer.html">Indexing</a></li><li class="none"><a href="validator.html">Validating</a></li><li class="none"><a href="documenting.html">Documenting</a></li></ul></li
><li class="none"><a href="faq.html">FAQ</a></li><li class="none"><a href="changelog.html">Changelog</a></li></ul></div><div id="menuDevelopment"><h5>Development</h5><ul><li class="none"><a href="mail-lists.html">Mailing Lists</a></li><li class="none"><a href="team-list.html">Team</a></li></ul></div><div id="menuProject_Documentation"><h5>Project Documentation</h5><ul><li class="none"><a href="index.html">About</a></li><li class="expanded"><a href="project-info.html">Project Info</a><ul><li class="none"><a href="mail-lists.html">Mailing Lists</a></li><li class="none"><a href="team-list.html">Project Team</a></li><li class="none"><strong><a href="dependencies.html">Dependencies</a></strong></li><li class="none"><a href="cvs-usage.html">Source Repository</a></li><li class="none"><a href="issue-tracking.html">Issue Tracking</a></li></ul></li><li class="collapsed"><a href="maven-reports.html">Project Reports</a></li><li class="none"><a href="http://commons.apache.org/charter.htm
l" class="externalLink" title="External Link">Development Process</a></li></ul></div><div id="menuCommons"><h5>Commons</h5><ul><li class="none"><a href="http://jakarta.apache.org/commons/" class="externalLink" title="External Link">Home</a></li><li class="collapsed"><a href="http://jakarta.apache.org/commons/components.html" class="externalLink" title="External Link">Components</a></li><li class="collapsed"><a href="http://jakarta.apache.org/commons/sandbox/index.html" class="externalLink" title="External Link">Sandbox</a></li><li class="collapsed"><a href="http://jakarta.apache.org/commons/dormant/index.html" class="externalLink" title="External Link">Dormant</a></li><li class="none"><a href="http://jakarta.apache.org/commons/volunteering.html" class="externalLink" title="External Link">Volunteering</a></li><li class="none"><a href="http://jakarta.apache.org/commons/patches.html" class="externalLink" title="External Link">Contributing Patches</a></li><li class="none"><a hre
f="http://jakarta.apache.org/commons/building.html" class="externalLink" title="External Link">Building Components</a></li><li class="none"><a href="http://jakarta.apache.org/commons/releases/index.html" class="externalLink" title="External Link">Releasing Components</a></li><li class="none"><a href="http://wiki.apache.org/jakarta-commons/FrontPage" class="externalLink" title="External Link">Wiki</a></li></ul></div><div id="legend"><h5>Legend</h5><ul><li class="externalLink">External Link</li><li class="newWindow">Opens in a new window</li></ul></div><a href="http://maven.apache.org/" title="Built by Maven" id="poweredBy"><img alt="Built by Maven" src="./images/logos/maven-feather.png"></img></a></div></div><div id="bodyColumn"><div class="contentBox"><div class="section"><a name="Dependencies"></a><h2>Dependencies</h2>
+ <p>
+ The following is a list of dependencies for this project. These dependencies are required to compile and run the application:
+ </p>
+ <table class="bodyTable">
+ <thead>
+ <tr class="a">
+ <th>
+ Artifact ID
+ </th>
+ <th>
+ Type
+ </th>
+ <th>
+ Version
+ </th>
+ <th>
+ URL
+ </th>
+ <th>
+ Comment
+ </th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr class="b">
+ <td>ant</td>
+ <td>jar</td>
+ <td>1.5</td>
+ <td>
+ <a href="http://ant.apache.org/" class="externalLink" title="External Link">http://ant.apache.org/</a>
+ </td>
+ <td>
+ </td>
+ </tr>
+ <tr class="a">
+ <td>maven-xdoc-plugin</td>
+ <td>plugin</td>
+ <td>1.9.2</td>
+ <td>
+ <a href="http://maven.apache.org/maven-1.x/reference/plugins/xdoc/" class="externalLink" title="External Link">http://maven.apache.org/maven-1.x/reference/plugins/xdoc/</a>
+ </td>
+ <td>
+
+ <strong>Site Only</strong> - v1.9.2 (minimum)
+
+ </td>
+ </tr>
+ <tr class="b">
+ <td>qdox</td>
+ <td>jar</td>
+ <td>1.5</td>
+ <td>
+ <a href="http://qdox.codehaus.org/" class="externalLink" title="External Link">http://qdox.codehaus.org/</a>
+ </td>
+ <td>
+ </td>
+ </tr>
+ <tr class="a">
+ <td>xerces</td>
+ <td>jar</td>
+ <td>2.2.1</td>
+ <td>
+ <a href="http://xml.apache.org/xerces2-j/" class="externalLink" title="External Link">http://xml.apache.org/xerces2-j/</a>
+ </td>
+ <td>
+ </td>
+ </tr>
+ <tr class="b">
+ <td>xml-apis</td>
+ <td>jar</td>
+ <td>1.0.b2</td>
+ <td>
+ <a href="http://xml.apache.org/xerces2-j/" class="externalLink" title="External Link">http://xml.apache.org/xerces2-j/</a>
+ </td>
+ <td>
+ </td>
+ </tr>
+ </tbody>
+ </table>
+ </div></div></div><div class="clear"><hr></hr></div><div id="footer"><div class="xright">© 2003-2007, The Apache Software Foundation</div><div class="clear"><hr></hr></div></div></body></html>
\ No newline at end of file
Added: websites/production/commons/content/propers/commons-attributes/documenting.html
==============================================================================
--- websites/production/commons/content/propers/commons-attributes/documenting.html (added)
+++ websites/production/commons/content/propers/commons-attributes/documenting.html Fri Jan 11 14:32:44 2013
@@ -0,0 +1,158 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html><head><title>Reference - Documenting with the Taglet - Commons Attributes</title><style type="text/css" media="all">
+ @import url("./style/maven-base.css");
+
+ @import url("./style/maven-theme.css");@import url("./style/project.css");</style><link rel="stylesheet" href="./style/print.css" type="text/css" media="print"></link><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"></meta><meta name="author" content="Apache Commons Development Team"></meta><meta name="email" content="dev@commons.apache.org"></meta></head><body class="composite"><div id="banner"><a href="http://commons.apache.org/" id="organizationLogo"><img alt="The Apache Software Foundation" src="http://commons.apache.org/images/logo.png"></img></a><a href="http://commons.apache.org/attributes/" id="projectLogo"><img alt="Commons Attributes Site" src="./images/attributes-logo-white.png"></img></a><div class="clear"><hr></hr></div></div><div id="breadcrumbs"><div class="xleft">Last published: 01 August 2007
+ <span class="separator">|</span> Doc for 2.2
+ </div><div class="xright">
+
+ <a href="http://commons.apache.org/" class="externalLink" title="External Link">Apache Commons</a>
+ </div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuCommons Attributes"><h5>Commons Attributes</h5><ul><li class="none"><a href="index.html">Overview</a></li><li class="none"><a href="http://commons.apache.org/downloads/download_attributes.cgi" class="externalLink" title="External Link">Download</a></li><li class="none"><a href="api/index.html">API</a></li><li class="expanded"><a href="tutorial.html">Tutorial</a><ul><li class="none"><a href="ant_demo.html">Ant Demo</a></li><li class="none"><a href="maven_demo.html">Maven Demo</a></li></ul></li><li class="expanded"><a href="reference.html">Reference</a><ul><li class="none"><a href="declaring.html">Declaring and Using</a></li><li class="none"><a href="compiler.html">Compiling</a></li><li class="none"><a href="indexer.html">Indexing</a></li><li class="none"><a href="validator.html">Validating</a></li><li class="none"><strong><a href="documenting.html">Documenting</a></stro
ng></li></ul></li><li class="none"><a href="faq.html">FAQ</a></li><li class="none"><a href="changelog.html">Changelog</a></li></ul></div><div id="menuDevelopment"><h5>Development</h5><ul><li class="none"><a href="mail-lists.html">Mailing Lists</a></li><li class="none"><a href="team-list.html">Team</a></li></ul></div><div id="menuProject_Documentation"><h5>Project Documentation</h5><ul><li class="none"><a href="index.html">About</a></li><li class="collapsed"><a href="project-info.html">Project Info</a></li><li class="collapsed"><a href="maven-reports.html">Project Reports</a></li><li class="none"><a href="http://commons.apache.org/charter.html" class="externalLink" title="External Link">Development Process</a></li></ul></div><div id="menuCommons"><h5>Commons</h5><ul><li class="none"><a href="http://jakarta.apache.org/commons/" class="externalLink" title="External Link">Home</a></li><li class="collapsed"><a href="http://jakarta.apache.org/commons/components.html" class="extern
alLink" title="External Link">Components</a></li><li class="collapsed"><a href="http://jakarta.apache.org/commons/sandbox/index.html" class="externalLink" title="External Link">Sandbox</a></li><li class="collapsed"><a href="http://jakarta.apache.org/commons/dormant/index.html" class="externalLink" title="External Link">Dormant</a></li><li class="none"><a href="http://jakarta.apache.org/commons/volunteering.html" class="externalLink" title="External Link">Volunteering</a></li><li class="none"><a href="http://jakarta.apache.org/commons/patches.html" class="externalLink" title="External Link">Contributing Patches</a></li><li class="none"><a href="http://jakarta.apache.org/commons/building.html" class="externalLink" title="External Link">Building Components</a></li><li class="none"><a href="http://jakarta.apache.org/commons/releases/index.html" class="externalLink" title="External Link">Releasing Components</a></li><li class="none"><a href="http://wiki.apache.org/jakarta-commons
/FrontPage" class="externalLink" title="External Link">Wiki</a></li></ul></div><div id="legend"><h5>Legend</h5><ul><li class="externalLink">External Link</li><li class="newWindow">Opens in a new window</li></ul></div><a href="http://maven.apache.org/" title="Built by Maven" id="poweredBy"><img alt="Built by Maven" src="./images/logos/maven-feather.png"></img></a></div></div><div id="bodyColumn"><div class="contentBox"><div class="section"><a name="What_is_a_Taglet_"></a><h2>What is a Taglet?</h2>
+
+ <p>A taglet is simply put a handler for a Javadoc tag, such as @author, @since and @param.</p>
+
+
+ <div class="source"><pre>/**
+ * @since 1.2
+ * @author Me
+ */</pre></div>
+
+
+ <p>
+ The taglet is then responsible for formatting the tag in the HTML output.
+ </p>
+ </div><div class="section"><a name="How_Do_I_Use_It_"></a><h2>How Do I Use It?</h2>
+
+ <p>
+ We will go through the options below, but in short:
+ </p>
+
+
+ <div class="source"><pre>javadoc
+ -J-Dorg.apache.commons.attributes.javadoc.CATaglet.sources=.
+ -tagletpath commons-attributes-compiler-2.2.jar
+ -taglet org.apache.commons.attributes.javadoc.CATaglet
+ [source files]
+</pre></div>
+
+
+ <p>
+ From top to bottom, then, are the options specific for the Commons-Attributes taglet:
+ </p>
+
+ <div class="subsection"><a name="-J-Dorg_apache_commons_attributes_javadoc_CATaglet_sources"></a><h3>-J-Dorg.apache.commons.attributes.javadoc.CATaglet.sources</h3>
+ <p>
+ Due to the way tags are used by Commons-Attributes, the Taglet must know which Java
+ files it will run on. This is caused by the Taglet API, which requires the Taglet to
+ specify exactly which tags it will handle. Since @@MyAttr() and @@MyOtherAttr() are
+ considered two different tags, the taglet must first scan the source files and compile
+ a list of all potential tag names.
+ </p>
+
+ <p>
+ This parameter is a semi-colon (Win32) or colon (Unix) separated list of files or directories
+ that will be used to create Javadocs. If you specify a directory, then all .java files in that
+ directory and any subdirectories are included.
+ </p>
+
+ <p>
+ Example:
+ </p>
+
+
+ <div class="source"><pre>javadoc
+ <b>-J-Dorg.apache.commons.attributes.javadoc.CATaglet.sources=/home/leo/java</b>
+ -tagletpath commons-attributes-compiler-2.2.jar
+ -taglet org.apache.commons.attributes.javadoc.CATaglet
+ [source files]
+</pre></div>
+
+
+ </div>
+
+ <div class="subsection"><a name="-tagletpath"></a><h3>-tagletpath</h3>
+ <p>
+ This is simply the classpath for taglets. Include the commons-attributes-compiler JAR.
+ </p>
+
+ <p>
+ Example:
+ </p>
+
+
+ <div class="source"><pre>javadoc
+ -J-Dorg.apache.commons.attributes.javadoc.CATaglet.sources=/home/leo/java
+ <b>-tagletpath commons-attributes-compiler-2.2.jar</b>
+ -taglet org.apache.commons.attributes.javadoc.CATaglet
+ [source files]
+</pre></div>
+
+
+ </div>
+
+ <div class="subsection"><a name="-taglet"></a><h3>-taglet</h3>
+ <p>
+ The fully-qualified class name of the taglet.
+ </p>
+
+ <p>
+ Example:
+ </p>
+
+
+ <div class="source"><pre>javadoc
+ -J-Dorg.apache.commons.attributes.javadoc.CATaglet.sources=/home/leo/java
+ -tagletpath commons-attributes-compiler-2.2.jar
+ <b>-taglet org.apache.commons.attributes.javadoc.CATaglet</b>
+ [source files]
+</pre></div>
+
+
+ </div>
+
+
+ </div><div class="section"><a name="Ant_Usage"></a><h2>Ant Usage</h2>
+
+ <p>
+ Ant usage is similar to command line usage.
+ </p>
+
+
+ <div class="source"><pre><javadoc
+ destdir="${basedir}/javadoc/"
+ additionalparam="-J-Dorg.apache.commons.attributes.javadoc.CATaglet.sources=${basedir}">
+ <taglet
+ name="org.apache.commons.attributes.javadoc.CATaglet"
+ path="${ant.home}/lib/commons-attributes-compiler-2.2.jar"
+ />
+ <fileset dir="${basedir}/" includes="**/*.java" />
+</javadoc></pre></div>
+
+
+ <p>
+ Note the need to:
+ </p>
+
+ <ul>
+ <li>
+ <p>
+ Include an additionalparam option to specify location of source files.
+ </p>
+ </li>
+ <li>
+ <p>
+ Specify the path to the attribute compiler jar when specifying the taglet.
+ (Javadoc is a separate JVM and does not share classpaths with Ant.)
+ </p>
+ </li>
+ </ul>
+
+ <p>
+ After you've run the <a href="ant_demo.html">Ant Demo</a>, you can also type:
+ </p>
+
+
+ <div class="source"><pre># ant javadoc</pre></div>
+
+
+ <p>To generate Javadocs for the demo.</p>
+ </div></div></div><div class="clear"><hr></hr></div><div id="footer"><div class="xright">© 2003-2007, The Apache Software Foundation</div><div class="clear"><hr></hr></div></div></body></html>
\ No newline at end of file
Added: websites/production/commons/content/propers/commons-attributes/download_attributes.cgi
==============================================================================
--- websites/production/commons/content/propers/commons-attributes/download_attributes.cgi (added)
+++ websites/production/commons/content/propers/commons-attributes/download_attributes.cgi Fri Jan 11 14:32:44 2013
@@ -0,0 +1,7 @@
+#!/bin/sh
+# Wrapper script around mirrors.cgi script
+# (we must change to that directory in order for python to pick up the
+# python includes correctly)
+cd /www/www.apache.org/dyn/mirrors
+/www/www.apache.org/dyn/mirrors/mirrors.cgi $*
+
Propchange: websites/production/commons/content/propers/commons-attributes/download_attributes.cgi
------------------------------------------------------------------------------
svn:executable = *
Added: websites/production/commons/content/propers/commons-attributes/download_attributes.html
==============================================================================
--- websites/production/commons/content/propers/commons-attributes/download_attributes.html (added)
+++ websites/production/commons/content/propers/commons-attributes/download_attributes.html Fri Jan 11 14:32:44 2013
@@ -0,0 +1,91 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html><head><title>Download Commons Attributes - Commons Attributes</title><style type="text/css" media="all">
+ @import url("./style/maven-base.css");
+
+ @import url("./style/maven-theme.css");@import url("./style/project.css");</style><link rel="stylesheet" href="./style/print.css" type="text/css" media="print"></link><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"></meta><meta name="author" content="Commons Documentation Team"></meta><meta name="email" content="dev@commons.apache.org"></meta></head><body class="composite"><div id="banner"><a href="http://commons.apache.org/" id="organizationLogo"><img alt="The Apache Software Foundation" src="http://commons.apache.org/images/logo.png"></img></a><a href="http://commons.apache.org/attributes/" id="projectLogo"><img alt="Commons Attributes Site" src="./images/attributes-logo-white.png"></img></a><div class="clear"><hr></hr></div></div><div id="breadcrumbs"><div class="xleft">Last published: 12 March 2010
+ <span class="separator">|</span> Doc for 2.2
+ </div><div class="xright">
+
+ <a href="http://commons.apache.org/" class="externalLink" title="External Link">Apache Commons</a>
+ </div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuCommons Attributes"><h5>Commons Attributes</h5><ul><li class="none"><a href="index.html">Overview</a></li><li class="none"><a href="http://commons.apache.org/downloads/download_attributes.cgi" class="externalLink" title="External Link">Download</a></li><li class="none"><a href="api/index.html">API</a></li><li class="expanded"><a href="tutorial.html">Tutorial</a><ul><li class="none"><a href="ant_demo.html">Ant Demo</a></li><li class="none"><a href="maven_demo.html">Maven Demo</a></li></ul></li><li class="expanded"><a href="reference.html">Reference</a><ul><li class="none"><a href="declaring.html">Declaring and Using</a></li><li class="none"><a href="compiler.html">Compiling</a></li><li class="none"><a href="indexer.html">Indexing</a></li><li class="none"><a href="validator.html">Validating</a></li><li class="none"><a href="documenting.html">Documenting</a></li></ul></li
><li class="none"><a href="faq.html">FAQ</a></li><li class="none"><a href="changelog.html">Changelog</a></li></ul></div><div id="menuDevelopment"><h5>Development</h5><ul><li class="none"><a href="mail-lists.html">Mailing Lists</a></li><li class="none"><a href="team-list.html">Team</a></li></ul></div><div id="menuProject_Documentation"><h5>Project Documentation</h5><ul><li class="none"><a href="index.html">About</a></li><li class="collapsed"><a href="project-info.html">Project Info</a></li><li class="collapsed"><a href="maven-reports.html">Project Reports</a></li><li class="none"><a href="http://commons.apache.org/charter.html" class="externalLink" title="External Link">Development Process</a></li></ul></div><div id="menuCommons"><h5>Commons</h5><ul><li class="none"><a href="http://commons.apache.org/" class="externalLink" title="External Link">Home</a></li><li class="collapsed"><a href="http://commons.apache.org/components.html" class="externalLink" title="External Link">Com
ponents</a></li><li class="collapsed"><a href="http://commons.apache.org/sandbox/index.html" class="externalLink" title="External Link">Sandbox</a></li><li class="collapsed"><a href="http://commons.apache.org/dormant/index.html" class="externalLink" title="External Link">Dormant</a></li><li class="none"><a href="http://commons.apache.org/volunteering.html" class="externalLink" title="External Link">Volunteering</a></li><li class="none"><a href="http://commons.apache.org/patches.html" class="externalLink" title="External Link">Contributing Patches</a></li><li class="none"><a href="http://commons.apache.org/building.html" class="externalLink" title="External Link">Building Components</a></li><li class="none"><a href="http://commons.apache.org/releases/index.html" class="externalLink" title="External Link">Releasing Components</a></li><li class="none"><a href="http://wiki.apache.org/commons/FrontPage" class="externalLink" title="External Link">Wiki</a></li></ul></div><div id="l
egend"><h5>Legend</h5><ul><li class="externalLink">External Link</li><li class="newWindow">Opens in a new window</li></ul></div><a href="http://maven.apache.org/" title="Built by Maven" id="poweredBy"><img alt="Built by Maven" src="./images/logos/maven-feather.png"></img></a></div></div><div id="bodyColumn"><div class="contentBox"><div class="section"><a name="Download_Commons_Attributes"></a><h2>Download Commons Attributes</h2>
+ <div class="subsection"><a name="Using_a_Mirror"></a><h3>Using a Mirror</h3>
+ <p>
+ We recommend you use a mirror to download our release
+ builds, but you <strong>must</strong> verify the integrity of
+ the downloaded files using signatures downloaded from our main
+ distribution directories. Recent releases (48 hours) may not yet
+ be available from the mirrors.
+ </p>
+
+ <p>
+ You are currently using <b>[preferred]</b>. If you
+ encounter a problem with this mirror, please select another
+ mirror. If all mirrors are failing, there are <i>backup</i>
+ mirrors (at the end of the mirrors list) that should be
+ available.
+ <br></br>
+ [if-any logo]<a href="[link]"><img align="right" src="[logo]" border="0" alt=""></img></a>[end]
+ </p>
+
+ <form action="[location]" method="get" id="SelectMirror">
+ <p>
+ Other mirrors:
+ <select name="Preferred">
+ [if-any http]
+ [for http]<option value="[http]">[http]</option>[end]
+ [end]
+ [if-any ftp]
+ [for ftp]<option value="[ftp]">[ftp]</option>[end]
+ [end]
+ [if-any backup]
+ [for backup]<option value="[backup]">[backup] (backup)</option>[end]
+ [end]
+ </select>
+ <input type="submit" value="Change"></input>
+ </p>
+ </form>
+
+ <p>
+ The <a href="http://www.apache.org/dist/commons/KEYS" class="externalLink" title="External Link">KEYS</a>
+ link links to the code signing keys used to sign the product.
+ The <code>PGP</code> link downloads the OpenPGP compatible signature from our main site.
+ The <code>MD5</code> link downloads the checksum from the main site.
+ </p>
+ </div>
+ </div><div class="section"><a name="Commons_Attributes_2_2_"></a><h2>Commons Attributes 2.2 </h2>
+ <div class="subsection"><a name="Binaries"></a><h3>Binaries</h3>
+ <table class="bodyTable">
+ <tr class="b">
+ <td><a href="[preferred]/commons/attributes/binaries/commons-attributes-2.2.tar.gz">commons-attributes-2.2.tar.gz</a></td>
+ <td><a href="http://www.apache.org/dist/commons/attributes/binaries/commons-attributes-2.2.tar.gz.md5" class="externalLink" title="External Link">md5</a></td>
+ <td><a href="http://www.apache.org/dist/commons/attributes/binaries/commons-attributes-2.2.tar.gz.asc" class="externalLink" title="External Link">pgp</a></td>
+ </tr>
+ <tr class="a">
+ <td><a href="[preferred]/commons/attributes/binaries/commons-attributes-2.2.zip">commons-attributes-2.2.zip</a></td>
+ <td><a href="http://www.apache.org/dist/commons/attributes/binaries/commons-attributes-2.2.zip.md5" class="externalLink" title="External Link">md5</a></td>
+ <td><a href="http://www.apache.org/dist/commons/attributes/binaries/commons-attributes-2.2.zip.asc" class="externalLink" title="External Link">pgp</a></td>
+ </tr>
+ </table>
+ </div>
+ <div class="subsection"><a name="Source"></a><h3>Source</h3>
+ <table class="bodyTable">
+ <tr class="b">
+ <td><a href="[preferred]/commons/attributes/source/commons-attributes-2.2-src.tar.gz">commons-attributes-2.2-src.tar.gz</a></td>
+ <td><a href="http://www.apache.org/dist/commons/attributes/source/commons-attributes-2.2-src.tar.gz.md5" class="externalLink" title="External Link">md5</a></td>
+ <td><a href="http://www.apache.org/dist/commons/attributes/source/commons-attributes-2.2-src.tar.gz.asc" class="externalLink" title="External Link">pgp</a></td>
+ </tr>
+ <tr class="a">
+ <td><a href="[preferred]/commons/attributes/source/commons-attributes-2.2-src.zip">commons-attributes-2.2-src.zip</a></td>
+ <td><a href="http://www.apache.org/dist/commons/attributes/source/commons-attributes-2.2-src.zip.md5" class="externalLink" title="External Link">md5</a></td>
+ <td><a href="http://www.apache.org/dist/commons/attributes/source/commons-attributes-2.2-src.zip.asc" class="externalLink" title="External Link">pgp</a></td>
+ </tr>
+ </table>
+ </div>
+ </div><div class="section"><a name="Archives"></a><h2>Archives</h2>
+ <p>
+ Older releases can be obtained from the archives.
+ </p>
+ <ul>
+ <li class="download"><a href="[preferred]/commons/attributes/">browse download area</a></li>
+ <li><a href="http://archive.apache.org/dist/commons/attributes/" class="externalLink" title="External Link">archives...</a></li>
+ </ul>
+ </div></div></div><div class="clear"><hr></hr></div><div id="footer"><div class="xright">© 2003-2010, The Apache Software Foundation</div><div class="clear"><hr></hr></div></div></body></html>
\ No newline at end of file
Added: websites/production/commons/content/propers/commons-attributes/downloads.html
==============================================================================
--- websites/production/commons/content/propers/commons-attributes/downloads.html (added)
+++ websites/production/commons/content/propers/commons-attributes/downloads.html Fri Jan 11 14:32:44 2013
@@ -0,0 +1,9 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html><head><title>Downloads - Commons Attributes</title><style type="text/css" media="all">
+ @import url("./style/maven-base.css");
+
+ @import url("./style/maven-theme.css");@import url("./style/project.css");</style><link rel="stylesheet" href="./style/print.css" type="text/css" media="print"></link><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"></meta></head><body class="composite"><div id="banner"><a href="http://commons.apache.org/" id="organizationLogo"><img alt="The Apache Software Foundation" src="http://commons.apache.org/images/logo.png"></img></a><a href="http://commons.apache.org/attributes/" id="projectLogo"><img alt="Commons Attributes Site" src="./images/attributes-logo-white.png"></img></a><div class="clear"><hr></hr></div></div><div id="breadcrumbs"><div class="xleft">Last published: 01 August 2007
+ <span class="separator">|</span> Doc for 2.2
+ </div><div class="xright">
+
+ <a href="http://commons.apache.org/" class="externalLink" title="External Link">Apache Commons</a>
+ </div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuCommons Attributes"><h5>Commons Attributes</h5><ul><li class="none"><a href="index.html">Overview</a></li><li class="none"><a href="http://commons.apache.org/downloads/download_attributes.cgi" class="externalLink" title="External Link">Download</a></li><li class="none"><a href="api/index.html">API</a></li><li class="expanded"><a href="tutorial.html">Tutorial</a><ul><li class="none"><a href="ant_demo.html">Ant Demo</a></li><li class="none"><a href="maven_demo.html">Maven Demo</a></li></ul></li><li class="expanded"><a href="reference.html">Reference</a><ul><li class="none"><a href="declaring.html">Declaring and Using</a></li><li class="none"><a href="compiler.html">Compiling</a></li><li class="none"><a href="indexer.html">Indexing</a></li><li class="none"><a href="validator.html">Validating</a></li><li class="none"><a href="documenting.html">Documenting</a></li></ul></li
><li class="none"><a href="faq.html">FAQ</a></li><li class="none"><a href="changelog.html">Changelog</a></li></ul></div><div id="menuDevelopment"><h5>Development</h5><ul><li class="none"><a href="mail-lists.html">Mailing Lists</a></li><li class="none"><a href="team-list.html">Team</a></li></ul></div><div id="menuProject_Documentation"><h5>Project Documentation</h5><ul><li class="none"><a href="index.html">About</a></li><li class="collapsed"><a href="project-info.html">Project Info</a></li><li class="collapsed"><a href="maven-reports.html">Project Reports</a></li><li class="none"><a href="http://commons.apache.org/charter.html" class="externalLink" title="External Link">Development Process</a></li></ul></div><div id="menuCommons"><h5>Commons</h5><ul><li class="none"><a href="http://jakarta.apache.org/commons/" class="externalLink" title="External Link">Home</a></li><li class="collapsed"><a href="http://jakarta.apache.org/commons/components.html" class="externalLink" title="Ex
ternal Link">Components</a></li><li class="collapsed"><a href="http://jakarta.apache.org/commons/sandbox/index.html" class="externalLink" title="External Link">Sandbox</a></li><li class="collapsed"><a href="http://jakarta.apache.org/commons/dormant/index.html" class="externalLink" title="External Link">Dormant</a></li><li class="none"><a href="http://jakarta.apache.org/commons/volunteering.html" class="externalLink" title="External Link">Volunteering</a></li><li class="none"><a href="http://jakarta.apache.org/commons/patches.html" class="externalLink" title="External Link">Contributing Patches</a></li><li class="none"><a href="http://jakarta.apache.org/commons/building.html" class="externalLink" title="External Link">Building Components</a></li><li class="none"><a href="http://jakarta.apache.org/commons/releases/index.html" class="externalLink" title="External Link">Releasing Components</a></li><li class="none"><a href="http://wiki.apache.org/jakarta-commons/FrontPage" class
="externalLink" title="External Link">Wiki</a></li></ul></div><div id="legend"><h5>Legend</h5><ul><li class="externalLink">External Link</li><li class="newWindow">Opens in a new window</li></ul></div><a href="http://maven.apache.org/" title="Built by Maven" id="poweredBy"><img alt="Built by Maven" src="./images/logos/maven-feather.png"></img></a></div></div><div id="bodyColumn"><div class="contentBox"><div class="section"><a name="Downloads"></a><h2>Downloads</h2><p>You must define the<code>maven.xdoc.distributionUrl</code>property if you wish to generate the download report.</p></div></div></div><div class="clear"><hr></hr></div><div id="footer"><div class="xright">© 2003-2007, The Apache Software Foundation</div><div class="clear"><hr></hr></div></div></body></html>
\ No newline at end of file