DPML Notify

[mcconnell AT netcompartner.com]

Author: mcconnell
Date: Mon Jan 10 15:40:05 2005
New Revision: 1439

Added:
   development/main/central/site/src/docs/products/magic/antlib/import.xml   
(contents, props changed)
   
development/main/central/site/src/docs/products/transit/overview/artifact.xml 
  (contents, props changed)
   
development/main/central/site/src/docs/products/transit/overview/features.xml 
  (contents, props changed)
   
development/main/central/site/src/docs/products/transit/overview/plugins.xml  
 (contents, props changed)
   development/main/central/site/src/docs/products/transit/technical/cache/
   
development/main/central/site/src/docs/products/transit/technical/cache/index.xml
   (contents, props changed)
   
development/main/central/site/src/docs/products/transit/technical/cache/navigation.xml
   (contents, props changed)
   
development/main/central/site/src/docs/products/transit/technical/cache/properties.xml
   (contents, props changed)
   development/main/central/site/src/docs/products/transit/technical/hosts/
   
development/main/central/site/src/docs/products/transit/technical/hosts/authorative.xml
   (contents, props changed)
   
development/main/central/site/src/docs/products/transit/technical/hosts/classic.xml
   (contents, props changed)
   
development/main/central/site/src/docs/products/transit/technical/hosts/hosts.xml
   (contents, props changed)
   
development/main/central/site/src/docs/products/transit/technical/hosts/index.xml
   (contents, props changed)
   
development/main/central/site/src/docs/products/transit/technical/hosts/navigation.xml
   (contents, props changed)
   
development/main/central/site/src/docs/products/transit/technical/hosts/properties.xml
   (contents, props changed)
   
development/main/central/site/src/docs/products/transit/technical/launcher/cli.xml
   (contents, props changed)
   
development/main/central/site/src/docs/products/transit/technical/launcher/deployment.xml
   (contents, props changed)
   
development/main/central/site/src/docs/products/transit/technical/launcher/properties.xml
   (contents, props changed)
   development/main/central/site/src/docs/products/transit/technical/monitors/
   
development/main/central/site/src/docs/products/transit/technical/monitors/index.xml
   (contents, props changed)
   
development/main/central/site/src/docs/products/transit/technical/monitors/navigation.xml
   (contents, props changed)
   
development/main/central/site/src/docs/products/transit/technical/repository/
   
development/main/central/site/src/docs/products/transit/technical/repository/index.xml
   (contents, props changed)
   
development/main/central/site/src/docs/products/transit/technical/repository/navigation.xml
   (contents, props changed)
Removed:
   
development/main/central/site/src/docs/products/transit/overview/management.xml
   
development/main/central/site/src/docs/products/transit/overview/retrieval.xml
   development/main/central/site/src/docs/products/transit/technical/concepts/
   
development/main/central/site/src/docs/products/transit/technical/protocol.xml
   
development/main/central/site/src/docs/products/transit/technical/protocol/classic.xml
   development/main/central/site/src/docs/products/transit/technical/tasks/
Modified:
   development/main/central/site/src/docs/products/magic/antlib/navigation.xml
   development/main/central/site/src/docs/products/magic/tasks/reactor.xml
   development/main/central/site/src/docs/products/transit/index.xml
   development/main/central/site/src/docs/products/transit/navigation.xml
   
development/main/central/site/src/docs/products/transit/overview/classloading.xml
   development/main/central/site/src/docs/products/transit/overview/index.xml
   
development/main/central/site/src/docs/products/transit/overview/navigation.xml
   development/main/central/site/src/docs/products/transit/technical/index.xml
   
development/main/central/site/src/docs/products/transit/technical/launcher/index.xml
   
development/main/central/site/src/docs/products/transit/technical/launcher/navigation.xml
   
development/main/central/site/src/docs/products/transit/technical/navigation.xml
   
development/main/central/site/src/docs/products/transit/technical/properties/cache.xml
   
development/main/central/site/src/docs/products/transit/technical/properties/hosts.xml
   
development/main/central/site/src/docs/products/transit/technical/properties/runtime.xml
   
development/main/central/site/src/docs/products/transit/technical/protocol/navigation.xml
Log:
Restructure content to better separate overview material from specification 
material and imporove a bunch of spec related stuff.

Added: development/main/central/site/src/docs/products/magic/antlib/import.xml
==============================================================================
--- (empty file)
+++ development/main/central/site/src/docs/products/magic/antlib/import.xml   
  Mon Jan 10 15:40:05 2005
@@ -0,0 +1,27 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<document>
+
+  <properties>
+    <author email="mcconnell AT dpml.net">Stephen McConnell</author>
+    <title>DPML Magic</title>
+  </properties> 
+
+  <body>
+    <section name="Import Task">
+
+      <p>
+      The import task imports an ant template file from a supplied 
+      artifact uri.
+      </p>
+
+      <p><i>Example of a import request.</i></p>
+       
+<source><![CDATA[
+  <magic:import uri="artifact:template:dpml/magic/standard"/>
+]]></source>
+
+    </section>
+  </body>
+
+</document>
+

Modified: 
development/main/central/site/src/docs/products/magic/antlib/navigation.xml
==============================================================================
--- 
development/main/central/site/src/docs/products/magic/antlib/navigation.xml 
(original)
+++ 
development/main/central/site/src/docs/products/magic/antlib/navigation.xml 
Mon Jan 10 15:40:05 2005
@@ -27,6 +27,7 @@
     <menu>
       <item name="Init" href="init.html"/>
       <item name="Plugin" href="plugin.html"/>
+      <item name="Import" href="import.html"/>
     </menu>
 
  </body>

Modified: 
development/main/central/site/src/docs/products/magic/tasks/reactor.xml
==============================================================================
--- development/main/central/site/src/docs/products/magic/tasks/reactor.xml   
  (original)
+++ development/main/central/site/src/docs/products/magic/tasks/reactor.xml   
  Mon Jan 10 15:40:05 2005
@@ -29,66 +29,165 @@
 
       <p><i>
        Example output when invoking the reactor from the root 
-       avalon directory:</i></p>
+       dpml directory:</i></p>
 
 <pre>
 default:
 [x:reactor] Preparing build sequence.
 ------------------------------------------------------------------------
-[avalon/util/avalon-util-criteria]
-[avalon/logkit/avalon-logkit]
-[avalon/util/avalon-util-env]
-[avalon/util/avalon-util-defaults]
-[avalon/util/avalon-util-i18n]
-[avalon/util/avalon-util-exception]
-[avalon/repository/avalon-repository-api]
-[avalon/repository/avalon-repository-util]
-[avalon/repository/avalon-repository-spi]
-[avalon/repository/avalon-repository-main]
-[avalon/framework/avalon-framework-api]
-[avalon/framework/avalon-framework-legacy]
-[avalon/framework/avalon-framework-impl]
-[avalon/util/avalon-util-configuration]
-[avalon/meta/avalon-meta-api]
-[avalon/meta/avalon-meta-spi]
-[avalon/meta/avalon-meta-impl]
-[avalon/meta/avalon-meta-tools]
-[avalon/util/avalon-util-lifecycle]
-[avalon/test/avalon-test-playground]
-[avalon/test/avalon-test-components]
-[avalon/repository/avalon-repository-impl]
-[avalon/repository/avalon-repository-test]
-[avalon/logging/avalon-logging-api]
-[avalon/logging/avalon-logging-spi]
-[avalon/logging/avalon-logging-impl]
-[avalon/logging/avalon-logging-logkit-api]
-[avalon/logging/avalon-logging-logkit-datagram]
-[avalon/logging/avalon-logging-logkit-socket]
-[avalon/logging/avalon-logging-logkit-syslog]
-[avalon/logging/avalon-logging-log4j]
-[avalon/logging/avalon-logging-logkit-impl]
-[avalon/logging/avalon-logging-test]
-[avalon/test/avalon-test-teste]
-[avalon/test/avalon-test-testd]
-[avalon/test/avalon-test-testc]
-[avalon/test/avalon-test-testb]
-[avalon/test/avalon-test-testa]
-[avalon/test/avalon-test-includes]
-[avalon/test/avalon-test-dynamics]
-[avalon/util/avalon-util-extension-api]
-[avalon/util/avalon-util-extension-impl]
-[avalon/composition/avalon-composition-api]
-[avalon/composition/avalon-composition-spi]
-[avalon/composition/avalon-composition-impl]
-[avalon/activation/avalon-activation-api]
-[avalon/activation/avalon-activation-impl]
-[avalon/merlin/avalon-merlin-api]
-[avalon/merlin/avalon-merlin-impl]
-[avalon/merlin/avalon-merlin-cli]
-[avalon/runtime]
-[avalon/site]
-[avalon/repository/avalon-repository-cli]
-[avalon/tools/avalon-tools-magic]
+[artifact:jar:dpml/metro/public/dpml-service-api#SNAPSHOT]
+[artifact:jar:dpml/metro/public/dpml-configuration-api#SNAPSHOT]
+[artifact:jar:dpml/metro/public/dpml-parameters-api#SNAPSHOT]
+[artifact:jar:dpml/metro/private/dpml-parameters-impl#SNAPSHOT]
+[artifact:jar:dpml/metro/private/dpml-configuration-impl#SNAPSHOT]
+[artifact:jar:dpml/util/dpml-util-i18n#SNAPSHOT]
+[artifact:jar:dpml/metro/protected/dpml-meta-api#SNAPSHOT]
+[artifact:jar:dpml/metro/private/dpml-meta-spi#SNAPSHOT]
+[artifact:jar:dpml/metro/private/dpml-meta-impl#SNAPSHOT]
+[artifact:jar:dpml/metro/tools/dpml-meta-tools#SNAPSHOT]
+[artifact:jar:dpml/http/dpml-http-api#SNAPSHOT]
+[artifact:jar:dpml/http/dpml-http-util#SNAPSHOT]
+[artifact:jar:dpml/metro/public/dpml-logging-api#SNAPSHOT]
+[artifact:jar:dpml/central/dpml-tutorial-context-casting]
+[artifact:jar:dpml/transit/dpml-transit-main#SNAPSHOT]
+[artifact:jar:dpml/metro/protected/dpml-extension-api#SNAPSHOT]
+[artifact:jar:dpml/metro/protected/dpml-logging-data#SNAPSHOT]
+[artifact:jar:dpml/metro/public/dpml-context-api#SNAPSHOT]
+[artifact:jar:dpml/metro/protected/dpml-composition-api#SNAPSHOT]
+[artifact:jar:dpml/console/dpml-console-api#SNAPSHOT]
+[artifact:jar:dpml/console/dpml-console-commands#SNAPSHOT]
+[artifact:jar:dpml/util/dpml-util-cli#SNAPSHOT]
+[artifact:jar:dpml/util/dpml-util-exception#SNAPSHOT]
+[artifact:jar:dpml/util/dpml-util-criteria#SNAPSHOT]
+[artifact:jar:dpml/transit/dpml-transit-plugin#SNAPSHOT]
+[artifact:jar:dpml/transit/dpml-transit-installer#SNAPSHOT]
+[artifact:jar:dpml/http/dpml-http-spi#SNAPSHOT]
+[artifact:jar:dpml/metro/public/dpml-activity-api#SNAPSHOT]
+[artifact:jar:dpml/http/dpml-http-impl#SNAPSHOT]
+[artifact:block:dpml/http/dpml-http-tapestry#1.0]
+[artifact:jar:dpml/http/examples/hangman/hangman-api#2.0.0]
+[artifact:war:dpml/http/examples/hangman/hangman-view]
+[artifact:jar:dpml/http/examples/hangman/hangman-game#2.0.0]
+[artifact:block:dpml/http/examples/hangman/hangman-app#2.0.0]
+[artifact:jar:dpml/central/dpml-tutorial-config-defaults]
+[artifact:jar:dpml/db/dpml-db-api#SNAPSHOT]
+[artifact:jar:dpml/dbcp/dpml-dbcp-api#SNAPSHOT]
+[artifact:jar:dpml/dbcp/dpml-dbcp-impl#SNAPSHOT]
+[artifact:block:dpml/http/dpml-http-servlet#1.0]
+[artifact:jar:dpml/metro/private/dpml-system-api#SNAPSHOT]
+[artifact:jar:dpml/metro/private/dpml-logging-spi#SNAPSHOT]
+[artifact:jar:dpml/metro/private/dpml-logging-logkit-api#SNAPSHOT]
+[artifact:jar:dpml/metro/private/dpml-util-defaults#SNAPSHOT]
+[artifact:jar:dpml/metro/private/dpml-logging-criteria#SNAPSHOT]
+[artifact:jar:dpml/metro/private/dpml-logging-logkit-impl#SNAPSHOT]
+[artifact:jar:dpml/metro/private/dpml-logging-logkit-datagram#SNAPSHOT]
+[artifact:jar:dpml/metro/private/dpml-logging-logkit-syslog#SNAPSHOT]
+[artifact:jar:dpml/metro/private/dpml-logging-log4j#SNAPSHOT]
+[artifact:jar:dpml/metro/private/dpml-context-impl#SNAPSHOT]
+[artifact:jar:dpml/test/dpml-test-playground]
+[artifact:jar:dpml/metro/private/dpml-system-spi#SNAPSHOT]
+[artifact:jar:dpml/metro/private/dpml-system-impl#SNAPSHOT]
+[artifact:jar:dpml/metro/private/dpml-composition-spi#SNAPSHOT]
+[artifact:jar:dpml/metro/private/dpml-activation-api#SNAPSHOT]
+[artifact:jar:dpml/metro/private/dpml-activation-avalon-provider#SNAPSHOT]
+[artifact:jar:dpml/metro/private/dpml-activation-metro-provider#SNAPSHOT]
+[artifact:jar:dpml/metro/private/dpml-activation-impl#SNAPSHOT]
+[artifact:jar:dpml/metro/private/dpml-extension-impl#SNAPSHOT]
+[artifact:jar:dpml/metro/private/dpml-composition-impl#SNAPSHOT]
+[artifact:jar:dpml/central/dpml-tutorial-config-injection]
+[artifact:block:dpml/central/dpml-tutorial-config-override]
+[artifact:jar:dpml/central/dpml-tutorial-selection]
+[artifact:jar:dpml/magic/dpml-magic-bootstrap#SNAPSHOT]
+[artifact:jar:dpml/reflector/dpml-reflector-api#SNAPSHOT]
+[artifact:jar:dpml/reflector/dpml-reflector-spi#SNAPSHOT]
+[artifact:jar:dpml/reflector/dpml-reflector-typehandlers#SNAPSHOT]
+[artifact:jar:dpml/central/dpml-tutorial-publisher-api]
+[artifact:jar:dpml/central/dpml-tutorial-publisher-impl]
+[artifact:jar:dpml/central/dpml-tutorial-context-phased]
+[artifact:jar:dpml/jms/dpml-jms-api#SNAPSHOT]
+[artifact:jar:dpml/central/dpml-tutorial-config-block]
+[artifact:jar:dpml/central/dpml-tutorial-dependency-manual]
+[artifact:jar:dpml/jms/dpml-jms-impl#SNAPSHOT]
+[artifact:jar:dpml/jms/dpml-jms-test]
+[artifact:jar:dpml/magic/dpml-magic-core#SNAPSHOT]
+[artifact:jar:dpml/magic/dpml-magic-upload#SNAPSHOT]
+[artifact:jar:dpml/test/dpml-test-testa]
+[artifact:jar:dpml/test/dpml-test-teste]
+[artifact:jar:dpml/test/dpml-test-testd]
+[artifact:jar:dpml/test/dpml-test-testb]
+[artifact:jar:dpml/test/dpml-test-testc]
+[artifact:jar:dpml/test/dpml-test-includes]
+[artifact:jar:dpml/central/dpml-tutorial-dynamics]
+[artifact:jar:dpml/central/dpml-tutorial-dependency-auto]
+[artifact:block:dpml/http/dpml-http-webappserver#1.0]
+[artifact:block:dpml/http/dpml-http-static#1.0]
+[artifact:jar:dpml/magic/dpml-magic-doc#SNAPSHOT]
+[artifact:theme:dpml/magic/dpml-magic-themes-modern]
+[artifact:jar:dpml/test/dpml-test-testschema]
+[artifact:jar:dpml/test/dpml-test-dynamics]
+[artifact:jar:dpml/test/dpml-test-testcyclic]
+[artifact:jar:dpml/test/dpml-composition-test#SNAPSHOT]
+[artifact:jar:dpml/test/dpml-magic-example#SNAPSHOT]
+[artifact:jar:dpml/magic/dpml-magic-bar#SNAPSHOT]
+[artifact:jar:dpml/magic/dpml-magic-publish#SNAPSHOT]
+[artifact:meta:dpml/test/dpml-magic-test#SNAPSHOT]
+[artifact:jar:dpml/metro/tools/dpml-metro-unit#SNAPSHOT]
+[artifact:jar:dpml/central/dpml-tutorial-hello]
+[artifact:block:dpml/http/dpml-http-hash-basic#1.0]
+[artifact:jar:dpml/central/dpml-tutorial-location-api]
+[artifact:jar:dpml/central/dpml-tutorial-profiles]
+[artifact:jar:dpml/tutorial/dpml-transit-tutorial-artifact]
+[artifact:jar:dpml/finder/dpml-finder-api#SNAPSHOT]
+[artifact:jar:dpml/test/dpml-test-components]
+[artifact:jar:dpml/console/dpml-console-impl#SNAPSHOT]
+[artifact:jar:dpml/reflector/dpml-reflector-impl#SNAPSHOT]
+[artifact:block:dpml/reflector/dpml-reflector-blocks-standard#SNAPSHOT]
+[artifact:jar:dpml/jmx/dpml-jmx-util#SNAPSHOT]
+[artifact:jar:dpml/jmx/dpml-jmx-api#SNAPSHOT]
+[artifact:jar:dpml/jmx/dpml-jmx-spi#SNAPSHOT]
+[artifact:jar:dpml/jmx/dpml-jmx-mx4j#SNAPSHOT]
+[artifact:block:dpml/http/dpml-http-server#1.0]
+[artifact:jar:dpml/magic/dpml-magic-style#SNAPSHOT]
+[artifact:jar:dpml/magic/dpml-magic-checkstyle#SNAPSHOT]
+[artifact:module:dpml/util/dpml-util#SNAPSHOT]
+[artifact:jar:dpml/magic/dpml-magic-eclipse#SNAPSHOT]
+[artifact:module:dpml/transit/dpml-transit#SNAPSHOT]
+[artifact:theme:dpml/magic/dpml-magic-themes-docbook.sf.net]
+[artifact:module:dpml/magic/dpml-magic#SNAPSHOT]
+[artifact:jar:dpml/jmx/dpml-jmx-handler#SNAPSHOT]
+[artifact:jar:dpml/jmx/dpml-jmx-test]
+[artifact:jar:dpml/central/dpml-tutorial-main]
+[artifact:jar:dpml/tutorial/dpml-transit-tutorial-plugin-cli]
+[artifact:jar:dpml/tutorial/dpml-transit-tutorial-plugin-controller]
+[artifact:jar:dpml/central/dpml-tutorial-parameters]
+[artifact:jar:dpml/test/dpml-system-test#SNAPSHOT]
+[artifact:jar:dpml/finder/dpml-finder-impl#SNAPSHOT]
+[artifact:jar:dpml/metro/private/dpml-logging-logkit-socket#SNAPSHOT]
+[artifact:jar:dpml/test/dpml-logging-logkit-test#SNAPSHOT]
+[artifact:jar:dpml/central/dpml-tutorial-location-impl]
+[artifact:jar:dpml/central/dpml-tutorial-application-impl]
+[artifact:jar:dpml/http/dpml-http-test]
+[artifact:jar:dpml/test/dpml-logging-log4j-test#SNAPSHOT]
+[artifact:jar:dpml/metro/tools/dpml-metro-main#SNAPSHOT]
+[artifact:module:dpml/metro/dpml-metro#SNAPSHOT]
+[artifact:jar:dpml/central/dpml-tutorial-context-injection]
+[artifact:jar:dpml/central/dpml-tutorial-context-custom]
+[artifact:doc:dpml/central/dpml-central-site]
+[artifact:jar:dpml/central/dpml-tutorial-context-alias]
+[artifact:jar:dpml/central/dpml-tutorial-lifecycle-modern]
+[artifact:module:dpml/central/dpml-central#SNAPSHOT]
+[artifact:block:dpml/http/dpml-http-hash-form#1.0]
+[artifact:block:dpml/console/dpml-console-default#SNAPSHOT]
+[artifact:jar:dpml/tutorial/dpml-transit-tutorial-plugin-simple]
+[artifact:jar:dpml/http/examples/hello/dpml-http-hello#2.0.0]
+[artifact:block:dpml/http/dpml-http-hash-clientcert#1.0]
+[artifact:block:dpml/http/dpml-http-hash-digest#1.0]
+[artifact:block:dpml/http/dpml-http-context#1.0]
+[artifact:module:dpml/http/dpml-http#SNAPSHOT]
+[artifact:block:dpml/reflector/dpml-reflector-blocks-complete#SNAPSHOT]
+[artifact:jar:dpml/db/dpml-db-hsql#SNAPSHOT]
+[artifact:jar:dpml/tutorial/dpml-transit-tutorial-extension]
+[artifact:jar:dpml/test/dpml-activation-test#SNAPSHOT]
 
 ....
 

Modified: development/main/central/site/src/docs/products/transit/index.xml
==============================================================================
--- development/main/central/site/src/docs/products/transit/index.xml   
(original)
+++ development/main/central/site/src/docs/products/transit/index.xml   Mon 
Jan 10 15:40:05 2005
@@ -25,7 +25,7 @@
     <author email="mcconnell AT dpml.net">Stephen McConnell</author>
     <author email="niclas AT hedhman.org">Niclas Hedhman</author>
     <author email="david.leangen AT konova.com">David Leangen</author>
-    <title>DPML Products</title>
+    <title>DPML Transit</title>
   </properties> 
 
   <body>

Modified: 
development/main/central/site/src/docs/products/transit/navigation.xml
==============================================================================
--- development/main/central/site/src/docs/products/transit/navigation.xml    
  (original)
+++ development/main/central/site/src/docs/products/transit/navigation.xml    
  Mon Jan 10 15:40:05 2005
@@ -21,12 +21,12 @@
 
 <project>
 
- <title>Transit</title>
+ <title>DPML Transit</title>
 
  <body>
 
     <menu>
-      <item name="Product Overview" href="index.html"/>
+      <item name="Product Overview" href="overview/index.html"/>
       <item name="Product Specifications" href="technical/index.html"/>
     </menu>
 

Added: 
development/main/central/site/src/docs/products/transit/overview/artifact.xml
==============================================================================
--- (empty file)
+++ 
development/main/central/site/src/docs/products/transit/overview/artifact.xml 
      Mon Jan 10 15:40:05 2005
@@ -0,0 +1,33 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+
+<document>
+  <properties>
+    <author email="mcconnell AT dpml.net">Stephen McConnell</author>
+    <contributor email="dleangen AT dpml.net">David Leangen</contributor>
+    <title>DPML Transit</title>
+  </properties> 
+
+  <body>
+    <section name="Dynamic Artifact Retrieval">
+
+      <p>
+        An artifact is a resource identified by an 
+        artifact uri. The Artifact 
+        <a href="../technical/protocol/index.html">protocol 
specification</a> 
+        describe a resource type, group, name, and resource version. These 
+        identifiers dissassociate the definition of an application from 
+        the source of the resources needed to build and deploy the 
+        application.
+      </p>
+       
+      <p>
+        The following example artifact uri identifies a resource named 
+        'dpml-http-server' associated with the 'dpml/http' group, a 
+        resource type called 'block' and a version value of 1024.
+      </p>
+       
+      <source>artifact:block:dpml/http/dpml-http-server#1024</source>
+
+    </section>
+  </body>
+</document>

Modified: 
development/main/central/site/src/docs/products/transit/overview/classloading.xml
==============================================================================
--- 
development/main/central/site/src/docs/products/transit/overview/classloading.xml
   (original)
+++ 
development/main/central/site/src/docs/products/transit/overview/classloading.xml
   Mon Jan 10 15:40:05 2005
@@ -25,45 +25,52 @@
     <author email="mcconnell AT dpml.net">Stephen McConnell</author>
     <author email="niclas AT hedhman.org">Niclas Hedhman</author>
     <author email="david.leangen AT konova.com">David Leangen</author>
-    <title>DPML Products</title>
+    <title>DPML Transit</title>
   </properties> 
 
   <body>
-    <section name="Transit Resource Management System">
+    <section name="Classloader Construction">
 
-      <subsection name="Features and Benefits">
-
-      <p>
-        The core of the Transit product is a URL protocol handler which 
serves as
-        the basic construct on which classloader management in provided.  
The classloader
-        creation services provide the framework with a simple plugin 
framework.
-      </p>
-
-      <p>
-        Key features of the Transit system include:
-      </p>
-
-      <ol>
-        <li>high level of integration with the JVM</li>
-        <li>simple configuration model</li>
-        <li>small footprint</li>
-        <li>flexible event monitoring</li>
-      </ol>
-
-      <p>
-        Key benefits delivered by Transit include:
-      </p>
-
-      <ol>
-        <li>cost reduction on product deployment and upgrade</li>
-        <li>reduced risk though improved control over version management</li>
-        <li>improved quality through reduction in class conflicts</li>
-
-        <li>improved security through repository management</li>
-        <li>low maintenance though centralized configuration</li>
-      </ol>
-
-      </subsection>
+        <p>
+        Layered above the Transit artifact handler is a system that provides
+        support for the creation of classloaders.  Classloaders are described
+        under a 'meta' file which is basically a list of artifact uris.  The
+        meta file is itself normally referenced as an artifact which means 
+        that the list is itself versioned, named, associated with a group, 
and 
+        dynamically resolvable.
+        </p>
+
+        <p><i>Example classloader descriptor artifact uri:</i></p>
+
+        <code>@METRO-PLUGIN-URI@</code>
+
+        <p>
+        The meta file declares api, spi and implementation jar files in 
+        the form of artifact uris.  Transit uses this infomation to 
+        construct a classloader chain.
+        </p>
+
+        <img src="/images/transit/chain.png"/>
+
+        <p>
+        Meta files use a simple property file format to declare features of 
+        of the classloader, including information used when resolving 
plugins.
+        This information is normally created automatically using the 
+        <a href="/products/magic/tasks/export.html">Export Task</a> from the 
+        <a href="/products/magic/index.html">Magic</a> build system.
+        </p>
+
+        <p>
+        The following code fragment demonstrates the relativly simple 
process of 
+        creating a new classloader using Transit.
+        </p>
+
+<source>
+Repository repository = new StandardLoader();
+ClassLoader parent = getClass().getClassLoader();
+URI uri = new URI( "artifact:meta:dpml/examples/hello/hello-world#1.0.0" );
+ClassLoader classloader = repository.getClassloader( parent, uri );
+</source>
 
     </section>
   </body>

Added: 
development/main/central/site/src/docs/products/transit/overview/features.xml
==============================================================================
--- (empty file)
+++ 
development/main/central/site/src/docs/products/transit/overview/features.xml 
      Mon Jan 10 15:40:05 2005
@@ -0,0 +1,66 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+
+<!-- 
+ Copyright 2005 David Leangen
+ Copyright 2004 Stephen McConnell
+ Copyright 2004 Niclas Hedhman
+
+ Licensed  under the  Apache License,  Version 2.0  (the "License");
+ you may not use  this file  except in  compliance with the License.
+ You may obtain a copy of the License at 
+ 
+   http://www.dpml.net/central/about/legal/
+ 
+ Unless required by applicable law or agreed to in writing, software
+ distributed  under the  License is distributed on an "AS IS" BASIS,
+ WITHOUT  WARRANTIES OR CONDITIONS  OF ANY KIND, either  express  or
+ implied.
+ 
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+
+<document verified="false">
+  <properties>
+    <author email="mcconnell AT dpml.net">Stephen McConnell</author>
+    <author email="niclas AT hedhman.org">Niclas Hedhman</author>
+    <author email="david.leangen AT konova.com">David Leangen</author>
+    <title>DPML Transit</title>
+  </properties> 
+
+  <body>
+    <section name="Features and Benefits">
+
+      <p>
+        The core of the Transit product is a URL protocol handler which 
serves as
+        the basic construct on which classloader management in provided.  
The classloader
+        creation services provide the framework with a simple plugin 
framework.
+      </p>
+
+      <p>
+        Key features of the Transit system include:
+      </p>
+
+      <ol>
+        <li>high level of integration with the JVM</li>
+        <li>simple configuration model</li>
+        <li>small footprint</li>
+        <li>flexible event monitoring</li>
+      </ol>
+
+      <p>
+        Key benefits delivered by Transit include:
+      </p>
+
+      <ol>
+        <li>cost reduction on product deployment and upgrade</li>
+        <li>reduced risk though improved control over version management</li>
+        <li>improved quality through reduction in class conflicts</li>
+
+        <li>improved security through repository management</li>
+        <li>low maintenance though centralized configuration</li>
+      </ol>
+
+    </section>
+  </body>
+</document>

Modified: 
development/main/central/site/src/docs/products/transit/overview/index.xml
==============================================================================
--- 
development/main/central/site/src/docs/products/transit/overview/index.xml  
(original)
+++ 
development/main/central/site/src/docs/products/transit/overview/index.xml  
Mon Jan 10 15:40:05 2005
@@ -25,46 +25,63 @@
     <author email="mcconnell AT dpml.net">Stephen McConnell</author>
     <author email="niclas AT hedhman.org">Niclas Hedhman</author>
     <author email="david.leangen AT konova.com">David Leangen</author>
-    <title>DPML Products</title>
+    <title>DPML Transit</title>
   </properties> 
 
   <body>
-    <section name="Transit Resource Management System">
+
+    <section name="Product Overview">
+
+      <subsection name="Repository Enabled">
+
+        <p>
+        A repository enabled application is an application the leverages a 
local 
+        cache of artifacts backed by a formal repository model.
+        Transit is the system infrastructure that provides support for 
artifact 
+        identification, <a href="artifact.html">retrieval</a>, and related 
+        application functions including 
+        <a href="classloading.html">classloader</a> construction and 
+        <a href="plugins.html">plugin</a> management required by repository 
+        enabled solutions.
+        </p>
+
+      </subsection>
 
       <subsection name="Features and Benefits">
 
-      <p>
+        <p>
         The core of the Transit product is a URL protocol handler which 
serves as
         the basic construct on which classloader management in provided.  
The classloader
         creation services provide the framework with a simple plugin 
framework.
-      </p>
+        </p>
 
-      <p>
+        <p>
         Key features of the Transit system include:
-      </p>
+        </p>
 
-      <ol>
+        <ol>
         <li>high level of integration with the JVM</li>
         <li>simple configuration model</li>
         <li>small footprint</li>
         <li>flexible event monitoring</li>
-      </ol>
+        </ol>
 
-      <p>
+        <p>
         Key benefits delivered by Transit include:
-      </p>
+        </p>
 
-      <ol>
+        <ol>
         <li>cost reduction on product deployment and upgrade</li>
         <li>reduced risk though improved control over version management</li>
         <li>improved quality through reduction in class conflicts</li>
 
         <li>improved security through repository management</li>
         <li>low maintenance though centralized configuration</li>
-      </ol>
+        </ol>
 
       </subsection>
 
     </section>
+
   </body>
 </document>

Modified: 
development/main/central/site/src/docs/products/transit/overview/navigation.xml
==============================================================================
--- 
development/main/central/site/src/docs/products/transit/overview/navigation.xml
     (original)
+++ 
development/main/central/site/src/docs/products/transit/overview/navigation.xml
     Mon Jan 10 15:40:05 2005
@@ -26,10 +26,16 @@
  <body>
 
     <menu>
-      <item name="Features and Benefits" href="index.html"/>
+
+      <!--
+      <item name="Features and Benefits" href="features.html"/>
       <item name="Dynamic Retrieval" href="retrieval.html"/>
+      -->
+
+      <item name="Dynamic Retrieval" href="artifact.html"/>
       <item name="Classloader Construction" href="classloading.html"/>
-      <item name="Plugin Management" href="management.html"/>
+      <item name="Plugin Management" href="plugins.html"/>
+
     </menu>
 
  </body>

Added: 
development/main/central/site/src/docs/products/transit/overview/plugins.xml
==============================================================================
--- (empty file)
+++ 
development/main/central/site/src/docs/products/transit/overview/plugins.xml  
      Mon Jan 10 15:40:05 2005
@@ -0,0 +1,51 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+
+<document>
+  <properties>
+    <author email="mcconnell AT dpml.net">Stephen McConnell</author>
+    <contributor email="dleangen AT dpml.net">David Leangen</contributor>
+    <title>DPML Transit</title>
+  </properties> 
+
+  <body>
+    <section name="Plugin Management">
+      
+        <p>
+        In addition to the structural classloader information - the meta file
+        may contain the declaration of a main class or and antlib resource 
and 
+        namespace. The antlib information is a special case used within the 
+        Magic build system to support dynamic task loading.  The main class 
+        declaration is the entry point for classic plugin class loading 
relative
+        to the established classloader.
+        </p>
+
+        <p>
+        The Transit repository service provides support for class creation 
and 
+        object instantiation.  Class creation is typically used by 
applications
+        that handle a particular semantics concerning a plugin model whereas 
+        the Tranit object instantiation provides a simple but flexible model 
+        suitable for control over selectable sub-system strategies (e.g. the 
+        loading of a logging system or application runtime).
+        </p>
+
+        <p>
+        The following code fragment demonstrates the creation of a plugin 
instance
+        using Transit's standard plugin loader.
+        </p>
+
+<source>
+  Repository repository = new StandardLoader();
+  ClassLoader parent = getClass().getClassLoader();
+  URI uri = new URI( "artifact:meta:dpml/examples/hello/hello-world#1.0.0" );
+  Object[] args = new Object[] { "Hello, World!" };
+  Object plugin = repository.getPlugin( parent, uri, args );
+</source>
+
+        <p>
+        Example of plugin loading and general plugin handling is provided 
+        under the <a href="/guide/transit/plugins/index.html">Transit 
Guide</a>.
+        </p>
+
+    </section>
+  </body>
+</document>

Added: 
development/main/central/site/src/docs/products/transit/technical/cache/index.xml
==============================================================================
--- (empty file)
+++ 
development/main/central/site/src/docs/products/transit/technical/cache/index.xml
   Mon Jan 10 15:40:05 2005
@@ -0,0 +1,34 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+
+<document>
+  <properties>
+    <author email="mcconnell AT dpml.net">Stephen McConnell</author>
+    <contributor email="dleangen AT dpml.net">David Leangen</contributor>
+    <title>DPML Transit</title>
+  </properties> 
+
+  <body>
+    <section name="Cache Management">
+
+      <p>
+      Resource are retrieved from one or more 
+      <a href="../hosts/index.html">host</a> repositories 
+      and maintained under a local cache.  The default location of 
+      the cache is <code>${dpml.home}/cache</code> where the value of 
+      <code>${dpml.home}</code> is either declared explicity via 
+      the <code>DPML_HOME</code> environment variable or the 
+      fallback default location <code>${user.home}/.dpml</code>.
+      </p>
+
+      <p>
+      Please see the <a href="/guide/setup/dpml.html">environment 
+      setup guide</a> for additional information concerning the 
+      declaration of the DPML_HOME and PATH environment variables.
+      The <a href="properties.html">cache properties</a> 
+      page provides additional information concerning cache location
+      management and mechanism supporting cache controller customization.
+      </p>
+
+    </section>
+  </body>
+</document>

Added: 
development/main/central/site/src/docs/products/transit/technical/cache/navigation.xml
==============================================================================
--- (empty file)
+++ 
development/main/central/site/src/docs/products/transit/technical/cache/navigation.xml
      Mon Jan 10 15:40:05 2005
@@ -0,0 +1,33 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- 
+ Copyright 2004 Stephen McConnell
+ Copyright 2004 Niclas Hedhman
+
+ Licensed  under the  Apache License,  Version 2.0  (the "License");
+ you may not use  this file  except in  compliance with the License.
+ You may obtain a copy of the License at 
+ 
+   http://www.dpml.net/central/about/legal/
+ 
+ Unless required by applicable law or agreed to in writing, software
+ distributed  under the  License is distributed on an "AS IS" BASIS,
+ WITHOUT  WARRANTIES OR CONDITIONS  OF ANY KIND, either  express  or
+ implied.
+ 
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+
+<project>
+
+ <title>Transit</title>
+
+ <body>
+
+    <menu>
+      <item name="Cache Properties" href="properties.html"/>
+    </menu>
+
+ </body>
+
+</project>

Added: 
development/main/central/site/src/docs/products/transit/technical/cache/properties.xml
==============================================================================
--- (empty file)
+++ 
development/main/central/site/src/docs/products/transit/technical/cache/properties.xml
      Mon Jan 10 15:40:05 2005
@@ -0,0 +1,80 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- 
+ Copyright 2004 Niclas Hedhman
+ Copyright 2005 David Leangen
+
+ Licensed  under the  Apache License,  Version 2.0  (the "License");
+ you may not use  this file  except in  compliance with the License.
+ You may obtain a copy of the License at 
+ 
+   http://www.dpml.net/central/about/legal/
+ 
+ Unless required by applicable law or agreed to in writing, software
+ distributed  under the  License is distributed on an "AS IS" BASIS,
+ WITHOUT  WARRANTIES OR CONDITIONS  OF ANY KIND, either  express  or
+ implied.
+ 
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+
+<document verified="false">
+  <properties>
+    <author email="niclas AT hedhman.org">Niclas Hedhman</author>
+    <author email="david.leangen AT konova.com">David Leangen</author>
+    <title>DPML Transit</title>
+  </properties> 
+
+  <body>
+    <section name="Cache Properties">
+      <p>
+        The transit system stores the downloaded resources
+        on your local file system. The cache provides DPML-enabled 
+        applications with quickly retrieval of required resources.
+      </p>
+      
+      <p>
+        When requested by your application, a cache manager will first 
+        check the local cache for the required resource.
+        If the resource is not available in the local cache, the cache 
manager
+        will then query each remote repository defined under the 
+        <a href="../hosts/index.html">host configuration</a> until the 
+        resource is resolved.
+      </p>
+      
+      <p>
+        Requests to remote repositories are conducted sequentially in order 
of
+        priority, with the highest priority value queried first.
+      </p>
+      
+      <subsection name="Properties" >
+        <table>
+          <tr>
+            <th>Property</th>
+            <th>Default Value</th>
+            <th>Description</th>
+          </tr>
+          <tr>
+            <td>dpml.transit.cache.location</td>
+            <td><code>${dpml.home}/cache</code></td>
+            <td>The location of the cache system.</td>
+          </tr>
+          <tr>
+            <td>dpml.transit.cache.class</td>
+            <td>
+              <a 
href="../../../../../@TRANSIT-DOCS-PATH@/net/dpml/transit/artifact/CacheHandler.html">
+                <code>FileCacheHandler</code>
+              </a>
+            </td>
+            <td>
+              The class that implements the cache handler interface.
+            </td>
+          </tr>
+        </table>
+      </subsection>
+    </section>
+  </body>
+</document>
+
+ 
+ 

Added: 
development/main/central/site/src/docs/products/transit/technical/hosts/authorative.xml
==============================================================================
--- (empty file)
+++ 
development/main/central/site/src/docs/products/transit/technical/hosts/authorative.xml
     Mon Jan 10 15:40:05 2005
@@ -0,0 +1,172 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- 
+ Copyright 2004 Niclas Hedhman
+
+ Licensed  under the  Apache License,  Version 2.0  (the "License");
+ you may not use  this file  except in  compliance with the License.
+ You may obtain a copy of the License at 
+ 
+   http://www.dpml.net/central/about/legal/
+ 
+ Unless required by applicable law or agreed to in writing, software
+ distributed  under the  License is distributed on an "AS IS" BASIS,
+ WITHOUT  WARRANTIES OR CONDITIONS  OF ANY KIND, either  express  or
+ implied.
+ 
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+
+<document>
+  <properties>
+    <author email="niclas AT hedhman.org">Niclas Hedhman</author>
+    <title>DPML Transit</title>
+  </properties> 
+
+  <body>
+
+      <section name="Authorative Host">
+
+        <p>
+        The Transit system may be configured locally or remotely depending on
+        the value of the "dpml.transit.authority" property.  The property 
identifies
+        a remote or local path to the authorative configuration and is held 
within a 
+        file of the same name.
+        </p>
+
+        <p>Search sequence:</p>
+
+        <ol>
+        <li><code>${java.ext.dirs}/dpml.transit.authority</code></li>
+        <li><code>${dpml.home}/transit/dpml.transit.authority</code></li>
+        </ol>
+
+        <p>
+          In the "dpml.transit.authority" file, a single property 
+          "dpml.transit.authority" is resolved to a URL of the 
+          Authorative Host. If no protocol is given, it is assumed to be a
+          directory in the local file system relative to
+          <i>${dpml.home}/transit</i>.
+        </p>
+
+        <p>Default contents of dpml.transit.authority file:</p>
+
+<source>
+dpml.transit.authority=authority/
+</source>
+
+        <p>The default value of the above is equivalent to:</p>
+
+<pre>
+  ${dpml.home}/transit/authority/
+</pre>
+
+        <p>
+          The configuration of available hosts is contained in the file:
+        </p>
+<pre>
+  ${dpml.transit.authority}/hosts.xml
+</pre>
+
+        <p>
+          Transit will also look for property based host descriptors.  If the
+          value of ${dpml.transit.authority} is a file url host properties 
files 
+          will be resolved relative to the following path:
+        </p>
+
+<pre>
+  ${dpml.transit.authority}/hosts/*.*
+</pre>
+        <p>
+          All files found in the hosts/ directory will be read one by one.
+          The priority property will determine in which order the hosts are
+          queried for artifacts.
+        </p>
+        <p>
+          If the location is a remote URL, it will read the file 
+          "index.lst" at that location. "index.lst" must contain a line 
+          separated list of files that can be read at the location, 
containing
+          the resource host defintions.
+        </p>
+      
+      <!--
+      <subsection name="Properties" >
+        <p>
+          The following properties must be located in the file authorative 
host
+          configuration file, default file location is 
+          ${dpml.home}/transit/authority/transit.conf
+        </p>
+        <table>
+          <tr>
+            <th>Property</th>
+            <th>Default Value</th>
+            <th>Description</th>
+            <th>Note</th>
+          </tr>
+          <tr>
+            <td>dpml.transit.authority.checksum.required</td>
+            <td>false</td>
+            <td>
+              If true, artifacts that doesn't have a valid checksum will not 
be
+              loaded.
+            </td>
+            <td><strong>Not Implemented.</strong></td>
+          </tr>
+          <tr>
+            <td>dpml.authority.checksum.from.trusted</td>
+            <td>true</td>
+            <td>
+              If true, checksums will only be downloaded from the trusted 
+              repository hosts. This increases the security against spoofed
+              codebases, by ensuring that the checksum of trusted host 
matches
+              the downloaded artifact from the non-trusted host. NOTE! It is
+              still possible (although difficult) to create a codebase 
artifact
+              with a matching checksum, so for better security, please use
+              signed codebases and a web of trust or a CA.
+            </td>
+            <td><strong>Not Implemented.</strong></td>
+          </tr>
+          <tr>
+            <td>dpml.transit.authority.signature.required</td>
+            <td>false</td>
+            <td>
+              If true, artifacts must be signed or the artifact will not 
+              be loaded. PGP signatures is the default requirement, but
+              other signature system should be supported in the future. 
+              Signatures increases the trust level by many magnitudes. By 
+              installing signed keys it is fairly easy to establish a web of
+              trust, without spending money on expensive certificates.
+            </td>
+            <td><strong>Not Implemented.</strong></td>
+          </tr>
+          <tr>
+            <td>dpml.transit.authority.signature.anonymous.allow</td>
+            <td>false</td>
+            <td>
+              If true, anonymous signatures will be allowed. Anonymous 
+              signatures are those that does not belong in the web of trust
+              nor lead to a known CA.
+            </td>
+            <td><strong>Not Implemented.</strong></td>
+          </tr>
+          <tr>
+            <td>dpml.transit.authority.signature.from.trusted</td>
+            <td>true</td>
+            <td>
+              If true, signatures will only be downloaded from the trusted 
+              repository hosts. This increases the security, especially if
+              anonymous signatures are allowed, to ensure that code bases 
are 
+              not spoofed.
+            </td>
+            <td><strong>Not Implemented.</strong></td>
+          </tr>
+        </table>
+      </subsection>
+      -->
+
+    </section>
+  </body>
+</document>
+
+ 
+ 

Added: 
development/main/central/site/src/docs/products/transit/technical/hosts/classic.xml
==============================================================================
--- (empty file)
+++ 
development/main/central/site/src/docs/products/transit/technical/hosts/classic.xml
 Mon Jan 10 15:40:05 2005
@@ -0,0 +1,84 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- 
+ Copyright 2004 Niclas Hedhman
+
+ Licensed  under the  Apache License,  Version 2.0  (the "License");
+ you may not use  this file  except in  compliance with the License.
+ You may obtain a copy of the License at 
+ 
+   http://www.dpml.net/central/about/legal/
+ 
+ Unless required by applicable law or agreed to in writing, software
+ distributed  under the  License is distributed on an "AS IS" BASIS,
+ WITHOUT  WARRANTIES OR CONDITIONS  OF ANY KIND, either  express  or
+ implied.
+ 
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+
+<document>
+  <properties>
+    <author email="niclas AT hedhman.org">Niclas Hedhman</author>
+    <title>DPML Transit</title>
+  </properties> 
+
+  <body>
+    <section name="Resource Host - Classic Layout">
+      <p>
+        The Classic resource host management model is based on the 
+        conventions popularized by the maven platform and subsequently used
+        within the Apache Software Foundation as a format for repository
+        layout.  The Classic layout can be viewed as a super-set of the 
+        Maven model in that Transit implementation fully supports unlimited
+        group segmentation.
+      </p>
+      <subsection name="Resolution">
+        <p>
+          The official format for the artifact protocol is as follows;
+        </p>
+<source> artifact:[type]:[group]/[name]#version </source>
+        <p>
+          which for Classic resource hosts will be translated into;
+        </p>
+<source> [resourcehost]/[group]/[type]s/[name]-[version].[type] </source>
+        <p>
+          where,
+        </p>
+        <table>
+          <tr>
+            <td>type</td>
+            <td>
+              The type of the resource.
+            </td>
+          </tr>
+          <tr>
+            <td>group</td>
+            <td>
+              The group the resource belongs to. Slashes in the group are 
+              allowed and denotes subgrouping.
+            </td>
+          </tr>
+          <tr>
+            <td>name</td>
+            <td>
+              The name of the resource.
+            </td>
+          </tr>
+          <tr>
+            <td>version</td>
+            <td>
+              The version of the resource. The version is an opaque string
+              in the current Classic resource host implementation, but may
+              evolve in the future, and known version formats should be used
+              for maximum future compatibility.
+            </td>
+          </tr>
+        </table>
+      </subsection>
+    </section>
+  </body>
+</document>
+
+ 
+ 

Added: 
development/main/central/site/src/docs/products/transit/technical/hosts/hosts.xml
==============================================================================
--- (empty file)
+++ 
development/main/central/site/src/docs/products/transit/technical/hosts/hosts.xml
   Mon Jan 10 15:40:05 2005
@@ -0,0 +1,105 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- 
+ Copyright 2004 Niclas Hedhman
+
+ Licensed  under the  Apache License,  Version 2.0  (the "License");
+ you may not use  this file  except in  compliance with the License.
+ You may obtain a copy of the License at 
+ 
+   http://www.dpml.net/central/about/legal/
+ 
+ Unless required by applicable law or agreed to in writing, software
+ distributed  under the  License is distributed on an "AS IS" BASIS,
+ WITHOUT  WARRANTIES OR CONDITIONS  OF ANY KIND, either  express  or
+ implied.
+ 
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+
+<document>
+  <properties>
+    <author email="niclas AT hedhman.org">Niclas Hedhman</author>
+    <title>DPML Transit</title>
+  </properties> 
+
+  <body>
+    <section name="Hosts Configuration">
+
+      <p>
+        A Resource Host is a place where Artifacts can be downloaded. Transit
+        is capable of handling many types of resource hosts. Conceptually, 
you
+        only need to implement the 
+        <code><a 
href="../../../../../@TRANSIT-DOCS-PATH@/net/dpml/transit/artifact/ResourceHost.html">
+        net.dpml.transit.artifact.ResourceHost</a></code> interface, and 
+        specify the implementation class of the host handler.
+      </p>
+
+      <p>
+        Resource hosts may be declared via XML (default) or property files.
+      </p>
+
+      <subsection name="XML Specification">
+
+      <p>
+        The hosts configuation files when full expanded contains multiple 
&lt;host&gt; 
+        element entries.  The following example shows a host element with 
all 
+        elements declared:
+      </p>
+
+<source><![CDATA[
+<hosts>
+
+  <host href="http://www.dpml.net"; enabled="true">
+    <priority>20</priority>
+    <policy>fast</policy>
+    <trusted>false</trusted>
+    <class>net.dpml.transit.artifact.ClassicResourceHost</class>
+    <index href="index.idx">
+    <credentials>
+      <username>fred</username>
+      <password>blogs</password>
+    </credentials>
+    <scheme>basic</scheme>
+    <prompt>repository</prompt>
+  </host>
+
+</hosts>
+]]></source>
+
+      <p>
+        The default host configuration file is shown below, and find the 
+        description of the elements in the <strong>properties</strong> 
section
+        below.
+      </p>
+
+<source><![CDATA[
+<hosts>
+
+  <host dir="local/SNAPSHOT">
+    <priority>10</priority>
+    <trusted>true</trusted>
+  </host>
+
+  <host href="http://www.dpml.net/repository";>
+    <priority>20</priority>
+  </host>
+
+  <host href="http://www.ibiblio.org/maven";>
+    <priority>50</priority>
+  </host>
+
+  <host href="http://www.apache.org/dist/java-repository";>
+    <priority>70</priority>
+  </host>
+
+</hosts>]]></source>
+
+      </subsection>
+
+    </section>
+  </body>
+</document>
+
+ 
+ 

Added: 
development/main/central/site/src/docs/products/transit/technical/hosts/index.xml
==============================================================================
--- (empty file)
+++ 
development/main/central/site/src/docs/products/transit/technical/hosts/index.xml
   Mon Jan 10 15:40:05 2005
@@ -0,0 +1,45 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+
+<document>
+  <properties>
+    <author email="mcconnell AT dpml.net">Stephen McConnell</author>
+    <contributor email="dleangen AT dpml.net">David Leangen</contributor>
+    <title>DPML Transit</title>
+  </properties> 
+
+  <body>
+
+    <section name="Host Management">
+
+      <p>
+      Transit uses artifact uris to identify a resource. These identifiers 
+      are in turn mapped internally to a a repository url (i.e. mapping 
+      identity to a location).  Locations are defined relative to one or 
+      more hosts.
+      </p>
+        
+      <p>
+      Each Transit host declares a base url, an implementation strategy
+      (typically dealing with uri to url mapping), and policies concerning 
+      the handling of timestamped resources.
+      </p>
+        
+      <p>
+      The Transit <a href="hosts.html">hosts configuration</a>
+      enables the declaration of local file based repositories and remote 
+      repositories accessible via http and https protocols. Host 
+      configurations may also be declared using <a href="properties.html">
+      properties</a>.  In both cases the source of the <a 
href="authorative.html">
+      authorative configuration</a> may be managed locally or centralized 
under
+      a remote location.
+      </p>
+
+      <p>
+      Example of artifact retrival and remote repositories are included in 
+      the <a href="/guide/transit/resources/index.html">Transit Guide</a>.
+      </p>
+
+    </section>
+
+  </body>
+</document>

Added: 
development/main/central/site/src/docs/products/transit/technical/hosts/navigation.xml
==============================================================================
--- (empty file)
+++ 
development/main/central/site/src/docs/products/transit/technical/hosts/navigation.xml
      Mon Jan 10 15:40:05 2005
@@ -0,0 +1,36 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- 
+ Copyright 2004 Stephen McConnell
+ Copyright 2004 Niclas Hedhman
+
+ Licensed  under the  Apache License,  Version 2.0  (the "License");
+ you may not use  this file  except in  compliance with the License.
+ You may obtain a copy of the License at 
+ 
+   http://www.dpml.net/central/about/legal/
+ 
+ Unless required by applicable law or agreed to in writing, software
+ distributed  under the  License is distributed on an "AS IS" BASIS,
+ WITHOUT  WARRANTIES OR CONDITIONS  OF ANY KIND, either  express  or
+ implied.
+ 
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+
+<project>
+
+ <title>Transit</title>
+
+ <body>
+
+    <menu>
+      <item name="Authorative Host" href="authorative.html"/>
+      <item name="Host Configuration" href="hosts.html"/>
+      <item name="Host Properties" href="properties.html"/>
+      <item name="Classic Repository Layout" href="classic.html"/>
+    </menu>
+
+ </body>
+
+</project>

Added: 
development/main/central/site/src/docs/products/transit/technical/hosts/properties.xml
==============================================================================
--- (empty file)
+++ 
development/main/central/site/src/docs/products/transit/technical/hosts/properties.xml
      Mon Jan 10 15:40:05 2005
@@ -0,0 +1,140 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- 
+ Copyright 2004 Niclas Hedhman
+
+ Licensed  under the  Apache License,  Version 2.0  (the "License");
+ you may not use  this file  except in  compliance with the License.
+ You may obtain a copy of the License at 
+ 
+   http://www.dpml.net/central/about/legal/
+ 
+ Unless required by applicable law or agreed to in writing, software
+ distributed  under the  License is distributed on an "AS IS" BASIS,
+ WITHOUT  WARRANTIES OR CONDITIONS  OF ANY KIND, either  express  or
+ implied.
+ 
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+
+<document>
+  <properties>
+    <author email="niclas AT hedhman.org">Niclas Hedhman</author>
+    <title>DPML Transit</title>
+  </properties> 
+
+  <body>
+    <section name="Host Properties">
+
+      <p>
+        If a host.xml file is not present, Transit will atempt to resolve 
hosts using
+        a set of property based host descriptors.  Property files describing 
remote hosts 
+        are based on the following property specification.
+      </p>
+
+      <table>
+        <tr>
+          <th>Property</th>
+          <th>Default Value</th>
+          <th>Description</th>
+        </tr>
+        <tr>
+          <td>dpml.transit.resourcehost.enabled</td>
+          <td>true</td>
+          <td>
+            If true, the remote host repository will be used. If false, it 
+            will be skipped completely.
+          </td>
+        </tr>
+        <tr>
+          <td>dpml.transit.resourcehost.base</td>          
+          <td></td>          
+          <td>This defines the base URL of the remote host repository.</td>  
        
+        </tr>
+        <tr>
+          <td>dpml.transit.resourcehost.class</td>          
+          <td>(see description)</td>          
+          <td>
+            Defines the class to use for the management of the remote host.
+            If undefined the value defaults to 
<code>net.dpml.transit.artifact.ClassicResourceHost</code>.
+          </td>
+        </tr>
+        <tr>
+          <td>dpml.transit.resourcehost.knowngroups</td>          
+          <td></td>          
+          <td>
+            A URL pointing to a file containing a line-separated list of 
+            groups that are known to be installed on the remote host 
+            repository. (named &lt;index&gt; in the hosts.xml file.)
+          </td>
+        </tr>
+        <tr>
+          <td>dpml.transit.resourcehost.username</td>
+          <td></td>
+          <td>The username required for the remote host.</td>
+        </tr>
+        <tr>
+          <td>dpml.transit.resourcehost.password</td>
+          <td></td>
+          <td>The password for the user required to access the remote 
host.</td>
+        </tr>
+        <tr>
+          <td>dpml.transit.resourcehost.scheme</td>
+          <td></td>
+          <td>The authentication scheme used for the connection.</td>
+        </tr>
+        <tr>
+          <td>dpml.transit.resourcehost.prompt</td>
+          <td></td>
+          <td>
+            The authentication <strong>prompt</strong> or 
+            <strong>realm</strong> sent by the server.
+          </td>
+        </tr>
+        <tr>
+          <td>dpml.transit.resourcehost.policy</td>
+          <td>fast</td>
+          <td>
+            Download policy. "fast"=if the artifact exist in the cache, use
+            it.
+          </td>
+        </tr>
+        <tr>
+          <td>dpml.transit.resourcehost.priority</td>
+          <td>80</td>
+          <td>
+            The priority defines which host should take precedence over 
+            another host for obtaining the artifact. A lower number indicates
+            a higher priority.
+          </td>
+        </tr>
+        <tr>
+          <td>dpml.transit.resourcehost.trusted</td>
+          <td>false</td>
+          <td>
+            If true Transit shall assume that the host connection is trusted.
+            When set to "true" in conjunction with an https:// conection, 
the 
+            certificate chain of the host will be accepted unconditionally.
+          </td>
+        </tr>
+        <!--
+        <tr>
+          <td>dpml.transit.resourcehost.upload</td>
+          <td>false</td>
+          <td>
+            Upload policy. If true, writing a versioned artifact to its 
+            output stream will also initiate an attempt to upload that 
+            artifact to the remote host. SCP will be used, and username and 
+            password will be used from the above property settings.
+          </td>
+          <td>Not Implemented</td>
+        </tr>
+        -->
+      </table>
+
+    </section>
+  </body>
+</document>
+
+ 
+ 

Modified: 
development/main/central/site/src/docs/products/transit/technical/index.xml
==============================================================================
--- 
development/main/central/site/src/docs/products/transit/technical/index.xml 
(original)
+++ 
development/main/central/site/src/docs/products/transit/technical/index.xml 
Mon Jan 10 15:40:05 2005
@@ -25,33 +25,12 @@
     <author email="mcconnell AT dpml.net">Stephen McConnell</author>
     <author email="niclas AT hedhman.org">Niclas Hedhman</author>
     <author email="david.leangen AT konova.com">David Leangen</author>
-    <title>DPML Products</title>
+    <title>DPML Transit</title>
   </properties> 
 
   <body>
-    <section name="Transit Resource Management System">
+    <section name="Transit Reference Specifications">
 
-
-      <p>
-        Transit provides a flexible framework for dynamically retrieving 
-        system and application resources, constructing classloaders, and 
-        managing plugins.
-
-        As a resource management system, Transit provides the foundation
-        for building repository-enabled applications.
-      </p>
-
-<!--
-      <subsection name="More Information">
-        <ul>
-          <li><a href="/guide/setup/index.html">installation</a></li>
-          <li><a href="/guide/transit/index.html">Transit Guide</a></li>
-          <li><a href="properties/index.html">properties 
specifications</a></li>
-          <li><a href="protocol/index.html">artifact protocol</a></li>
-          <li><a href="launcher/index.html">application launcher</a></li>
-        </ul>
-      </subsection>
--->
     </section>
   </body>
 </document>

Added: 
development/main/central/site/src/docs/products/transit/technical/launcher/cli.xml
==============================================================================
--- (empty file)
+++ 
development/main/central/site/src/docs/products/transit/technical/launcher/cli.xml
  Mon Jan 10 15:40:05 2005
@@ -0,0 +1,142 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+
+<!-- 
+ Copyright 2005 Stephen McConnell
+
+ Licensed  under the  Apache License,  Version 2.0  (the "License");
+ you may not use  this file  except in  compliance with the License.
+ You may obtain a copy of the License at 
+ 
+   http://www.dpml.net/central/about/legal/
+ 
+ Unless required by applicable law or agreed to in writing, software
+ distributed  under the  License is distributed on an "AS IS" BASIS,
+ WITHOUT  WARRANTIES OR CONDITIONS  OF ANY KIND, either  express  or
+ implied.
+ 
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+
+<document>
+  <properties>
+    <author email="mcconnell AT dpml.net">Stephen McConnell</author>
+    <title>DPML Transit</title>
+  </properties> 
+
+  <body>
+    <section name="Commandline Options">
+
+      <subsection name="Bootstrap CLI Options">
+
+      <p>
+      The <code>-Xbootstrap</code> cli option is recognized by the Transit 
Main class
+      and is used to establish the application launcher plugin uri.
+      </p>
+
+      <table>
+          <tr>
+            <th width="100">Option</th>
+            <th>Argument Type</th>
+            <th>Description</th>
+          </tr>
+          <tr>
+            <td>-Xbootstrap</td>
+            <td>URI</td>
+            <td>
+            The uri of the application launcher to be used. This value is 
normally 
+            set by the transit commandline script. The value declared under 
the script
+            is the artifact uri <code>"@TRANSIT-PLUGIN-URI@"</code>.  The 
loaded plugin is required
+            to handle the cli options described below.
+            </td>
+          </tr>
+        </table>
+
+      </subsection>
+
+      <subsection name="Standard CLI Options">
+
+      <p>
+      The transit application launcher evaluates the supplied commandline 
arguments
+      and processes only those arguments applicable to itself.  Remaining 
arguments 
+      are forwarded on to the application that is the target of a launch 
request.
+      </p>
+
+      <p>
+        The standard CLI Options recognized by the launcher are listed in 
the following table.
+      </p>
+      <table>
+          <tr>
+            <th>Option</th>
+            <th width="170">Argument Type</th>
+            <th>Description</th>
+          </tr>
+          <tr>
+            <td>-debug</td>
+            <td>none</td>
+            <td>
+                Enable stacktrace and debug message reporting.
+            </td>
+          </tr>
+          <tr>
+            <td>-lang</td>
+            <td>language code</td>
+            <td>A two-letter language code to provide hooks for I18N.</td>
+          </tr>
+          <!--
+          <tr>
+            <td>-get</td>
+            <td>none</td>
+            <td>
+                downloads the supplied artifacts into the local cache
+            </td>
+          </tr>
+          -->
+          <tr>
+            <td>-load</td>
+            <td>plugin uri</td>
+            <td>
+                Transit loads the (single) plugin from the supplied artifact 
URI.
+                If the plugin is an instance of 
<code>java.lang.Runnable</code>, it 
+                will be started by the controller using the 
<code>start()</code>
+                method. A shutdown hook is added to the newly loaded plugin 
to 
+                enable clean shutdown together with the transit instance.
+                <br/><br/>For example, Metro is started via:
+                <br/><code>transit -load @METRO-PLUGIN-URI@</code>
+            </td>
+          </tr>
+        </table>
+
+      </subsection>
+
+      <subsection name="-XOptions">
+
+        <p>Supplimentary CLI arguments that are processed by the launcher 
include:</p>
+
+        <table>
+          <tr>
+            <th>Option</th>
+            <th>Description</th>
+          </tr>
+          <tr>
+            <td>-Xhelp</td>
+            <td>
+              Prints a help message on the available transit launcher plugin 
CLI options
+            </td>
+          </tr>
+          <tr>
+            <td>-Xversion</td>
+            <td>
+             Prints version information of the transit launcher plugin 
version
+            </td>
+          </tr>
+        </table>
+
+      </subsection>
+
+    </section>
+
+  </body>
+
+</document>
+

Added: 
development/main/central/site/src/docs/products/transit/technical/launcher/deployment.xml
==============================================================================
--- (empty file)
+++ 
development/main/central/site/src/docs/products/transit/technical/launcher/deployment.xml
   Mon Jan 10 15:40:05 2005
@@ -0,0 +1,83 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+
+<!-- 
+ Copyright 2005 Stephen McConnell
+
+ Licensed  under the  Apache License,  Version 2.0  (the "License");
+ you may not use  this file  except in  compliance with the License.
+ You may obtain a copy of the License at 
+ 
+   http://www.dpml.net/central/about/legal/
+ 
+ Unless required by applicable law or agreed to in writing, software
+ distributed  under the  License is distributed on an "AS IS" BASIS,
+ WITHOUT  WARRANTIES OR CONDITIONS  OF ANY KIND, either  express  or
+ implied.
+ 
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+
+<document>
+  <properties>
+    <author email="mcconnell AT dpml.net">Stephen McConnell</author>
+    <title>DPML Transit</title>
+  </properties> 
+
+  <body>
+    <section name="Runtime Deployment Model">
+
+        <p>Using information derived from system properties and command line 
options, the 
+           Transit Application Launcher will build up a map containing keys 
and options
+           to be supplied as an optional constructor argument.</p>
+
+        <p>Constructor argument values populated by the launcher and 
supplied to
+           the transit repository plugin handler are detailed in the 
following table.</p>
+
+        <table>
+          <tr>
+            <th>Argument</th>
+            <th>Description</th>
+          </tr>
+          <tr>
+            <td>Map</td>
+            <td>
+             Will be supplied with the Transit context map.
+            </td>
+          </tr>
+          <tr>
+            <td>String[]</td>
+            <td>
+             Will be supplied with the remaining command line arguments 
following
+             removal of standard and -X cli options recognized by Transit.
+            </td>
+          </tr>
+        </table>
+
+        <p>Transit context map keys and values are detailed in the following 
table.</p>
+
+        <table>
+          <tr>
+            <th>Key</th>
+            <th>Value</th>
+          </tr>
+          <tr>
+            <td>urn:transit.debug.policy</td>
+            <td>
+             A Boolean value declaring the debug policy.
+            </td>
+          </tr>
+          <tr>
+            <td>urn:transit.cli.args</td>
+            <td>
+             The non-processed cli arguments.
+            </td>
+          </tr>
+        </table>
+
+    </section>
+
+  </body>
+
+</document>
+

Modified: 
development/main/central/site/src/docs/products/transit/technical/launcher/index.xml
==============================================================================
--- 
development/main/central/site/src/docs/products/transit/technical/launcher/index.xml
        (original)
+++ 
development/main/central/site/src/docs/products/transit/technical/launcher/index.xml
        Mon Jan 10 15:40:05 2005
@@ -29,181 +29,19 @@
 
       <source>@TRANSIT-PLUGIN-URI@</source>
 
-       <subsection name="Overview">
-
       <p>
       The application launcher is a plugin established by the Transit handler
-      that is responsible for the deployment of application plugins.  The 
+      that is responsible for the deployment of a single application plugin. 
 The 
       launcher is responsible for low-level debug tracing, assignment of a 
-      shutdown hook, the instantiation and deployment of a target
-      application, and a number of utility tasks.
+      shutdown hook, the instantiation and deployment of the target
+      application.
       </p>
       <p>
-      The transit application launcher may be initialized via a command line 
script 
-      or through direct invocation with a java programe.
+      The transit application launcher may be initialized via a command line 
+      script or through direct invocation with a java programe.
       </p>
       <p><i>CLI Usage example:</i></p> 
-<source>$ transit [-load uri] [arg1 arg2 arg3 ...]</source>
-      </subsection>
-
-      <subsection name="Bootstrap CLI Options">
-
-      <p>
-      The <code>-Xbootstrap</code> cli option is recognized by the Transit 
Main class
-      and is used to establish the application launcher plugin uri.
-      </p>
-
-      <table>
-          <tr>
-            <th width="100">Option</th>
-            <th>Argument Type</th>
-            <th>Description</th>
-          </tr>
-          <tr>
-            <td>-Xbootstrap</td>
-            <td>URI</td>
-            <td>
-            The uri of the application launcher to be used. This value is 
normally 
-            set by the transit commandline script. The value declared under 
the script
-            is the artifact uri <code>"@TRANSIT-PLUGIN-URI@"</code>.  The 
loaded plugin is required
-            to handle the cli options described below.
-            </td>
-          </tr>
-        </table>
-
-      </subsection>
-
-      <subsection name="Standard CLI Options">
-
-      <p>
-      The transit application launcher evaluates the supplied commandline 
arguments
-      and processes only those arguments applicable to itself.  Remaining 
arguments 
-      are forwarded on to the application that is the target of a launch 
request.
-      </p>
-
-      <p>
-        The standard CLI Options recognized by the launcher are listed in 
the following table.
-      </p>
-      <table>
-          <tr>
-            <th>Option</th>
-            <th width="170">Argument Type</th>
-            <th>Description</th>
-          </tr>
-          <tr>
-            <td>-debug</td>
-            <td>none</td>
-            <td>
-                Enable stacktrace and debug message reporting.
-            </td>
-          </tr>
-          <tr>
-            <td>-lang</td>
-            <td>language code</td>
-            <td>A two-letter language code to provide hooks for I18N.</td>
-          </tr>
-          <!--
-          <tr>
-            <td>-get</td>
-            <td>none</td>
-            <td>
-                downloads the supplied artifacts into the local cache
-            </td>
-          </tr>
-          -->
-          <tr>
-            <td>-load</td>
-            <td>plugin uri</td>
-            <td>
-                Transit loads the (single) plugin from the supplied artifact 
URI.
-                If the plugin is an instance of 
<code>java.lang.Runnable</code>, it 
-                will be started by the controller using the 
<code>start()</code>
-                method. A shutdown hook is added to the newly loaded plugin 
to 
-                enable clean shutdown together with the transit instance.
-                <br/><br/>For example, Metro is started via:
-                <br/><code>transit -load @METRO-PLUGIN-URI@</code>
-            </td>
-          </tr>
-        </table>
-
-      </subsection>
-
-      <subsection name="-XOptions">
-
-        <p>Supplimentary CLI arguments that are processed by the launcher 
include:</p>
-
-        <table>
-          <tr>
-            <th>Option</th>
-            <th>Description</th>
-          </tr>
-          <tr>
-            <td>-Xhelp</td>
-            <td>
-              Prints a help message on the available transit launcher plugin 
CLI options
-            </td>
-          </tr>
-          <tr>
-            <td>-Xversion</td>
-            <td>
-             Prints version information of the transit launcher plugin 
version
-            </td>
-          </tr>
-        </table>
-
-      </subsection>
-
-      <subsection name="Deployment Model">
-
-        <p>Using information derived from system properties and command line 
options, the 
-           Transit Application Launcher will build up a map containing keys 
and options
-           to be supplied as an optional constructor argument.</p>
-
-        <p>Constructor argument values populated by the launcher and 
supplied to
-           the transit repository plugin handler are detailed in the 
following table.</p>
-
-        <table>
-          <tr>
-            <th>Argument</th>
-            <th>Description</th>
-          </tr>
-          <tr>
-            <td>Map</td>
-            <td>
-             Will be supplied with the Transit context map.
-            </td>
-          </tr>
-          <tr>
-            <td>String[]</td>
-            <td>
-             Will be supplied with the remaining command line arguments 
following
-             removal of standard and -X cli options recognized by Transit.
-            </td>
-          </tr>
-        </table>
-
-        <p>Transit context map keys and values are detailed in the following 
table.</p>
-
-        <table>
-          <tr>
-            <th>Key</th>
-            <th>Value</th>
-          </tr>
-          <tr>
-            <td>urn:transit.debug.policy</td>
-            <td>
-             A Boolean value declaring the debug policy.
-            </td>
-          </tr>
-          <tr>
-            <td>urn:transit.cli.args</td>
-            <td>
-             The non-processed cli arguments.
-            </td>
-          </tr>
-        </table>
-
-      </subsection>
+<code>$ transit [-load uri] [arg1 arg2 arg3 ...]</code>
 
     </section>
 

Modified: 
development/main/central/site/src/docs/products/transit/technical/launcher/navigation.xml
==============================================================================
--- 
development/main/central/site/src/docs/products/transit/technical/launcher/navigation.xml
   (original)
+++ 
development/main/central/site/src/docs/products/transit/technical/launcher/navigation.xml
   Mon Jan 10 15:40:05 2005
@@ -25,6 +25,9 @@
  <body>
 
     <menu>
+      <item name="Commandline Options" href="cli.html"/>
+      <item name="Deployment Model" href="deployment.html"/>
+      <item name="Properties" href="properties.html"/>
     </menu>
 
  </body>

Added: 
development/main/central/site/src/docs/products/transit/technical/launcher/properties.xml
==============================================================================
--- (empty file)
+++ 
development/main/central/site/src/docs/products/transit/technical/launcher/properties.xml
   Mon Jan 10 15:40:05 2005
@@ -0,0 +1,67 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!-- 
+ Copyright 2004 Niclas Hedhman
+
+ Licensed  under the  Apache License,  Version 2.0  (the "License");
+ you may not use  this file  except in  compliance with the License.
+ You may obtain a copy of the License at 
+ 
+   http://www.dpml.net/central/about/legal/
+ 
+ Unless required by applicable law or agreed to in writing, software
+ distributed  under the  License is distributed on an "AS IS" BASIS,
+ WITHOUT  WARRANTIES OR CONDITIONS  OF ANY KIND, either  express  or
+ implied.
+ 
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+
+<document>
+
+  <properties>
+    <author email="niclas AT hedhman.org">Niclas Hedhman</author>
+    <title>DPML Transit</title>
+  </properties> 
+
+  <body>
+
+    <section name="Runtime Properties">
+
+      <p>
+        In addition to the classic protocol handling, Transit provides 
support
+        for the deployment of a runtime application via the 
+        <a 
href="../../../../../@TRANSIT-DOCS-PATH@/net/dpml/transit/Main.html">
+        Transit Main</a> handler class.  This class looks for the 
+        "dpml.transit.bootstrap.uri" system property and value corresponding 
to 
+        a uri of a bootstrap plugin that handles the deployment of 
application
+        plugins (the bootstrap uri may be overriden with the -Xbootstrap cli 
+        argument in command-line scenarios).
+      </p>
+
+      <subsection name="Properties">
+        <table>
+          <tr>
+            <th>Property</th>
+            <th>Default Value</th>
+            <th>Description</th>
+          </tr>
+          <tr>
+            <td>dpml.transit.bootstrap.uri</td>
+            <td><a href="../launcher/index.html">plugin</a></td>
+            <td>URI of an application launcher plugin. The plugin handles
+             the loading and deployment of application plugins such as 
+             the metro component managment platform cli handler and other 
+             application hanlders.</td>
+          </tr>
+        </table>
+      </subsection>
+
+    </section>
+
+  </body>
+
+</document>
+
+ 
+ 

Added: 
development/main/central/site/src/docs/products/transit/technical/monitors/index.xml
==============================================================================
--- (empty file)
+++ 
development/main/central/site/src/docs/products/transit/technical/monitors/index.xml
        Mon Jan 10 15:40:05 2005
@@ -0,0 +1,57 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+
+<document>
+  <properties>
+    <author email="mcconnell AT dpml.net">Stephen McConnell</author>
+    <contributor email="dleangen AT dpml.net">David Leangen</contributor>
+    <title>DPML Transit</title>
+  </properties> 
+
+  <body>
+    <section name="Event Monitoring">
+
+      <p>
+      Internal events within the Transit system are forwarded to a set of
+      event routers, each dealing with a particular Transit sub-system. 
Routers
+      forward events to registered monitors.
+      </p>
+
+      <img src="/images/transit/monitors.png"/>
+
+
+      <subsection name="Router/Monitor Types">
+
+        <table>
+          <tr><th>Type</th><th>Description</th></tr>
+          <tr>
+            <td>
+              <a 
href="../../../../@TRANSIT-DOCS-PATH@/net/dpml/transit/monitors/CacheMonitor.html">CacheMonitor</a></td>
+            <td>Handles events related to resource requests, modification of 
the 
+                local cache, and download failures.</td>
+          </tr>
+          <tr>
+            <td>
+              <a 
href="../../../../@TRANSIT-DOCS-PATH@/net/dpml/transit/monitors/ConnectionMonitor.html">
+ConnectionMonitor</a></td>
+            <td>Handles events dealing with the openning and closing of 
connections.</td>
+          </tr>
+          <tr>
+            <td>
+              <a 
href="../../../../@TRANSIT-DOCS-PATH@/net/dpml/transit/monitors/NetworkMonitor.html">
+NetworkMonitor</a></td>
+            <td>Handles events dealing with network activitiy including 
progressive 
+                download activitiy and download completion.</td>
+          </tr>
+          <tr>
+            <td>
+              <a 
href="../../../../@TRANSIT-DOCS-PATH@/net/dpml/transit/monitors/RepositoryMonitor.html">
+RepositoryMonitor</a></td>
+            <td>Handles events dealing with plugin requests, plugin class 
establishment, constructor
+               discovery, plugin instantiation, classloader creation, and 
plugin error reporting.</td>
+          </tr>
+        </table>
+      </subsection>
+
+    </section>
+  </body>
+</document>

Added: 
development/main/central/site/src/docs/products/transit/technical/monitors/navigation.xml
==============================================================================
--- (empty file)
+++ 
development/main/central/site/src/docs/products/transit/technical/monitors/navigation.xml
   Mon Jan 10 15:40:05 2005
@@ -0,0 +1,32 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- 
+ Copyright 2004 Stephen McConnell
+ Copyright 2004 Niclas Hedhman
+
+ Licensed  under the  Apache License,  Version 2.0  (the "License");
+ you may not use  this file  except in  compliance with the License.
+ You may obtain a copy of the License at 
+ 
+   http://www.dpml.net/central/about/legal/
+ 
+ Unless required by applicable law or agreed to in writing, software
+ distributed  under the  License is distributed on an "AS IS" BASIS,
+ WITHOUT  WARRANTIES OR CONDITIONS  OF ANY KIND, either  express  or
+ implied.
+ 
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+
+<project>
+
+ <title>Transit</title>
+
+ <body>
+
+    <menu>
+    </menu>
+
+ </body>
+
+</project>

Modified: 
development/main/central/site/src/docs/products/transit/technical/navigation.xml
==============================================================================
--- 
development/main/central/site/src/docs/products/transit/technical/navigation.xml
    (original)
+++ 
development/main/central/site/src/docs/products/transit/technical/navigation.xml
    Mon Jan 10 15:40:05 2005
@@ -25,11 +25,13 @@
  <body>
 
     <menu>
-      <item name="Repository Enabled" href="concepts/index.html"/>
-      <item name="Protocol Specification" href="protocol/index.html"/>
+      <item name="Artifact Protocol" href="protocol/index.html"/>
+      <item name="Cache Management" href="cache/index.html"/>
+      <item name="Local and Remote Hosts" href="hosts/index.html"/>
+      <item name="Event Monitors" href="monitors/index.html"/>
+      <item name="Repository Service" href="repository/index.html"/>
       <item name="Application Launcher" href="launcher/index.html"/>
-      <item name="Properties" href="properties/index.html"/>
-      <item name="Javadocs" href="../../../@TRANSIT-DOCS-PATH@/index.html"/>
+      <item name="Javadocs" 
href="../../../../@TRANSIT-DOCS-PATH@/index.html"/>
     </menu>
 
  </body>

Modified: 
development/main/central/site/src/docs/products/transit/technical/properties/cache.xml
==============================================================================
--- 
development/main/central/site/src/docs/products/transit/technical/properties/cache.xml
      (original)
+++ 
development/main/central/site/src/docs/products/transit/technical/properties/cache.xml
      Mon Jan 10 15:40:05 2005
@@ -63,7 +63,7 @@
             <td>net.dpml.transit.artifact.FileCacheHandler</td>
             <td>
               The class that implements the cache handler interface 
-              <a 
href="../../../../@TRANSIT-DOCS-PATH@/net/dpml/transit/artifact/CacheHandler.html">net.dpml.transit.artifact.CacheHandler</a>.
+              <a 
href="../../../../../@TRANSIT-DOCS-PATH@/net/dpml/transit/artifact/CacheHandler.html">net.dpml.transit.artifact.CacheHandler</a>.
             </td>
           </tr>
         </table>

Modified: 
development/main/central/site/src/docs/products/transit/technical/properties/hosts.xml
==============================================================================
--- 
development/main/central/site/src/docs/products/transit/technical/properties/hosts.xml
      (original)
+++ 
development/main/central/site/src/docs/products/transit/technical/properties/hosts.xml
      Mon Jan 10 15:40:05 2005
@@ -30,7 +30,7 @@
         A Resource Host is a place where Artifacts can be downloaded. Transit
         is capable of handling many types of resource hosts. Conceptually, 
you
         only need to implement the 
-        <code><a 
href="../../../../@TRANSIT-DOCS-PATH@/net/dpml/transit/artifact/ResourceHost.html">
+        <code><a 
href="../../../../../@TRANSIT-DOCS-PATH@/net/dpml/transit/artifact/ResourceHost.html">
         net.dpml.transit.artifact.ResourceHost</a></code> interface, and 
         specify the implementation class of the host handler.
         host.

Modified: 
development/main/central/site/src/docs/products/transit/technical/properties/runtime.xml
==============================================================================
--- 
development/main/central/site/src/docs/products/transit/technical/properties/runtime.xml
    (original)
+++ 
development/main/central/site/src/docs/products/transit/technical/properties/runtime.xml
    Mon Jan 10 15:40:05 2005
@@ -31,7 +31,7 @@
       <p>
         In addition to the classic protocol handling, Transit provides 
support
         for the deployment of a runtime application via the 
-        <a href="../../../../@TRANSIT-DOCS-PATH@/net/dpml/transit/Main.html">
+        <a 
href="../../../../../@TRANSIT-DOCS-PATH@/net/dpml/transit/Main.html">
         Transit Main</a> handler class.  This class looks for the 
         "dpml.transit.bootstrap.uri" system property and value corresponding 
to 
         a uri of a bootstrap plugin that handles the deployment of 
application

Modified: 
development/main/central/site/src/docs/products/transit/technical/protocol/navigation.xml
==============================================================================
--- 
development/main/central/site/src/docs/products/transit/technical/protocol/navigation.xml
   (original)
+++ 
development/main/central/site/src/docs/products/transit/technical/protocol/navigation.xml
   Mon Jan 10 15:40:05 2005
@@ -25,7 +25,6 @@
  <body>
 
     <menu>
-      <item name="Classic Repository Layout" href="classic.html"/>
     </menu>
 
  </body>

Added: 
development/main/central/site/src/docs/products/transit/technical/repository/index.xml
==============================================================================
--- (empty file)
+++ 
development/main/central/site/src/docs/products/transit/technical/repository/index.xml
      Mon Jan 10 15:40:05 2005
@@ -0,0 +1,15 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+
+<document>
+  <properties>
+    <author email="mcconnell AT dpml.net">Stephen McConnell</author>
+    <contributor email="dleangen AT dpml.net">David Leangen</contributor>
+    <title>DPML Transit</title>
+  </properties> 
+
+  <body>
+    <section name="Repository Service">
+
+    </section>
+  </body>
+</document>

Added: 
development/main/central/site/src/docs/products/transit/technical/repository/navigation.xml
==============================================================================
--- (empty file)
+++ 
development/main/central/site/src/docs/products/transit/technical/repository/navigation.xml
 Mon Jan 10 15:40:05 2005
@@ -0,0 +1,32 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- 
+ Copyright 2004 Stephen McConnell
+ Copyright 2004 Niclas Hedhman
+
+ Licensed  under the  Apache License,  Version 2.0  (the "License");
+ you may not use  this file  except in  compliance with the License.
+ You may obtain a copy of the License at 
+ 
+   http://www.dpml.net/central/about/legal/
+ 
+ Unless required by applicable law or agreed to in writing, software
+ distributed  under the  License is distributed on an "AS IS" BASIS,
+ WITHOUT  WARRANTIES OR CONDITIONS  OF ANY KIND, either  express  or
+ implied.
+ 
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+
+<project>
+
+ <title>Transit</title>
+
+ <body>
+
+    <menu>
+    </menu>
+
+ </body>
+
+</project>