avalon-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From mcconn...@apache.org
Subject cvs commit: avalon-components/cornerstone/site/xdocs/notes build.xml download.xml index.xml navigation.xml
Date Sun, 28 Mar 2004 08:13:03 GMT
mcconnell    2004/03/28 00:13:03

  Added:       cornerstone README.TXT maven.xml
               cornerstone/site .cvsignore maven.xml project.xml
               cornerstone/site/etc LICENSE.txt maven.css site.jsl
                        stylesheet.css tigris.css
               cornerstone/site/xdocs/components connection.xml
                        datasource.xml index.xml navigation.xml
                        scheduler.xml sockets.xml store.xml threads.xml
               cornerstone/site/xdocs/examples fortress.xml index.xml
                        navigation.xml phoenix.xml
               cornerstone/site/xdocs/examples/merlin index.xml
                        navigation.xml threads.xml
               cornerstone/site/xdocs index.xml navigation.xml
               cornerstone/site/xdocs/notes build.xml download.xml
                        index.xml navigation.xml
  Log:
  Move cornerstne docs under cornerstone directory.
  
  Revision  Changes    Path
  1.1                  avalon-components/cornerstone/README.TXT
  
  Index: README.TXT
  ===================================================================
  
  Avalon Components
  -----------------
  
  The components repository is based on the restructuring of the Cornerstone 
  project.  The restructuring incorporates the seperation of each component 
  into its own directory including isolation of of api relative to 
  implemetation.
  
  Components subprojects include:
  
     connection
     datasources
     scheduler
     sockets
     store
     threads
  
  The default target will build, jar and install the complete component 
  suite into your local maven repository.
  
    $ cd avalon-components/cornerstone
    $ maven
  
  Site documetation generated hy the avalon:site goal will be placed in 
  the avalon-components/cornerstone/target/docs directory.
  
  Each project can be build indepedendently using classic Maven 
  goals.  For example:
  
    $ cd avalon-components/cornerstone/threads/api
    $ maven jar:install
  
  For more information please consult the project documentation
  included under the avalon-components/cornerstone/site directory.
  
  
  1.1                  avalon-components/cornerstone/maven.xml
  
  Index: maven.xml
  ===================================================================
  <project default="build" xmlns:maven="jelly:maven" xmlns:j="jelly:core" xmlns:util="jelly:util">
    <property file="${basedir}/project.properties"/>
    <property file="${basedir}/../project.properties"/>
  
    <goal name="avalon:build">
      <attainGoal name="avalon:install"/>
    </goal>
  
    <goal name="avalon:install"
      description="Install the sub-project jars." >
      <maven:reactor
        basedir="${basedir}"
        includes="**/project.xml"
        excludes="project.xml,site/*"
        goals="jar:install"
        banner="Installing:"
        ignoreFailures="false" />
    </goal>
  
    <goal name="avalon:site"
      description="Build the project site." >
      <maven:reactor
        basedir="${basedir}"
        includes="project.xml,site/project.xml"
        goals="site"
        banner="Building site:"
        ignoreFailures="false" />
    </goal>
  
    <goal name="avalon:clean"
      description="Clean up build artifacts" >
      <maven:reactor
        basedir="${basedir}"
        includes="**/project.xml"
        excludes="project.xml,site/*"
        goals="clean"
        banner="Cleaning:"
        ignoreFailures="false" />
      <attainGoal name="clean"/>
    </goal>
  
    <goal name="avalon:dist"
        description="Build binary distributions" >
        <maven:reactor
          basedir="${basedir}"
          includes="**/project.xml"
          excludes="project.xml,site/*"
          goals="dist"
          banner="Building distribution:"
          ignoreFailures="false" />
    </goal>
  
  </project>
  
  
  
  1.1                  avalon-components/cornerstone/site/.cvsignore
  
  Index: .cvsignore
  ===================================================================
  maven.log
  velocity.log
  build.properties
  target
  maven.log
  
  
  1.1                  avalon-components/cornerstone/site/maven.xml
  
  Index: maven.xml
  ===================================================================
  <project default="site" xmlns:maven="jelly:maven" xmlns:j="jelly:core" xmlns:util="jelly:util"   xmlns:ant="jelly:ant">
  
    <preGoal name="site">
      <attainGoal name="xavalon:css-copy"/>
      <attainGoal name="license"/>
      <attainGoal name="xjavadoc"/>
    </preGoal>
  
    <goal name="xavalon:css-copy">
      <ant:mkdir dir="${maven.build.dir}/docs/style"/>
      <ant:copy toDir="${maven.build.dir}/docs/style">
        <fileset dir="${basedir}/src/etc">
          <include name="maven.css"/>
          <include name="tigris.css"/>
        </fileset>
      </ant:copy>
    </goal>
  
    <goal name="xjavadoc">
      <mkdir dir="${basedir}/target/docs/api" />
      <property name="copyright"
        value="Copyright &amp;copy; ${year} ${pom.organization.name}. All Rights Reserved." />
      <property name="title" value="${pom.name} ${pom.currentVersion} API"/>
      <javadoc destdir="${basedir}/target/docs/api" 
  	doctitle="&lt;h1&gt;Cornerstone API&lt;/h1&gt;" 
        noindex="false" author="true" use="true"
  	windowtitle="${title}" 
        bottom="${copyright}"
        additionalparam="-breakiterator -J-Xmx128m "
        packagenames="*,org.*">
          <j:forEach var="packageGroup" items="${pom.packageGroups}">
        	  <group title="${packageGroup.title}" packages="${packageGroup.packages}"/>
          </j:forEach>
          <sourcepath path="${basedir}/../threads-api/src/java"/>
          <sourcepath path="${basedir}/../threads-impl/src/java"/>
          <sourcepath path="${basedir}/../connection-api/src/java"/>
          <sourcepath path="${basedir}/../connection-impl/src/java"/>
          <sourcepath path="${basedir}/../datasources-api/src/java"/>
          <sourcepath path="${basedir}/../datasources-impl/src/java"/>
          <sourcepath path="${basedir}/../sockets-api/src/java"/>
          <sourcepath path="${basedir}/../sockets-impl/src/java"/>
          <sourcepath path="${basedir}/../store-api/src/java"/>
          <sourcepath path="${basedir}/../store-impl/src/java"/>
          <classpath>
            <path refid="maven.dependency.classpath"/>
  	  </classpath>
  	  <link href="${sun.j2se.link}" />
  	  <link href="${avalon.logkit.link}" />
  	  <link href="${avalon.framework.link}" />
  	  <link href="${excalibur.thread.link}" />
  	  <link href="${excalibur.event.link}" />
      </javadoc>
    </goal>
  
  </project>
  
  
  
  1.1                  avalon-components/cornerstone/site/project.xml
  
  Index: project.xml
  ===================================================================
  <?xml version="1.0" encoding="ISO-8859-1"?>
  
  <project>
  
    <extend>${basedir}/../project.xml</extend>
  
    <groupId>cornerstone</groupId>
    <id>cornerstone</id>
    <name>Avalon Components Suite</name>
    <package>org.apache.avalon.cornerstone</package>
  
    <inceptionYear>2001</inceptionYear>
    <shortDescription>Avalon Components Site</shortDescription>
  
    <dependencies>
  
      <!-- framework dependencies -->
  
      <dependency>
        <groupId>avalon-framework</groupId>
        <artifactId>avalon-framework-api</artifactId>
        <version>4.1.5</version>
      </dependency>
      <dependency>
        <groupId>avalon-framework</groupId>
        <artifactId>avalon-framework-impl</artifactId>
        <version>4.1.5</version>
      </dependency>
  
      <!-- excalibur dependencies -->
  
      <dependency>
        <groupId>excalibur-thread</groupId>
        <artifactId>excalibur-thread-api</artifactId>
        <version>SNAPSHOT</version>
      </dependency>
      <dependency>
        <groupId>excalibur-thread</groupId>
        <artifactId>excalibur-thread-impl</artifactId>
        <version>SNAPSHOT</version>
      </dependency>
  
      <dependency>
        <groupId>excalibur-pool</groupId>
        <artifactId>excalibur-pool-api</artifactId>
        <version>SNAPSHOT</version>
      </dependency>
      <dependency>
        <groupId>excalibur-pool</groupId>
        <artifactId>excalibur-pool-impl</artifactId>
        <version>SNAPSHOT</version>
      </dependency>
      <dependency>
        <groupId>excalibur-datasource</groupId>
        <artifactId>excalibur-datasource</artifactId>
        <version>1.1.1</version>
      </dependency>
  
      <!-- local dependencies -->
  
      <dependency>
        <groupId>cornerstone-threads</groupId>
        <artifactId>cornerstone-threads-api</artifactId>
        <version>SNAPSHOT</version>
      </dependency>
      <dependency>
        <groupId>cornerstone-threads</groupId>
        <artifactId>cornerstone-threads-impl</artifactId>
        <version>SNAPSHOT</version>
      </dependency>
  
      <dependency>
        <groupId>cornerstone-connection</groupId>
        <artifactId>cornerstone-connection-api</artifactId>
        <version>SNAPSHOT</version>
      </dependency>
      <dependency>
        <groupId>cornerstone-connection</groupId>
        <artifactId>cornerstone-connection-impl</artifactId>
        <version>SNAPSHOT</version>
      </dependency>
  
      <dependency>
        <groupId>cornerstone-datasources</groupId>
        <artifactId>cornerstone-datasources-api</artifactId>
        <version>1.0</version>
      </dependency>
      <dependency>
        <groupId>cornerstone-datasources</groupId>
        <artifactId>cornerstone-datasources-impl</artifactId>
        <version>SNAPSHOT</version>
      </dependency>
  
      <dependency>
        <groupId>cornerstone-scheduler</groupId>
        <artifactId>cornerstone-scheduler-api</artifactId>
        <version>1.0</version>
      </dependency>
      <dependency>
        <groupId>cornerstone-scheduler</groupId>
        <artifactId>cornerstone-scheduler-impl</artifactId>
        <version>SNAPSHOT</version>
      </dependency>
  
      <dependency>
        <groupId>cornerstone-sockets</groupId>
        <artifactId>cornerstone-sockets-api</artifactId>
        <version>1.0</version>
      </dependency>
      <dependency>
        <groupId>cornerstone-sockets</groupId>
        <artifactId>cornerstone-sockets-impl</artifactId>
        <version>SNAPSHOT</version>
      </dependency>
  
      <dependency>
        <groupId>cornerstone-store</groupId>
        <artifactId>cornerstone-store-api</artifactId>
        <version>1.0</version>
      </dependency>
      <dependency>
        <groupId>cornerstone-store</groupId>
        <artifactId>cornerstone-store-impl</artifactId>
        <version>1.1</version>
      </dependency>
  
    </dependencies>
  
    <reports>
      <report>maven-changelog-plugin</report>
      <report>maven-file-activity-plugin</report>
      <report>maven-developer-activity-plugin</report>
    </reports>
  
  </project>
  
  
  
  1.1                  avalon-components/cornerstone/site/etc/LICENSE.txt
  
  Index: LICENSE.txt
  ===================================================================
  /*
  
   ============================================================================
                     The Apache Software License, Version 1.1
   ============================================================================
   
   Copyright (C) 1999-2003 The Apache Software Foundation. All rights reserved.
   
   Redistribution and use in source and binary forms, with or without modifica-
   tion, are permitted provided that the following conditions are met:
   
   1. Redistributions of  source code must  retain the above copyright  notice,
      this list of conditions and the following disclaimer.
   
   2. Redistributions in binary form must reproduce the above copyright notice,
      this list of conditions and the following disclaimer in the documentation
      and/or other materials provided with the distribution.
   
   3. The end-user documentation included with the redistribution, if any, must
      include  the following  acknowledgment:  "This product includes  software
      developed  by the  Apache Software Foundation  (http://www.apache.org/)."
      Alternately, this  acknowledgment may  appear in the software itself,  if
      and wherever such third-party acknowledgments normally appear.
   
   4. The names "Jakarta", "Apache Avalon", "Avalon Components", "Avalon
      Framework" and "Apache Software Foundation"  must not be used to endorse
      or promote products derived  from this  software without  prior written
      permission. For written permission, please contact apache@apache.org.
   
   5. Products  derived from this software may not  be called "Apache", nor may
      "Apache" appear  in their name,  without prior written permission  of the
      Apache Software Foundation.
   
   THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
   INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
   FITNESS  FOR A PARTICULAR  PURPOSE ARE  DISCLAIMED.  IN NO  EVENT SHALL  THE
   APACHE SOFTWARE  FOUNDATION  OR ITS CONTRIBUTORS  BE LIABLE FOR  ANY DIRECT,
   INDIRECT, INCIDENTAL, SPECIAL,  EXEMPLARY, OR CONSEQUENTIAL  DAMAGES (INCLU-
   DING, BUT NOT LIMITED TO, PROCUREMENT  OF SUBSTITUTE GOODS OR SERVICES; LOSS
   OF USE, DATA, OR  PROFITS; OR BUSINESS  INTERRUPTION)  HOWEVER CAUSED AND ON
   ANY  THEORY OF LIABILITY,  WHETHER  IN CONTRACT,  STRICT LIABILITY,  OR TORT
   (INCLUDING  NEGLIGENCE OR  OTHERWISE) ARISING IN  ANY WAY OUT OF THE  USE OF
   THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
   
   This software  consists of voluntary contributions made  by many individuals
   on  behalf of the Apache Software  Foundation. For more  information on the 
   Apache Software Foundation, please see <http://www.apache.org/>.
   
  */
  
  
  
  1.1                  avalon-components/cornerstone/site/etc/maven.css
  
  Index: maven.css
  ===================================================================
  body {
   background: #fff;
   color: #000;
   }
  
  .app h3 {
   color: #fff;
   background-color: #036;
   }
  
  .app h4 {
   color: #fff;
   background-color: #888;
   }
  
  .a td { 
   background: #ddd;
   color: #000;
   }
  
  .b td { 
   background: #efefef;
   color: #000;
   }
  
  .app th {
   background-color: #bbb;
   color: #fff;
   }
  
  div#banner {
   border-top: 1px solid #369;
   border-bottom: 1px solid #003;
   }
  
  #banner, #banner td { 
   background: #fff;
   color: #000;
   }
  
  #leftcol {
   background: #eee;
   color: #000;
   border-right: 1px solid #aaa;
   border-bottom: 1px solid #aaa;
   border-top: 1px solid #fff;
  }
  
  #navcolumn {
   background: #eee;
   color: #000;
   border-right: none;
   border-bottom: none;
   border-top: none;
   }
  
  #breadcrumbs {
   background-color: #ddd;
   color: #000;
   border-top: 1px solid #fff;
   border-bottom: 1px solid #aaa;
   }
  
  #source {
   background-color: #fff;
   color: #000;
   border-right: 1px solid #888; 
   border-left: 1px solid #888; 
   border-top: 1px solid #888; 
   border-bottom: 1px solid #888; 
   margin-right: 7px;
   margin-left: 7px;
   margin-top: 1em;
   }
  
  #source pre {
   margin-right: 7px;
   margin-left: 7px;
   }
  
  a[name]:hover, #leftcol a[name]:hover {
   color: inherit !important;
   }
  
  a:link, #breadcrumbs a:visited, #navcolumn a:visited, .app a:visited, .tasknav a:visited {
   color: blue;
   }
  
  a:active, a:hover, #leftcol a:active, #leftcol a:hover {
   color: #f30 !important;
   }
  
  a:link.selfref, a:visited.selfref {
   color: #555 !important;
   }
  
  h3, h4 {
   margin-top: 1em;
   margin-bottom: 0;
   }
  
  
  
  1.1                  avalon-components/cornerstone/site/etc/site.jsl
  
  Index: site.jsl
  ===================================================================
  <?xml version="1.0"?>
  <!-- stylesheet to be used -->
  <jsl:stylesheet select="$doc"
    xmlns:define="jelly:define"
    xmlns:j="jelly:core"
    xmlns:jsl="jelly:jsl"
    xmlns:log="jelly:log"
    xmlns:util="jelly:util"
    xmlns:x="jelly:xml"
    xmlns:doc="doc"
    xmlns="dummy" trim="false">
    <jsl:template match="document" trim="false">
      <j:useBean var="navbean" class="org.apache.maven.NavBean"/>
  	<j:set var="location" value="${outFile.substring(destdir.length())}"/>
  	<util:replace var="location" oldChar="\" newChar="/" value="${location}"/>
  
      <!-- Stores location for publish date / version -->
      <j:set var="date">${maven.xdoc.date}</j:set>
        
  	<j:setProperties 
  		object="${navbean}"
    		document="${doc}"
    		location="${location}"/>
  	
  	<x:doctype name="html"
        publicId="-//W3C//DTD XHTML 1.0 Transitional//EN"
        systemId="http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"/>
  
      <html>
        <head>
          <j:set var="docTitle">
            <x:expr select="./properties/title"/>
          </j:set>
          <x:if select="$nav/title">
            <title>
              <x:expr select="$nav/title"/> - ${docTitle}
            </title>
          </x:if>
          <x:if select="not($nav/title)">
            <title>${pom.name} - ${docTitle}</title>
          </x:if>
          
          <style type="text/css"><![CDATA[
            @import url("${relativePath}/style/tigris.css");
            @import url("${relativePath}/style/maven.css");
          ]]></style>
          
          <util:file var="projectCssFile" name="${maven.docs.src}/style/project.css"/>
          <j:if test="${projectCssFile.exists()}">
            <style type="text/css"><![CDATA[
              @import url("${relativePath}/style/project.css");
            ]]></style>
          </j:if>
          
          <!-- FIXME: once someone works out how to stop this breaking
          <x:element name="script"><x:attribute name="type">text/javascript</x:attribute>
            if (document.layers) {
                  document.writeln(''+
                  '<link rel="stylesheet" type="text/css" href="${relativePath}/style/ns4_only.css" media="screen" /><link rel="stylesheet" type="text/css" href="${relativePath}/style/maven_ns4_only.css" media="screen"/>');
                }
              </x:element>
          -->
          <link rel="stylesheet" type="text/css" href="${relativePath}/style/print.css" media="print"/>
          <meta http-equiv="Content-Type" content="text/html; charset=${outputencoding}"></meta>
          <x:forEach var="author" select="./properties/author">
            <meta name="author" content="${author.text}"/>
            <meta name="email" content="${author.attribute('email').value}"/>
          </x:forEach>
          
          <jsl:applyTemplates select="$doc/document/head/*"/>
          
        </head>
  
        <x:element name="body"><j:whitespace trim="true">
          <x:attribute name="class">composite</x:attribute>
          <x:forEach var="attr" select="$doc/document/body/@*">
            <x:attribute name="${attr.name}">${attr.value}</x:attribute>
          </x:forEach>
          </j:whitespace>
  
          <div id="banner">
            <table border="0" cellspacing="0" cellpadding="8" width="100%" height="103">
              <tr>
                <!-- organization logo -->
                <td>
                  <j:set var="logo" value="${pom.organization.logo}"/>
                  <j:if test="${!empty(logo)}">
                    <!-- set url to org or project url -->
                    <j:set var="url" value="${pom.organization.url}"/>
                    <j:if test="${!empty(url)}">
                      <j:set var="home" value="${pom.organization.url}"/>
                    </j:if>
                    <j:if test="${empty(url)}">
                      <j:set var="home" value="${pom.url}"/>
                    </j:if>
                    <!-- set image to relative or complete -->
                    <j:set var="image" value="${pom.organization.logo}"/>
                    <j:if test="${!image.startsWith('http://')}">
                      <j:set var="image" value="${relativePath}${image}"/>
                    </j:if>
                    <a href="${home}">
                      <img src="${image}" align="left" alt="${pom.organization.name}" border="0"/>
                    </a>
                  </j:if>
                </td>
  
                <!-- project logo and link -->
  
                <td>
                  <div align="right" id="login">
                    <a href='http://apachecon.com/2003/US/index.html'>
                      <img border='0' 
                        src='http://www.apache.org/~ceki/ac2003/ac2003-150.gif'/>
                    </a>
                  </div>
                </td>
  
                <!--
                <td>
                  <div align="right" id="login">
                    <j:set var="logo" value="${pom.logo}"/>
                    <j:if test="${logo != null and logo != ''}">
                      <j:set var="image" value="${pom.logo}"/>
                      <j:if test="${!image.startsWith('http://')}">
                        <j:set var="image" value="${relativePath}${image}"/>
                      </j:if>
                      <a href="${pom.url}">
                        <img src="${image}" align="right" alt="${pom.name}" border="0"/>
                      </a>
                    </j:if>
                  </div>
                </td>
                -->
              </tr>
            </table>
          </div>
          <div id="breadcrumbs">
            <table border="0" cellspacing="0" cellpadding="4" width="100%">
              <tr>
                <j:if test="${date == 'left'}">
                  <j:set var="version" value="${maven.xdoc.version}"/>
                  <td>Last published: ${build.date}
                    <j:if test="${!empty(version)}">| Doc for ${version}</j:if>
                  </td>
                </j:if>
                <td>
                  <div align="right">
                    <j:if test="${date == 'right'}">
                      Last published: ${build.date}
                      <x:if select="$nav/body/links">|</x:if>
                    </j:if>
                    <!-- render links -->
                    <x:if select="$nav/body/links">
                      <jsl:applyTemplates select="$nav/body/links"/>
                    </x:if>
                    <x:if select="not($nav/body/links)">
                      <!-- FIXME &nbsp; -->
                    </x:if>
                  </div>
                </td>
              </tr>
            </table>
          </div>
          <!-- Body of the page -->
          <table border="0" cellspacing="0" cellpadding="8" width="100%"> <!--id="main" -->
            <tr valign="top">
              <td id="leftcol" width="20%">
                <div id="navcolumn">
                  <j:if test="${date == 'navigation-top'}">
                    <div>
                      <small>Last published: ${build.date}</small>
                    </div>
                  </j:if>
  
                  <x:if select="$nav">
                    <jsl:applyTemplates select="$nav/body/menu[not(@type) | @type='header'] | $nav/body/search"/>
                  </x:if>
                  
                  <!-- Standard Maven Navigation -->
                  <j:set var="fileName">${file}</j:set>
  
                  <!-- 
                   ! Check to see if the user wishes to include the
                   ! maven-generated docs on their site.
                   !-->
                  <j:if test="${includeProjectDocumentation.equals('yes')}">
                  <div>
                    <strong>Project Documentation</strong>
                    <div>
                      <small>
                        <a href="${relativePath}/index.html">About ${pom.name}</a>
                      </small>
                    </div>
                    <div>
                      <small>
                        <a href="${relativePath}/project-info.html">Project Info</a>
                      </small>
                      <util:tokenize var="projectInfoFiles" delim=",">${maven.xdoc.projectInfo}</util:tokenize>
                      <j:forEach var="infoFile" items="${projectInfoFiles}">
                        <j:if test="${relativePath == '.' and fileName.endsWith(infoFile)}">
                          <div>
                            <small>
                              <a href="${relativePath}/mail-lists.html">Mailing Lists</a>
                            </small>
                          </div>
                          <div>
                            <small>
                              <a href="${relativePath}/team-list.html">Project Team</a>
                            </small>
                          </div>
                          <div>
                            <small>
                              <a href="${relativePath}/dependencies.html">Dependencies</a>
                            </small>
                          </div>
                          <j:if test="${!empty(pom.repository.url)}">
                            <div>
                              <small>
                                <a href="${relativePath}/cvs-usage.html">Source Repository</a>
                              </small>
                            </div>
                          </j:if>
                          <j:if test="${!empty(pom.issueTrackingUrl)}">
                            <div>
                              <small>
                                <a href="${relativePath}/issue-tracking.html">Issue Tracking</a>
                              </small>
                            </div>
                          </j:if>
                        </j:if>
                      </j:forEach>
                    </div>
                    <div>
                      <small>
                        <a href="${relativePath}/maven-reports.html">Project Reports</a>
                      </small>
                      
  					<!--
                       | Check to see if we need to include the report
                       | links in this document.  The only time we
                       | need to do this is when the current document
                       | either the maven-reports.xml doc (the page
                       | is displayed when clicking on Project
                       | Reports) or when the current document is one
                       | of the actual reports (in which case we want
                       | to leave the project report links expanded.
                       |-->
                      <j:set var="includeReportLinks" value="false"/>
                      <j:forEach var="report" items="${reports}">
                        <j:set var="linkWithXmlExt" value="${report.link}.xml"/>
                        <j:if test="${relativePath == '.' and (fileName.endsWith('maven-reports.xml') or fileName.endsWith(linkWithXmlExt))}">
                        <j:set var="includeReportLinks" value="true"/>
                        </j:if>
                      </j:forEach>
                      
                      <!--
                       | If we need to include the report links, then
                       | do so.  This is determined by the above
                       | block.
                       |-->
                      <j:if test="${includeReportLinks == 'true'}">
                        <j:forEach var="report" items="${reports}">
                          <div>
                            <small>
                              <a href="${relativePath}/${report.link}.html">
                                ${report.name}
                              </a>
                            </small>
                          </div>
                        </j:forEach>
                      </j:if>
                    </div>
                    <j:if test="${pom.reports.isEmpty()}">
                      <j:if test="${sourcesPresent}">
                        <div>
                          <small>
                            <a href="${relativePath}/apidocs/index.html">JavaDocs</a>
                          </small>
                        </div>
                        <div>
                          <small>
                            <a href="${relativePath}/xref/index.html">Source XReference</a>
                          </small>
                        </div>
                        <j:if test="${unitTestSourcesPresent == 'true'}">
                          <div>
                            <small>
                              <a href="${relativePath}/xref-test/index.html">Test XReference</a>
                            </small>
                          </div>
                        </j:if>
                      </j:if>
                    </j:if>
                    <j:set var="devProcess" value="false"/>
                    <util:available file="${maven.docs.src}/development-process.xml">
                      <j:set var="devProcess" value="true"/>
                    </util:available>
                    <j:if test="${devProcess}">
                      <div>
                        <small>
                          <a href="${relativePath}/development-process.html">Development Process</a>
                        </small>
                      </div>
                    </j:if>
                    <j:if test="${!devProcess}">
                      <div>
                        <small>
                          <j:set var="devProcess">${maven.xdoc.developmentProcessUrl}</j:set>
                          <a href="${devProcess}">Development Process</a>
                        </small>
                      </div>
                    </j:if>
                  </div>
                </j:if>
                
                  <j:set var="poweredbyimage">${maven.xdoc.poweredby.image}</j:set>
                  <j:set var="poweredbytitle">${maven.xdoc.poweredby.title}</j:set>
                  <j:set var="poweredbyurl">${maven.xdoc.poweredby.url}</j:set>
                  <j:if test="${!empty(poweredbyimage)}">
                  	<div style="margin-top: 20px; width: 100%; text-align: center;">
                  		<a href="${poweredbyurl}" title="${poweredbytitle}"><img alt="${maven.xdoc.poweredby.title}" style="border: 1px solid black" src="${relativePath}/images/logos/${poweredbyimage}"/></a>
                  	</div>
                  </j:if>
                
                  <j:if test="${date == 'navigation-bottom'}">
                    <div>
                      <small>Last published: ${build.date}</small>
                    </div>
                  </j:if>
                </div>
              </td>
              <td rowspan="2">
                <div id="bodycol">
                  <!-- Insert MAIN body here -->
                  <div class="app">
                    <!-- FIXME really shouldn't use $doc, but jelly loses it's context again -->
                    <jsl:applyTemplates select="$doc/document/body/section"/>
                    <jsl:applyTemplates select="$doc/document/body/glossary" />
                    <jsl:applyTemplates select="$doc/document/body/release" />
                    <jsl:applyTemplates select="$doc/document/body/changelog" />
                    <jsl:applyTemplates select="$doc/document/body/taskList" />
                    <jsl:applyTemplates select="$doc/document/body/goals" />
                  </div>
                </div>
              </td>
            </tr>
          </table>
          <div id="footer">
            <table style='width:100%' border="0" cellspacing="0" cellpadding="4">
              <jsl:applyTemplates select="$nav/body/footer"/>
              <tr>
                <td>
                  <j:if test="${!empty(pom.organization.name)}">
                    <j:if test="${!empty(pom.inceptionYear)}">
                      <j:if test="${pom.inceptionYear == mavenCurrentYear}">
                        &#169; ${mavenCurrentYear}, ${pom.organization.name}
                      </j:if>
                      <j:if test="${pom.inceptionYear != mavenCurrentYear}">
                        &#169; ${pom.inceptionYear}-${mavenCurrentYear}, ${pom.organization.name}
                      </j:if>
                    </j:if>
                    <j:if test="${empty(pom.inceptionYear)}">
                      &#169; ${mavenCurrentYear}, ${pom.organization.name}
                    </j:if>
                  </j:if>
  
                  <j:if test="${date == 'bottom'}">
                    - Last published: ${build.date}
                  </j:if>
                </td>
                <j:if test="${date == 'bottom-right'}">
                  <td style='width: auto; text-align:right'>Last published: ${build.date}</td>
                </j:if>
              </tr>
            </table>
          </div>
        </x:element>
      </html>
    </jsl:template>
  
    <!-- process the properties of the doc -->
    <jsl:template match="properties" trim="false">
      <!-- stick head block here later -->
    </jsl:template>
  
    <!-- Process a menu for the navigation bar -->
    <jsl:template match="menu" trim="false">
      <div>
        <strong><x:expr select="@name"/></strong>
        <jsl:applyTemplates select="item"/>
      </div>
    </jsl:template>
  
    <jsl:template match="item" trim="false">
      <x:set var="item" select="."/>
      <x:set var="_name" select="string(@name)"/>
      <x:set var="_link" select="string(@href)"/>
      <x:set var="_img" select="string(@img)"/>
  
      <div>
        <small>
        	<j:if test="${navbean.isSelected(item.get(0))}">
        		<b><doc:itemLink name="${_name}" link="${_link}" img="${_img}"/></b>
        	</j:if>
        	<j:if test="${!navbean.isSelected(item.get(0))}">
        		<doc:itemLink name="${_name}" link="${_link}" img="${_img}"/>
        	</j:if>
        </small>
  	  <j:if test="${!navbean.isCollapsed(item.get(0))}">
          <jsl:applyTemplates select="item"/>
        </j:if>
      </div>
    </jsl:template>
  
    <!-- Process the breadcrumb navbar -->
    <jsl:template match="links" trim="false">
      <j:set var="linkCount" value="1"/>
      <x:forEach var="link" select="item">
        <j:if test="${linkCount != 1}">|</j:if>
        <j:set var="_name"><x:expr select="@name"/></j:set>
        <j:set var="_link"><x:expr select="@href"/></j:set>
        <doc:itemLink name="${_name}" link="${_link}"/>
        <j:set var="linkCount" value="${1+linkCount}"/>
      </x:forEach>
    </jsl:template>
  
    <!-- Google site search -->
    <jsl:template match="search" trim="false">
      <!-- Search code: http://www.google.com/searchcode.html -->
      <!-- Google logos: http://www.google.com/stickers.html -->
      <!-- Terms: http://www.google.com./services/terms_free.html -->
      <div>
        <strong>Search ${pom.name}</strong>
        <form method="get" action="http://www.google.com/search">
          <a class="navlink" href="http://www.google.com">
            <img src="http://www.google.com/logos/Logo_25wht.gif" 
                 alt="Google" border="0" />
          </a><p/>
          <j:set var="siteURL" value="${pom.url}"/>
          <!-- google fails on urls that end with / -->
          <j:if test="${siteURL.endsWith('/')}">
            <j:set var="URLLength" value="${siteURL.length() - 1}"/>
            <j:set var="siteURL" value="${siteURL.substring(0, URLLength.intValue())}"/>
          </j:if>
          <input type="text" size="15" name="q" maxlength="255" value=""/>
          <input type="submit" value="Go" name="btnG"/>
          <input type="hidden" name="domains" value="${siteURL}"/>
          <input type="hidden" id="search" name="sitesearch" value="${siteURL}"/>
        </form>
      </div>
    </jsl:template>
  
    <!-- process a documentation section -->
    <jsl:template match="section" trim="false">
      <div class="h3">
        <j:set var="_sectionName"><x:expr select="@name"/></j:set>
        <j:if test="${!empty(_sectionName)}">
          <h3>
            <a name="${_sectionName}">${_sectionName}</a>
          </h3>
        </j:if>
        <jsl:applyTemplates select="*"/>
      </div>
    </jsl:template>
  
    <jsl:template match="subsection" trim="false">
      <div class="h4">
        <j:set var="_sectionName"><x:expr select="@name"/></j:set>
        <j:if test="${!empty(_sectionName)}">
          <h4>
            <a name="${_sectionName}">${_sectionName}</a>
          </h4>
        </j:if>
        <jsl:applyTemplates select="*"/>
      </div>
    </jsl:template>
  
    <jsl:template match="source" trim="false">
      <div id="source">
        <pre><x:expr select="."/></pre>
      </div>
    </jsl:template>
  
    <jsl:template match="footer" trim="false">
      <tr>
        <td>
          <jsl:applyTemplates select="*"/>
        </td>
      </tr>
    </jsl:template>
  
    <jsl:template match="table" trim="false">
      <j:set var="rowcount" value="0"/>
      <table cellpadding="3" cellspacing="2" border="1" width="100%">
        <jsl:applyTemplates select="*"/>
      </table>
    </jsl:template>
  
    <jsl:template match="tr" trim="false">
      <j:choose>
        <j:when test="${rowMode == 'a'}">
          <j:set var="rowMode" value="b"/>
        </j:when>
        <j:otherwise>
          <j:set var="rowMode" value="a"/>
        </j:otherwise>
      </j:choose>
  
      <!-- copy attributes FIXME: Shouldn't this only be colspan|rowspan? -->
      <x:element name="tr"><j:whitespace trim="true">
        <x:attribute name="class">${rowMode}</x:attribute>
        <x:forEach var="attr" select="@*">
          <x:attribute name="${attr.name}">${attr.value}</x:attribute>
        </x:forEach>
        <jsl:applyTemplates select="*"/>
  </j:whitespace></x:element>
    </jsl:template>
  
    <!--************************-->
    <!-- glossary documentation -->
    <!--************************-->
    <jsl:template match="glossary" trim="false">
      <jsl:applyTemplates select="glossary-entries/glossary-entry" />
    </jsl:template>
        
    <jsl:template match="glossary-entry" trim="false">
      <strong><x:expr select="name" /></strong>
      <br/>
      <x:expr select="definition" />
      <p/>
    </jsl:template>
  
        <!--************************-->
        <!-- goals documentation    -->
        <!--************************-->
        <jsl:template match="goals" trim="false">
          <!-- reset row alternation -->
          <j:set var="rowMode" value="" />
          <div class="h3">
            <h3><a name="Goals">Goals</a></h3>
            <table>
              <tr width='100%'><th>Goal</th><th>Description</th></tr>
              <jsl:applyTemplates select="goal"/>
            </table>
          </div>
        </jsl:template>
        
        <!-- a goal -->
          <!-- FIXME: this is copied from tr - there must be a way of
               calling templates in jsl? -->
        <jsl:template match="goal" trim="false">
          <j:choose>
            <j:when test="${rowMode == 'a'}">
              <j:set var="rowMode" value="b"/>
            </j:when>
            <j:otherwise>
              <j:set var="rowMode" value="a"/>
            </j:otherwise>
          </j:choose>
          
          <x:element name="tr"><j:whitespace trim="true">
            <x:attribute name="class">${rowMode}</x:attribute>
            <j:set var="_goalName"><x:expr select="./name" /></j:set>
            <td width='20%'><a name="${_goalName}">${_goalName}</a></td>
            <td width='80%'><jsl:applyTemplates select="description" /></td>
  </j:whitespace></x:element>
        </jsl:template>   
        
        <jsl:template match="description">
          <jsl:copy trim="false">
            <jsl:applyTemplates trim="false"/>
          </jsl:copy>
        </jsl:template>
  
        <!--************************-->
        <!-- changelog documentation-->
        <!--************************-->
        <jsl:template match="changelog" trim="false">
          <j:set var="rowMode" value="" />
          <table width="100%">
            <tr>
              <th>Date</th><th>Author</th><th>Files/Message</th>
            </tr>
            <jsl:applyTemplates select="changelog-entry" />
          </table>
        </jsl:template>
  
        <!-- transform a changelog entry -->
        <!-- FIXME: tr code copied from above -->
        <jsl:template match="changelog-entry" trim="false">
          <j:choose>
            <j:when test="${rowMode == 'a'}">
              <j:set var="rowMode" value="b"/>
            </j:when>
            <j:otherwise>
              <j:set var="rowMode" value="a"/>
            </j:otherwise>
          </j:choose>
          
          <x:element name="tr"><j:whitespace trim="true">
            <x:attribute name="class">${rowMode}</x:attribute>
            
            <td><x:expr select="date" /> <x:expr select="time" /></td>
            <td><x:expr select="author"/></td>
            <td><jsl:applyTemplates select="*" />
              <pre><x:expr select="msg"/></pre>
            </td>
  </j:whitespace></x:element>
        </jsl:template>
  
        <jsl:template match="file">
          <j:set var="url">${pom.repository.url}<x:expr select="name"/></j:set>
          <j:set var="revUrl">${url}?<x:expr select="revision"/>&amp;content-type=text/vnd.viewcvs-markup</j:set>
          <a href="${url}"><x:expr select="name"/></a> - 
          <a href="${revUrl}">v<x:expr select="revision"/></a>
          <br/>
        </jsl:template>
  
    <!-- remove the space at the end of parsed "a" anchors -->
    <jsl:template match="a" trim="false">
      <jsl:copy trim="true">
        <jsl:applyTemplates trim="true"/>
      </jsl:copy>
    </jsl:template>
  
    <!-- copy any other elements through -->
    <jsl:template match="*" trim="false">
      <jsl:copy trim="false">
        <jsl:applyTemplates trim="false"/>
      </jsl:copy>
     </jsl:template>
  
     <!-- element values don't pass through as text -->
     <jsl:template match="@*"/>
  
  </jsl:stylesheet>
  
  
  
  1.1                  avalon-components/cornerstone/site/etc/stylesheet.css
  
  Index: stylesheet.css
  ===================================================================
  /* Javadoc style sheet */
  
  /* Define colors, fonts and other style attributes here to override the defaults */
  
  /* Page background color */
  body { background-color: #FFFFFF }
  
  /* Table colors */
  .TableHeadingColor     { background: #CCCCFF } /* Dark mauve */
  .TableSubHeadingColor  { background: #EEEEFF } /* Light mauve */
  .TableRowColor         { background: #FFFFFF } /* White */
  
  /* Font used in left-hand frame lists */
  .FrameTitleFont   { font-size: 10pts; font-family: Helvetica, Arial, san-serif }
  .FrameHeadingFont { font-size: 10pts; font-family: Helvetica, Arial, san-serif }
  .FrameItemFont    { font-size: 10pts; font-family: Helvetica, Arial, san-serif }
  
  /* Example of smaller, sans-serif font in frames */
  /* .FrameItemFont  { font-size: 10pt; font-family: Helvetica, Arial, sans-serif } */
  
  /* Navigation bar fonts and colors */
  .NavBarCell1    { background-color:#EEEEFF;}/* Light mauve */
  .NavBarCell1Rev { background-color:#00008B;}/* Dark Blue */
  .NavBarFont1    { font-family: Arial, Helvetica, sans-serif; color:#000000;}
  .NavBarFont1Rev { font-family: Arial, Helvetica, sans-serif; color:#FFFFFF;}
  
  .NavBarCell2    { font-family: Arial, Helvetica, sans-serif; background-color:#FFFFFF;}
  .NavBarCell3    { font-family: Arial, Helvetica, sans-serif; background-color:#FFFFFF;}
  
  
  
  
  1.1                  avalon-components/cornerstone/site/etc/tigris.css
  
  Index: tigris.css
  ===================================================================
  /* contains rules unsuitable for Netscape 4.x; simpler rules are in ns4_only.css. see <http://style.tigris.org/> */
  
  /* colors, backgrounds, borders, link indication */ 
  
  body {
   background: #fff;
   color: #000;
   }
  .app h3, .app h4, .app th, .tabs td, .tabs th, .functnbar {
   background-image: url(../images/nw_min.gif);
   background-repeat: no-repeat;
   }
  #navcolumn div div, body.docs #toc li li  {
   background-image: url(../images/strich.gif);
   background-repeat: no-repeat;
   background-position: .5em .5em;
   }
  #navcolumn div div.heading  {
   background-image: none;
   }
  .app h3, .app h4 {
   color: #fff;
   }
  .app h3 {
   background-color: #036;
   }
  .app h4 { 
   background-color: #888;
   }
  .a td { 
   background: #ddd;
   }
  .b td { 
   background: #efefef;
   }
  table, th, td {
   border: none
   } 
  .mtb {
   border-top: solid 1px #ddd;
   }
  div.colbar {
   background: #bbb;
   }
  div#banner {
   border-top: 1px solid #369;
   border-bottom: 1px solid #003;
   }
  div#helptext th {
   border-bottom: 1px solid #996;
   border-right: 1px solid #996;
   }
  div#helptext td {
   border-bottom: 1px solid #cc9;
   border-right: 1px solid #cc9;
   }
  .tabs { 
   border-bottom: .75em #888 solid;
   }
  .tabs th, .tabs td {
   border-right: 1px solid #333;
   }
  .tabs td {
   border-bottom: 1px solid #ddd;
   }
  #navcolumn {
   background: #eee;
   border-right: 1px solid #aaa;
   border-bottom: 1px solid #aaa;
   }
  #breadcrumbs {
   border-bottom: 1px solid #aaa;
   background-color: #ddd;
   }
  #navcolumn, #breadcrumbs {
   border-top: 1px solid #fff;
   }
  #rightcol div.www, #rightcol div.help {
   border: 1px solid #ddd;
   }
  div#navcolumn div.focus { 
   border-top: 1px solid #aaa;
   border-left: 1px solid #aaa;
   background-color: #fff;
   } 
  body.docs div.docs { 
   background: #fff;
   border-left: 1px solid #ddd;
   border-top: 1px solid #ddd;
   }
  body.docs { 
   background: #eee url(../images/help_logo.gif) top right no-repeat !important;
   }
  .docs h3, .docs h4 {
   border-top: solid 1px #000;
   }
  #alerterrormessage { 
   background: url(../images/icon_alert.gif) top left no-repeat !important;
   }
  .functnbar {
   background-color: #aaa;
   }
  .functnbar2, .functnbar3  {
   background: #aaa url(../images/sw_min.gif) no-repeat bottom left;
   }
  .functnbar3 {
   background-color: #ddd;
   }
  .functnbar, .functnbar2, .functnbar3 {
   color: #000;
   }
  .functnbar a, .functnbar2 a, .functnbar3 a {
   color: #000;
   text-decoration: underline;
   }
  #topmodule {
   background: #ddd;
   border-top: 1px solid #fff;
   border-bottom: 1px solid #aaa; 
   border-right: 1px solid #aaa; 
   }
  #topmodule #issueid {
   border-right: 1px solid #aaa;
   }
  a:link, #navcolumn a:visited, .app a:visited, .tasknav a:visited {
   color: blue;
   }
  a:active, a:hover, #leftcol a:active, #leftcol a:hover {
   color: #f30 !important;
   }
  #login a:link, #login a:visited {
   color: white; 
   text-decoration: underline;
   }
  #banner a:active, #banner a:hover {
   color: #f90 !important;
   }
  #leftcol a, #breadcrumbs a  {
   text-decoration: none;
   }
  a:link.selfref, a:visited.selfref {
   color: #555 !important;
   text-decoration: none;
   }
  h2 .lastchild {
   color: #777
   } 
  .tabs td, .tabs th {
   background-color: #ddd;
   }
  .app th {
   background-color: #bbb;
   }
  .tabs th {
   background-color: #888;
   color: #fff;
   }
  .axial th {
   background-color: #ddd;
   color: black
   }
  .tabs td {
   background-color: #ddd;
   }
  .alert { 
   color: #c00;
   }
  .confirm {
   color: green;
   }
  .info {
   color: blue;
   }
  .selection {
   background: #ffc;
   }
  #login {
   color: #fff;
   }
  #helptext th {
   background: #cc9;
   }
  #helptext td {
   background: #ffc;
   }
  .tabs a  {
   text-decoration: none;
   }
  #navcolumn div strong {
   color: #000;
   }
  #banner, #banner td { 
   background: #036;
   color: #fff;
   }
  body #banner #login a { 
   color: #fff;
   }
  
  
  /* font and text properties, exclusive of link indication, alignment, text-indent */
  
  body, th, td, input, select, textarea, h2 small {
   font-family: Verdana, Helvetica, Arial, sans-serif;
   }
  code, pre {
   font-family: 'Andale Mono', Courier, monospace;
   }
  html body, body th, body td, textarea, h2 small, .app h3, .app h4, #rightcol h3, #bodycol pre, #bodycol code {
   font-size: x-small;
   voice-family: "\"}\"";
   voice-family: inherit;
   font-size: small
   }
  html>body, html>body th, html>body td, html>body input, html>body select, html>body textarea, html>body h2 small, html>body .app h3, html>body .app h4, html>body #rightcol h3, html>body #bodycol pre, html>body #bodycol code {
   font-size: small
   }
  small, div#footer td, div#login, div#helptext th, div#helptext td, div.tabs th, div.tabs td, input, select, .paginate, .functnbar, .functnbar2, .functnbar3, #breadcrumbs td, .courtesylinks, #rightcol div.help, .colbar, .tasknav, body.docs div#toc {
   font-size: xx-small;
   voice-family: "\"}\"";
   voice-family: inherit;
   font-size: x-small
   }
  html>body small, html>body div#footer td, html>body div#login, html>body div#helptext td, html>body div#helptext th, html>body div.tabs th, html>body div.tabs td, html>body input, html>body select, html>body .paginate, html>body .functnbar, html>body .functnbar2, html>body .functnbar3, html>body #breadcrumbs td, html>body .courtesylinks, html>body #rightcol div.help, html>body .colbar, html>body .tasknav, html>body.docs #toc {
   font-size: x-small
   }
  #bodycol h2 {
   font-family: Tahoma, Verdana, Helvetica, Arial, sans-serif;
   font-size: 1.5em;
   font-weight: normal;
   }
  h2 small {
   font-weight: bold;
   letter-spacing: .06em;
   }
  dt {
   font-weight: bold
   }
  #login .username {
   font-weight: bold;
   }
  h4 {
   font-size: 1em;
   }
  #breadcrumbs td {
   font-weight: bold;
   }
  .selection {
   font-weight: bold
   }
  
  
  /* box properties (exclusive of borders), positioning, alignments, list types, text-indent */
  
  #bodycol h2 {
   margin-top: .3em;
   margin-bottom: .5em;
   }
  p, ul, ol, dl {
   margin-top: .67em;
   margin-bottom: .67em;
   }
  h3, h4 {
   margin-bottom: 0;
   }
  form {
   margin-top: 0;
   margin-bottom: 0;
   }
  #bodycol {
   padding-left: 12px;
   padding-right: 12px;
   width: 100%;
   voice-family: "\"}\"";
   voice-family: inherit;
   width: auto;
   }
  html>body #bodycol {
   width: auto;
   }
  .docs {
   line-height: 1.4;
   }
  .app h3, .app h4 {
   padding: 5px;
   margin-right: 2px;
   margin-left: 2px;
   }
  .h3 p, .h4 p, .h3 dt, .h4 dt {
   margin-right: 7px;
   margin-left: 7px;
   }
  .tasknav {
   margin-bottom: 1.33em
   }
  div.colbar {
   padding: 4px;
   margin: 2px 2px 0;
   }
  .tabs { 
   margin-top: .67em;
   margin-right: 2px;
   margin-left: 2px;
   }
  #leftcol {
   padding-bottom: .5em;
   }
  #breadcrumbs td {
   vertical-align: middle;
   padding: 2px 8px;
   } 
  #rightcol div.www, #rightcol div.help {
   padding: 0 .5em
   }
  #navcolumn {
   margin: -8px -8px 0 -8px;
   padding: 4px;
   }
  #navcolumn div {
   padding-left: 5px
   }
  div#navcolumn div div {
   margin-top: .3em;
   margin-bottom: .3em;
   }
  div#navcolumn div.focus { 
   margin-top: -.1em;
   padding: .2em 4px; 
   } 
  body.docs #toc { 
   position: absolute;
   top: 15px;
   left: 0px;
   width: 120px;
   padding: 0 20px 0 0
   }
  body.docs #toc ul, #toc ol {
   margin-left: 0;
   padding-left: 0;
   }
  body.docs #toc li {
   margin-top: 7px;
   padding-left: 10px;
   list-style-type: none;
   }
  body.docs div.docs { 
   margin: 61px 0 0 150px;
   padding: 1em 2em 1em 1em !important;
   }
  .docs p+p {
   text-indent: 5%;
   margin-top: -.67em
   }
  .docs h3, .docs h4 {
   margin-bottom: .1em;
   padding-top: .3em;
   }
  #alerterrormessage { 
   padding-left: 100px;
   }
  .functnbar, .functnbar2, .functnbar3 {
   padding: 5px;
   margin: .67em 2px;
   }
  #topmodule td {
   vertical-align: middle;
   padding: 2px 8px
   } 
  body {
   padding: 1em;
   }
  body.composite, body.docs {
   margin: 0;
   padding: 0;
   }
  th, td {
   text-align: left;
   vertical-align: top 
   }
  .right {
   text-align: right !important;
   }
  .center {
   text-align: center !important;
   }
  .tabs td, .tabs th {
   padding-left: 7px;
   padding-right: 7px;
   }
  .axial th {
   text-align: right;
   }
  .app .axial td th {
   text-align: left;
   }
  body td .stb {
   margin-top: 1em;
   text-indent: 0;
   }
  body td .mtb {
   margin-top: 2em;
   text-indent: 0;
   }
  dd {
   margin-bottom: .67em;
   }
  #footer {
   margin: 4px
   }
  #helptext {
   margin-top: 1em
   }
  #helptext td div {
   margin: .5em
   }
  .courtesylinks {
   margin-top: 1em;
   padding-top: 1em
   }
  #navcolumn div {
   margin-bottom: .5em;
   }
  #navcolumn div div {
   margin-top: .3em
   }
  #navcolumn div div {
   padding-left: 1em;
   }
  #banner, #banner td { 
   vertical-align: middle;
   }
  body.docs, body.nonav {
   margin: 1em
   }
  
  
  
  1.1                  avalon-components/cornerstone/site/xdocs/components/connection.xml
  
  Index: connection.xml
  ===================================================================
  <?xml version="1.0"?>
  
  <document>
  
    <properties>
      <author email="mcconnell@apache.org">Stephen McConnell</author>
      <title>Cornerstone Connection</title>
    </properties>
  
    <body>
      <section name="Cornerstone Components - Connection">
        <subsection name="Description">
              <p>
              The ConnectionManager service provides a facility to listen 
              for incoming socket connections.
              The DefaultConnectionManager compoent gives a thread pooled 
              implementation of this service. If there are multiple server 
              components depending on this component, they would all share
              the same thread pool.
              </p>
        </subsection>
        <subsection name="Deployment Facts">
          <table>
            <tr><td>Containment</td><td>Avalon Framework 4.1.4</td>
            </tr>
            <tr><td>Lifestyle</td><td>singleton</td></tr>
            <tr><td>Lifecycle</td>
              <td>
                <table>
                  <tr><th>Stage</th><th>Description</th></tr>
                  <tr><td>LogEnabled</td><td>Logs lifescycle stages and handles assignment
                   of logging channels to managed connection handlers.</td></tr>
                  <tr>
                    <td>Serviceable</td>
                    <td>
                    The connection manager has a structural dependency on the 
                    <a href="threads.html">Threads</a>component.
                    </td>
                  </tr>
                  <tr>
                    <td>Disposable</td>
                    <td>
                    Disconnects all standing connections.
                    </td>
                  </tr>
                </table>
              </td>
            </tr>
          </table>
        </subsection>
      </section>
  
    </body>
  
  </document>
  
  
  
  
  
  
  1.1                  avalon-components/cornerstone/site/xdocs/components/datasource.xml
  
  Index: datasource.xml
  ===================================================================
  <?xml version="1.0"?>
  
  <document>
  
    <properties>
      <author email="mcconnell@apache.org">Stephen McConnell</author>
      <title>Cornerstone Connection</title>
    </properties>
  
    <body>
      <section name="Cornerstone Components - Datasource">
        <subsection name="Description">
              <p>
              The ConnectionManager service provides a facility to listen 
              for incoming socket connections.
              The DefaultConnectionManager compoent gives a thread pooled 
              implementation of this service. If there are multiple server 
              components depending on this component, they would all share
              the same thread pool.
              </p>
        </subsection>
        <subsection name="Deployment Facts">
          <table>
            <tr><td>Containment</td><td>Avalon Framework 4.1.4</td>
            </tr>
            <tr><td>Lifestyle</td><td>singleton</td></tr>
            <tr><td>Lifecycle</td>
              <td>
                <table>
                  <tr><th>Stage</th><th>Description</th></tr>
                  <tr><td>LogEnabled</td><td>Logs lifescycle stages and handles assignment
                   of logging channels to managed connection handlers.</td></tr>
                  <tr>
                    <td>Contextualizable</td>
                    <td>
                    <table>
                      <tr>
                        <th>Key</th><th>Type</th><th>Required</th>
                      </tr>
                      <tr>
                        <td>block.name</td><td>java.lang.String</td><td>false</td>
                      </tr>
                    </table>
                    </td>
                  </tr>
                  <tr>
                    <td>Configurable</td>
                    <td>
                    <p>Example configuration:</p>
                    <source>
   &lt;configuration&gt;
     &lt;data-source name="<i>default</i>"
       class="<i>org.apache.avalon.excalibur.datasource.JdbcDataSource</i>"&gt;
       &lt;!-- configuration for JdbcDataSource --&gt;
       &lt;pool-controller min="<i>5</i>" max="<i>10</i>" 
         connection-class="<i>my.overrided.ConnectionClass</i>"&gt;
       &lt;keep-alive&gt;select 1&lt;/keep-alive&gt;
       &lt;/pool-controller&gt;
       &lt;driver&gt;<i>com.database.jdbc.JdbcDriver</i>&lt;/driver&gt;
       &lt;dburl&gt;<i>jdbc:driver://host/mydb</i>&lt;/dburl&gt;
       &lt;user&gt;<i>username</i>&lt;/user&gt;
       &lt;password&gt;<i>password</i>&lt;/password&gt;
     &lt;/data-source&gt;
   &lt;/configuration&gt;
                    </source>
                    </td>
                  </tr>
                  <tr>
                    <td>Initializable</td>
                    <td>
                    Component initialization.
                    </td>
                  </tr>
                  <tr>
                    <td>Disposable</td>
                    <td>
                    Component disposal.
                    </td>
                  </tr>
                </table>
              </td>
            </tr>
          </table>
        </subsection>
      </section>
  
    </body>
  
  </document>
  
  
  
  
  
  
  
  1.1                  avalon-components/cornerstone/site/xdocs/components/index.xml
  
  Index: index.xml
  ===================================================================
  <?xml version="1.0"?>
  
  <document>
  
    <properties>
      <author email="mcconnell@apache.org">Stephen McConnell</author>
      <title>Cornerstone Thread Manager</title>
    </properties>
  
    <body>
      <section name="Cornerstone Components">
      <subsection name="Index">
        <table>
          <tr>
            <th>Topic</th>
            <th>Description</th>
            <th>Status</th>
            <th>Javadocs</th>
            <th>Usage Docs</th>
            <th>Testcases</th>
          </tr>
          <tr><td><a href="connection.html">Connection</a></td>
            <td>
              <p>
              The ConnectionManager service provides a facility to listen 
              for incoming socket connections.
              The DefaultConnectionManager compoent gives a thread pooled 
              implementation of this service. If there are multiple server 
              components depending on this component, they would all share
              the same thread pool.
              </p>
            </td>
            <td>CANDIDATE</td>
            <td>[1]</td>
            <td>No</td>
            <td>No</td>
          </tr>
          <tr><td><a href="datasource.html">Datasource</a></td>
            <td>
              <p>
              The DataSourceSelector service provides a way to select 
              DataSourceComponent.
              The DefaultDataSourceSelector component provides a set of 
              ready to use DataSourceComponents.
              </p>
            </td>
            <td>CANDIDATE</td>
            <td>[1]</td>
            <td>No</td>
            <td>No</td>
          </tr>
          <tr><td><a href="scheduler.html">Scheduler</a></td>
            <td>
             <p>
             The TimeScheduler service provides a services supporting the 
             scheduling of activities to occur an certain intervals.
             The DefaultTimeScheduler block implements the service. When
             used in conjunction with the service is it a TimeTrigger.  
             There are two such tiggers provided within the implementation
             CronTimeTrigger and PeriodicTimeTigger.
             </p>
            </td>
            <td>CANDIDATE</td>
            <td>[1]</td>
            <td>No</td>
            <td>No</td>
          </tr>
          <tr><td><a href="sockets.html">Sockets</a></td>
            <td>
              <p>
              The SocketManager service provides a way to lookup a factory 
              for server of client sockets.  This service is provided by the 
              DefaultSocketManager component.
              </p>
            </td>
            <td>CANDIDATE</td>
            <td>[1]</td>
            <td>No</td>
            <td>No</td>
          </tr>
          <tr><td><a href="store.html">Store</a></td>
            <td>
              <p>
                The Store service provides a way to store named Objects or 
                Streams without knowing how they are stored.
                The RepositoryManager block implements this service and 
                provides (in invocation of select(..) ) an appropriate 
                Respository.  The two configurable implementations use the 
                local file system for storage.
                </p>
            </td>
            <td>CANDIDATE</td>
            <td>[1]</td>
            <td>No</td>
            <td>No</td>
          </tr>
          <tr><td><a href="threads.html">Threads</a></td>
            <td>
              <p>
              The ThreadManager service provides a way get default or named 
              Thread Pool.
              The DefaultThreadManager block implements this service based on
              the Excalibur implementations of ThreadPool.
              </p>
            </td>
            <td>CANDIDATE</td>
            <td>[1]</td>
            <td>No</td>
            <td>No</td>
          </tr>
        </table>
        <p>
          <strong>[1]</strong>Rudimentary Javadocs.
        </p>
        <p>
          <strong>[2]</strong>Basic Javadocs.
        </p>
        <p>
          <strong>[3]</strong>Excellent Javadocs.
        </p>
      </subsection>
      </section>
    </body>
  
  </document>
  
  
  
  
  
  1.1                  avalon-components/cornerstone/site/xdocs/components/navigation.xml
  
  Index: navigation.xml
  ===================================================================
  <?xml version="1.0" encoding="UTF-8"?>
  <project>
  
   <title>Cornerstone Threads</title>
  
   <body>
  
      <links>
        <item name="Apache" href="http://apache.org/"/>
        <item name="Avalon" href="http://avalon.apache.org/"/>
        <item name="Framework" href="http://avalon.apache.org/product/framework/"/>
        <item name="Containment" href="http://avalon.apache.org/product/containers/"/>
        <item name="Components" href="http://avalon.apache.org/product/components/"/>
      </links>
  
      <menu name="About Cornerstone">
        <item name="Overview" href="/index.html"/>
        <item name="Components" href="/components/index.html">
          <item name="Connection" href="/components/connection.html"/>
          <item name="Datasource" href="/components/datasource.html"/>
          <item name="Scheduler" href="/components/scheduler.html"/>
          <item name="Sockets" href="/components/sockets.html"/>
          <item name="Store" href="/components/store.html"/>
          <item name="Threads" href="/components/threads.html"/>
        </item>
        <item name="Examples" href="/examples/index.html"/>
        <item name="Developer Info" href="/notes/index.html"/>
      </menu>
  
   </body>
  
  </project>
  
  
  
  1.1                  avalon-components/cornerstone/site/xdocs/components/scheduler.xml
  
  Index: scheduler.xml
  ===================================================================
  <?xml version="1.0"?>
  
  <document>
  
    <properties>
      <author email="mcconnell@apache.org">Stephen McConnell</author>
      <title>Cornerstone Connection</title>
    </properties>
  
    <body>
      <section name="Cornerstone Components - Scheduler">
        <subsection name="Description">
             <p>
             The TimeScheduler service provides a services supporting the 
             scheduling of activities to occur an certain intervals.
             The DefaultTimeScheduler block implements the service. When
             used in conjunction with the service is it a TimeTrigger.  
             There are two such tiggers provided within the implementation
             CronTimeTrigger and PeriodicTimeTigger.
             </p>
        </subsection>
        <subsection name="Deployment Facts">
          <table>
            <tr><td>Containment</td><td>Avalon Framework 4.1.4</td>
            </tr>
            <tr><td>Lifestyle</td><td>singleton</td></tr>
            <tr><td>Lifecycle</td>
              <td>
                <table>
                  <tr><th>Stage</th><th>Description</th></tr>
                  <tr><td>LogEnabled</td><td>Logs lifescycle stages and runtime warning.</td></tr>
                  <tr>
                    <td>Serviceable</td>
                    <td>
                    The connection manager has a structural dependency on the 
                    <a href="threads.html">Threads</a>component.
                    </td>
                  </tr>
                  <tr>
                    <td>Startable</td>
                    <td>
                    Initiates execution using the default thread pool.
                    </td>
                  </tr>
                  <tr>
                    <td>Disposable</td>
                    <td>
                    Disposal phase cleanup.
                    </td>
                  </tr>
                </table>
              </td>
            </tr>
          </table>
        </subsection>
      </section>
  
    </body>
  
  </document>
  
  
  
  
  
  
  
  1.1                  avalon-components/cornerstone/site/xdocs/components/sockets.xml
  
  Index: sockets.xml
  ===================================================================
  <?xml version="1.0"?>
  
  <document>
  
    <properties>
      <author email="mcconnell@apache.org">Stephen McConnell</author>
      <title>Cornerstone Scheduler</title>
    </properties>
  
    <body>
      <section name="Cornerstone Components - Sockets">
        <subsection name="Description">
        </subsection>
        <subsection name="Deployment Facts">
          <table>
            <tr><td>Containment</td><td>Avalon Framework 4.1.4</td>
            </tr>
            <tr><td>Lifestyle</td><td>singleton</td></tr>
            <tr><td>Lifecycle</td>
              <td>
                <table>
                  <tr><th>Stage</th><th>Description</th></tr>
                  <tr><td>LogEnabled</td><td>Logs runtime warnings and assigns 
                   logging channels to created factories.</td></tr>
                  <tr><td>Contextualizable</td>
                    <td>
                    <table>
                      <tr>
                        <th>Key</th><th>Type</th><th>Required</th>
                      </tr>
                      <tr>
                        <td>block.name</td><td>java.lang.String</td><td>true</td>
                      </tr>
                      <tr>
                        <td>app.name</td><td>java.lang.String</td><td>true</td>
                      </tr>
                      <tr>
                        <td>app.home</td><td>java.io.File</td><td>true</td>
                      </tr>
                    </table>
                    </td>
                  </tr>
                  <tr>
                    <td>Configurable</td>
                    <td>
                    An example configuration is 
                    presented below.
                    </td>
                  </tr>
                </table>
              </td>
            </tr>
          </table>
        </subsection>
        <subsection name="Example Configuration">
  <source><![CDATA[
  <configuration>
    <server-sockets>
      <factory name="plain" 
  class="org.apache.avalon.cornerstone.blocks.sockets.DefaultServerSocketFactory"/>
    </server-sockets>
    <client-sockets>
      <factory name="plain" 
  class="org.apache.avalon.cornerstone.blocks.sockets.DefaultSocketFactory"/>
    </client-sockets>
  </configuration>
  ]]></source>
        </subsection>
      </section>
  
    </body>
  
  </document>
  
  
  
  
  
  
  1.1                  avalon-components/cornerstone/site/xdocs/components/store.xml
  
  Index: store.xml
  ===================================================================
  <?xml version="1.0"?>
  
  <document>
  
    <properties>
      <author email="mcconnell@apache.org">Stephen McConnell</author>
      <title>Cornerstone Store</title>
    </properties>
  
    <body>
      <section name="Cornerstone Components - Datasource">
        <subsection name="Description">
          <p>
            The Store service provides a way to store named Objects or 
            Streams without knowing how they are stored.
            The RepositoryManager block implements this service and 
            provides (in invocation of select(..) ) an appropriate 
            Respository.  The two configurable implementations use the 
            local file system for storage.
          </p>
        </subsection>
        <subsection name="Deployment Facts">
          <table>
            <tr><td>Containment</td><td>Avalon Framework 4.1.4</td>
            </tr>
            <tr><td>Lifestyle</td><td>singleton</td></tr>
            <tr><td>Lifecycle</td>
              <td>
                <table>
                  <tr><th>Stage</th><th>Description</th></tr>
                  <tr><td>LogEnabled</td><td>Logs store establishment and 
                  runtime related warnings.</td></tr>
                  <tr>
                    <td>Contextualizable</td>
                    <td>
                    <table>
                      <tr>
                        <th>Key</th><th>Type</th><th>Required</th>
                      </tr>
                      <tr>
                        <td>block.name</td><td>java.lang.String</td><td>true</td>
                      </tr>
                      <tr>
                        <td>app.name</td><td>java.lang.String</td><td>true</td>
                      </tr>
                      <tr>
                        <td>app.home</td><td>java.io.File</td><td>true</td>
                      </tr>
                    </table>
                    </td>
                  </tr>
                  <tr>
                    <td>Configurable</td>
                    <td>
                    <p>Example configuration included below.</p>
                    </td>
                  </tr>
                  <tr>
                    <td>Serviceable</td>
                    <td>
                    WARNING: Implementated but no dependencies declared!
                    </td>
                  </tr>
                  <tr>
                    <td>Disposable</td>
                    <td>
                    Component disposal.
                    </td>
                  </tr>
                </table>
              </td>
            </tr>
          </table>
        </subsection>
        <subsection name="Example Configuration">
  <p>
  The following example coinfiguration is taken from the 
  <a href="http://james.apache.org/">Apache James Project</a>.
  </p>
  
  <source><![CDATA[
  <configuration>
    <repositories>
      <repository
   class="org.apache.james.mailrepository.filepair.File_Persistent_Object_Repository"> 
        <protocols>
          <protocol>file</protocol>
        </protocols>
        <types>
          <type>OBJECT</type>
        </types>
        <models>
          <model>SYNCHRONOUS</model>
          <model>ASYNCHRONOUS</model>
          <model>CACHE</model>
        </models>
      </repository>
      <repository 
  class="org.apache.james.mailrepository.filepair.File_Persistent_Stream_Repository">
        <protocols>
          <protocol>file</protocol>
        </protocols>
        <types>
          <type>STREAM</type>
        </types>
        <models>
          <model>SYNCHRONOUS</model>
          <model>ASYNCHRONOUS</model>
          <model>CACHE</model>
        </models>
      </repository>
    </repositories>
  </configuration>
  ]]></source>
        </subsection>
      </section>
  
    </body>
  
  </document>
  
  
  
  
  
  
  
  
  1.1                  avalon-components/cornerstone/site/xdocs/components/threads.xml
  
  Index: threads.xml
  ===================================================================
  <?xml version="1.0"?>
  
  <document>
  
    <properties>
      <author email="mcconnell@apache.org">Stephen McConnell</author>
      <title>Cornerstone Scheduler</title>
    </properties>
  
    <body>
      <section name="Cornerstone Components - Threads">
        <subsection name="Description">
          <p>The threads component provides support for the establishment
          a set of named thread pools.  The component implementation can be configured
          such that multiple thread pools may be defined within which each pool has 
          a minimum and maximum pool criteria and daemon property.  Consumer components
          can access threads from named or default pool using the ThreadManager 
          service interface.</p>
        </subsection>
        <subsection name="Deployment Facts">
          <table>
            <tr><td>Containment</td><td>Classic Framework 4.</td>
            </tr>
            <tr><td>Lifestyle</td><td>singleton</td></tr>
            <tr><td>Lifecycle</td>
              <td>
                <table>
                  <tr><th>Stage</th><th>Description</th></tr>
                  <tr><td>LogEnabled</td><td>Logs information concerning created pools during 
                    configuration at the DEBUG level.</td></tr>
                  <tr>
                    <td>Configurable</td>
                    <td>
                    Declaration of the thread pools and associated 
                    pool establishment criteria.  An example configuration is 
                    presented below.
  <source><![CDATA[
  <configuration>
    <thread-group>
      <name>default</name>
      <is-daemon>false</is-daemon>
      <max-threads>100</max-threads>
      <min-threads>20</min-threads>
    </thread-group>
  </configuration>
  ]]></source>
                    </td>
                  </tr>
                </table>
              </td>
            </tr>
          </table>
        </subsection>
        <subsection name="Examples">
          <table>
            <tr><th>Container</th><th>Description</th></tr>
            <tr>
              <td><a href="../examples/merlin/threads.html">Merlin</a></td>
              <td>
                A demonstration component implementation demonstrates the resolution
                of a ThreadManager and subsequent access to a ThreadPoll against 
                which a Runnable object is launched.  Termination of the container 
                before this time will trigger disposal of the component causing the 
                interuption of the subsidiary thread.
              </td>
            </tr>
          </table>
        </subsection>      
      </section>
  
    </body>
  
  </document>
  
  
  
  
  
  1.1                  avalon-components/cornerstone/site/xdocs/examples/fortress.xml
  
  Index: fortress.xml
  ===================================================================
  <?xml version="1.0"?>
  
  <document>
  
    <properties>
      <author email="mcconnell@apache.org">Stephen McConnell</author>
      <title>Fortress Examples</title>
    </properties>
  
    <body>
      <section name="Fortress Examples">
        <p><strong>PLACEHOLDER</strong></p>
      </section>
    </body>
  
  </document>
  
  
  
  
  
  1.1                  avalon-components/cornerstone/site/xdocs/examples/index.xml
  
  Index: index.xml
  ===================================================================
  <?xml version="1.0"?>
  
  <document>
  
    <properties>
      <author email="mcconnell@apache.org">Stephen McConnell</author>
      <title>Cornerstone Examples</title>
    </properties>
  
    <body>
      <section name="Cornerstone - Examples">
        <subsection name="Containers">
          <p>
          Component management is intrinsically linked with the containment 
          environment with which a component is deployed.  A container provides
          functions covering the establishment of a component, subsequent 
          deployment and component decommissioning. At this time there are three
          production quality containers with Avalon.  These include  
          <a href="http://avalon.apache.org/excalibur/fortress">Fortress</a>, 
          <a href="http://avalon.apache.org/phoenix">Phoenix</a>, and the 
          <a href="http://avalon.apache.org/sandbox/merlin">
          Merlin Service Management Platform</a>.  The following links provide
          examples of the deployment of cornerstone components across one or 
          more of the these respective containers.
          </p>
        </subsection>
        <subsection name="Tutorials">
          <table>
            <tr><th>Container</th><th>Tutorial Overview</th></tr>
            <tr><td><a href="merlin/index.html">Merlin</a></td>
              <td>
                A set of tutorials using the 
                <a href="http://avalon.apache.org/sandbox/merlin">
                Merlin Service Management Platform</a>. Currently the tutorials 
                address the Thread component.  Tutorials will be expanded to 
                include all cornerstone candidate-release components as part of
                the overall cornerstone release process.
              </td>
            </tr>
          </table>
        </subsection>
      </section>
    </body>
  
  </document>
  
  
  
  1.1                  avalon-components/cornerstone/site/xdocs/examples/navigation.xml
  
  Index: navigation.xml
  ===================================================================
  <?xml version="1.0" encoding="UTF-8"?>
  <project>
  
   <title>Cornerstone Threads</title>
  
   <body>
  
      <links>
        <item name="Apache" href="http://apache.org/"/>
        <item name="Avalon" href="http://avalon.apache.org/"/>
        <item name="Framework" href="http://avalon.apache.org/product/framework/"/>
        <item name="Containment" href="http://avalon.apache.org/product/containers/"/>
        <item name="Components" href="http://avalon.apache.org/product/components/"/>
      </links>
  
      <menu name="About Cornerstone">
        <item name="Overview" href="/index.html"/>
        <item name="Components" href="/components/index.html"/>
        <item name="Examples" href="/examples/index.html">
          <item name="Merlin" href="/examples/merlin/index.html"/>
          <item name="Fortress" href="/examples/fortress.html"/>
          <item name="Phoenix" href="/examples/phoenix.html"/>
        </item>
        <item name="Developer Info" href="/notes/index.html"/>
      </menu>
  
   </body>
  
  </project>
  
  
  
  1.1                  avalon-components/cornerstone/site/xdocs/examples/phoenix.xml
  
  Index: phoenix.xml
  ===================================================================
  <?xml version="1.0"?>
  
  <document>
  
    <properties>
      <author email="mcconnell@apache.org">Stephen McConnell</author>
      <title>Phoenix Examples</title>
    </properties>
  
    <body>
      <section name="Phoenix Examples">
        <p><strong>PLACEHOLDER</strong></p>
      </section>
    </body>
  
  </document>
  
  
  
  
  
  1.1                  avalon-components/cornerstone/site/xdocs/examples/merlin/index.xml
  
  Index: index.xml
  ===================================================================
  <?xml version="1.0"?>
  
  <document>
  
    <properties>
      <author email="mcconnell@apache.org">Stephen McConnell</author>
      <title>Cornerstone Thread Manager</title>
    </properties>
  
    <body>
      <section name="Merlin Examples of Cornerstone Components">
      <subsection name="Index">
        <table>
          <tr><th>Component</th><th>Description</th></tr>
          <tr><td><a href="threads.html">Threads</a></td>
            <td>
              <p>
              This tutorial demonstrates the creation of a component that 
              uses the cornerstone thread pool, establishes a work thread
              and demonstrates some of the features of the underlying 
              Excalibur Thread Pool.
              </p>
            </td>
          </tr>
        </table>
      </subsection>
      </section>
    </body>
  
  </document>
  
  
  
  1.1                  avalon-components/cornerstone/site/xdocs/examples/merlin/navigation.xml
  
  Index: navigation.xml
  ===================================================================
  <?xml version="1.0" encoding="UTF-8"?>
  <project>
  
   <title>Cornerstone Threads</title>
  
   <body>
  
      <links>
        <item name="Apache" href="http://apache.org/"/>
        <item name="Avalon" href="http://avalon.apache.org/"/>
        <item name="Framework" href="http://avalon.apache.org/product/framework/"/>
        <item name="Containment" href="http://avalon.apache.org/product/containers/"/>
        <item name="Components" href="http://avalon.apache.org/product/components/"/>
      </links>
  
      <menu name="About Cornerstone">
        <item name="Overview" href="/index.html"/>
        <item name="Components" href="/components/index.html"/>
        <item name="Examples" href="/examples/index.html">
          <item name="Merlin" href="/examples/merlin/index.html">
            <item name="Threads" href="/examples/merlin/threads.html"/>
          </item>
          <item name="Fortress" href="/examples/fortress.html"/>
          <item name="Phoenix" href="/examples/phoenix.html"/>
        </item>
        <item name="Developer Info" href="/notes/index.html"/>
      </menu>
  
   </body>
  
  </project>
  
  
  
  1.1                  avalon-components/cornerstone/site/xdocs/examples/merlin/threads.xml
  
  Index: threads.xml
  ===================================================================
  <?xml version="1.0"?>
  
  <document>
  
    <properties>
      <author email="mcconnell@apache.org">Stephen McConnell</author>
      <title>Cornerstone Scheduler</title>
    </properties>
  
    <body>
      <section name="Cornerstone Components - Threads">
        <subsection name="Example">
          <table>
            <tr><th>Source</th><th>Description</th></tr>
            <tr>
              <td><a href="http://cvs.apache.org/viewcvs.cgi/avalon-components/threads-tutorial/src/java/org/apache/avalon/cornerstone/threads/tutorial/ThreadConsumer.java">ThreadConsumer.java</a>
              </td>
              <td>
                A demonstration component implementation demonstrates the resolution
                of a ThreadManager and subsequent access to a ThreadPoll against 
                which a Runnable object is launched.  Termination of the container 
                before this time will trigger disposal of the component causing the 
                interruption of the subsidiary thread.
              </td>
            </tr>
            <tr>
              <td>
                <a href="http://cvs.apache.org/viewcvs.cgi/avalon-components/threads-tutorial/src/java/org/apache/avalon/cornerstone/threads/tutorial/Counter.java">Counter.java</a>
              </td>
              <td>
                The runnable object that simply initiates a countdown and will normally 
                complete and terminate within 10 seconds.  Used by the ThreadConsumer
                component to establish a threaded activity.
              </td>
            </tr>
            <tr>
              <td>
                <a href="http://cvs.apache.org/viewcvs.cgi/*checkout*/avalon-components/threads-tutorial/conf/block.xml">block.xml</a>
              </td>
              <td>
                Merlin deployment directive.
  <source><![CDATA[
  <container name="thread-tutorial">
  
       <categories>
         <category name="classloader/scanner" priority="ERROR"/>
       </categories>
  
       <classloader>
         <classpath>
           <repository>
             <resource id="avalon-framework:avalon-framework-impl" version="4.1.5"/>
             <resource id="commons-collections:commons-collections" version="2.1"/>
             <resource id="excalibur-pool:excalibur-pool" version="1.2"/>
             <resource id="excalibur-thread:excalibur-thread" version="1.1.1"/>
             <resource id="excalibur-event:excalibur-event" version="1.0.3"/>
             <resource id="cornerstone-threads:cornerstone-threads-api" version="1.0"/>
             <resource id="cornerstone-threads:cornerstone-threads-impl" version="1.0"/>
           </repository>
         </classpath>
       </classloader>
  
       <component name="threads" 
          class="org.apache.avalon.cornerstone.blocks.threads.DefaultThreadManager">
         <configuration>
           <thread-group>
             <name>default</name>
             <priority>5</priority> 
             <is-daemon>false</is-daemon>
             <max-threads>100</max-threads>
             <min-threads>20</min-threads>
             <min-spare-threads>20</min-spare-threads>
           </thread-group>
         </configuration>
       </component>
  
       <component name="test" 
          class="org.apache.avalon.cornerstone.threads.tutorial.ThreadConsumer" />
  
  </container>
  ]]></source>
              </td>
            </tr>
          </table>
        </subsection>
        <subsection name="Runtime">
  <p>
  To execute this demonstration please make sure that you copy the cornerstone-threads-* jar files from your Maven repository to you <a href="http://avalon.apache.org/sandbox/merlin/">Merlin</a> repository.
  </p>
  <source><![CDATA[
  $ cd avalon-cornerstone\threads\tutorial
  $ merlin target\cornerstone-threads-tutorial-1.0.jar
  
  [INFO   ] (thread-tutorial.test): aquiring cornerstone threads service
  [INFO   ] (thread-tutorial.test): initialization
  [INFO   ] (thread-tutorial.test.counter): count: 10
  [INFO   ] (thread-tutorial.test.counter): count: 9
  [INFO   ] (thread-tutorial.test.counter): count: 8
  [INFO   ] (thread-tutorial.test.counter): count: 7
  ]]></source>
  <p>
  Interrupting the container (using ^C) will trigger component disposal
  which in turn will trigger early termination of the thread established
  using the cornerstone thread manager.
  </p>
  <source><![CDATA[
  [INFO   ] (thread-tutorial.test): disposal
  [INFO   ] (thread-tutorial.test): disposal invoked while child thread active
  [INFO   ] (thread-tutorial.test.counter): I've been interrupted.
  [INFO   ] (thread-tutorial.test.counter): Time to die.
  [INFO   ] (thread-tutorial.test): disposal complete
  ]]></source>
        </subsection>
        
      </section>
  
    </body>
  
  </document>
  
  
  
  1.1                  avalon-components/cornerstone/site/xdocs/index.xml
  
  Index: index.xml
  ===================================================================
  <?xml version="1.0"?>
  
  <document>
  
    <properties>
      <author email="mcconnell@apache.org">Stephen McConnell</author>
      <title>Cornerstone</title>
    </properties>
  
    <body>
      <section name="Cornerstone">
        <subsection name="About">
          <p>
          The cornerstone project is the home of a set of utility components
          that can be used to simplify application development.  These components
          and typically singleton components that represent structural building 
          blocks.
          </p>
          <p>
          The <a href="components/index.html">Cornerstone Component List</a> details 
          the set of available components and release status.
          </p>
          <p>
          These components have been tested and validated under a number of 
          Avalon containers.  Further information concerning container support 
          or container specific deployment requirements, please consult the respective
          component fact sheet.
          </p>
        </subsection>
      </section>
    </body>
  
  </document>
  
  
  
  
  
  1.1                  avalon-components/cornerstone/site/xdocs/navigation.xml
  
  Index: navigation.xml
  ===================================================================
  <?xml version="1.0" encoding="UTF-8"?>
  <project>
  
   <title>Cornerstone Threads</title>
  
   <body>
  
      <links>
        <item name="Apache" href="http://apache.org/"/>
        <item name="Avalon" href="http://avalon.apache.org/"/>
        <item name="Framework" href="http://avalon.apache.org/product/framework/"/>
        <item name="Containment" href="http://avalon.apache.org/product/containers/"/>
        <item name="Components" href="http://avalon.apache.org/product/components/"/>
      </links>
  
      <menu name="About Cornerstone">
        <item name="Overview" href="/index.html"/>
        <item name="Components" href="/components/index.html"/>
        <item name="Examples" href="/examples/index.html"/>
        <item name="Developer Info" href="/notes/index.html"/>
      </menu>
  
   </body>
  
  </project>
  
  
  
  1.1                  avalon-components/cornerstone/site/xdocs/notes/build.xml
  
  Index: build.xml
  ===================================================================
  <?xml version="1.0"?>
  
  <document>
  
    <properties>
      <author email="mcconnell@apache.org">Stephen McConnell</author>
      <title>Cornerstone Notes</title>
    </properties>
  
    <body>
      <section name="Cornerstone - Developer Info">
        <subsection name="Build Instructions">
  
  <p>
  The cornerstone repository has been restructured to support the seperation
  of components, and for each component - the seperation of api relative to 
  implemetation builds.
  </p>
  <p>
  Components subprojects include:
  </p>
  <source>
     connection-api
     connection-impl
  
     datasources-api
     datasources-impl
  
     scheduler-api
     scheduler-impl
  
     sockets-api
     sockets-impl
  
     store-api
     store-impl
  
     threads-api
     threads-impl
     threads-tutorial
  </source>
  
  <p>
  The entire suite can be built as follows:
  </p>
  <source>
    $ cd avalon-components
    $ maven
  </source>
  <p>
  The default target will build, jar and install the component into 
  your local maven repository followind by the generation of the 
  project documetation under the following directory:
  </p>
  <source>
    avalon-components/site/target/docs
  </source>
  
        </subsection>
      </section>
    </body>
  
  </document>
  
  
  
  
  
  1.1                  avalon-components/cornerstone/site/xdocs/notes/download.xml
  
  Index: download.xml
  ===================================================================
  <?xml version="1.0"?>
  
  <document>
  
    <properties>
      <author email="mcconnell@apache.org">Stephen McConnell</author>
      <title>Cornerstone</title>
    </properties>
  
    <body>
      <section name="Cornerstone - Developer Info">
        <subsection name="Download">
          <p>PLACEHOLDER</p>
        </subsection>
      </section>
    </body>
  
  </document>
  
  
  
  
  
  1.1                  avalon-components/cornerstone/site/xdocs/notes/index.xml
  
  Index: index.xml
  ===================================================================
  <?xml version="1.0"?>
  
  <document>
  
    <properties>
      <author email="mcconnell@apache.org">Stephen McConnell</author>
      <title>Cornerstone Examples</title>
    </properties>
  
    <body>
      <section name="Cornerstone - Developer Info">
        <subsection name="Index">
          <table>
            <tr><th>Subject</th><th>Description</th></tr>
            <tr><td><a href="download.html">Downloads</a></td>
              <td>
                Component distribution download site.
              </td>
            </tr>
            <tr><td><a href="build.html">Build Instructions</a></td>
              <td>
                Details about the component build environment used 
                in conjunction with CVS based access to the source
                repository.
              </td>
            </tr>
          </table>
        </subsection>
      </section>
    </body>
  
  </document>
  
  
  
  
  
  1.1                  avalon-components/cornerstone/site/xdocs/notes/navigation.xml
  
  Index: navigation.xml
  ===================================================================
  <?xml version="1.0" encoding="UTF-8"?>
  <project>
  
   <title>Cornerstone Threads</title>
  
   <body>
  
      <links>
        <item name="Apache" href="http://apache.org/"/>
        <item name="Avalon" href="http://avalon.apache.org/"/>
        <item name="Framework" href="http://avalon.apache.org/product/framework/"/>
        <item name="Containment" href="http://avalon.apache.org/product/containers/"/>
        <item name="Components" href="http://avalon.apache.org/product/components/"/>
      </links>
  
      <menu name="About Cornerstone">
        <item name="Overview" href="/index.html"/>
        <item name="Components" href="/components/index.html"/>
        <item name="Examples" href="/examples/index.html"/>
        <item name="Developer Info" href="/notes/index.html">
          <item name="Download" href="/notes/download.html"/>
          <item name="Build Instructions" href="/notes/build.html"/>
          <item name="Javadoc" href="/api/index.html"/>
        </item>
      </menu>
  
   </body>
  
  </project>
  
  
  

---------------------------------------------------------------------
To unsubscribe, e-mail: cvs-unsubscribe@avalon.apache.org
For additional commands, e-mail: cvs-help@avalon.apache.org


Mime
View raw message