sanders 01/04/30 13:50:11
Added: xdocs integration.xml repository.xml use.xml
velocity.properties
xdocs/stylesheets project.xml
Removed: xdocs intergration.xml site-book.xml
Log:
Preparing to update website
Revision Changes Path
1.1 jakarta-alexandria/xdocs/integration.xml
Index: integration.xml
===================================================================
<?xml version="1.0"?>
<document>
<properties>
<title>Alexandria Build Testing</title>
<author email="[EMAIL PROTECTED]">Jeff Martin</author>
</properties>
<body>
<section name="Continuous Intergration">
<img src="/images/build.png" alt="Continuous Intergration Diagram"/>
<p>Alexandrias ability to automatically get the latest versions of source code makes
it ideally suited as a tool for continuous intergration.</p>
<p>Contious intergration is an approach which was brought to the fore as part of <a
target="_blank" href="http://www.xprogramming.com";>eXtreme Programming</a> or XP. The
idea has long been part of open source projects but is now becouming more widly
accepted and formalised into a recognised process.</p>
</section>
<section name="Building Modules">
<p>Alexandria provides support for build projects which use Ant as there build tool.
To enable Alexandria to build a module you add the build taga to the global.xml
file.</p>
<p>Alexandria runs the build in a seperate JVM to avoid clashes the source libraries
ant those used by Alexandria. This means that the classpath attribute is used to
specify classes that will be needed byt the module. Ant properties can also be passed
to the build file using the arg tag this allows properties such as the output dir for
the build to be changed from there defaults.</p>
<source>
<build buildfile="build.xml" target="main" classpath="lib/mylib.jar">
<arg name="build.dir" value="build"/>
</build>
</source>
</section>
<section name="Testing Modules">
<p>Alexandria provides support for analyzing the output from the JUnit Ant task.
JUnit is a java based framework for writing unit tests for java applications.</p>
<p>To anable Alexandria to use the output from the JUnit task it needs to be
formatted using the xml formatter. The following example shows an example of this in
the JUnit task.</p>
<source> <property name="test.format" value="plain"/> </source>
<p>If you wish to allow developers to run tests and provide them with plain text
output, using an variable which defaults to plain and can be overriden with xml via
the -D option is recommended.</p>
<source>
<junit printsummary="yes" haltonfailure="yes">
<classpath>
<pathelement location="${build.tests}" />
<pathelement path="${java.class.path}" />
</classpath>
<formatter type="${test.format}" />
<batchtest fork="yes">
<fileset dir="${src.tests}">
<include name="**/*Test*.java" />
<exclude name="**/AllTests.java" />
</fileset>
</batchtest>
</junit> </source>
<p>Test targets are included in the <strong>global.xml</strong> file using the test
tag. The test tag has two attributes buildfile and target. Buildfile is the name of
the Ant buildfile which contains the test target and target is the name of the Ant
target to be run. Test optionally takes a classpath (Test are always run in a seperate
JVM to avoid class version problems) and arg tags that are used to pass Ant property
values into Ant.</p>
<source>
<test buildfile="build.xml" target="test" classpath="lib/mylib.jar">
<arg name="test.format" value="xml"/>
</test>
</source>
</section>
</body>
</document>
1.1 jakarta-alexandria/xdocs/repository.xml
Index: repository.xml
===================================================================
<?xml version="1.0"?>
<document>
<properties>
<title>Code Repository</title>
<author email="[EMAIL PROTECTED]">Jeff Martin</author>
</properties>
<body>
<section name="Code Repository">
<p>
You can see the code <a
href="http://jakarta.apache.org/cvsweb/index.cgi/jakarta-alexandria/";>here</a>.
</p>
</section>
</body>
</document>
1.1 jakarta-alexandria/xdocs/use.xml
Index: use.xml
===================================================================
<?xml version="1.0"?>
<document>
<properties>
<title>Use Alexandria</title>
<author email="[EMAIL PROTECTED]">Jeff Martin</author>
</properties>
<body>
<section name="Use Alexandria">
<p>
You can try Alexandria <a href="http://relativity.yi.org/alexandria";>here</a>.
</p>
</section>
</body>
</document>
1.1 jakarta-alexandria/xdocs/velocity.properties
Index: velocity.properties
===================================================================
resource.loader.1.resource.path = ../jakarta-site2/xdocs/stylesheets
1.1 jakarta-alexandria/xdocs/stylesheets/project.xml
Index: project.xml
===================================================================
<?xml version="1.0" encoding="ISO-8859-1"?>
<project name="Alexandria" href="http://jakarta.apache.org/alexandria/";>
<title>Alexandria</title>
<logo href="/images/logo.jpg">Alexandria</logo>
<body>
<menu name="About">
<item name="Index" href="/index.html"/>
<item name="Features" href="/features.html"/>
<item name="Configuration" href="/config.html"/>
<item name="Document Flow" href="/doc_flow.html"/>
<item name="Build Testing" href="/integration.html"/>
<item name="Usage" href="/usage.html"/>
<item name="Mailing Lists" href="/mail.html"/>
<item name="License" href="/license.html"/>
<item name="Todo" href="/todo.html"/>
</menu>
<menu name="References">
<item name="View Alexandria" href="/repository.html"/>
<item name="Use Alexandria" href="/use.html"/>
</menu>
</body>
</project>
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
