You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@avalon.apache.org by do...@apache.org on 2002/09/06 14:01:09 UTC

cvs commit: jakarta-avalon-phoenix/src/java/org/apache/avalon/phoenix/components/embeddor DefaultEmbeddor.java

donaldp     2002/09/06 05:01:08

  Modified:    src/java/org/apache/avalon/phoenix/components/application
                        BlockResourceProvider.java DefaultApplication.java
                        ListenerSupport.java
               src/java/org/apache/avalon/phoenix/components/classloader
                        ContextClassLoaderManager.java
                        DefaultClassLoaderManager.java
                        PolicyClassLoader.java
               src/java/org/apache/avalon/phoenix/components/configuration
                        FileSystemPersistentConfigurationRepository.java
               src/java/org/apache/avalon/phoenix/components/embeddor
                        DefaultEmbeddor.java
  Log:
  Convert some more <code> sections into {@link} sections.
  
  Revision  Changes    Path
  1.6       +9 -9      jakarta-avalon-phoenix/src/java/org/apache/avalon/phoenix/components/application/BlockResourceProvider.java
  
  Index: BlockResourceProvider.java
  ===================================================================
  RCS file: /home/cvs/jakarta-avalon-phoenix/src/java/org/apache/avalon/phoenix/components/application/BlockResourceProvider.java,v
  retrieving revision 1.5
  retrieving revision 1.6
  diff -u -r1.5 -r1.6
  --- BlockResourceProvider.java	26 Aug 2002 10:39:55 -0000	1.5
  +++ BlockResourceProvider.java	6 Sep 2002 12:01:07 -0000	1.6
  @@ -115,11 +115,11 @@
       }
   
       /**
  -     * Create a <code>ComponentManager</code> object for a
  -     * specific <code>Block</code>. This requires that for
  -     * each dependency a reference to providing <code>Block</code>
  +     * Create a {@link ComponentManager} object for a
  +     * specific Block. This requires that for
  +     * each dependency a reference to providing Block
        * is aaqiured from the Application and placing it in
  -     * <code>ComponentManager</code> under the correct name.
  +     * {@link ComponentManager} under the correct name.
        *
        * @param entry the entry representing block
        * @return the created ComponentManager
  @@ -154,11 +154,11 @@
       }
   
       /**
  -     * Create a <code>ServiceManager</code> object for a
  -     * specific <code>Block</code>. This requires that for
  -     * each dependency a reference to providing <code>Block</code>
  +     * Create a {@link ServiceManager} object for a
  +     * specific Block. This requires that for
  +     * each dependency a reference to providing Block
        * is aaqiured from the Application and placing it in
  -     * <code>ServiceManager</code> under the correct name.
  +     * {@link ServiceManager} under the correct name.
        *
        * @param entry the entry representing block
        * @return the created ServiceManager
  
  
  
  1.36      +5 -5      jakarta-avalon-phoenix/src/java/org/apache/avalon/phoenix/components/application/DefaultApplication.java
  
  Index: DefaultApplication.java
  ===================================================================
  RCS file: /home/cvs/jakarta-avalon-phoenix/src/java/org/apache/avalon/phoenix/components/application/DefaultApplication.java,v
  retrieving revision 1.35
  retrieving revision 1.36
  diff -u -r1.35 -r1.36
  --- DefaultApplication.java	7 Aug 2002 03:00:00 -0000	1.35
  +++ DefaultApplication.java	6 Sep 2002 12:01:07 -0000	1.36
  @@ -463,8 +463,8 @@
       }
   
       /**
  -     * Method to run a <code>Block</code> through it's startup phase.
  -     * This will involve notification of <code>BlockListener</code>
  +     * Method to run a Block through it's startup phase.
  +     * This will involve notification of {@link BlockListener}
        * objects, creation of the Block/Block Proxy object, calling the startup
        * Avalon Lifecycle methods and updating State property of BlockEntry.
        * Errors that occur during shutdown will be logged appropriately and
  @@ -492,8 +492,8 @@
       }
   
       /**
  -     * Method to run a <code>Block</code> through it's shutdown phase.
  -     * This will involve notification of <code>BlockListener</code>
  +     * Method to run a Block through it's shutdown phase.
  +     * This will involve notification of {@link BlockListener}
        * objects, invalidating the proxy object, calling the shutdown
        * Avalon Lifecycle methods and updating State property of BlockEntry.
        * Errors that occur during shutdown will be logged appropraitely.
  @@ -524,7 +524,7 @@
       }
   
       /**
  -     * Method to run a <code>BlockListener</code> through it's startup phase.
  +     * Method to run a {@link BlockListener} through it's startup phase.
        * This will involve creation of BlockListener object and configuration of
        * object if appropriate.
        *
  
  
  
  1.4       +6 -6      jakarta-avalon-phoenix/src/java/org/apache/avalon/phoenix/components/application/ListenerSupport.java
  
  Index: ListenerSupport.java
  ===================================================================
  RCS file: /home/cvs/jakarta-avalon-phoenix/src/java/org/apache/avalon/phoenix/components/application/ListenerSupport.java,v
  retrieving revision 1.3
  retrieving revision 1.4
  diff -u -r1.3 -r1.4
  --- ListenerSupport.java	6 Aug 2002 11:57:39 -0000	1.3
  +++ ListenerSupport.java	6 Sep 2002 12:01:07 -0000	1.4
  @@ -15,8 +15,8 @@
   import org.apache.avalon.phoenix.metadata.SarMetaData;
   
   /**
  - * Manage a set of <code>ApplicationListener</code> objects and propogate
  - * <code>ApplicationEvent</code> notifications to these listeners.  Not all
  + * Manage a set of {@link ApplicationListener} objects and propogate
  + * {@link ApplicationEvent} notifications to these listeners.  Not all
    * events pass an Applicationevent parameter.
    *
    * @author <a href="mailto:peter at apache.org">Peter Donald</a>
  @@ -85,7 +85,7 @@
   
       /**
        * Add a ApplicationListener to those requiring notification of
  -     * <code>ApplicationEvent</code>s.
  +     * {@link ApplicationEvent}s.
        *
        * @param listener the ApplicationListener
        */
  @@ -99,7 +99,7 @@
   
       /**
        * Remove a ApplicationListener from those requiring notification of
  -     * <code>ApplicationEvent</code>s.
  +     * {@link ApplicationEvent}s.
        *
        * @param listener the ApplicationListener
        */
  @@ -127,7 +127,7 @@
   
       /**
        * Add a BlockListener to those requiring notification of
  -     * <code>BlockEvent</code>s.
  +     * {@link BlockEvent}s.
        *
        * @param listener the BlockListener
        */
  @@ -141,7 +141,7 @@
   
       /**
        * Remove a BlockListener from those requiring notification of
  -     * <code>BlockEvent</code>s.
  +     * {@link BlockEvent}s.
        *
        * @param listener the BlockListener
        */
  
  
  
  1.9       +1 -1      jakarta-avalon-phoenix/src/java/org/apache/avalon/phoenix/components/classloader/ContextClassLoaderManager.java
  
  Index: ContextClassLoaderManager.java
  ===================================================================
  RCS file: /home/cvs/jakarta-avalon-phoenix/src/java/org/apache/avalon/phoenix/components/classloader/ContextClassLoaderManager.java,v
  retrieving revision 1.8
  retrieving revision 1.9
  diff -u -r1.8 -r1.9
  --- ContextClassLoaderManager.java	20 May 2002 10:25:46 -0000	1.8
  +++ ContextClassLoaderManager.java	6 Sep 2002 12:01:07 -0000	1.9
  @@ -15,7 +15,7 @@
       implements ClassLoaderManager
   {
       /**
  -     * Return current Context <code>ClassLoader</code>.
  +     * Return current Context {@link ClassLoader}.
        *
        * @param environment ignored
        * @param source the source of application. (usually the name of the .sar file
  
  
  
  1.40      +1 -1      jakarta-avalon-phoenix/src/java/org/apache/avalon/phoenix/components/classloader/DefaultClassLoaderManager.java
  
  Index: DefaultClassLoaderManager.java
  ===================================================================
  RCS file: /home/cvs/jakarta-avalon-phoenix/src/java/org/apache/avalon/phoenix/components/classloader/DefaultClassLoaderManager.java,v
  retrieving revision 1.39
  retrieving revision 1.40
  diff -u -r1.39 -r1.40
  --- DefaultClassLoaderManager.java	6 Aug 2002 11:57:39 -0000	1.39
  +++ DefaultClassLoaderManager.java	6 Sep 2002 12:01:07 -0000	1.40
  @@ -34,7 +34,7 @@
   
   /**
    * Component that creates and manages the {@link ClassLoader}
  - * for an application loaded out of a <code>.sar</code> deployment.
  + * for an application loaded out of a <tt>.sar</tt> deployment.
    *
    * <p>Currently it creates a policy based on the policy declaration
    * in the configuration. It then just creates a URLClassLoader and
  
  
  
  1.20      +1 -1      jakarta-avalon-phoenix/src/java/org/apache/avalon/phoenix/components/classloader/PolicyClassLoader.java
  
  Index: PolicyClassLoader.java
  ===================================================================
  RCS file: /home/cvs/jakarta-avalon-phoenix/src/java/org/apache/avalon/phoenix/components/classloader/PolicyClassLoader.java,v
  retrieving revision 1.19
  retrieving revision 1.20
  diff -u -r1.19 -r1.20
  --- PolicyClassLoader.java	6 Aug 2002 11:57:39 -0000	1.19
  +++ PolicyClassLoader.java	6 Sep 2002 12:01:07 -0000	1.20
  @@ -138,7 +138,7 @@
       }
   
       /**
  -     * Find the resource in the ClassLoader. Return a <code>URL</code>
  +     * Find the resource in the ClassLoader. Return a {@link URL}
        * object if found, otherwise return null if this resource cannot
        * be found.
        *
  
  
  
  1.10      +2 -2      jakarta-avalon-phoenix/src/java/org/apache/avalon/phoenix/components/configuration/FileSystemPersistentConfigurationRepository.java
  
  Index: FileSystemPersistentConfigurationRepository.java
  ===================================================================
  RCS file: /home/cvs/jakarta-avalon-phoenix/src/java/org/apache/avalon/phoenix/components/configuration/FileSystemPersistentConfigurationRepository.java,v
  retrieving revision 1.9
  retrieving revision 1.10
  diff -u -r1.9 -r1.10
  --- FileSystemPersistentConfigurationRepository.java	2 Aug 2002 13:55:01 -0000	1.9
  +++ FileSystemPersistentConfigurationRepository.java	6 Sep 2002 12:01:07 -0000	1.10
  @@ -40,13 +40,13 @@
    * </p><p>
    * When a Configuration is retrieved from the repository, the configuration from disk is
    * <i>merged</i> with the configuration from the SAR. This merge is accompilished via
  - * <code>ConfigurationMerger.merge</code>.
  + * {@link ConfigurationMerger#merge}.
    * </p><p>
    * When a Configuration is stored in the repository, if there is no <i>transient</i>, that is,
    * configuration from the SAR, Configuration information, the first store is that. Subsequent
    * calls to storeConfiguration will persist the difference between the <i>transient</i>
    * Configuration and the passed configuration to disk. The differences are computed via
  - * <code>ConfigurationSplitter.split</code>
  + * {@link ConfigurationSplitter#split}
    * </p>
    *
    * @author <a href="mailto:proyal@apache.org">Peter Royal</a>
  
  
  
  1.78      +7 -6      jakarta-avalon-phoenix/src/java/org/apache/avalon/phoenix/components/embeddor/DefaultEmbeddor.java
  
  Index: DefaultEmbeddor.java
  ===================================================================
  RCS file: /home/cvs/jakarta-avalon-phoenix/src/java/org/apache/avalon/phoenix/components/embeddor/DefaultEmbeddor.java,v
  retrieving revision 1.77
  retrieving revision 1.78
  diff -u -r1.77 -r1.78
  --- DefaultEmbeddor.java	6 Aug 2002 11:57:40 -0000	1.77
  +++ DefaultEmbeddor.java	6 Sep 2002 12:01:07 -0000	1.78
  @@ -137,8 +137,8 @@
        * type include parameters used to setup proeprties of the embeddor.
        * The second type include the implementation names of the components
        * that the Embeddor manages. For instance if you want to replace the
  -     * <code>ConfigurationRepository</code> with your own repository you
  -     * would pass in a parameter such as;</p>
  +     * {@link org.apache.avalon.phoenix.interfaces.ConfigurationRepository}
  +     * with your own repository you would pass in a parameter such as;</p>
        * <p>org.apache.avalon.phoenix.interfaces.ConfigurationRepository =
        * com.biz.MyCustomConfigurationRepository</p>
        *
  @@ -188,7 +188,7 @@
       /**
        * Creates the core handlers - logger, deployer, Manager and
        * Kernel. Note that these are not set up properly until you have
  -     * called the <code>run()</code> method.
  +     * called the {@link #execute()} method.
        */
       public void initialize()
           throws Exception
  @@ -213,7 +213,7 @@
        * This is the main method of the embeddor. It sets up the core
        * components, and then deploys the <code>Facilities</code>. These
        * are registered with the Kernel and the Manager. The same
  -     * happens for the <code>Applications</code>.
  +     * happens for the {@link org.apache.avalon.phoenix.interfaces.Application}s.
        * Now, the Kernel is taken through its lifecycle. When it is
        * finished, as well as all the applications running in it, it
        * is shut down, after which the PhoenixEmbeddor is as well.
  @@ -234,7 +234,7 @@
           }
           else
           {
  -            // loop until <code>Shutdown</code> is created.
  +            // loop until Shutdown occurs.
               while( true )
               {
                   // wait() for shutdown() to take action...
  @@ -630,7 +630,8 @@
       }
   
       /**
  -     * Unregister embeddor and it's components from <code>SystemManager</code>.
  +     * Unregister embeddor and it's components from
  +     * {@link SystemManager}.
        */
       private void unregisterComponents()
           throws Exception
  
  
  

--
To unsubscribe, e-mail:   <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>