Menu
▾
▴
[dbunit-commit] SF.net SVN: dbunit: [526] trunk
|
From: <fel...@us...> - 2006-12-25 22:50:41
|
Revision: 526
http://svn.sourceforge.net/dbunit/?rev=526&view=rev
Author: felipeal
Date: 2006-12-25 14:50:40 -0800 (Mon, 25 Dec 2006)
Log Message:
-----------
1482990: minor fixes
Modified Paths:
--------------
trunk/pom.xml
trunk/src/site/apt/building.apt
trunk/src/site/fml/faq.fml
trunk/src/site/site.xml
trunk/src/site/xdoc/components.xml
trunk/src/site/xdoc/howto.xml
trunk/src/site/xdoc/index.xml
trunk/src/site/xdoc/properties.xml
Modified: trunk/pom.xml
===================================================================
--- trunk/pom.xml 2006-12-25 22:49:47 UTC (rev 525)
+++ trunk/pom.xml 2006-12-25 22:50:40 UTC (rev 526)
@@ -51,12 +51,20 @@
<archive>http://sourceforge.net/mailarchive/forum.php?forum_id=9162</archive>
</mailingList>
<mailingList>
- <name>DbUnit CVS Commit List</name>
+ <name>DbUnit SVN Commit List</name>
<subscribe>http://lists.sourceforge.net/lists/listinfo/dbunit-commit</subscribe>
<unsubscribe>http://lists.sourceforge.net/lists/listinfo/dbunit-commit</unsubscribe>
<archive>http://sourceforge.net/mailarchive/forum.php?forum_id=9771</archive>
</mailingList>
</mailingLists>
+
+ <pluginRepositories>
+ <pluginRepository>
+ <id>snapshots</id>
+ <url>http://people.apache.org/repo/m2-snapshot-repository/</url>
+ </pluginRepository>
+ </pluginRepositories>
+
<!-- who the developers are for the project -->
<developers>
@@ -229,7 +237,7 @@
<dependency>
<groupId>commons-logging</groupId>
<artifactId>commons-logging</artifactId>
-<!-- TODO: update -->
+<!-- TODO: update or use range-->
<version>1.0.4</version>
</dependency>
@@ -375,20 +383,20 @@
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-javadoc-plugin</artifactId>
</plugin>
+<!-- disabled for now, as reports show 100% coverage - see
+http://www.dbunit.org/cobertura/index.html
<plugin>
<groupId>org.codehaus.mojo</groupId>
<artifactId>cobertura-maven-plugin</artifactId>
-<!-- TODO: remove
- <version>2.0-SNAPSHOT</version>
+ </plugin>
-->
- </plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-changes-plugin</artifactId>
</plugin>
<plugin>
- <groupId>org.codehaus.mojo</groupId>
- <artifactId>changelog-maven-plugin</artifactId>
+ <groupId>org.apache.maven.plugins</groupId>
+ <artifactId>maven-changelog-plugin</artifactId>
</plugin>
</plugins>
</reporting>
Modified: trunk/src/site/apt/building.apt
===================================================================
--- trunk/src/site/apt/building.apt 2006-12-25 22:49:47 UTC (rev 525)
+++ trunk/src/site/apt/building.apt 2006-12-25 22:50:40 UTC (rev 526)
@@ -1 +1,64 @@
-coming soon...
+ ----
+Building DbUnit
+ ----
+Felipe Leme
+ ----
+23 December 2006
+
+Overview
+
+ Building DbUnit is quite simple; all you need is JDK 1.4+, Subversion and Maven 2. Once you have them all, you can build DbUnit by just typing mvn! Anyway, the items below describe every step
+
+Preparation
+
+ * 1.Install Java SE SDK version 1.4 (link)or newer (although DbUnit is Java 1.3 compatible, Maven 2 requires 1.4)
+ * 2.Install Maven 2 (link)
+ * 3.Download DbUnit code, either current (link) or released (link) source
+ * 4.On the root directory, simply type <code>mvn</code> in the command line (if you need to clean up the binaries, run <code>mvn clean install</code> instead). The jar file will be generated in the target directory.
+
+
+Creating the site
+
+ Run <code>mvn site:site</code> in the command line; the site will be available on <code>target/site/index.html</code>. Note that you might get an OutOfMemoryExceptionError; if that happens, you must increase the heap size through the MAVEN_OPTS variable (for instance, on Unix systems you could run <code>MAVEN_OPTS=-mx512M mvn site:site</code>).
+
+Using an IDE
+
+ As DbUnit uses Maven, it's not necessary to store IDE-specific information in the source repository. Instead, these meta-data can be dynamically generate by Maven. For instance, to create an Eclipse project, it's just a matter of typing <code>mvn eclipse:eclipe</code>. See more details on (link)Maven Eclipse Plugin, Mevenide for NetBeans, Maven IDEA plugin
+
+
+Contributing patches
+
+ If you are building DbUnit in order to contribute a patch, it's necessary to compile it using Java SE 1.3, which takes 3 adittional steps:
+
+1.Create an environment variable called JAVA_1_3_HOME pointing to the root of the Java 1.3 installation
+2.Download JDBC xxx (link)
+3.Run the command <code>mvn install:install-file -DgroupId=javax.sql -DartifactId=jdbc-stdext -Dversion=2.0 -Dpackaging=jar -Dfile=_path_to_the_jdbc_2_0_stdext_jar_</code>
+4.Run Maven using the <code>official</code> profile, i.e., <code>mvn -Pofficial clean install</code>. You should also generate the IDE meta-data using this profiling (for instance, <code>mvn -Pofficial eclipse:eclipse), and configure your IDE to use Java 1.3 for that project
+5.Once you finish your modifications, run <code>svn diff > name_of_the_patch_file</code> (or use your IDE) to generate a patch file and submit it on the web site (link). Don't forget to include test cases!
+
+Maintenance tasks
+
+ The tasks described below describes how to maintain DbUnit
+
+Updating the repository and site
+
+ Once new code is incorporated in the SVN code, it is necessary to update the Maven 2 repository with new snapshots and also update the site. These 2 tasks can be done with a simple command:
+
+mvn -Pofficial clean site:site source:jar javadoc:jar deploy site:deploy
+
+Cutting a release
+
+ Cutting a release requires 4 steps: create a SVN tag, generate the artifacts, update the site and upload the artifacts into SourceForge.
+
+ Fortunatelly, the first 3 steps can be achieve using Maven Release Plugin, as follow:
+
+ The final step must be done manually, logging in SourceForge and uploading the following files:
+
+XXX
+
+It is also nice to send a message to the mailing lists; ideally that should be done automatically, as the maven-announcement-plugin did for Maven 1.
+
+
+Fixing a bug/request
+
+ Everytinme a bug is fixed (or request is implemented), it is necesary to update the src/site/changes.xml file.
Modified: trunk/src/site/fml/faq.fml
===================================================================
(Binary files differ)
Modified: trunk/src/site/site.xml
===================================================================
--- trunk/src/site/site.xml 2006-12-25 22:49:47 UTC (rev 525)
+++ trunk/src/site/site.xml 2006-12-25 22:50:40 UTC (rev 526)
@@ -2,20 +2,16 @@
<project name="DbUnit">
<body>
- <links>
- <!--
- Removed until it can be fixed
- item name="Wiki" href="http://www.dbunit.org/wiki/"/-->
- <item name="SF.net Project Page" href="http://www.sf.net/projects/dbunit"/>
- <item name="Maven Plugin" href="http://maven-plugins.sourceforge.net/maven-dbunit-plugin/index.html"/>
- </links>
<menu name="Quick Links">
+ <item name="Maven 1.x Plugin" href="http://maven-plugins.sourceforge.net/maven-dbunit-plugin/index.html"/>
<item name="Download" href="http://sourceforge.net/project/showfiles.php?group_id=47439&release_id=242511"/>
<item name="Changes" href="/changes-report.html"/>
<item name="FAQ" href="/faq.html"/>
+ <item name="Wiki" href="/cgi-bin/wiki.pl"/>
<item name="Get Support" href="http://sourceforge.net/support/getsupport.php?group_id=47439"/>
- <item name="Source" href="/cvs-usage.html"/>
- <item name="JavaDocs" href="apidocs/index.html"/>
+ <item name="Get source" href="/source-repository.html"/>
+ <item name="Browse source" href="/jxr-report.html"/>
+ <item name="JavaDocs" href="/apidocs/index.html"/>
</menu>
<menu name="Overview">
<item name="About DbUnit" href="/index.html"/>
@@ -28,5 +24,6 @@
<item name="Building DbUnit" href="/building.html"/>
<item name="Resources" href="/resources.html"/>
</menu>
+ ${reports}
</body>
</project>
Modified: trunk/src/site/xdoc/components.xml
===================================================================
--- trunk/src/site/xdoc/components.xml 2006-12-25 22:49:47 UTC (rev 525)
+++ trunk/src/site/xdoc/components.xml 2006-12-25 22:50:40 UTC (rev 526)
@@ -91,7 +91,7 @@
<td><a name="xmldataset" href="apidocs/org/dbunit/dataset/xml/XmlDataSet.html">XmlDataSet</a></td>
<td>
Reads and writes original XML dataset document. This format
- is very verbiose and must conform to the following DTD:
+ is very verbose and must conform to the following DTD:
<source><