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 [13/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/faq.html
==============================================================================
--- websites/production/commons/content/propers/commons-attributes/faq.html (added)
+++ websites/production/commons/content/propers/commons-attributes/faq.html Fri Jan 11 14:32:44 2013
@@ -0,0 +1,127 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html><head><title>Frequently Asked Question - 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"><strong><a href="faq.html">FAQ</a></strong></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="Java_1_5_Annotations"></a><h2>Java 1.5 Annotations</h2>
+
+ <p><b>Q: How does Commons-Attributes fit in with the annotations in Java 5.0?</b></p>
+
+ <p>
+ <b>A:</b> With annotations we'll finally have a standard API for metadata in Java. The downside
+ is that we have to switch to Java 5.0. Since people even now are still stuck with
+ Java 1.2 and Java 1.3, it may be a while before a project can require 5.0 and still
+ have a reasonably-sized audience and/or usefulness.
+ </p>
+
+ <p>
+ This is where Commons-Attributes comes in.
+ </p>
+
+ <p>
+ Ultimately this s a choice you must make based on your own preconditions, but this
+ is my advice: You should switch to 5.0 if you can, given stability, compatibility
+ et cetera. After all, it is the standard that people will use when it becomes the standard
+ (which it will). However, if you foresee that you'll stick with 1.4 or earlier and you
+ think that metadata is the most cost-effective way of solving your problem, then
+ you should definitely take a closer look at Commons-Attributes.
+ </p>
+ </div><div class="section"><a name="Other_Users"></a><h2>Other Users</h2>
+
+ <p><b>Q: Anyone else using C-A?</b></p>
+
+ <p>
+ <b>A:</b> A number of companies use C-A in their products, and I have myself used in
+ deployed business-critical systems. Less anonymous users are:
+ </p>
+
+ <ul>
+ <li>
+ <p><a href="http://www.springframework.org/" class="externalLink" title="External Link">Spring Framework</a></p>
+ </li>
+ <li>
+ <p><a href="http://acegisecurity.sourceforge.net/" class="externalLink" title="External Link">Acegi Security System for Spring</a></p>
+ </li>
+ </ul>
+
+ </div><div class="section"><a name="Other_Frameworks"></a><h2>Other Frameworks</h2>
+
+ <p><b>Q: How does Commons-Attributes compare to other metadata frameworks, such as
+ JSR175, MetaClass, qDox, JAM, etc?</b></p>
+
+ <p><b>A:</b> This is a two-part answer. First JSR175: When Java 5.0 becomes as commonly
+ used as 1.3+1.4 is today, nobody will want to use any other metadata framework, just
+ like nobody wants to use any other string class than the java.lang one. Therefore, by
+ that time, C-A will have been rendered superfluous, and development will stop.</p>
+
+ <p>Compared to JAM, QDox, etc. C-A stands up very well. It offers a simple API, powerful
+ annotation features, type-safety and low overhead. Let's examine these points:</p>
+
+ <ul>
+ <li>
+ <p>Simple API: Too many frameworks try to be the all-encompassing über-framework -
+ and usually fails at that. The result is an over-complicated API, that still
+ won't let you do what you want to do. C-A aims to do one thing, and do it well.</p>
+ </li>
+ <li>
+ <p>Powerful annotation features: You can attach attributes to classes, methods,
+ fields, method parameters and return values. You can also control how an
+ attribute can be used via the <a href="api/org/apache/commons/attributes/Target.html"><tt>Target</tt></a>
+ meta-attribute. Few other frameworks offer all these features.</p>
+ </li>
+ <li>
+ <p>Type safety: Most other frameworks are limited to key-value pairs of Strings.
+ C-A lets you use JavaBeans, which gives you a layer of compile-time safety
+ against mistyping an attribute name.</p>
+ </li>
+ <li>
+ <p>Low overhead: C-A has no runtime dependencies, and fits into a 36k jar file.</p>
+ </li>
+ </ul>
+
+ <p>In summary, C-A stands up very well.</p>
+
+ </div><div class="section"><a name="Future_Plans"></a><h2>Future Plans</h2>
+
+ <p><b>Q: What are the future plans for Commons-Attributes?</b></p>
+
+ <p><b>A:</b> As indicated above, C-A isn't expected to live beyond widespread adoption
+ of Java 5.0. With the 2.2 release it is considered to have approached its end of
+ life, so there are no future plans. </p>
+
+ <p>Prior to reaching end of life, the future plans were for ease of use and included: </p>
+
+ <ul>
+ <li>
+ <p>Documentation: The existing code should be further documented, making it
+ easier to understand the package.</p>
+ </li>
+ <li>
+ <p>
+ Helpful code: Exceptions should go out of their way to help the developer
+ find the bug by being precise and having relevant messages. Very often,
+ all a developer will have will be a stack trace in a logfile - let's make
+ that all they need as well.
+ </p>
+ </li>
+ <li>
+ <p>Standards compliance: The code should behave as expected in all Java
+ environments. For example, all Throwables that have a nested Throwable
+ should implement getCause(). This makes it easy for developers to deploy the
+ package in various environments.</p>
+ </li>
+ <li>
+ <p>No dependencies: The runtime API should have no dependencies, making upgrades
+ easy and painless.</p>
+ </li>
+ <li>
+ <p>Maximum backwards compatibility: Upgrading to the latest version of C-A should be
+ a no-brainer, not a carefully decided tradeoff between new features and
+ migration pain.</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/images/add.gif
==============================================================================
Binary file - no diff available.
Propchange: websites/production/commons/content/propers/commons-attributes/images/add.gif
------------------------------------------------------------------------------
svn:mime-type = image/gif
Added: websites/production/commons/content/propers/commons-attributes/images/attributes-logo-white.png
==============================================================================
Binary file - no diff available.
Propchange: websites/production/commons/content/propers/commons-attributes/images/attributes-logo-white.png
------------------------------------------------------------------------------
svn:mime-type = image/png
Added: websites/production/commons/content/propers/commons-attributes/images/attributes-logo-white.xcf
==============================================================================
Binary file - no diff available.
Propchange: websites/production/commons/content/propers/commons-attributes/images/attributes-logo-white.xcf
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: websites/production/commons/content/propers/commons-attributes/images/collapsed.gif
==============================================================================
Binary file - no diff available.
Propchange: websites/production/commons/content/propers/commons-attributes/images/collapsed.gif
------------------------------------------------------------------------------
svn:mime-type = image/gif
Added: websites/production/commons/content/propers/commons-attributes/images/expanded.gif
==============================================================================
Binary file - no diff available.
Propchange: websites/production/commons/content/propers/commons-attributes/images/expanded.gif
------------------------------------------------------------------------------
svn:mime-type = image/gif
Added: websites/production/commons/content/propers/commons-attributes/images/external.png
==============================================================================
Binary file - no diff available.
Propchange: websites/production/commons/content/propers/commons-attributes/images/external.png
------------------------------------------------------------------------------
svn:mime-type = image/png
Added: websites/production/commons/content/propers/commons-attributes/images/fix.gif
==============================================================================
Binary file - no diff available.
Propchange: websites/production/commons/content/propers/commons-attributes/images/fix.gif
------------------------------------------------------------------------------
svn:mime-type = image/gif
Added: websites/production/commons/content/propers/commons-attributes/images/icon_error_sml.gif
==============================================================================
Binary file - no diff available.
Propchange: websites/production/commons/content/propers/commons-attributes/images/icon_error_sml.gif
------------------------------------------------------------------------------
svn:mime-type = image/gif
Added: websites/production/commons/content/propers/commons-attributes/images/icon_info_sml.gif
==============================================================================
Binary file - no diff available.
Propchange: websites/production/commons/content/propers/commons-attributes/images/icon_info_sml.gif
------------------------------------------------------------------------------
svn:mime-type = image/gif
Added: websites/production/commons/content/propers/commons-attributes/images/icon_success_sml.gif
==============================================================================
Binary file - no diff available.
Propchange: websites/production/commons/content/propers/commons-attributes/images/icon_success_sml.gif
------------------------------------------------------------------------------
svn:mime-type = image/gif
Added: websites/production/commons/content/propers/commons-attributes/images/icon_warning_sml.gif
==============================================================================
Binary file - no diff available.
Propchange: websites/production/commons/content/propers/commons-attributes/images/icon_warning_sml.gif
------------------------------------------------------------------------------
svn:mime-type = image/gif
Added: websites/production/commons/content/propers/commons-attributes/images/logos/maven-feather.png
==============================================================================
Binary file - no diff available.
Propchange: websites/production/commons/content/propers/commons-attributes/images/logos/maven-feather.png
------------------------------------------------------------------------------
svn:mime-type = image/png
Added: websites/production/commons/content/propers/commons-attributes/images/newwindow.png
==============================================================================
Binary file - no diff available.
Propchange: websites/production/commons/content/propers/commons-attributes/images/newwindow.png
------------------------------------------------------------------------------
svn:mime-type = image/png
Added: websites/production/commons/content/propers/commons-attributes/images/pdf.gif
==============================================================================
Binary file - no diff available.
Propchange: websites/production/commons/content/propers/commons-attributes/images/pdf.gif
------------------------------------------------------------------------------
svn:mime-type = image/gif
Added: websites/production/commons/content/propers/commons-attributes/images/remove.gif
==============================================================================
Binary file - no diff available.
Propchange: websites/production/commons/content/propers/commons-attributes/images/remove.gif
------------------------------------------------------------------------------
svn:mime-type = image/gif
Added: websites/production/commons/content/propers/commons-attributes/images/update.gif
==============================================================================
Binary file - no diff available.
Propchange: websites/production/commons/content/propers/commons-attributes/images/update.gif
------------------------------------------------------------------------------
svn:mime-type = image/gif
Added: websites/production/commons/content/propers/commons-attributes/index.html
==============================================================================
--- websites/production/commons/content/propers/commons-attributes/index.html (added)
+++ websites/production/commons/content/propers/commons-attributes/index.html Fri Jan 11 14:32:44 2013
@@ -0,0 +1,245 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html><head><title>Overview - 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"><strong><a href="index.html">Overview</a></strong></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"><strong><a href="index.html">About</a></strong></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.ht
ml" 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 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.or
g/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="Overview"></a><h2>Overview</h2>
+ <p>
+ Commons Attributes enables Java programmers to use C#/.Net-style
+ attributes in their code.
+
+ Please see the <a href="tutorial.html">tutorial</a> and
+ <a href="reference.html">reference</a> for a thorough explanation of the features
+ and how the project integrates into the development process.
+ </p>
+ </div><div class="section"><a name="News"></a><h2>News</h2>
+ <p>Please see the <a href="changelog.html">change log</a> for summaries of code changes.</p>
+
+ <p><b>2006-08-03</b></p>
+ <ul>
+ <li><p>Attributes 2.2 is released (<a href="http://svn.apache.org/repos/asf/commons/proper/attributes/tags/CA_2_2/RELEASE_NOTES.txt" class="externalLink" title="External Link">release notes</a>)</p></li>
+ </ul>
+
+ <p><b>2004-08-15</b></p>
+ <ul>
+ <li><p>Attributes 2.1 released!</p></li>
+ </ul>
+
+ <p><b>2004-07-12</b></p>
+ <ul>
+ <li><p>Attributes promoted out of sandbox to Commons proper.</p></li>
+ </ul>
+ </div><div class="section"><a name="Download_and_Installation"></a><h2>Download and Installation</h2>
+
+ <div class="subsection"><a name="Full_Distribution"></a><h3>Full Distribution</h3>
+ <p>You can download the full Commons Attributes distribution <a href="http://commons.apache.org/downloads/download_attributes.cgi" class="externalLink" title="External Link">here</a>. </p>
+ </div>
+
+ <div class="subsection"><a name="Ant_Users"></a><h3>Ant Users</h3>
+ <p>
+ Download the following files and put them in your <code>$ANT_HOME/lib</code> directory:
+ </p>
+
+ <ul>
+ <li>
+ <p>Client API: <a href="http://www.ibiblio.org/maven/commons-attributes/jars/commons-attributes-api-2.2.jar" class="externalLink" title="External Link">commons-attributes-api-2.2.jar</a></p>
+ </li>
+ <li>
+ <p>Ant task: <a href="http://www.ibiblio.org/maven/commons-attributes/jars/commons-attributes-compiler-2.2.jar" class="externalLink" title="External Link">commons-attributes-compiler-2.2.jar</a></p>
+ </li>
+ <li>
+ <p>qDox 1.5: <a href="http://www.ibiblio.org/maven/qdox/jars/qdox-1.5.jar" class="externalLink" title="External Link">qdox-1.5.jar</a></p>
+ </li>
+ </ul>
+ </div>
+
+ <div class="subsection"><a name="Maven_Users"></a><h3>Maven Users</h3>
+
+ <p>
+ Download the following files:
+ </p>
+
+ <ul>
+ <li>
+ <p>Client API: <a href="http://www.ibiblio.org/maven/commons-attributes/jars/commons-attributes-api-2.2.jar" class="externalLink" title="External Link">commons-attributes-api-2.2.jar</a></p>
+ </li>
+ <li>
+ <p>Ant task: <a href="http://www.ibiblio.org/maven/commons-attributes/jars/commons-attributes-compiler-2.2.jar" class="externalLink" title="External Link">commons-attributes-compiler-2.2.jar</a></p>
+ </li>
+ <li>
+ <p>Maven plugin: <a href="http://www.apache.org/dist/java-repository/commons-attributes/plugins/commons-attributes-plugin-2.2.jar" class="externalLink" title="External Link">commons-attributes-plugin-2.2.jar</a></p>
+ </li>
+ </ul>
+
+ <p>Drop the <code>-api</code> and <code>-compiler</code> jars into your <code>${maven repository}/commons-attributes/jars/</code>
+ directory, and the Maven <code>-plugin</code> in your <code>${maven home}/plugins/</code> directory.
+ You can now use attributes in your Java code, provided that you declare a dependency on the client API:</p>
+
+
+ <div class="source"><pre><dependency>
+ <groupId>commons-attributes</groupId>
+ <artifactId>commons-attributes-api</artifactId>
+ <version>2.2</version>
+</dependency></pre></div>
+
+
+
+ <p>The attribute compiler will act as a precompiler to the java:compile goal, so you do not need to do
+ anything else.</p>
+ </div>
+ </div><div class="section"><a name="A_Quick_Sample"></a><h2>A Quick Sample</h2>
+
+ <p>
+ Commons Attributes enables you to add attributes to your code:
+ </p>
+
+
+ <div class="source"><pre>
+/**
+ * Make this attribute inheritable...
+ *
+ * @@Inheritable()
+ */
+public class MyAttribute {
+ private final float value;
+
+ public MyAttribute( float value ) {
+ this.value = value;
+ }
+
+ public float getValue() {
+ return value;
+ }
+}
+
+/**
+ * Add a MyAttribute with value 0.8.
+ *
+ * @@MyAttribute( 0.8 )
+ */
+public class MyClass {
+ public static void main( String[] args ) {
+ System.out.println( "MyClass has the following attributes:" +
+ Attributes.getAttributes( MyClass.class ) );
+ }
+}</pre></div>
+
+
+ <p>
+ As the example shows, the attributes are type-safe and provides for validation
+ of values.
+ </p>
+
+ </div><div class="section"><a name="Features"></a><h2>Features</h2>
+
+ <table class="bodyTable">
+ <tr class="b">
+ <th colspan="2">
+ API
+ </th>
+ </tr>
+ <tr class="a">
+ <td>Can add attributes to classes</td>
+ <td>Yes</td>
+ </tr>
+ <tr class="b">
+ <td>Can add attributes to nested classes</td>
+ <td>Yes</td>
+ </tr>
+ <tr class="a">
+ <td>Can add attributes to methods and constructors</td>
+ <td>Yes</td>
+ </tr>
+ <tr class="b">
+ <td>Can add attributes to return values of methods</td>
+ <td>Yes</td>
+ </tr>
+ <tr class="a">
+ <td>Can add attributes to method parameters</td>
+ <td>Yes</td>
+ </tr>
+ <tr class="b">
+ <td>Can add attributes to fields</td>
+ <td>Yes</td>
+ </tr>
+ <tr class="a">
+ <td>Type safe attributes</td>
+ <td>Yes</td>
+ </tr>
+ <tr class="b">
+ <td>Ability to restrict targets</td>
+ <td>Yes, add an appropriate @@Target() attribute.</td>
+ </tr>
+ <tr class="a">
+ <td>Attribute inheritance</td>
+ <td>Yes, add the @@Inheritable() attribue to any attribute you wish to be inheritable.</td>
+ </tr>
+ <tr class="b">
+ <td>Inheritance without access to superclass source code</td>
+ <td>Yes</td>
+ </tr>
+ <tr class="a">
+ <td>Named parameters in attribute declaration</td>
+ <td>Yes, corresponds to setter methods. A Sealable interface enables the instance to
+ become read-only when all relevant setters have been called.</td>
+ </tr>
+ <tr class="b">
+ <td>Ability to quickly find all classes with a specific attribute</td>
+ <td>Yes, via attribute indexes.</td>
+ </tr>
+ <tr class="a">
+ <td>Object attributes don't have to be serializable</td>
+ <td>Yes</td>
+ </tr>
+ <tr class="b">
+ <td>Multiple attributes with same tag on an element</td>
+ <td>Yes, this is controlled by the attribute itself</td>
+ </tr>
+ <tr class="a">
+ <th colspan="2">
+ Tools
+ </th>
+ </tr>
+ <tr class="b">
+ <td>Ant task</td>
+ <td>Yes</td>
+ </tr>
+ <tr class="a">
+ <td>Maven plugin</td>
+ <td>Yes</td>
+ </tr>
+ <tr class="b">
+ <td>Javadoc Taglet</td>
+ <td>Yes <i>(Note: Taglets only exist in Javadoc 1.4 and later)</i></td>
+ </tr>
+ <tr class="a">
+ <td>Incremental compilation</td>
+ <td>Yes</td>
+ </tr>
+ <tr class="b">
+ <td>Compile-time Validation</td>
+ <td>Yes</td>
+ </tr>
+ <tr class="a">
+ <th colspan="2">
+ Implementation
+ </th>
+ </tr>
+ <tr class="b">
+ <td>Attribute storage</td>
+ <td>Generated classes</td>
+ </tr>
+ <tr class="a">
+ <td>Runtime code size</td>
+ <td>36kB</td>
+ </tr>
+ <tr class="b">
+ <td>Unit test coverage</td>
+ <td>Excellent</td>
+ </tr>
+ </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/indexer.html
==============================================================================
--- websites/production/commons/content/propers/commons-attributes/indexer.html (added)
+++ websites/production/commons/content/propers/commons-attributes/indexer.html Fri Jan 11 14:32:44 2013
@@ -0,0 +1,69 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html><head><title>Reference - Indexing - 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"><strong><a href="indexer.html">Indexing</a></strong></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_AttributeIndexer_Ant_Task"></a><h2>The AttributeIndexer Ant Task</h2>
+
+ <p>The AttributeIndexer tool creates a list of classes that the o.a.c.a.AttributeIndex class
+ should consider for inclusion in its index. The tool is run on a JAR file and will create a file named
+ attrs.index in the META-INF folder. The process is:</p>
+
+
+ <div class="source"><pre>+------------+
+|.class Files|
++------------+
+ |
+ JAR Tool
+ |
+ v
++-------------+
+| .JAR File |
++-------------+
+ |
+ Indexer
+ |
+ v
++-------------+
+|Jar w. index |
++-------------+</pre></div>
+
+
+ <p>
+ This is how the indexer is used:
+ </p>
+
+
+ <div class="source"><pre><taskdef resource="org/apache/commons/attributes/anttasks.properties"/>
+
+<attribute-indexer jarfile="myclasses.jar"/></pre></div>
+
+
+ <table class="bodyTable">
+ <tr class="a">
+ <th>
+ Parameter
+ </th>
+ <th>
+ Required
+ </th>
+ <th>
+ Description
+ </th>
+ </tr>
+ <tr class="b">
+ <td>
+ jarfile
+ </td>
+ <td>
+ Yes
+ </td>
+ <td>
+ The jar file to create an index for.
+ </td>
+ </tr>
+ </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/issue-tracking.html
==============================================================================
--- websites/production/commons/content/propers/commons-attributes/issue-tracking.html (added)
+++ websites/production/commons/content/propers/commons-attributes/issue-tracking.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>Issue Tracking - 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"><a href="cvs-usage.html">Source Repository</a></li><li class="none"><strong><a href="issue-tracking.html">Issue Tracking</a></strong></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="Issue_Tracking"></a><h2>Issue Tracking</h2>
+ <p>
+ <a href="http://issues.apache.org/jira/browse/ATTRIBUTES" class="externalLink" title="External Link">http://issues.apache.org/jira/browse/ATTRIBUTES</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/license.html
==============================================================================
--- websites/production/commons/content/propers/commons-attributes/license.html (added)
+++ websites/production/commons/content/propers/commons-attributes/license.html Fri Jan 11 14:32:44 2013
@@ -0,0 +1,213 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html><head><title>Project License - 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="expanded"><a href="maven-reports.html">Project Reports</a><ul><li class="none"><strong><a href="license.html">Project License</a></strong></li></ul></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="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="Project_License"></a><h2>Project License</h2><p></p>
+ <div class="source"><pre>
+ Apache License
+ Version 2.0, January 2004
+ http://www.apache.org/licenses/
+
+ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+ 1. Definitions.
+
+ "License" shall mean the terms and conditions for use, reproduction,
+ and distribution as defined by Sections 1 through 9 of this document.
+
+ "Licensor" shall mean the copyright owner or entity authorized by
+ the copyright owner that is granting the License.
+
+ "Legal Entity" shall mean the union of the acting entity and all
+ other entities that control, are controlled by, or are under common
+ control with that entity. For the purposes of this definition,
+ "control" means (i) the power, direct or indirect, to cause the
+ direction or management of such entity, whether by contract or
+ otherwise, or (ii) ownership of fifty percent (50%) or more of the
+ outstanding shares, or (iii) beneficial ownership of such entity.
+
+ "You" (or "Your") shall mean an individual or Legal Entity
+ exercising permissions granted by this License.
+
+ "Source" form shall mean the preferred form for making modifications,
+ including but not limited to software source code, documentation
+ source, and configuration files.
+
+ "Object" form shall mean any form resulting from mechanical
+ transformation or translation of a Source form, including but
+ not limited to compiled object code, generated documentation,
+ and conversions to other media types.
+
+ "Work" shall mean the work of authorship, whether in Source or
+ Object form, made available under the License, as indicated by a
+ copyright notice that is included in or attached to the work
+ (an example is provided in the Appendix below).
+
+ "Derivative Works" shall mean any work, whether in Source or Object
+ form, that is based on (or derived from) the Work and for which the
+ editorial revisions, annotations, elaborations, or other modifications
+ represent, as a whole, an original work of authorship. For the purposes
+ of this License, Derivative Works shall not include works that remain
+ separable from, or merely link (or bind by name) to the interfaces of,
+ the Work and Derivative Works thereof.
+
+ "Contribution" shall mean any work of authorship, including
+ the original version of the Work and any modifications or additions
+ to that Work or Derivative Works thereof, that is intentionally
+ submitted to Licensor for inclusion in the Work by the copyright owner
+ or by an individual or Legal Entity authorized to submit on behalf of
+ the copyright owner. For the purposes of this definition, "submitted"
+ means any form of electronic, verbal, or written communication sent
+ to the Licensor or its representatives, including but not limited to
+ communication on electronic mailing lists, source code control systems,
+ and issue tracking systems that are managed by, or on behalf of, the
+ Licensor for the purpose of discussing and improving the Work, but
+ excluding communication that is conspicuously marked or otherwise
+ designated in writing by the copyright owner as "Not a Contribution."
+
+ "Contributor" shall mean Licensor and any individual or Legal Entity
+ on behalf of whom a Contribution has been received by Licensor and
+ subsequently incorporated within the Work.
+
+ 2. Grant of Copyright License. Subject to the terms and conditions of
+ this License, each Contributor hereby grants to You a perpetual,
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+ copyright license to reproduce, prepare Derivative Works of,
+ publicly display, publicly perform, sublicense, and distribute the
+ Work and such Derivative Works in Source or Object form.
+
+ 3. Grant of Patent License. Subject to the terms and conditions of
+ this License, each Contributor hereby grants to You a perpetual,
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+ (except as stated in this section) patent license to make, have made,
+ use, offer to sell, sell, import, and otherwise transfer the Work,
+ where such license applies only to those patent claims licensable
+ by such Contributor that are necessarily infringed by their
+ Contribution(s) alone or by combination of their Contribution(s)
+ with the Work to which such Contribution(s) was submitted. If You
+ institute patent litigation against any entity (including a
+ cross-claim or counterclaim in a lawsuit) alleging that the Work
+ or a Contribution incorporated within the Work constitutes direct
+ or contributory patent infringement, then any patent licenses
+ granted to You under this License for that Work shall terminate
+ as of the date such litigation is filed.
+
+ 4. Redistribution. You may reproduce and distribute copies of the
+ Work or Derivative Works thereof in any medium, with or without
+ modifications, and in Source or Object form, provided that You
+ meet the following conditions:
+
+ (a) You must give any other recipients of the Work or
+ Derivative Works a copy of this License; and
+
+ (b) You must cause any modified files to carry prominent notices
+ stating that You changed the files; and
+
+ (c) You must retain, in the Source form of any Derivative Works
+ that You distribute, all copyright, patent, trademark, and
+ attribution notices from the Source form of the Work,
+ excluding those notices that do not pertain to any part of
+ the Derivative Works; and
+
+ (d) If the Work includes a "NOTICE" text file as part of its
+ distribution, then any Derivative Works that You distribute must
+ include a readable copy of the attribution notices contained
+ within such NOTICE file, excluding those notices that do not
+ pertain to any part of the Derivative Works, in at least one
+ of the following places: within a NOTICE text file distributed
+ as part of the Derivative Works; within the Source form or
+ documentation, if provided along with the Derivative Works; or,
+ within a display generated by the Derivative Works, if and
+ wherever such third-party notices normally appear. The contents
+ of the NOTICE file are for informational purposes only and
+ do not modify the License. You may add Your own attribution
+ notices within Derivative Works that You distribute, alongside
+ or as an addendum to the NOTICE text from the Work, provided
+ that such additional attribution notices cannot be construed
+ as modifying the License.
+
+ You may add Your own copyright statement to Your modifications and
+ may provide additional or different license terms and conditions
+ for use, reproduction, or distribution of Your modifications, or
+ for any such Derivative Works as a whole, provided Your use,
+ reproduction, and distribution of the Work otherwise complies with
+ the conditions stated in this License.
+
+ 5. Submission of Contributions. Unless You explicitly state otherwise,
+ any Contribution intentionally submitted for inclusion in the Work
+ by You to the Licensor shall be under the terms and conditions of
+ this License, without any additional terms or conditions.
+ Notwithstanding the above, nothing herein shall supersede or modify
+ the terms of any separate license agreement you may have executed
+ with Licensor regarding such Contributions.
+
+ 6. Trademarks. This License does not grant permission to use the trade
+ names, trademarks, service marks, or product names of the Licensor,
+ except as required for reasonable and customary use in describing the
+ origin of the Work and reproducing the content of the NOTICE file.
+
+ 7. Disclaimer of Warranty. Unless required by applicable law or
+ agreed to in writing, Licensor provides the Work (and each
+ Contributor provides its Contributions) on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+ implied, including, without limitation, any warranties or conditions
+ of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+ PARTICULAR PURPOSE. You are solely responsible for determining the
+ appropriateness of using or redistributing the Work and assume any
+ risks associated with Your exercise of permissions under this License.
+
+ 8. Limitation of Liability. In no event and under no legal theory,
+ whether in tort (including negligence), contract, or otherwise,
+ unless required by applicable law (such as deliberate and grossly
+ negligent acts) or agreed to in writing, shall any Contributor be
+ liable to You for damages, including any direct, indirect, special,
+ incidental, or consequential damages of any character arising as a
+ result of this License or out of the use or inability to use the
+ Work (including but not limited to damages for loss of goodwill,
+ work stoppage, computer failure or malfunction, or any and all
+ other commercial damages or losses), even if such Contributor
+ has been advised of the possibility of such damages.
+
+ 9. Accepting Warranty or Additional Liability. While redistributing
+ the Work or Derivative Works thereof, You may choose to offer,
+ and charge a fee for, acceptance of support, warranty, indemnity,
+ or other liability obligations and/or rights consistent with this
+ License. However, in accepting such obligations, You may act only
+ on Your own behalf and on Your sole responsibility, not on behalf
+ of any other Contributor, and only if You agree to indemnify,
+ defend, and hold each Contributor harmless for any liability
+ incurred by, or claims asserted against, such Contributor by reason
+ of your accepting any such warranty or additional liability.
+
+ END OF TERMS AND CONDITIONS
+
+ APPENDIX: How to apply the Apache License to your work.
+
+ To apply the Apache License to your work, attach the following
+ boilerplate notice, with the fields enclosed by brackets "[]"
+ replaced with your own identifying information. (Don't include
+ the brackets!) The text should be enclosed in the appropriate
+ comment syntax for the file format. We also recommend that a
+ file or class name and description of purpose be included on the
+ same "printed page" as the copyright notice for easier
+ identification within third-party archives.
+
+ Copyright [yyyy] [name of copyright owner]
+
+ Licensed 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
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ 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.
+</pre></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/mail-lists.html
==============================================================================
--- websites/production/commons/content/propers/commons-attributes/mail-lists.html (added)
+++ websites/production/commons/content/propers/commons-attributes/mail-lists.html Fri Jan 11 14:32:44 2013
@@ -0,0 +1,57 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html><head><title>Mailing Lists - 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"><strong><a href="mail-lists.html">Mailing Lists</a></strong></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"><strong><a href="mail-lists.html">Mailing Lists</a></strong></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"><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.apach
e.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="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 cl
ass="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="Mailing_Lists"></a><h2>Mailing Lists</h2>
+ <p>
+ These are the mailing lists that have been established for this project. For each list, there is a subscribe, unsubscribe, and an archive link.
+ </p>
+ <table class="bodyTable">
+ <thead>
+ <tr class="a">
+ <th>
+ List Name
+ </th>
+ <th>
+ Subscribe
+ </th>
+ <th>
+ Unsubscribe
+ </th>
+ <th>
+ Archive
+ </th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr class="b">
+ <td>Commons Dev List</td>
+ <td>
+ <a href="mailto:dev-subscribe@commons.apache.org">Subscribe</a>
+ </td>
+ <td>
+ <a href="mailto:dev-unsubscribe@commons.apache.org">Unsubscribe</a>
+ </td>
+ <td>
+ <a href="http://mail-archives.apache.org/mod_mbox/commons-dev/" class="externalLink" title="External Link">Archive</a>
+ </td>
+ </tr>
+ <tr class="a">
+ <td>Commons User List</td>
+ <td>
+ <a href="mailto:user-subscribe@commons.apache.org">Subscribe</a>
+ </td>
+ <td>
+ <a href="mailto:user-unsubscribe@commons.apache.org">Unsubscribe</a>
+ </td>
+ <td>
+ <a href="http://mail-archives.apache.org/mod_mbox/commons-user/" class="externalLink" title="External Link">Archive</a>
+ </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/maven-reports.html
==============================================================================
--- websites/production/commons/content/propers/commons-attributes/maven-reports.html (added)
+++ websites/production/commons/content/propers/commons-attributes/maven-reports.html Fri Jan 11 14:32:44 2013
@@ -0,0 +1,37 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html><head><title>Project Reports - 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="expanded"><strong><a href="maven-reports.html">Project Reports</a></strong><ul><li class="none"><a href="license.html">Project License</a></li></ul></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="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="Maven_Generated_Reports"></a><h2>Maven Generated Reports</h2>
+ <p>
+ This document provides an overview of the various reports that are automatically generated by
+ <a href="http://maven.apache.org/" class="externalLink" title="External Link">Maven</a>
+ . Each report is briefly described below.
+ </p>
+
+
+ <div class="subsection"><a name="Overview"></a><h3>Overview</h3>
+ <table class="bodyTable">
+ <tr class="b">
+ <th>
+ Document
+ </th>
+ <th>
+ Description
+ </th>
+ </tr>
+ <tr class="a">
+ <td>
+ <a href="license.html">
+ Project License
+ </a>
+ </td>
+ <td>Displays the primary license for the project.</td>
+ </tr>
+ </table>
+ </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/maven_demo.html
==============================================================================
--- websites/production/commons/content/propers/commons-attributes/maven_demo.html (added)
+++ websites/production/commons/content/propers/commons-attributes/maven_demo.html Fri Jan 11 14:32:44 2013
@@ -0,0 +1,104 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html><head><title>Tutorial - Maven Demo - 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"><strong><a href="maven_demo.html">Maven Demo</a></strong></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="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="About_This_Demo"></a><h2>About This Demo</h2>
+ <p>
+ This is a quick demo that shows how to use attributes together with
+ Maven. Don't worry about 90% here seemingly being pure unexplainable
+ magic - the purpose of this part of the tutorial is to show you
+ what steps you must do to make the Commons Attributes package work.
+ In the reference we'll focus more on just what happens, and how
+ the all features work.
+ </p>
+
+ </div><div class="section"><a name="The_Demo_Files"></a><h2>The Demo Files</h2>
+ <p>
+ All files required for this demo can be found in <a href="maven_demo.zip">maven_demo.zip</a>.
+ </p>
+ </div><div class="section"><a name="Project_Setup"></a><h2>Project Setup</h2>
+
+ <p>
+ In order to get attributes working in your project you need to do three things:
+ (1) declare dependencies, (2) install the commons-attributes plugin and (3) set project
+ properties that will enable the plugin for your project.
+ </p>
+
+ <div class="subsection"><a name="Declaring_Dependencies"></a><h3>Declaring Dependencies</h3>
+ <p>
+ Dependencies are declared as you would expect in your project.xml:
+ </p>
+
+ <div class="source"><pre><dependency>
+ <groupId>commons-attributes</groupId>
+ <artifactId>commons-attributes-api</artifactId>
+ <version>2.2</version>
+</dependency>
+
+<dependency>
+ <groupId>commons-attributes</groupId>
+ <artifactId>commons-attributes-compiler</artifactId>
+ <version>2.2</version>
+</dependency></pre></div>
+
+ </div>
+
+ <div class="subsection"><a name="Installing_the_Plugin"></a><h3>Installing the Plugin</h3>
+ <p>
+ You can install the plugin by checking out the sources and doing:
+ </p>
+
+
+ <div class="source"><pre>$ maven install
+$ maven install-plugin</pre></div>
+
+
+ <p>
+ Alternatively, you can download the plugin and put it in your Maven
+ plugin directory.
+ </p>
+ </div>
+
+ <div class="subsection"><a name="Project_Properties"></a><h3>Project Properties</h3>
+
+ <p>Since Maven will unconditionally apply all plugins to every project being compiled
+ it is neccessary to explicitly enable the attribute compiler and/or indexer. This
+ is simply to keep them from being run on projects that do not want anything to do
+ with Commons-Attributes. The compiler and/or indexer are enabled by two project
+ properties that you can set in your project.properties file or in your maven.xml
+ file:
+ </p>
+
+
+ <div class="source"><pre>######################################################################
+# Commons-Attributes
+######################################################################
+org.apache.commons.attributes.enable=true
+org.apache.commons.attributes.index.enable=true</pre></div>
+
+
+ <p>
+ The first property will enable the attribute precompilation step. The second will
+ enable the attribute indexing step that takes place after the jar:jar target.
+ Both properties can be set independently of each other, although it makes little
+ sense to enable indexing if compilation isn't enables as well.
+ </p>
+ </div>
+
+ </div><div class="section"><a name="Running_the_Demo"></a><h2>Running the Demo</h2>
+
+ <p>
+ You should be able to unzip the demo files, cd into the directory and execute
+ "maven run", like this:
+ </p>
+
+
+ <div class="source"><pre>$ unzip maven_demo.zip
+$ cd maven_demo
+$ maven run</pre></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/maven_demo.zip
==============================================================================
Binary file - no diff available.
Propchange: websites/production/commons/content/propers/commons-attributes/maven_demo.zip
------------------------------------------------------------------------------
svn:mime-type = application/zip