Hi all,
I've committed the Maven project and properties files and also some
example xdocs to illustrate how the site structure might pan out. An
example of the output can be viewed at
http://www.monkeymachine.ltd.uk/spring/index.html
The "project reports" section is of particular interest.
If you want to try it out there are a few steps (plus some others which
I'll probably forget :).
The first thing is to download maven 1.0-beta-9 from maven.apache.org
and install it. This should be straightforward. I think you'll also have
to set up MAVEN_HOME to point to the directory you unpack it to.
One of the main features of Maven is its ability to handle dependencies
on third-party libraries across your projects. The dependencies are
specified in the project.xml file (have a look to see how it's done).
Maven will automatically download these as required from an online
repository (at http://www.ibiblio.org/maven) and maintain a local
repository. So the idea is that you don't have to store jar files in cvs
anymore. Unfortunately due to licensing issues with Sun, a lot of key
jar files can't be provided by the online repository. Others may be
missing because they aren't well known projects or just because nobody's
asked yet. The solution is to insert these into the local repository
yourself.
For each unsatisfied dependency, create your own directory in
MAVEN_HOME/repository and copy the jar file(s) there. e.g. for the ejb
classes the project.xml entry is
<dependency>
<id>ejb</id>
<version>2.0</version>
<jar>ejb.jar</jar>
</dependency>
So you create directory MAVEN_HOME/repository/ejb/jar and copy ejb.jar
into it.
Repeat this for jta, jms, javamail, aopalliance and attrib4j entries.
The rest should be handled automatically. I've specified the jdk1.4
version of mockobjects 'cos that's what I'm building with so that may
cause problems if you're using 1.3.
Once that's done, there are a few things you can try. All output goes to
the "target" directory.
maven -Dmaven.test.skip=true dist
will build a set of distribution files (binary and src, tar.gz and zip)
in the distribution directory.
maven site
will generate the documentation and web site in "docs". This should look
like the one at the above URL.
If you have any problems post them here. Use "maven --debug" if
something's going drastically wrong.
Have fun,
Luke.
--
Luke Taylor. Monkey Machine Ltd.
PGP Key ID: 0x57E9523C http://www.monkeymachine.ltd.uk
|
