DPML Notify

[mcconnell at BerliOS <mcconnell AT mail.berlios.de>]

Author: mcconnell
Date: 2006-04-19 07:55:14 +0200 (Wed, 19 Apr 2006)
New Revision: 1382

Modified:
   
trunk/main/depot/library/src/main/net/dpml/library/info/ModuleDirective.java
   
trunk/main/depot/library/src/main/net/dpml/library/info/ResourceDirective.java
   
trunk/main/depot/library/src/test/net/dpml/library/impl/AbsoluteTestCase.java
   
trunk/main/depot/library/src/test/net/dpml/library/impl/PropertiesTestCase.java
   
trunk/main/depot/tools/builder/src/main/net/dpml/tools/impl/DefaultContext.java
   
trunk/main/depot/tools/builder/src/main/net/dpml/tools/impl/DefaultWorkbench.java
   
trunk/main/depot/tools/builder/src/main/net/dpml/tools/impl/StandardBuildListener.java
   
trunk/main/depot/tools/builder/src/main/net/dpml/tools/impl/StandardBuilder.java
   
trunk/main/depot/tools/builder/src/main/net/dpml/tools/info/BuilderDirective.java
   
trunk/main/depot/tools/builder/src/main/net/dpml/tools/info/BuilderDirectiveHelper.java
   trunk/main/depot/tools/builder/src/main/net/dpml/tools/model/Context.java
   trunk/main/depot/tools/builder/src/main/net/dpml/tools/model/Processor.java
   
trunk/main/depot/tools/builder/src/main/net/dpml/tools/process/AbstractProcessor.java
   
trunk/main/depot/tools/builder/src/main/net/dpml/tools/process/JarProcess.java
   
trunk/main/depot/tools/builder/src/main/net/dpml/tools/process/ModuleProcess.java
   
trunk/main/depot/tools/builder/src/main/net/dpml/tools/process/PluginProcess.java
   
trunk/main/depot/tools/builder/src/main/net/dpml/tools/process/StandardProcess.java
   
trunk/main/depot/tools/builder/src/main/net/dpml/tools/tasks/GenericTask.java
   
trunk/main/depot/tools/builder/src/main/net/dpml/tools/tasks/InitializationTask.java
Log:
checkstyle cleanup

Modified: 
trunk/main/depot/library/src/main/net/dpml/library/info/ModuleDirective.java
===================================================================
--- 
trunk/main/depot/library/src/main/net/dpml/library/info/ModuleDirective.java  
      2006-04-19 04:43:53 UTC (rev 1381)
+++ 
trunk/main/depot/library/src/main/net/dpml/library/info/ModuleDirective.java  
      2006-04-19 05:55:14 UTC (rev 1382)
@@ -45,6 +45,7 @@
     * @param dependencies resource dependencies
     * @param properties suppliementary properties
     * @param filters source filters
+    * @param resources subsidary resources
     * @return the immediate enclosing resource
     */
     public static ModuleDirective createModuleDirective( 

Modified: 
trunk/main/depot/library/src/main/net/dpml/library/info/ResourceDirective.java
===================================================================
--- 
trunk/main/depot/library/src/main/net/dpml/library/info/ResourceDirective.java
      2006-04-19 04:43:53 UTC (rev 1381)
+++ 
trunk/main/depot/library/src/main/net/dpml/library/info/ResourceDirective.java
      2006-04-19 05:55:14 UTC (rev 1382)
@@ -62,6 +62,7 @@
     * @param version the resource version
     * @param type the resource type
     * @param properties suppliementary properties
+    * @return the resource directive
     */
     public static ResourceDirective createAnonymousResource( 
       String name, String version, String type, Properties properties )

Modified: 
trunk/main/depot/library/src/test/net/dpml/library/impl/AbsoluteTestCase.java
===================================================================
--- 
trunk/main/depot/library/src/test/net/dpml/library/impl/AbsoluteTestCase.java 
      2006-04-19 04:43:53 UTC (rev 1381)
+++ 
trunk/main/depot/library/src/test/net/dpml/library/impl/AbsoluteTestCase.java 
      2006-04-19 05:55:14 UTC (rev 1382)
@@ -26,8 +26,6 @@
 import net.dpml.util.Logger;
 import net.dpml.util.DefaultLogger;
 
-import junit.framework.TestCase;
-
 /**
  * The ImportDirective class describes a the inclusion of a typed value.
  *

Modified: 
trunk/main/depot/library/src/test/net/dpml/library/impl/PropertiesTestCase.java
===================================================================
--- 
trunk/main/depot/library/src/test/net/dpml/library/impl/PropertiesTestCase.java
     2006-04-19 04:43:53 UTC (rev 1381)
+++ 
trunk/main/depot/library/src/test/net/dpml/library/impl/PropertiesTestCase.java
     2006-04-19 05:55:14 UTC (rev 1382)
@@ -20,14 +20,9 @@
 
 import java.io.File;
 
-import net.dpml.library.Module;
-import net.dpml.library.Resource;
-
 import net.dpml.util.Logger;
 import net.dpml.util.DefaultLogger;
 
-import junit.framework.TestCase;
-
 /**
  * The ImportDirective class describes a the inclusion of a typed value.
  *

Modified: 
trunk/main/depot/tools/builder/src/main/net/dpml/tools/impl/DefaultContext.java
===================================================================
--- 
trunk/main/depot/tools/builder/src/main/net/dpml/tools/impl/DefaultContext.java
     2006-04-19 04:43:53 UTC (rev 1381)
+++ 
trunk/main/depot/tools/builder/src/main/net/dpml/tools/impl/DefaultContext.java
     2006-04-19 05:55:14 UTC (rev 1382)
@@ -50,9 +50,7 @@
 import org.apache.tools.ant.Project;
 import org.apache.tools.ant.BuildException;
 import org.apache.tools.ant.BuildListener;
-import org.apache.tools.ant.Target;
 import org.apache.tools.ant.types.Path;
-import org.apache.tools.ant.taskdefs.Delete;
 
 /**
  * Default implmentation of a project context.
@@ -73,6 +71,7 @@
    /**
     * Creation of a new project build context.
     * @param project the unconfigured Ant project
+    * @exception Exception if an error occurs during context extablishment
     */
     public DefaultContext( Project project ) throws Exception
     {
@@ -85,6 +84,7 @@
     * Creation of a new project build context.
     * @param resource the resource definition
     * @param project the Ant project
+    * @exception Exception if an error occurs during context extablishment
     */
     public DefaultContext( Resource resource, Project project ) throws 
Exception
     {
@@ -714,7 +714,7 @@
         return buffer.toString();
     }
     
-    public BuildListener loadBuildListener( ListenerDirective listener )
+    private BuildListener loadBuildListener( ListenerDirective listener )
     {
         String name = listener.getName();
         URI uri = listener.getURI();
@@ -737,7 +737,7 @@
         }
     }
     
-    public Processor loadProcessor( ProcessorDirective directive )
+    private Processor loadProcessor( ProcessorDirective directive )
     {
         String name = directive.getName();
         URI uri = directive.getURI();
@@ -760,7 +760,7 @@
         }
     }
     
-    public Object loadInstance( String name, URI uri, String classname )
+    private Object loadInstance( String name, URI uri, String classname )
     {
         if( null == uri )
         {

Modified: 
trunk/main/depot/tools/builder/src/main/net/dpml/tools/impl/DefaultWorkbench.java
===================================================================
--- 
trunk/main/depot/tools/builder/src/main/net/dpml/tools/impl/DefaultWorkbench.java
   2006-04-19 04:43:53 UTC (rev 1381)
+++ 
trunk/main/depot/tools/builder/src/main/net/dpml/tools/impl/DefaultWorkbench.java
   2006-04-19 05:55:14 UTC (rev 1382)
@@ -26,18 +26,8 @@
 import net.dpml.library.Library;
 import net.dpml.library.Resource;
 import net.dpml.library.Type;
-
-import net.dpml.tools.info.BuilderDirective;
-import net.dpml.tools.info.BuilderDirectiveHelper;
-import net.dpml.tools.info.ListenerDirective;
 import net.dpml.tools.info.ProcessorDirective;
 
-import net.dpml.tools.model.Context;
-//import net.dpml.tools.model.Processor;
-//import net.dpml.tools.model.ProcessorNotFoundException;
-
-import org.apache.tools.ant.Project;
-
 /**
  * The Profile interface exposes the working configuration of the build 
system.
  *

Modified: 
trunk/main/depot/tools/builder/src/main/net/dpml/tools/impl/StandardBuildListener.java
===================================================================
--- 
trunk/main/depot/tools/builder/src/main/net/dpml/tools/impl/StandardBuildListener.java
      2006-04-19 04:43:53 UTC (rev 1381)
+++ 
trunk/main/depot/tools/builder/src/main/net/dpml/tools/impl/StandardBuildListener.java
      2006-04-19 05:55:14 UTC (rev 1382)
@@ -21,17 +21,17 @@
 import net.dpml.tools.model.Context;
 import net.dpml.tools.model.Processor;
 
-import net.dpml.tools.info.ProcessorDirective;
 import net.dpml.tools.process.StandardProcess;
 
 import org.apache.tools.ant.BuildListener;
 import org.apache.tools.ant.BuildEvent;
 import org.apache.tools.ant.Target;
-import org.apache.tools.ant.Location;
 import org.apache.tools.ant.Project;
 
 /**
- * Standard build listener.
+ * Standard build listener.  The implementation provides support
+ * for codebase structure normalization, and delegation of type-specific
+ * build functions to build processors. 
  *
  * @author <a href="@PUBLISHER-URL@">@PUBLISHER-NAME@</a>
  * @version @PROJECT-VERSION@
@@ -41,6 +41,10 @@
     private final Context m_context;
     private final StandardProcess m_standard;
     
+   /**
+    * Creation of a new standard build listener.
+    * @param context the wotrking context
+    */
     public StandardBuildListener( Context context )
     {
         if( null == context )

Modified: 
trunk/main/depot/tools/builder/src/main/net/dpml/tools/impl/StandardBuilder.java
===================================================================
--- 
trunk/main/depot/tools/builder/src/main/net/dpml/tools/impl/StandardBuilder.java
    2006-04-19 04:43:53 UTC (rev 1381)
+++ 
trunk/main/depot/tools/builder/src/main/net/dpml/tools/impl/StandardBuilder.java
    2006-04-19 05:55:14 UTC (rev 1382)
@@ -21,13 +21,11 @@
 import java.io.File;
 import java.net.URI;
 import java.net.URL;
-import java.util.Date;
 import java.util.Vector;
 
 import net.dpml.library.Builder;
 import net.dpml.library.Library;
 import net.dpml.library.Resource;
-import net.dpml.library.Filter;
 
 import net.dpml.tools.model.Context;
 import net.dpml.tools.info.BuilderDirective;
@@ -66,6 +64,9 @@
     */
     public static final String DEFAULT_TEMPLATE_URN = 
"local:template:dpml/tools/standard";
     
+   /**
+    * The builder configuration.
+    */
     public static final BuilderDirective CONFIGURATION = loadConfiguration();
     
     private static BuilderDirective loadConfiguration()

Modified: 
trunk/main/depot/tools/builder/src/main/net/dpml/tools/info/BuilderDirective.java
===================================================================
--- 
trunk/main/depot/tools/builder/src/main/net/dpml/tools/info/BuilderDirective.java
   2006-04-19 04:43:53 UTC (rev 1381)
+++ 
trunk/main/depot/tools/builder/src/main/net/dpml/tools/info/BuilderDirective.java
   2006-04-19 05:55:14 UTC (rev 1382)
@@ -45,6 +45,7 @@
     * @param phase the default target phase
     * @param processors an array of processor directives
     * @param properties supplimentary properties
+    * @exception UnknownKeyException if a unknown key is referenced
     */
     public BuilderDirective( 
       ListenerDirective[] listeners, String phase, 

Modified: 
trunk/main/depot/tools/builder/src/main/net/dpml/tools/info/BuilderDirectiveHelper.java
===================================================================
--- 
trunk/main/depot/tools/builder/src/main/net/dpml/tools/info/BuilderDirectiveHelper.java
     2006-04-19 04:43:53 UTC (rev 1381)
+++ 
trunk/main/depot/tools/builder/src/main/net/dpml/tools/info/BuilderDirectiveHelper.java
     2006-04-19 05:55:14 UTC (rev 1382)
@@ -19,7 +19,6 @@
 package net.dpml.tools.info;
 
 import java.io.File;
-import java.io.InputStream;
 import java.io.IOException;
 import java.io.FileNotFoundException;
 import java.io.FileInputStream;
@@ -28,17 +27,11 @@
 import java.net.URL;
 import java.util.Properties;
 
-import net.dpml.tools.process.JarProcess;
-import net.dpml.tools.process.PluginProcess;
-import net.dpml.tools.process.ModuleProcess;
-
 import net.dpml.transit.Artifact;
 import net.dpml.transit.Transit;
 
 import net.dpml.util.ElementHelper;
 
-import net.dpml.lang.UnknownKeyException;
-
 import org.w3c.dom.Element;
 
 /**

Modified: 
trunk/main/depot/tools/builder/src/main/net/dpml/tools/model/Context.java
===================================================================
--- trunk/main/depot/tools/builder/src/main/net/dpml/tools/model/Context.java 
  2006-04-19 04:43:53 UTC (rev 1381)
+++ trunk/main/depot/tools/builder/src/main/net/dpml/tools/model/Context.java 
  2006-04-19 05:55:14 UTC (rev 1382)
@@ -24,8 +24,6 @@
 import net.dpml.library.Library;
 import net.dpml.library.Resource;
 
-import net.dpml.tools.info.ProcessorDirective;
-
 import org.apache.tools.ant.Project;
 import org.apache.tools.ant.types.Path;
 

Modified: 
trunk/main/depot/tools/builder/src/main/net/dpml/tools/model/Processor.java
===================================================================
--- 
trunk/main/depot/tools/builder/src/main/net/dpml/tools/model/Processor.java 
2006-04-19 04:43:53 UTC (rev 1381)
+++ 
trunk/main/depot/tools/builder/src/main/net/dpml/tools/model/Processor.java 
2006-04-19 05:55:14 UTC (rev 1382)
@@ -1,5 +1,5 @@
 /*
- * Copyright 2005 Stephen J. McConnell
+ * Copyright 2005-2006 Stephen J. McConnell
  *
  * Licensed  under the  Apache License,  Version 2.0  (the "License");
  * you may not use  this file  except in  compliance with the License.
@@ -18,10 +18,6 @@
 
 package net.dpml.tools.model;
 
-import java.net.URI;
-
-import net.dpml.library.Dictionary;
-
 /**
  * The Processor interface is implemented by phase-aware build processors.
  *
@@ -30,15 +26,40 @@
  */
 public interface Processor
 {
+   /**
+    * Handle initialization.
+    * @param context the working context
+    */
     void initialize( Context context );
     
+   /**
+    * Handle supplimentary codebase preparation.
+    * @param context the working context
+    */
     void prepare( Context context );
     
+   /**
+    * Handle type-specific construction in preparation for 
+    * data packaging.
+    * @param context the working context
+    */
     void build( Context context );
     
+   /**
+    * Packaging of type-specific data.
+    * @param context the working context
+    */
     void pack( Context context );
     
+   /**
+    * Datatype validation.
+    * @param context the working context
+    */
     void validate( Context context );
     
+   /**
+    * Post installation actions.
+    * @param context the working context
+    */
     void install( Context context );
 }

Modified: 
trunk/main/depot/tools/builder/src/main/net/dpml/tools/process/AbstractProcessor.java
===================================================================
--- 
trunk/main/depot/tools/builder/src/main/net/dpml/tools/process/AbstractProcessor.java
       2006-04-19 04:43:53 UTC (rev 1381)
+++ 
trunk/main/depot/tools/builder/src/main/net/dpml/tools/process/AbstractProcessor.java
       2006-04-19 05:55:14 UTC (rev 1382)
@@ -29,26 +29,51 @@
  */
 public class AbstractProcessor implements Processor
 {
+   /**
+    * Handle initialization.
+    * @param context the working context
+    */
     public void initialize( Context context )
     {
     }
     
+   /**
+    * Handle supplimentary codebase preparation.
+    * @param context the working context
+    */
     public void prepare( Context context )
     {
     }
     
+   /**
+    * Handle type-specific construction in preparation for 
+    * data packaging.
+    * @param context the working context
+    */
     public void build( Context context )
     {
     }
     
+   /**
+    * Packaging of type-specific data.
+    * @param context the working context
+    */
     public void pack( Context context )
     {
     }
     
+   /**
+    * Datatype validation.
+    * @param context the working context
+    */
     public void validate( Context context )
     {
     }
     
+   /**
+    * Post installation actions.
+    * @param context the working context
+    */
     public void install( Context context )
     {
     }

Modified: 
trunk/main/depot/tools/builder/src/main/net/dpml/tools/process/JarProcess.java
===================================================================
--- 
trunk/main/depot/tools/builder/src/main/net/dpml/tools/process/JarProcess.java
      2006-04-19 04:43:53 UTC (rev 1381)
+++ 
trunk/main/depot/tools/builder/src/main/net/dpml/tools/process/JarProcess.java
      2006-04-19 05:55:14 UTC (rev 1382)
@@ -23,7 +23,6 @@
 import net.dpml.library.info.Scope;
 
 import net.dpml.tools.model.Context;
-//import net.dpml.tools.model.Processor;
 
 import net.dpml.tools.tasks.JavacTask;
 import net.dpml.tools.tasks.JarTask;
@@ -31,18 +30,23 @@
 
 import org.apache.tools.ant.BuildException;
 import org.apache.tools.ant.Project;
-import org.apache.tools.ant.Target;
-import org.apache.tools.ant.BuildEvent;
 import org.apache.tools.ant.types.Path;
 
 /**
- * Execute all plugins relative to the current build phase.
+ * Processor supporting ujava class compilation, jar creation, 
+ * testcase compilation and test execution.
  *
  * @author <a href="@PUBLISHER-URL@">@PUBLISHER-NAME@</a>
  * @version @PROJECT-VERSION@
  */
 public class JarProcess extends AbstractProcessor
 {
+   /**
+    * Executes the compilation of java source files
+    * under the normalized target/main/classes directory.
+    *
+    * @param context the working context
+    */
     public void build( Context context )
     {
         Project project = context.getProject();
@@ -52,6 +56,12 @@
         task.execute();
     }
     
+   /**
+    * Packages java class files into a jar file published under 
+    * the target/deliverables/jars directory.
+    *
+    * @param context the working context
+    */
     public void pack( Context context )
     {
         Project project = context.getProject();
@@ -70,6 +80,12 @@
         }
     }
     
+   /**
+    * Compiles and executes unit tests using a classpath incorporating the 
+    * jar file produced under the pack phase.
+    *
+    * @param context the working context
+    */
     public void validate( Context context )
     {
         Project project = context.getProject();

Modified: 
trunk/main/depot/tools/builder/src/main/net/dpml/tools/process/ModuleProcess.java
===================================================================
--- 
trunk/main/depot/tools/builder/src/main/net/dpml/tools/process/ModuleProcess.java
   2006-04-19 04:43:53 UTC (rev 1381)
+++ 
trunk/main/depot/tools/builder/src/main/net/dpml/tools/process/ModuleProcess.java
   2006-04-19 05:55:14 UTC (rev 1382)
@@ -23,17 +23,21 @@
 import net.dpml.tools.tasks.ModuleTask;
 
 import org.apache.tools.ant.Project;
-import org.apache.tools.ant.Target;
-import org.apache.tools.ant.BuildEvent;
 
 /**
- * Execute all plugins relative to the current build phase.
+ * Processor supporting module datatype production.
  *
  * @author <a href="@PUBLISHER-URL@">@PUBLISHER-NAME@</a>
  * @version @PROJECT-VERSION@
  */
 public class ModuleProcess extends AbstractProcessor
 {
+   /**
+    * Creation of a module descriptor under the directory
+    * target/deliverables/modules.
+    *
+    * @param context the working context
+    */
     public void pack( Context context )
     {
         Project project = context.getProject();

Modified: 
trunk/main/depot/tools/builder/src/main/net/dpml/tools/process/PluginProcess.java
===================================================================
--- 
trunk/main/depot/tools/builder/src/main/net/dpml/tools/process/PluginProcess.java
   2006-04-19 04:43:53 UTC (rev 1381)
+++ 
trunk/main/depot/tools/builder/src/main/net/dpml/tools/process/PluginProcess.java
   2006-04-19 05:55:14 UTC (rev 1382)
@@ -25,18 +25,22 @@
 import net.dpml.util.ExceptionHelper;
 
 import org.apache.tools.ant.Project;
-import org.apache.tools.ant.Target;
-import org.apache.tools.ant.BuildEvent;
 import org.apache.tools.ant.BuildException;
 
 /**
- * Execute all plugins relative to the current build phase.
+ * Processor supporting part datatype production.
  *
  * @author <a href="@PUBLISHER-URL@">@PUBLISHER-NAME@</a>
  * @version @PROJECT-VERSION@
  */
 public class PluginProcess extends AbstractProcessor
 {    
+   /**
+    * Creation of a part descriptor under the directory
+    * target/deliverables/parts.
+    *
+    * @param context the working context
+    */
     public void pack( Context context )
     {
         try

Modified: 
trunk/main/depot/tools/builder/src/main/net/dpml/tools/process/StandardProcess.java
===================================================================
--- 
trunk/main/depot/tools/builder/src/main/net/dpml/tools/process/StandardProcess.java
 2006-04-19 04:43:53 UTC (rev 1381)
+++ 
trunk/main/depot/tools/builder/src/main/net/dpml/tools/process/StandardProcess.java
 2006-04-19 05:55:14 UTC (rev 1382)
@@ -18,30 +18,40 @@
 
 package net.dpml.tools.process;
 
-import net.dpml.library.Resource;
-
 import net.dpml.tools.model.Context;
-
 import net.dpml.tools.tasks.PrepareTask;
 import net.dpml.tools.tasks.InstallTask;
 
 import org.apache.tools.ant.Project;
-import org.apache.tools.ant.Target;
-import org.apache.tools.ant.BuildEvent;
 
 /**
- * Execute all plugins relative to the current build phase.
+ * Standard process dealing with context initialization, codfebase 
+ * normalization, and artifact installation.
  *
  * @author <a href="@PUBLISHER-URL@">@PUBLISHER-NAME@</a>
  * @version @PROJECT-VERSION@
  */
 public class StandardProcess extends AbstractProcessor
 {
+   /**
+    * Handles context initialization during which path definitions
+    * for runtime and test concerns are bound to the active project.
+    *
+    * @param context the working context
+    */
     public void initialize( Context context )
     {
         context.init();
     }
     
+   /**
+    * Handles normalization of a codebase during which a working copy of 
+    * the codebase is created under the target/build directory.  Global 
+    * filters are applied and merging of the src/main with etc/main and 
+    * src/test wityh etc/test is undertaken.
+    *
+    * @param context the working context
+    */
     public void prepare( Context context )
     {
         context.getProject().log( "commencing preparation", 
Project.MSG_VERBOSE );
@@ -54,6 +64,13 @@
         context.getProject().log( "preparation complete", 
Project.MSG_VERBOSE );
     }
     
+   /**
+    * Handles replication of content under target/deliverables to the 
+    * common cache directory - includes validation of the presence of 
declared 
+    * artifacts during execution.
+    *
+    * @param context the working context
+    */
     public void install( Context context )
     {
         Project project = context.getProject();

Modified: 
trunk/main/depot/tools/builder/src/main/net/dpml/tools/tasks/GenericTask.java
===================================================================
--- 
trunk/main/depot/tools/builder/src/main/net/dpml/tools/tasks/GenericTask.java 
      2006-04-19 04:43:53 UTC (rev 1381)
+++ 
trunk/main/depot/tools/builder/src/main/net/dpml/tools/tasks/GenericTask.java 
      2006-04-19 05:55:14 UTC (rev 1382)
@@ -25,12 +25,7 @@
 
 import net.dpml.library.Library;
 import net.dpml.library.Resource;
-import net.dpml.library.impl.DefaultLibrary;
 
-import net.dpml.util.Logger;
-
-import net.dpml.transit.monitor.LoggingAdapter;
-
 import org.apache.tools.ant.BuildException;
 import org.apache.tools.ant.Project;
 import org.apache.tools.ant.Task;

Modified: 
trunk/main/depot/tools/builder/src/main/net/dpml/tools/tasks/InitializationTask.java
===================================================================
--- 
trunk/main/depot/tools/builder/src/main/net/dpml/tools/tasks/InitializationTask.java
        2006-04-19 04:43:53 UTC (rev 1381)
+++ 
trunk/main/depot/tools/builder/src/main/net/dpml/tools/tasks/InitializationTask.java
        2006-04-19 05:55:14 UTC (rev 1382)
@@ -18,23 +18,13 @@
 
 package net.dpml.tools.tasks;
 
-import java.net.URI;
 import java.util.ArrayList;
-import java.util.Date;
 
-import net.dpml.lang.Part;
-import net.dpml.lang.Plugin;
-
-import net.dpml.library.Resource;
-
 import net.dpml.tools.model.Context;
 
-import org.apache.tools.ant.Project;
-import org.apache.tools.ant.BuildListener;
-import org.apache.tools.ant.BuildException;
-
 /**
- * Execute the install phase.
+ * General initialization during which context establishment is 
+ * undertaken (if not already present).
  *
  * @author <a href="@PUBLISHER-URL@">@PUBLISHER-NAME@</a>
  * @version @PROJECT-VERSION@