leosutic 2004/08/01 13:17:59 Modified: attributes build.xml maven.xml attributes/site/xdocs faq.xml index.xml navigation.xml attributes/unittest project.xml Log: Last changes before release. Revision Changes Path 1.7 +5 -3 jakarta-commons/attributes/build.xml Index: build.xml =================================================================== RCS file: /home/cvs/jakarta-commons/attributes/build.xml,v retrieving revision 1.6 retrieving revision 1.7 diff -u -r1.6 -r1.7 --- build.xml 28 Jul 2004 09:48:30 -0000 1.6 +++ build.xml 1 Aug 2004 20:17:58 -0000 1.7 @@ -36,9 +36,11 @@ </property> <property name="javadocdir" value="dist/docs/api"> </property> - <property name="final.name.api" value="commons-attributes-api-2.1"> + <property name="version" value="2.1"> </property> - <property name="final.name.compiler" value="commons-attributes-compiler-2.1"> + <property name="final.name.api" value="commons-attributes-api-${version}"> + </property> + <property name="final.name.compiler" value="commons-attributes-compiler-${version}"> </property> <target name="init" description="o Initializes some properties"> <mkdir dir="${libdir}"> @@ -126,7 +128,7 @@ </tstamp> <property name="copyright" value="Copyright &copy; Apache Software Foundation. All Rights Reserved."> </property> - <property name="title" value="Jakarta Commons Attribute Compiler API 2.1 API"> + <property name="title" value="Jakarta Commons Attribute Compiler API ${version} API"> </property> <javadoc use="true" private="true" destdir="${javadocdir}" author="true" version="true" sourcepath="api/src/java" packagenames="org.apache.commons.attributes.*"> <classpath> 1.4 +80 -8 jakarta-commons/attributes/maven.xml Index: maven.xml =================================================================== RCS file: /home/cvs/jakarta-commons/attributes/maven.xml,v retrieving revision 1.3 retrieving revision 1.4 diff -u -r1.3 -r1.4 --- maven.xml 26 Jul 2004 20:48:58 -0000 1.3 +++ maven.xml 1 Aug 2004 20:17:58 -0000 1.4 @@ -26,7 +26,7 @@ <property name="pom.specificationVersion" value="1.0"/> <property name="javadoc14.jar" value="${maven.repo.local}/javadoc/jars/javadoc-1.4.jar"/> - + <goal name="attributes:help" description="Print some help."> <echo><![CDATA[ @@ -85,7 +85,7 @@ Finally, please be aware that I *have* contacted Sun regarding putting the javadoc API classes into a Maven repository... ]]></echo> - + <mkdir dir="${maven.repo.local}/javadoc/jars/"/> <jar destfile="${maven.repo.local}/javadoc/jars/javadoc-1.4.jar"> <zipfileset src="${java.home}/../lib/tools.jar" includes="com/sun/javadoc/**,com/sun/tools/doclets/Taglet.class"/> @@ -154,12 +154,84 @@ </goal> <goal name="dist"> - <maven:reactor - basedir="${basedir}" - includes="api/project.xml,compiler/project.xml" - goals="dist:build" - banner="Creating distribution:" - ignoreFailures="false" /> + <property name="maven.dist.assembly.dir" value="${maven.build.dir}/${maven.final.name}"/> + <property name="maven.dist.bin.archive.dir" value="${maven.dist.assembly.dir}/bin"/> + <property name="maven.dist.src.archive.dir" value="${maven.dist.assembly.dir}/src"/> + <property name="maven.dist.bin.assembly.dir" value="${maven.dist.assembly.dir}/bin/${maven.final.name}"/> + <property name="maven.dist.src.assembly.dir" value="${maven.dist.assembly.dir}/src/${maven.final.name}"/> + <property name="maven.dist.dir" value="${maven.build.dir}/distributions"/> + + + <attainGoal name="clean"/> + <attainGoal name="install"/> + <attainGoal name="site"/> + + <delete dir="${maven.dist.dir}"/> + <mkdir dir="${maven.dist.dir}"/> + + <!-- + Copy the Jars across + --> + <copy todir="${maven.dist.dir}"> + <fileset dir="${basedir}/api/target/" + includes="commons-attributes-api-${pom.currentVersion}.jar"/> + <fileset dir="${basedir}/compiler/target/" + includes="commons-attributes-compiler-${pom.currentVersion}.jar"/> + </copy> + + <!-- + + Make binary distribution consisting of: + + + Compiler and API Jars. + + Javadocs + + LICENSE, NOTICE and RELEASE files + + --> + <mkdir dir="${maven.dist.bin.assembly.dir}"/> + <copy todir="${maven.dist.bin.assembly.dir}"> + <fileset dir="${basedir}/api/target/" + includes="commons-attributes-api-${pom.currentVersion}.jar"/> + <fileset dir="${basedir}/compiler/target/" + includes="commons-attributes-compiler-${pom.currentVersion}.jar"/> + <fileset dir="${basedir}/site/target/docs/" includes="api/**"/> + <fileset dir="${basedir}/" includes="LICENSE.txt,NOTICE.txt,RELEASE.txt"/> + </copy> + <!-- zip and tgz --> + <zip destfile="${maven.dist.dir}/${maven.final.name}.zip"> + <fileset dir="${maven.dist.bin.assembly.dir}"/> + </zip> + <tar destfile="${maven.dist.dir}/${maven.final.name}.tgz" + compression="gzip" + basedir="${maven.dist.bin.assembly.dir}"/> + + <!-- + + Make source distribution consisting of: + + + Source files from api, compiler, plugin, site and unittest + + build files + + LICENSE, NOTICE and RELEASE files + + --> + <copy todir="${maven.dist.src.assembly.dir}"> + <fileset dir="${basedir}/" includes="api/*,api/src/**" excludes="api/target/,**/CVS/**"/> + <fileset dir="${basedir}/" includes="compiler/*,compiler/src/**" excludes="compiler/target/**/CVS/**"/> + <fileset dir="${basedir}/" includes="plugin/*" excludes="**/CVS/**" /> + <fileset dir="${basedir}/" includes="site/*,site/etc/**,site/xdocs/" excludes="site/target/,**/CVS/**"/> + <fileset dir="${basedir}/" includes="unittest/*,unittest/src/**" excludes="unittest/target/,**/CVS/**" /> + + <fileset dir="${basedir}/" includes="build.xml,maven.xml,project.xml,project.properties" excludes="**/CVS/**" /> + + <fileset dir="${basedir}/" includes="LICENSE.txt,NOTICE.txt,RELEASE.txt"/> + </copy> + <!-- zip and tgz --> + <zip destfile="${maven.dist.dir}/${maven.final.name}-src.zip"> + <fileset dir="${maven.dist.src.assembly.dir}"/> + </zip> + <tar destfile="${maven.dist.dir}/${maven.final.name}-src.tgz" + compression="gzip" + basedir="${maven.dist.src.assembly.dir}"/> </goal> <goal name="install-plugin"> 1.2 +41 -0 jakarta-commons/attributes/site/xdocs/faq.xml Index: faq.xml =================================================================== RCS file: /home/cvs/jakarta-commons/attributes/site/xdocs/faq.xml,v retrieving revision 1.1 retrieving revision 1.2 diff -u -r1.1 -r1.2 --- faq.xml 6 Jul 2004 20:42:40 -0000 1.1 +++ faq.xml 1 Aug 2004 20:17:59 -0000 1.2 @@ -68,6 +68,47 @@ </ul> </section> + + <section name="Other Frameworks"> + + <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> + + </section> + + </body> </document> 1.5 +2 -1 jakarta-commons/attributes/site/xdocs/index.xml Index: index.xml =================================================================== RCS file: /home/cvs/jakarta-commons/attributes/site/xdocs/index.xml,v retrieving revision 1.4 retrieving revision 1.5 diff -u -r1.4 -r1.5 --- index.xml 24 Jul 2004 14:32:28 -0000 1.4 +++ index.xml 1 Aug 2004 20:17:59 -0000 1.5 @@ -30,7 +30,8 @@ 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 + 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> </section> 1.3 +1 -4 jakarta-commons/attributes/site/xdocs/navigation.xml Index: navigation.xml =================================================================== RCS file: /home/cvs/jakarta-commons/attributes/site/xdocs/navigation.xml,v retrieving revision 1.2 retrieving revision 1.3 diff -u -r1.2 -r1.3 --- navigation.xml 26 Jul 2004 20:48:58 -0000 1.2 +++ navigation.xml 1 Aug 2004 20:17:59 -0000 1.3 @@ -20,10 +20,7 @@ <body> <menu name="Commons Attributes"> <item name="Overview" href="/index.html"/> - <item name="API" href="/api-2.1/index.html"> - <item name="CVS" href="/api/index.html"/> - <item name="2.1" href="/api-2.1/index.html"/> - </item> + <item name="API" href="/api/index.html"/> <item name="Tutorial" href="/tutorial.html"> <item name="Ant Demo" href="/ant_demo.html"/> <item name="Maven Demo" href="/maven_demo.html"/> 1.4 +2 -2 jakarta-commons/attributes/unittest/project.xml Index: project.xml =================================================================== RCS file: /home/cvs/jakarta-commons/attributes/unittest/project.xml,v retrieving revision 1.3 retrieving revision 1.4 diff -u -r1.3 -r1.4 --- project.xml 24 Jul 2004 14:49:34 -0000 1.3 +++ project.xml 1 Aug 2004 20:17:59 -0000 1.4 @@ -55,13 +55,13 @@ <dependency> <groupId>commons-attributes</groupId> <artifactId>commons-attributes-compiler</artifactId> - <version>2.1rc1</version> + <version>2.1</version> </dependency> <dependency> <groupId>commons-attributes</groupId> <artifactId>commons-attributes-api</artifactId> - <version>2.1rc1</version> + <version>2.1</version> </dependency> </dependencies>
--------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]