You are viewing a plain text version of this content. The canonical link for it is here.
Posted to alexandria-dev@jakarta.apache.org by sa...@apache.org on 2001/04/30 22:50:12 UTC
cvs commit: jakarta-alexandria/xdocs/stylesheets project.xml
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="jmartin@silcom.com">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="jmartin@silcom.com">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="jmartin@silcom.com">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: alexandria-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: alexandria-dev-help@jakarta.apache.org
Re: cvs commit: jakarta-alexandria/xdocs/stylesheets project.xml
Posted by Scott Sanders <sa...@totalsync.com>.
I will change that ;-)
Jon Stevens wrote:
> on 4/30/01 1:50 PM, "sanders@apache.org" <sa...@apache.org> wrote:
>
>
>> <source>
>> <build buildfile="build.xml" target="main" classpath="lib/mylib.jar">
>> <arg name="build.dir" value="build"/>
>> </build>
>> </source>
>
>
> With Anakia, you don't need convert things to > first. Just put it in a
> CDATA and Anakia will fix the output.
---------------------------------------------------------------------
To unsubscribe, e-mail: alexandria-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: alexandria-dev-help@jakarta.apache.org
Re: cvs commit: jakarta-alexandria/xdocs/stylesheets project.xml
Posted by Jon Stevens <jo...@latchkey.com>.
on 4/30/01 1:50 PM, "sanders@apache.org" <sa...@apache.org> wrote:
> <source>
> <build buildfile="build.xml" target="main" classpath="lib/mylib.jar">
> <arg name="build.dir" value="build"/>
> </build>
> </source>
With Anakia, you don't need convert things to > first. Just put it in a
CDATA and Anakia will fix the output.
Thanks,
-jon
---------------------------------------------------------------------
To unsubscribe, e-mail: alexandria-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: alexandria-dev-help@jakarta.apache.org