You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@commons.apache.org by le...@apache.org on 2004/08/01 22:17:59 UTC
cvs commit: jakarta-commons/attributes/unittest project.xml
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: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org