geirm 01/06/19 04:39:06
Added: rupert README.txt STATUS.html build.properties.sample
build.xml
Log:
Basic stuff for a new webapp tools project called, for lack of a better
name, 'Rupert'. The name will be decided by community :)
Maybe : toollibs
Revision Changes Path
1.1 jakarta-commons-sandbox/rupert/README.txt
Index: README.txt
===================================================================
Quickie How-To
==============
1) See the STATUS.html for all dependencies
2) The default location for all dependency jars
is the lib directory.
3) You can override the location of the jars as
specified in build.xml using the build.properties
file that would contain local values. See the
example.
4) Once you have ant installed, and all dependencies
satisfied, just simply start ant as creating the
jar is the default target.
1.1 jakarta-commons-sandbox/rupert/STATUS.html
Index: STATUS.html
===================================================================
<html>
<head>
<title>Status File for Jakarta Commons "Rupert" Component</title>
<head>
<body bgcolor="white">
<div align="center">
<h1>The Jakarta Commons <em>Rupert</em> Component</h1>
$Id: STATUS.html,v 1.1 2001/06/19 11:39:05 geirm Exp $<br>
<a href="#Introduction">[Introduction]</a>
<a href="#Dependencies">[Dependencies]</a>
<a href="#Release Info">[Release Info]</a>
<a href="#Committers">[Committers]</a>
<br><br>
</div>
<a name="Introduction"></a>
<h3>1. INTRODUCTION</h3>
<p>
This scope of the <em>Rupert</em> component is to provide a set of
useful tools to use in servlet-based web application development.
</p>
<p>
While the initial seeding of this project was from the members of
the Jakarta Velocity community, the intention is to provide
a set of tools useful for developers using other template engines
like WebMacro as well as JSPs.
</p>
<p>
The tools in <em>Rupert</em> should be kept as free of specific engine
dependecies to allow maximum usability.
</p>
<p>
We invite contributions from all.
</p>
<p>Note : the name 'rupert' is a temporary placeholder until the
community can decide on a real one :)
</p>
<a name="Dependencies"></a>
<buih3>2. DEPENDENCIES</h3>
<p>
To build <em>Rupert</em> you will need the Really Great Jakarta Ant build
tool, available <a href="http://jakarta.apache.org/ant/";>here</a>.
</p>
<p>The <em>Rupert</em> component is dependent upon the following external
components for development and use:</p>
<ul>
<li><a href="http://java.sun.com/j2se";>Java Development Kit</a>
(Version 1.2 or later)</li>
<li><a href="http://jakarta.apache.org/velocity/";>Jakarta Velocity</a></li>
<li><a href="http://www.jdom.org";>JDOM</a></li>
<li><a href="http://sourceforge.net/projects/werken-xpath/";>werken-xpath</a></li>
<li><a href="http://jakarta.apache.org/oro/";>Jakarta Oro</a></li>
</ul>
<p>
In addition, you need some rendition of the servlet API. For example,
<a href="http://jakarta.apache.org/builds/jakarta-tomcat/release/v3.2.2/bin/";>
Jakarta Servlet API</a>.
</p>
<a name="Release Info"></a>
<h3>3. RELEASE INFO</h3>
<p>Current Release: <strong>Unreleased, CVS Repository Only</strong></p>
<p>Planned Next Release: N/A</p>
<p>
Any release of this software depends upon acceptance by the Jakarta Commons
community as a 'regular' component.
</p>
<a name="Committers"></a>
<h3>4. COMMITTERS</h3>
<p>
The following individuals are the primary developers and maintainers of this
component. Developers who plan to use <em>Rupert</em> in their own
projects are encouraged to collaborate on the future development of this
component to ensure that it continues to meet a variety of needs.
</p>
<ul>
<li><a href="mailto:[EMAIL PROTECTED]";>Geir Magnusson Jr.</a></li>
<li><a href="mailto:[EMAIL PROTECTED]";>Christoph Reck</a></li>
<li><a href="mailto:[EMAIL PROTECTED]";>Nathan Bubna</a></li>
</ul>
</body>
</html>
1.1 jakarta-commons-sandbox/rupert/build.properties.sample
Index: build.properties.sample
===================================================================
# junit.jar - JUnit 3.2+ Classpath
junit.jar=/java/junit/junit.jar
1.1 jakarta-commons-sandbox/rupert/build.xml
Index: build.xml
===================================================================
<project name="Digester" default="jar" basedir=".">
<!--
"Digester" component of the Jakarta Commons Subproject
$Id: build.xml,v 1.1 2001/06/19 11:39:05 geirm Exp $
-->
<!-- ========== Initialize Properties ===================================== -->
<property file="build.properties"/> <!-- Component local -->
<property file="../build.properties"/> <!-- Commons local -->
<property file="${user.home}/build.properties"/> <!-- User local -->
<!-- ========== External Dependencies ===================================== -->
<!-- The directories corresponding to your necessary dependencies -->
<property name="velocity.home" value="lib"/>
<property name="jdom.home" value="lib"/>
<property name="werken-xpath.home" value="lib"/>
<property name="oro.home" value="lib"/>
<property name="servlet.home" value="lib"/>
<!-- ========== Derived Values ============================================ -->
<!-- The locations of necessary jar files -->
<property name="velocity.jar" value="${velocity.home}/velocity.jar"/>
<property name="jdom.jar" value="${jdom.home}/jdom.jar"/>
<property name="werken-xpath.jar"
value="${werken-xpath.home}/werken-xpath.jar"/>
<property name="oro.jar" value="${oro.home}/oro.jar"/>
<property name="servlet.jar" value="${servlet.home}/servlet.jar"/>
<!-- ========== Component Declarations ==================================== -->
<!-- The name of this component -->
<property name="component.name" value="rupert"/>
<!-- The title of this component -->
<property name="component.title" value="servlet-based webapp development
tools"/>
<!-- The current version number of this component -->
<property name="component.version" value="0.1-dev"/>
<!-- The base directory for compilation targets -->
<property name="build.home" value="target"/>
<!-- The base directory for component configuration files -->
<property name="conf.home" value="src/conf"/>
<!-- The base directory for distribution targets -->
<property name="dist.home" value="dist"/>
<!-- The base directory for component sources -->
<property name="source.home" value="src/java"/>
<!-- The base directory for unit test sources -->
<property name="test.home" value="src/test"/>
<!-- ========== Compiler Defaults ========================================= -->
<!-- Should Java compilations set the 'debug' compiler option? -->
<property name="compile.debug" value="true"/>
<!-- Should Java compilations set the 'deprecation' compiler option? -->
<property name="compile.deprecation" value="false"/>
<!-- Should Java compilations set the 'optimize' compiler option? -->
<property name="compile.optimize" value="true"/>
<!-- Construct compile classpath -->
<path id="compile.classpath">
<pathelement location="${build.home}/classes"/>
<pathelement location="${velocity.jar}"/>
<pathelement location="${jdom.jar}"/>
<pathelement location="${werken-xpath.jar}"/>
<pathelement location="${oro.jar}"/>
<pathelement location="${servlet.jar}"/>
</path>
<!-- ========== Executable Targets ======================================== -->
<target name="init"
description="Initialize and evaluate conditionals">
<echo message="-------- ${component.name} ${component.version} --------"/>
<filter token="name" value="${component.name}"/>
<filter token="version" value="${component.version}"/>
</target>
<target name="prepare" depends="init"
description="Prepare build directory">
<mkdir dir="${build.home}"/>
<mkdir dir="${build.home}/classes"/>
<mkdir dir="${build.home}/conf"/>
<mkdir dir="${build.home}/tests"/>
</target>
<target name="static" depends="prepare"
description="Copy static files to build directory">
<tstamp/>
<copy todir="${build.home}/conf" filtering="on">
<fileset dir="${conf.home}" includes="*.MF"/>
</copy>
</target>
<target name="compile" depends="static"
description="Compile shareable components">
<javac srcdir="${source.home}"
destdir="${build.home}/classes"
debug="${compile.debug}"
deprecation="${compile.deprecation}"
optimize="${compile.optimize}">
<classpath refid="compile.classpath"/>
</javac>
<copy todir="${build.home}/classes" filtering="on">
<fileset dir="${source.home}" excludes="**/*.java"/>
</copy>
</target>
<target name="jar" depends="compile"
description="Creates jar">
<jar jarfile="commons-${component.name}.jar"
basedir="${build.home}/classes"
manifest="${build.home}/conf/MANIFEST.MF"/>
</target>
<target name="clean"
description="Clean build and distribution directories">
<delete dir="${build.home}"/>
<delete dir="${dist.home}"/>
</target>
<target name="all" depends="clean,compile"
description="Clean and compile all components"/>
<target name="javadoc" depends="compile"
description="Create component Javadoc documentation">
<mkdir dir="${dist.home}"/>
<mkdir dir="${dist.home}/docs"/>
<mkdir dir="${dist.home}/docs/api"/>
<javadoc sourcepath="${source.home}"
destdir="${dist.home}/docs/api"
packagenames="org.apache.commons.*"
author="true"
private="true"
version="true"
doctitle="<h1>${component.title}</h1>"
windowtitle="${component.title} (Version ${component.version})"
bottom="Copyright (c) 2001 - Apache Software Foundation"/>
</target>
<target name="dist" depends="compile,javadoc"
description="Create binary distribution">
<mkdir dir="${dist.home}"/>
<copy file="../LICENSE"
todir="${dist.home}"/>
<jar jarfile="${dist.home}/commons-${component.name}.jar"
basedir="${build.home}/classes"
manifest="${build.home}/conf/MANIFEST.MF"/>
</target>
</project>
