notify-dpml AT lists.ibiblio.org

Subject: DPML Notify

List archive

r1881 - in trunk/central/site/src/docs: . util util/depot util/transit

From: mcconnell at BerliOS <mcconnell AT mail.berlios.de>
To: notify-dpml AT lists.ibiblio.org
Subject: r1881 - in trunk/central/site/src/docs: . util util/depot util/transit
Date: Wed, 7 Mar 2007 03:41:44 +0100

Author: mcconnell
Date: 2007-03-07 03:41:42 +0100 (Wed, 07 Mar 2007)
New Revision: 1881

Added:
trunk/central/site/src/docs/util/depot/
trunk/central/site/src/docs/util/depot/library/
trunk/central/site/src/docs/util/depot/tasks/
trunk/central/site/src/docs/util/transit/
trunk/central/site/src/docs/util/transit/concepts/
trunk/central/site/src/docs/util/transit/config/
trunk/central/site/src/docs/util/transit/navigation.xml
trunk/central/site/src/docs/util/transit/properties.xml
trunk/central/site/src/docs/util/transit/technical/
trunk/central/site/src/docs/util/transit/tutorials/
Removed:
trunk/central/site/src/docs/depot/
trunk/central/site/src/docs/util/depot/concepts/
trunk/central/site/src/docs/util/depot/library/
trunk/central/site/src/docs/util/depot/tasks/
trunk/central/site/src/docs/util/transit/cli/
trunk/central/site/src/docs/util/transit/concepts/
trunk/central/site/src/docs/util/transit/config/
trunk/central/site/src/docs/util/transit/navigation.xml
trunk/central/site/src/docs/util/transit/properties.xml
trunk/central/site/src/docs/util/transit/tasks/
trunk/central/site/src/docs/util/transit/technical/
trunk/central/site/src/docs/util/transit/tutorials/
Modified:
trunk/central/site/src/docs/index.xml
trunk/central/site/src/docs/navigation.xml
trunk/central/site/src/docs/util/depot/index.xml
trunk/central/site/src/docs/util/depot/navigation.xml
trunk/central/site/src/docs/util/navigation.xml
Log:

Modified: trunk/central/site/src/docs/index.xml
===================================================================
--- trunk/central/site/src/docs/index.xml 2007-03-07 02:16:46 UTC (rev
1880)
+++ trunk/central/site/src/docs/index.xml 2007-03-07 02:41:42 UTC (rev
1881)
@@ -28,23 +28,18 @@
</subsection>

<subsection name="Products">
-
+
<ul>
<li>
- <a href="util/transit/index.html">Transit</a> resource
management framework.
- </li>
- <li>
- <a href="depot/index.html">Depot</a> tools
- for build automation in complex multi-project environments.
- </li>
- <li>
<a href="metro/index.html">Metro</a> context-driven IOC runtime
container.
</li>
<li>
<a href="station/index.html">Station</a> multi-appplication
management system.
</li>
<li>
- <a href="util/index.html">Util</a> supporting utilities.
+ <a href="util/index.html">Util</a> supporting utilities
including the
+ <a href="util/transit/index.html">Transit</a> resource
management system and
+ <a href="util/depot/index.html">Depot</a> build tool.
</li>
</ul>

Modified: trunk/central/site/src/docs/navigation.xml
===================================================================
--- trunk/central/site/src/docs/navigation.xml 2007-03-07 02:16:46 UTC (rev
1880)
+++ trunk/central/site/src/docs/navigation.xml 2007-03-07 02:41:42 UTC (rev
1881)
@@ -30,7 +30,7 @@
<item name="Utilities" href="util/concepts/index.html"/>
<item name="Station" href="station/concepts/index.html"/>
<item name="Metro" href="metro/concepts/index.html"/>
- <item name="Depot" href="depot/concepts/index.html"/>
+ 

</links>

Copied: trunk/central/site/src/docs/util/depot (from rev 1860,
trunk/central/site/src/docs/depot)

Modified: trunk/central/site/src/docs/util/depot/index.xml
===================================================================
--- trunk/central/site/src/docs/depot/index.xml 2007-02-09 01:32:02 UTC (rev
1860)
+++ trunk/central/site/src/docs/util/depot/index.xml 2007-03-07 02:41:42
UTC (rev 1881)
@@ -35,9 +35,67 @@
the build system <a href="tools/index.html"> implementation</a>.
</p>

- <img src="../images/tools/index.png"/>
+ <img src="../../images/tools/index.png"/>

+ <subsection name="Centralization">
+
+ <p>
+ One of the objectives of the DPML component development strategy
+ is an effective breakdown of concerns such that you end up with
+ small and easily understandable sub-systems. However, while
+ individal projects are under control, the configuration management
+ of an overall system (possibly involving several hundred sub-projects)
+ becomes an inevitable configuration management concern.
+ </p>
+
+ <p>
+ Depot addresses overall configuration management through
+ centralization of project information within a
+ <a href="library/index.html">common build library</a> that
+ captures information about <a href="library/projects.html">
+ projects</a> and shared <a href="library/resources.html">resources</a>
+ organized and structured within distrinct
+ <a href="library/modules.html">modules</a>.
+ A <tt><a href="cli/index.html">build</a></tt> commandline tool
provides
+ support for listing of registered projects and the execution
+ of project builds. The build tool executes builds using a plugin
builder.
+ A default <a href="tools/index.html">build system implementation</a>
+ based on the Apache Ant product is included in the Depot distribution.
+ </p>
+
+ </subsection>
+
+ <subsection name="Modularization">
+
+ <p>
+ A framework for modularization of project structures enables the
+ establishment and maintenance of discrete namespaces. In turn this
+ improves the overall maintainability within large-scale projects.
+ The Depot system maintains information about project and resources
+ within <a href="library/modules.html">modules</a> and provides
+ support for the production of a module suitable for export and use
+ by external projects. This adds to the general integrity concerning
+ naming, content versioning, and overall dependency management.
+ </p>
+
+ </subsection>
+
+ <subsection name="Simplification">
+
+ <p>
+ One of the aims of the Depot build system is the simplification
+ of build procedures. Depot focuses on the principal of 80/20 where
+ 80% of projects can be easily automated to extent that no
+ build file is needed at all. For the remaining 20% Depot provides
+ mechanisms to customize builds for those specialized requirements.
+ Overall - the aim is to reduce the amount of information that
+ resides in a build file and focus where possible on mechanisms that
+ will enable consistent and reliable build automation.
+ </p>
+
+ </subsection>
+
</section>

</body>

Copied: trunk/central/site/src/docs/util/depot/library (from rev 1880,
trunk/central/site/src/docs/depot/library)

Modified: trunk/central/site/src/docs/util/depot/navigation.xml
===================================================================
--- trunk/central/site/src/docs/depot/navigation.xml 2007-02-09 01:32:02
UTC (rev 1860)
+++ trunk/central/site/src/docs/util/depot/navigation.xml 2007-03-07
02:41:42 UTC (rev 1881)
@@ -25,12 +25,11 @@
<body>

<menu>
- <item name="Overview" href="concepts/index.html"/>
- <item name="Tutorials" href="tutorials/index.html"/>
+ <item name="CLI" href="cli/index.html"/>
<item name="Directives" href="library/index.html"/>
<item name="Ant Builder" href="tools/index.html"/>
<item name="Ant Tasks" href="tasks/index.html"/>
- <item name="CLI" href="cli/index.html"/>
+ <item name="Tutorials" href="tutorials/index.html"/>
</menu>

</body>

Copied: trunk/central/site/src/docs/util/depot/tasks (from rev 1880,
trunk/central/site/src/docs/depot/tasks)

Modified: trunk/central/site/src/docs/util/navigation.xml
===================================================================
--- trunk/central/site/src/docs/util/navigation.xml 2007-03-07 02:16:46
UTC (rev 1880)
+++ trunk/central/site/src/docs/util/navigation.xml 2007-03-07 02:41:42
UTC (rev 1881)
@@ -29,6 +29,7 @@
<item name="Overview" href="concepts/index.html"/>
<item name="CommandLine" href="cli/index.html"/>
<item name="Transit" href="transit/index.html"/>
+ <item name="Depot" href="depot/index.html"/>
</menu>

</body>

Copied: trunk/central/site/src/docs/util/transit (from rev 1860,
trunk/central/site/src/docs/transit)

Copied: trunk/central/site/src/docs/util/transit/concepts (from rev 1880,
trunk/central/site/src/docs/transit/concepts)

Copied: trunk/central/site/src/docs/util/transit/config (from rev 1880,
trunk/central/site/src/docs/transit/config)

Deleted: trunk/central/site/src/docs/util/transit/navigation.xml
===================================================================
--- trunk/central/site/src/docs/transit/navigation.xml 2007-02-09 01:32:02
UTC (rev 1860)
+++ trunk/central/site/src/docs/util/transit/navigation.xml 2007-03-07
02:41:42 UTC (rev 1881)
@@ -1,40 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-
-
-
-<project>
-
- <title>DPML Central</title>
-
- <body>
-
- <menu>
- <item name="Overview" href="concepts/index.html"/>
- <item name="Tutorials" href="tutorials/index.html"/>
- <item name="System Properties" href="properties.html"/>
- <item name="Cache Configuration" href="config/index.html"/>
- <item name="Part Directive" href="parts/index.html"/>
- <item name="Protocols" href="technical/index.html"/>
- <item name="Ant" href="tasks/index.html"/>
- <item name="CLI" href="cli/index.html"/>
- </menu>
-
- </body>
-
-</project>

Copied: trunk/central/site/src/docs/util/transit/navigation.xml (from rev
1880, trunk/central/site/src/docs/transit/navigation.xml)

Deleted: trunk/central/site/src/docs/util/transit/properties.xml
===================================================================
--- trunk/central/site/src/docs/transit/properties.xml 2007-02-09 01:32:02
UTC (rev 1860)
+++ trunk/central/site/src/docs/util/transit/properties.xml 2007-03-07
02:41:42 UTC (rev 1881)
@@ -1,71 +0,0 @@
-<?xml version="1.0" encoding="ISO-8859-1"?>
-
-
-
-<document>
-
- <properties>
- <author email="mcconnell AT dpml.net">Stephen McConnell</author>
- <title>DPML Transit Properties</title>
- </properties>
-
- <body>
- <section name="System Properties">
-
- <p>
- Two optional system properties may be used to control the
configuration
- of the Transit system. One property provides a mechanisms whereby a
- remote active transit model can be associated as the confiuration
- for a local transit instance. A second property is available for
- selection of a transit profile via url (suitable for centralized
- configuration of static models).
- </p>
-
- <table>
- <tr>
- <td>dpml.transit.model</td>
- <td>
- If this system property is passed as an argument to the Depot
- console handler (via the <tt>transit</tt>, <tt>metro</tt>, or
- <tt>station</tt> commandline handlers), Depot will attempt to
- locate a Transit Model using an RMI registry. If declared the
- value of the property must be in the form
<tt>registry[:host[:port]]:name</tt>
- where the <tt>name</tt> value corresponds to a RMI registry name
binding
- that maps to an instance of a remote TransitModel.
- </td>
- </tr>
- <tr>
- <td>dpml.transit.profile</td>
- <td>
- If Transit is not initialized within an explicit TransitModel
then
- Transit will attempt to establish a TransitModel using a
externalized
- TransitDirective located at the uri
<tt>local:xml:dpml/transit/standard</tt>.
- This uri can be overridden using the
<tt>dpml.transit.profile</tt> property
- enabling the selection of a remote profile. The uri value will
be resolved
- to a url referencing a <a href="config/index.html">Transit XML
configuration</a>.
- Overriding the uri enables the possiblity for centralization of
multiple
- Transit configurations.
- </td>
- </tr>
- </table>
-
- </section>
- </body>
-</document>
-

Copied: trunk/central/site/src/docs/util/transit/properties.xml (from rev
1880, trunk/central/site/src/docs/transit/properties.xml)

Copied: trunk/central/site/src/docs/util/transit/technical (from rev 1880,
trunk/central/site/src/docs/transit/technical)

Copied: trunk/central/site/src/docs/util/transit/tutorials (from rev 1880,
trunk/central/site/src/docs/transit/tutorials)

r1881 - in trunk/central/site/src/docs: . util util/depot util/transit, mcconnell at BerliOS, 03/06/2007