avalon-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From dona...@apache.org
Subject cvs commit: jakarta-avalon-site/docs/phoenix/mx index.html mxinfo.html overview.html structure.html xdoctags.html
Date Fri, 06 Sep 2002 23:31:52 GMT
donaldp     2002/09/06 16:31:52

  Modified:    docs/phoenix changes.html features.html
                        for-developers-a-future.html
                        for-developers-alternate-kernel.html
                        for-developers-project-structure.html
                        getting-started.html guide-administrator.html
                        guide-architecture.html guide-deployers.html
                        guide-example-configuration.html guide-roles.html
                        index.html install.html
               docs/phoenix/assemblers assembly-xml-specification.html
                        config-xml-specification.html
                        creating-a-server-application.html
                        environment-xml-specification.html index.html
                        what-is-a-server-application.html
               docs/phoenix/bdg blockinfo-specification.html
                        creating-a-block.html index.html
                        making-phoenix-compatible-comps.html
                        what-is-a-block-listener.html what-is-a-block.html
                        what-is-an-application-listener.html
  Added:       docs/phoenix guide-management.html
               docs/phoenix/mx index.html mxinfo.html overview.html
                        structure.html xdoctags.html
  Log:
  Update the Phoenix website.
  
  Revision  Changes    Path
  1.11      +1 -484    jakarta-avalon-site/docs/phoenix/changes.html
  
  Index: changes.html
  ===================================================================
  RCS file: /home/cvs/jakarta-avalon-site/docs/phoenix/changes.html,v
  retrieving revision 1.10
  retrieving revision 1.11
  diff -u -r1.10 -r1.11
  --- changes.html	30 Jun 2002 21:37:39 -0000	1.10
  +++ changes.html	6 Sep 2002 23:31:51 -0000	1.11
  @@ -1,492 +1,9 @@
   <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
   
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
   <!-- Content Stylesheet for Site -->
   
       
   <!-- start the processing -->
  -    <html>
  -    <head>
  -      <style type="text/css">
  -        @import url("./css/tigris.css");
  -        @import url("./css/site.css");
  -      </style>
  -      <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>
  -
  -            
  -      <title>Avalon Phoenix - Changes</title>
  -    </head>
  -
  -    <body marginwidth="0" marginheight="0" class="composite">
  -
  -      <div id="banner">
  -        <table border="0" cellspacing="0" cellpadding="8" width="100%">
  -          <!-- TOP IMAGE -->
  -          <tr>
  -            <td>      <td align="left">
  -    <a href="http://jakarta.apache.org"><img src="http://jakarta.apache.org/images/jakarta-logo.gif" border="0"/></a>
  -    </td>
  -    <td align="right">
  -              <a href="http://jakarta.apache.org/avalon/phoenix"><img src="./images/header.gif" alt="Avalon Phoenix" border="0"/></a>
  -        </td>
  -  </td>
  -            <td><div align="right" valign="bottom"><b><font size="+3">Avalon Phoenix</font></b></div></td>
  -          </tr>
  -        </table>
  -      </div>
  -
  -      <table border="0" cellspacing="0" cellpadding="8" width="100%" id="main">
  -        <tr valign="top">
  -          <!-- LEFT SIDE NAVIGATION -->
  -          <td id="leftcol" width="20%">
  -            <div id="navcolumn">
  -                  <div>
  -      <strong>Essentials</strong>
  -              <div><small>      <a href="./index.html">Overview</a>
  -  </small></div>
  -              <div><small>      <a href="./features.html">Features</a>
  -  </small></div>
  -              <div><small>      <a href="./getting-started.html">Getting started</a>
  -  </small></div>
  -              <div><small>      <a href="http://jakarta.apache.org/builds/jakarta-avalon-phoenix">Download</a>
  -  </small></div>
  -              <div><small>      <a href="./install.html">Install</a>
  -  </small></div>
  -          </div>
  -      <div>
  -      <strong>Guide</strong>
  -              <div><small>      <a href="./guide-architecture.html">Architectural Overview</a>
  -  </small></div>
  -              <div><small>      <a href="./guide-roles.html">Development Roles</a>
  -  </small></div>
  -              <div><small>      <a href="./guide-administrator.html">for Administrators</a>
  -  </small></div>
  -              <div><small>      <a href="./guide-deployers.html">for Deployers</a>
  -  </small></div>
  -              <div><small>      <a href="./assemblers/index.html">for Assemblers</a>
  -  </small></div>
  -              <div><small>      <a href="./bdg/index.html">for Block Developers</a>
  -  </small></div>
  -              <div><small>      <a href="./guide-example-configuration.html">Example configuration</a>
  -  </small></div>
  -          </div>
  -      <div>
  -      <strong>Reference</strong>
  -              <div><small>      <a href="./api/index.html">API Docs</a>
  -  </small></div>
  -              <div><small>      <a href="./assemblers/config-xml-specification.html">config.xml Specification</a>
  -  </small></div>
  -              <div><small>      <a href="./assemblers/assembly-xml-specification.html">assembly.xml Specification</a>
  -  </small></div>
  -              <div><small>      <a href="./assemblers/environment-xml-specification.html">environment.xml Specification</a>
  -  </small></div>
  -              <div><small>      <a href="./bdg/blockinfo-specification.html">BlockInfo Specification</a>
  -  </small></div>
  -          </div>
  -      <div>
  -      <strong>For Developers</strong>
  -              <div><small>      <a href="./changes.html">Changes</a>
  -  </small></div>
  -              <div><small>      <a href="http://jakarta.apache.org/avalon/code-standards.html">Coding standards</a>
  -  </small></div>
  -              <div><small>      <a href="./for-developers-project-structure.html">Project Structure</a>
  -  </small></div>
  -              <div><small>      <a href="http://jakarta.apache.org/site/cvsindex.html">CVS Repositories</a>
  -  </small></div>
  -              <div><small>      <a href="http://jakarta.apache.org/site/mail.html">Mailing Lists</a>
  -  </small></div>
  -              <div><small>      <a href="http://nagoya.apache.org/bugzilla/buglist.cgi?bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&bug_status=RESOLVED&product=Avalon&component=Phoenix">TODO</a>
  -  </small></div>
  -              <div><small>      <a href="http://nagoya.apache.org/bugzilla/enter_bug.cgi?product=Avalon&component=Phoenix">Bug Database</a>
  -  </small></div>
  -              <div><small>      <a href="http://nagoya.apache.org/bugzilla/enter_bug.cgi?product=Avalon&component=Phoenix&bug_severity=Enhancement">Enhancement Requests</a>
  -  </small></div>
  -              <div><small>      <a href="./for-developers-alternate-kernel.html">Alternate Kernels</a>
  -  </small></div>
  -          </div>
  -              </div>
  -          </td>
  -          <td><div id="bodycol"><div class="app">
  -
  -  <table border="0" cellspacing="0" cellpadding="2" width="100%">
  -    <tr><td bgcolor="#525D76">
  -      <font color="#ffffff" face="arial,helvetica,sanserif">
  -        <strong>ChangeLog</strong>
  -      </font>
  -    </td></tr>
  -    <tr><td>
  -      <blockquote>
  -                      <table border="0" cellspacing="0" cellpadding="2" width="100%">
  -    <tr><td bgcolor="#828DA6">
  -      <font color="#ffffff" face="arial,helvetica,sanserif">
  -        <strong>
  -          Revision 4.0a4 (Unreleased)
  -        </strong>
  -      </font>
  -    </td></tr>
  -    <tr><td>
  -      <blockquote>
  -        <ul>
  -                <li>  <p>
  -        Update documentation and move to Anakia for document generation.
  -    (PD)</p>
  -</li>
  -                <li>  <p>
  -Remove deprecated functionality for deploying old style .sar files or
  -deploying from a directory.
  -    (PD)</p>
  -</li>
  -                <li>  <p>
  -Remove deprecated Service interface.
  -    (PD)</p>
  -</li>
  -                <li>  <p>
  -Remove some deprecated methods from BlockContext.
  -    (PD)</p>
  -</li>
  -                <li>  <p>
  -Warn users if their blocks Work interfaces/Services implement
  -any lifecycle interfaces.
  -     (PD)</p>
  -</li>
  -                <li>  <p>
  -       Allow name sub-element in block section of BlockInfo.
  -    (SM)</p>
  -</li>
  -                <li>  <p>
  -        Add "sar:" URL protocol handling to policy section in environment.xml
  -        file.
  -     (PD)</p>
  -</li>
  -                <li>  <p>
  -        Blocks no longre need to implement Block interface. Block interface
  -        is thus deprecated as is AbstractBlock. This was done to facilitate
  -        sharing of components between multiple containers.
  -     (PD)</p>
  -</li>
  -                <li>  <p>
  -        Extrace Blocks to directory based on name deployed with rather than
  -        .sar name (to support multiple deployments of same .sar). Submitted
  -        By: Ulrich Mayring (ulim@denic.de)
  -     (PD)</p>
  -</li>
  -                <li>  <p>
  -        Rework deployer such that jars are extracted to a temporary work
  -        directory and then deleted when application is undeployed. This is
  -        to work around the JVM locking and caching the jars and thus allowing
  -        users to redeploy applications. Submitted By: Ulrich Mayring
  - (ulim@denic.de)
  -     (PD)</p>
  -</li>
  -                <li>  <p>
  -        Updated build script so it will work when installed in a directory
  -        with spaces. Submitted By: dsmiley@mitre.org (David Smiley)
  -     (PD)</p>
  -</li>
  -                <li>  <p>
  -        Use MX4J project to provide the JMX management kernel rather than
  -        RI.
  -     (PD)</p>
  -</li>
  -                <li>  <p>
  -        Make phoenix use a temporary located in its hierarchy by setting
  -        the JVM system property "java.io.tmp". By default this temporary
  -        location is $PHOENIX_HOME/temp
  -     (PD)</p>
  -</li>
  -                <li>  <p>
  -        Rework Embeddor so that it instantiates kernel components from a
  -        by reading the contents of conf/kernel.xml file.
  -        Submitted By: Joerg Bauer (bauer@denic.de)
  -     (PD)</p>
  -</li>
  -                <li>  <p>
  -        Add XDoclet tasks to generate the manifest and BlockInfo files
  -        based on javadoc tags inserted into Blocks java file. Originally
  -        Submitted By: vinay nair (vinayc77@yahoo.com)
  -     (PD)</p>
  -</li>
  -                <li>  <p>
  -        Added javadoc to more classes and added in package.html files
  -        where appropriate.
  -     (SM)</p>
  -</li>
  -                <li>  <p>
  -        Added ApplicationListener objects that implement all same
  -        funcitonality as BlockListener but also provide support
  -        for Application Starting/Stopping/Failure events and
  -        provide access to SarMetaData. Consequently deprecated
  -        BlockListener interface.
  -     (PH)</p>
  -</li>
  -                <li>  <p>
  -Enhanced DefaultManager to support authenticated connecitons.
  -Submitted By: "Jorg Bauer/Denic" (bauer@denic.de)
  -     (PD)</p>
  -</li>
  -                <li>  <p>
  -Add support for Parameterizable blocks. Submitted by:
  -Brian Olsen (brian@mmmanager.org)
  -     (MT)</p>
  -</li>
  -                <li>  <p>
  -Allow Blocks to declare that they are able to be exported to a Management
  -subsystem (ie JMS) by making their blocks declare (Management-access-points/)
  -        in their BlockInfo. Blocks will be exported to JMX with names like
  -        "application=Foo,name=MrBlock,role=org.apache.MyManagementInterface"
  -     (PD)</p>
  -</li>
  -                <li>  <p>
  -    Validate the assembly.xml file and any BlockInfo files if they
  -    declare the DTD correctly.
  -   (PD)</p>
  -</li>
  -                <li>  <p>
  -    Add native daemon support by using the daemon created in the
  -    http://wrapper.sourceforge.net/ project. Submitted By:
  -    Leif Mortenson (leif@silveregg.co.jp)
  -   (PD)</p>
  -</li>
  -                <li>  <p>
  -    Fixed bug where application names were inapropriately prefixed
  -    to log categories. Submitted By Antal Attila (atech@nolimits.ro)
  -   (PD)</p>
  -</li>
  -                <li>  <p>
  -    Fixed bug where application names were inapropriately prefixed
  -    to log categories.
  -   (PD)</p>
  -</li>
  -                <li>  <p>
  -    Allow jars contained within the .sar file to declare dependencies
  -    on libraries using the standard JDK1.2+ Extension mechanism. For
  -    more information about optional packages, see the document
  -    Optional Package Versioning in the documentation bundle for your
  -    Java2 Standard Edition package, in the file
  -    guide/extensions/versioning.html.
  -   (PD)</p>
  -</li>
  -                </ul>
  -      </blockquote>
  -    </td></tr>
  -  </table>
  -  </a>
  -                <table border="0" cellspacing="0" cellpadding="2" width="100%">
  -    <tr><td bgcolor="#828DA6">
  -      <font color="#ffffff" face="arial,helvetica,sanserif">
  -        <strong>
  -          Revision 4.0a3 (November 13, 2001)
  -        </strong>
  -      </font>
  -    </td></tr>
  -    <tr><td>
  -      <blockquote>
  -        <ul>
  -                <li>  <p>
  -    Add documentation describing BlockListener.
  -   (PD)</p>
  -</li>
  -                <li>  <p>
  -    Fixed bug that allowed binary distributions to be built without
  -    copying xerces.jar into correct place.
  -   (PD)</p>
  -</li>
  -                </ul>
  -      </blockquote>
  -    </td></tr>
  -  </table>
  -  </a>
  -                <table border="0" cellspacing="0" cellpadding="2" width="100%">
  -    <tr><td bgcolor="#828DA6">
  -      <font color="#ffffff" face="arial,helvetica,sanserif">
  -        <strong>
  -          Revision 4.0a2 (November 12, 2001)
  -        </strong>
  -      </font>
  -    </td></tr>
  -    <tr><td>
  -      <blockquote>
  -        <ul>
  -                <li>  <p>
  -    Update Phoenix to use the new Avalon Framework Logger interface rather than
  -    directly using LogKits Logger class. This required a backwards incompatible
  -    change in BlockContext. The getLogger() methods now return the Logger interface
  -    rather than LogKits Logger class. If a Block implements Loggable then it will
  -    be passed LogKits Logger, this is required for backwards compatability. If the
  -    Block implements LogEnabled it will receive the new style Logger.
  -   (PD)</p>
  -</li>
  -                <li>  <p>
  -    Add support for undeploying and unistalling applications. Add support for separating
  -    out install phase from deployment phase and persisting information about
  -    application installations.
  -   (MT)</p>
  -</li>
  -                <li>  <p>
  -    Rework the application deployment format (ie .sar format) to be more in line
  -    with other specifications. See docs/creating-a-server-application.html in distribution
  -    for current format description. The old format is deprecated but will still work.
  -   (PD)</p>
  -</li>
  -                <li>  <p>
  -    Created the start of a Phoenix Developers Kit (PDK) that will enable
  -    developers to rapidly become accustom to developing Phoenix applications.
  -   (PH)</p>
  -</li>
  -                <li>  <p>
  -    Started to incorporate the JMX code more fully into Phoenix kernel. Started
  -    doing this by refactoring the base MBeans and testing using the RIs agent.
  -   (PD)</p>
  -</li>
  -                <li>  <p>
  -    Separated code that validated assembly of application into separate
  -    classes. The validation is now much stricter and requires that
  -    Blocks conform to established patterns. The validation phase should give
  -    more reasonable explanations for violations. Extra validation checks
  -    include verifying that services offered by a Block are actually interfaces,
  -    that there is no circular dependencies, that declared Blocks and BlockListeners
  -    actually implement Block or BlockListener interface, that the names of Blocks
  -    are valid etc.
  -   (PD)</p>
  -</li>
  -                </ul>
  -      </blockquote>
  -    </td></tr>
  -  </table>
  -  </a>
  -                <table border="0" cellspacing="0" cellpadding="2" width="100%">
  -    <tr><td bgcolor="#828DA6">
  -      <font color="#ffffff" face="arial,helvetica,sanserif">
  -        <strong>
  -          Revision 4.0a1 (September 25, 2001)
  -        </strong>
  -      </font>
  -    </td></tr>
  -    <tr><td>
  -      <blockquote>
  -        <ul>
  -                <li>  <p>
  -    Too many things to enumerate here.  This is the first public release,
  -    and the code is still considered alpha.  In future releases, we will
  -    be much more careful to record the changes to Phoenix.
  -   (BL)</p>
  -</li>
  -                </ul>
  -      </blockquote>
  -    </td></tr>
  -  </table>
  -  </a>
  -                <table border="0" cellspacing="0" cellpadding="2" width="100%">
  -    <tr><td bgcolor="#828DA6">
  -      <font color="#ffffff" face="arial,helvetica,sanserif">
  -        <strong>
  -          Revision 3.1a2 (Unreleased)
  -        </strong>
  -      </font>
  -    </td></tr>
  -    <tr><td>
  -      <blockquote>
  -        <ul>
  -                <li>  <p>
  -      Added stylesheet to convert Stylebook markup to DocBook markup.
  -     (BL)</p>
  -</li>
  -                <li>  <p>
  -      Changed the documentation build process to use Cocoon to build
  -      the site.
  -     (BL)</p>
  -</li>
  -                <li>  <p>
  -    Legacy support for nested configuration elements in assembly file
  -    removed.
  -   (PD)</p>
  -</li>
  -                <li>  <p>
  -    Simplified Loader and made it set ContextClassLoader before executing
  -    Main method. It will also use the System property phoenix.home if set
  -    rather than always trying to dynamically determine home directory.
  -   (PD)</p>
  -</li>
  -                <li>  <p>
  -    Added SingleAppEmbeddor to launch a kernel to load a single Application.
  -    Patch supplied by "Eung-ju Park" (colus@isoft.co.kr). This is useful if
  -    you need to reuse the blocks in other contexts (such as in a Servlet).
  -   (PD)</p>
  -</li>
  -                <li>  <p>
  -    Made default SystemManager a NoopSystemManager. Patch supplied
  -    by "Eung-ju Park" (colus@isoft.co.kr). To re-enable RMI manager a new
  -    command line switch "--remote-manager" was added.
  -   (PD)</p>
  -</li>
  -                <li>  <p>
  -    Reworked SecurityManager setup. Instead of starting a security
  -    Manager inside the code it has been re-architectured so that the
  -    SecurityManager is set on the command line. This was to avoid a number
  -    of issues related to creating a URLClassLoader in an unprotected context
  -    before setting SecurityManager. ie As AccessControllerContext was null it
  -    is impossible to use ClassLoader.getResource(AsStream)(). This means that
  -    defining phoenix.insecure will no longer disable the SecurityManager. The
  -    replacement method is to set the native OS environment variable
  -    'PHOENIX_SECURE=false'.
  -   (PD)</p>
  -</li>
  -                <li>  <p>
  -    Separate Parsing of CLI arguements into separate class (CLISetup).
  -    This is to facilitate launching Phoenix as a native daemon using
  -    Tomcats Services API.
  -   (PD)</p>
  -</li>
  -                <li>  <p>
  -    Started Localizing text strings throughout Phoenix. This is done using
  -    ResourceManager and Resources from Avalon/Excalibur project.
  -   (PD)</p>
  -</li>
  -                </ul>
  -      </blockquote>
  -    </td></tr>
  -  </table>
  -  </a>
  -            </blockquote>
  -    </td></tr>
  -  </table>
  -            </div>
  -		<div align="right" id="authors">
  -			</div>
  -          </div></td>
  -        </tr>
  -      </table>
  -
  -      <!-- FOOTER -->
  -      <div id="footer">
  -        <table border="0" cellspacing="0" cellpadding="4">
  -          <tr>
  -            <td>Copyright &#169; 1999-2002, Apache Software Foundation</td>
  -          </tr>
  -        </table>
  -      </div>
  -
  -    </body>
  -  </html>
  -
  +#changes()
   <!-- end the processing -->
  -
  -
   
  
  
  
  1.13      +3 -21     jakarta-avalon-site/docs/phoenix/features.html
  
  Index: features.html
  ===================================================================
  RCS file: /home/cvs/jakarta-avalon-site/docs/phoenix/features.html,v
  retrieving revision 1.12
  retrieving revision 1.13
  diff -u -r1.12 -r1.13
  --- features.html	30 Jun 2002 21:37:39 -0000	1.12
  +++ features.html	6 Sep 2002 23:31:51 -0000	1.13
  @@ -1,23 +1,5 @@
   <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
   
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
   <!-- This is a generated file.  Do not edit. -->
       <html>
       <head>
  @@ -83,6 +65,8 @@
     </small></div>
                 <div><small>      <a href="./bdg/index.html">for Block Developers</a>
     </small></div>
  +              <div><small>      <a href="./mx/index.html">Management Guide</a>
  +  </small></div>
                 <div><small>      <a href="./guide-example-configuration.html">Example configuration</a>
     </small></div>
             </div>
  @@ -226,7 +210,7 @@
                             
   		
                                 <li
  -        >      Configuration management
  +        >      Configuration management and persistence
     </li>
                             
   		
  @@ -276,5 +260,3 @@
   
       </body>
     </html>
  -
  -
  
  
  
  1.6       +2 -20     jakarta-avalon-site/docs/phoenix/for-developers-a-future.html
  
  Index: for-developers-a-future.html
  ===================================================================
  RCS file: /home/cvs/jakarta-avalon-site/docs/phoenix/for-developers-a-future.html,v
  retrieving revision 1.5
  retrieving revision 1.6
  diff -u -r1.5 -r1.6
  --- for-developers-a-future.html	30 Jun 2002 21:37:39 -0000	1.5
  +++ for-developers-a-future.html	6 Sep 2002 23:31:51 -0000	1.6
  @@ -1,23 +1,5 @@
   <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
   
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
   <!-- This is a generated file.  Do not edit. -->
       <html>
       <head>
  @@ -83,6 +65,8 @@
     </small></div>
                 <div><small>      <a href="./bdg/index.html">for Block Developers</a>
     </small></div>
  +              <div><small>      <a href="./mx/index.html">Management Guide</a>
  +  </small></div>
                 <div><small>      <a href="./guide-example-configuration.html">Example configuration</a>
     </small></div>
             </div>
  @@ -196,5 +180,3 @@
   
       </body>
     </html>
  -
  -
  
  
  
  1.2       +2 -20     jakarta-avalon-site/docs/phoenix/for-developers-alternate-kernel.html
  
  Index: for-developers-alternate-kernel.html
  ===================================================================
  RCS file: /home/cvs/jakarta-avalon-site/docs/phoenix/for-developers-alternate-kernel.html,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- for-developers-alternate-kernel.html	30 Jun 2002 21:37:39 -0000	1.1
  +++ for-developers-alternate-kernel.html	6 Sep 2002 23:31:51 -0000	1.2
  @@ -1,23 +1,5 @@
   <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
   
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
   <!-- This is a generated file.  Do not edit. -->
       <html>
       <head>
  @@ -83,6 +65,8 @@
     </small></div>
                 <div><small>      <a href="./bdg/index.html">for Block Developers</a>
     </small></div>
  +              <div><small>      <a href="./mx/index.html">Management Guide</a>
  +  </small></div>
                 <div><small>      <a href="./guide-example-configuration.html">Example configuration</a>
     </small></div>
             </div>
  @@ -190,5 +174,3 @@
   
       </body>
     </html>
  -
  -
  
  
  
  1.6       +2 -20     jakarta-avalon-site/docs/phoenix/for-developers-project-structure.html
  
  Index: for-developers-project-structure.html
  ===================================================================
  RCS file: /home/cvs/jakarta-avalon-site/docs/phoenix/for-developers-project-structure.html,v
  retrieving revision 1.5
  retrieving revision 1.6
  diff -u -r1.5 -r1.6
  --- for-developers-project-structure.html	30 Jun 2002 21:37:39 -0000	1.5
  +++ for-developers-project-structure.html	6 Sep 2002 23:31:51 -0000	1.6
  @@ -1,23 +1,5 @@
   <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
   
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
   <!-- This is a generated file.  Do not edit. -->
       <html>
       <head>
  @@ -83,6 +65,8 @@
     </small></div>
                 <div><small>      <a href="./bdg/index.html">for Block Developers</a>
     </small></div>
  +              <div><small>      <a href="./mx/index.html">Management Guide</a>
  +  </small></div>
                 <div><small>      <a href="./guide-example-configuration.html">Example configuration</a>
     </small></div>
             </div>
  @@ -209,5 +193,3 @@
   
       </body>
     </html>
  -
  -
  
  
  
  1.13      +2 -20     jakarta-avalon-site/docs/phoenix/getting-started.html
  
  Index: getting-started.html
  ===================================================================
  RCS file: /home/cvs/jakarta-avalon-site/docs/phoenix/getting-started.html,v
  retrieving revision 1.12
  retrieving revision 1.13
  diff -u -r1.12 -r1.13
  --- getting-started.html	30 Jun 2002 21:37:39 -0000	1.12
  +++ getting-started.html	6 Sep 2002 23:31:51 -0000	1.13
  @@ -1,23 +1,5 @@
   <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
   
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
   <!-- This is a generated file.  Do not edit. -->
       <html>
       <head>
  @@ -87,6 +69,8 @@
     </small></div>
                 <div><small>      <a href="./bdg/index.html">for Block Developers</a>
     </small></div>
  +              <div><small>      <a href="./mx/index.html">Management Guide</a>
  +  </small></div>
                 <div><small>      <a href="./guide-example-configuration.html">Example configuration</a>
     </small></div>
             </div>
  @@ -353,5 +337,3 @@
   
       </body>
     </html>
  -
  -
  
  
  
  1.6       +2 -20     jakarta-avalon-site/docs/phoenix/guide-administrator.html
  
  Index: guide-administrator.html
  ===================================================================
  RCS file: /home/cvs/jakarta-avalon-site/docs/phoenix/guide-administrator.html,v
  retrieving revision 1.5
  retrieving revision 1.6
  diff -u -r1.5 -r1.6
  --- guide-administrator.html	30 Jun 2002 21:37:39 -0000	1.5
  +++ guide-administrator.html	6 Sep 2002 23:31:51 -0000	1.6
  @@ -1,23 +1,5 @@
   <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
   
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
   <!-- This is a generated file.  Do not edit. -->
       <html>
       <head>
  @@ -83,6 +65,8 @@
     </small></div>
                 <div><small>      <a href="./bdg/index.html">for Block Developers</a>
     </small></div>
  +              <div><small>      <a href="./mx/index.html">Management Guide</a>
  +  </small></div>
                 <div><small>      <a href="./guide-example-configuration.html">Example configuration</a>
     </small></div>
             </div>
  @@ -172,5 +156,3 @@
   
       </body>
     </html>
  -
  -
  
  
  
  1.7       +2 -20     jakarta-avalon-site/docs/phoenix/guide-architecture.html
  
  Index: guide-architecture.html
  ===================================================================
  RCS file: /home/cvs/jakarta-avalon-site/docs/phoenix/guide-architecture.html,v
  retrieving revision 1.6
  retrieving revision 1.7
  diff -u -r1.6 -r1.7
  --- guide-architecture.html	4 Sep 2002 21:40:58 -0000	1.6
  +++ guide-architecture.html	6 Sep 2002 23:31:51 -0000	1.7
  @@ -1,23 +1,5 @@
   <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
   
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
   <!-- This is a generated file.  Do not edit. -->
       <html>
       <head>
  @@ -83,6 +65,8 @@
     </small></div>
                 <div><small>      <a href="./bdg/index.html">for Block Developers</a>
     </small></div>
  +              <div><small>      <a href="./mx/index.html">Management Guide</a>
  +  </small></div>
                 <div><small>      <a href="./guide-example-configuration.html">Example configuration</a>
     </small></div>
             </div>
  @@ -281,5 +265,3 @@
   
       </body>
     </html>
  -
  -
  
  
  
  1.7       +4 -22     jakarta-avalon-site/docs/phoenix/guide-deployers.html
  
  Index: guide-deployers.html
  ===================================================================
  RCS file: /home/cvs/jakarta-avalon-site/docs/phoenix/guide-deployers.html,v
  retrieving revision 1.6
  retrieving revision 1.7
  diff -u -r1.6 -r1.7
  --- guide-deployers.html	6 Aug 2002 11:21:03 -0000	1.6
  +++ guide-deployers.html	6 Sep 2002 23:31:51 -0000	1.7
  @@ -1,23 +1,5 @@
   <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
   
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
   <!-- This is a generated file.  Do not edit. -->
       <html>
       <head>
  @@ -28,7 +10,7 @@
         <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>
   
                         <meta name="author" value="Peter Donald">
  -  <meta name="email" value="peter @ apache.org">
  +  <meta name="email" value="peter at apache.org">
         
         <title>Avalon Phoenix - Guide - for Deployers</title>
       </head>
  @@ -83,6 +65,8 @@
     </small></div>
                 <div><small>      <a href="./bdg/index.html">for Block Developers</a>
     </small></div>
  +              <div><small>      <a href="./mx/index.html">Management Guide</a>
  +  </small></div>
                 <div><small>      <a href="./guide-example-configuration.html">Example configuration</a>
     </small></div>
             </div>
  @@ -150,7 +134,7 @@
               </div>
                 </div>
   		<div align="right" id="authors">
  -		 by   <a href="peter @ apache.org">Peter Donald</a>
  +		 by   <a href="peter at apache.org">Peter Donald</a>
   		</div>
             </div></td>
           </tr>
  @@ -167,5 +151,3 @@
   
       </body>
     </html>
  -
  -
  
  
  
  1.6       +2 -20     jakarta-avalon-site/docs/phoenix/guide-example-configuration.html
  
  Index: guide-example-configuration.html
  ===================================================================
  RCS file: /home/cvs/jakarta-avalon-site/docs/phoenix/guide-example-configuration.html,v
  retrieving revision 1.5
  retrieving revision 1.6
  diff -u -r1.5 -r1.6
  --- guide-example-configuration.html	30 Jun 2002 21:37:39 -0000	1.5
  +++ guide-example-configuration.html	6 Sep 2002 23:31:51 -0000	1.6
  @@ -1,23 +1,5 @@
   <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
   
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
   <!-- This is a generated file.  Do not edit. -->
       <html>
       <head>
  @@ -85,6 +67,8 @@
     </small></div>
                 <div><small>      <a href="./bdg/index.html">for Block Developers</a>
     </small></div>
  +              <div><small>      <a href="./mx/index.html">Management Guide</a>
  +  </small></div>
                 <div><small>      <a href="./guide-example-configuration.html">Example configuration</a>
     </small></div>
             </div>
  @@ -379,5 +363,3 @@
   
       </body>
     </html>
  -
  -
  
  
  
  1.6       +2 -20     jakarta-avalon-site/docs/phoenix/guide-roles.html
  
  Index: guide-roles.html
  ===================================================================
  RCS file: /home/cvs/jakarta-avalon-site/docs/phoenix/guide-roles.html,v
  retrieving revision 1.5
  retrieving revision 1.6
  diff -u -r1.5 -r1.6
  --- guide-roles.html	30 Jun 2002 21:37:39 -0000	1.5
  +++ guide-roles.html	6 Sep 2002 23:31:51 -0000	1.6
  @@ -1,23 +1,5 @@
   <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
   
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
   <!-- This is a generated file.  Do not edit. -->
       <html>
       <head>
  @@ -83,6 +65,8 @@
     </small></div>
                 <div><small>      <a href="./bdg/index.html">for Block Developers</a>
     </small></div>
  +              <div><small>      <a href="./mx/index.html">Management Guide</a>
  +  </small></div>
                 <div><small>      <a href="./guide-example-configuration.html">Example configuration</a>
     </small></div>
             </div>
  @@ -212,5 +196,3 @@
   
       </body>
     </html>
  -
  -
  
  
  
  1.16      +9 -22     jakarta-avalon-site/docs/phoenix/index.html
  
  Index: index.html
  ===================================================================
  RCS file: /home/cvs/jakarta-avalon-site/docs/phoenix/index.html,v
  retrieving revision 1.15
  retrieving revision 1.16
  diff -u -r1.15 -r1.16
  --- index.html	4 Sep 2002 21:44:01 -0000	1.15
  +++ index.html	6 Sep 2002 23:31:51 -0000	1.16
  @@ -1,23 +1,5 @@
   <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
   
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
   <!-- This is a generated file.  Do not edit. -->
       <html>
       <head>
  @@ -30,7 +12,7 @@
                         <meta name="author" value="Berin Loritsch">
     <meta name="email" value="bloritsch@apache.org">
                   <meta name="author" value="Peter Donald">
  -  <meta name="email" value="peter @ apache.org">
  +  <meta name="email" value="peter at apache.org">
                   <meta name="author" value="Paul Hammant">
     <meta name="email" value="Paul_Hammant@yahoo.com">
         
  @@ -87,6 +69,8 @@
     </small></div>
                 <div><small>      <a href="./bdg/index.html">for Block Developers</a>
     </small></div>
  +              <div><small>      <a href="./mx/index.html">Management Guide</a>
  +  </small></div>
                 <div><small>      <a href="./guide-example-configuration.html">Example configuration</a>
     </small></div>
             </div>
  @@ -232,6 +216,11 @@
                             
               
                                 <li
  +        >                                <a href="guide-management.html">JMX Management Guide</a>
  +                </li>
  +                          
  +            
  +                              <li
           >                                <a href="assemblers/index.html">Server Application Assembler Guide</a>
                   </li>
                             
  @@ -266,7 +255,7 @@
                 </div>
   		<div align="right" id="authors">
   		 by   <a href="bloritsch@apache.org">Berin Loritsch</a>
  -	  , <a href="peter @ apache.org">Peter Donald</a>
  +	  , <a href="peter at apache.org">Peter Donald</a>
   	  , <a href="Paul_Hammant@yahoo.com">Paul Hammant</a>
   		</div>
             </div></td>
  @@ -284,5 +273,3 @@
   
       </body>
     </html>
  -
  -
  
  
  
  1.13      +2 -20     jakarta-avalon-site/docs/phoenix/install.html
  
  Index: install.html
  ===================================================================
  RCS file: /home/cvs/jakarta-avalon-site/docs/phoenix/install.html,v
  retrieving revision 1.12
  retrieving revision 1.13
  diff -u -r1.12 -r1.13
  --- install.html	30 Jun 2002 21:37:39 -0000	1.12
  +++ install.html	6 Sep 2002 23:31:51 -0000	1.13
  @@ -1,23 +1,5 @@
   <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
   
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
   <!-- This is a generated file.  Do not edit. -->
       <html>
       <head>
  @@ -83,6 +65,8 @@
     </small></div>
                 <div><small>      <a href="./bdg/index.html">for Block Developers</a>
     </small></div>
  +              <div><small>      <a href="./mx/index.html">Management Guide</a>
  +  </small></div>
                 <div><small>      <a href="./guide-example-configuration.html">Example configuration</a>
     </small></div>
             </div>
  @@ -190,5 +174,3 @@
   
       </body>
     </html>
  -
  -
  
  
  
  1.1                  jakarta-avalon-site/docs/phoenix/guide-management.html
  
  Index: guide-management.html
  ===================================================================
  <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  
  <!-- This is a generated file.  Do not edit. -->
      <html>
      <head>
        <style type="text/css">
          @import url("./css/tigris.css");
          @import url("./css/site.css");
        </style>
        <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>
  
                        <meta name="author" value="Huw Roberts">
    <meta name="email" value="huw@apache.org">
        
        <title>Avalon Phoenix - Guide - JMX Management</title>
      </head>
  
      <body marginwidth="0" marginheight="0" class="composite">
  
        <div id="banner">
          <table border="0" cellspacing="0" cellpadding="8" width="100%">
            <!-- TOP IMAGE -->
            <tr>
              <td>      <td align="left">
      <a href="http://jakarta.apache.org"><img src="http://jakarta.apache.org/images/jakarta-logo.gif" border="0"/></a>
      </td>
      <td align="right">
                <a href="http://jakarta.apache.org/avalon/phoenix"><img src="./images/header.gif" alt="Avalon Phoenix" border="0"/></a>
          </td>
    </td>
              <td><div align="right" valign="bottom"><b><font size="+3">Avalon Phoenix</font></b></div></td>
            </tr>
          </table>
        </div>
  
        <table border="0" cellspacing="0" cellpadding="8" width="100%" id="main">
          <tr valign="top">
            <!-- LEFT SIDE NAVIGATION -->
            <td id="leftcol" width="20%">
              <div id="navcolumn">
                    <div>
        <strong>Essentials</strong>
                <div><small>      <a href="./index.html">Overview</a>
    </small></div>
                <div><small>      <a href="./features.html">Features</a>
    </small></div>
                <div><small>      <a href="./getting-started.html">Getting started</a>
    </small></div>
                <div><small>      <a href="http://jakarta.apache.org/builds/jakarta-avalon-phoenix">Download</a>
    </small></div>
                <div><small>      <a href="./install.html">Install</a>
    </small></div>
            </div>
        <div>
        <strong>Guide</strong>
                <div><small>      <a href="./guide-architecture.html">Architectural Overview</a>
    </small></div>
                <div><small>      <a href="./guide-roles.html">Development Roles</a>
    </small></div>
                <div><small>      <a href="./guide-administrator.html">for Administrators</a>
    </small></div>
                <div><small>      <a href="./guide-deployers.html">for Deployers</a>
    </small></div>
                <div><small>      <a href="./assemblers/index.html">for Assemblers</a>
    </small></div>
                <div><small>      <a href="./bdg/index.html">for Block Developers</a>
    </small></div>
                <div><small>      <a href="./mx/index.html">Management Guide</a>
    </small></div>
                <div><small>      <a href="./guide-example-configuration.html">Example configuration</a>
    </small></div>
            </div>
        <div>
        <strong>Reference</strong>
                <div><small>      <a href="./api/index.html">API Docs</a>
    </small></div>
                <div><small>      <a href="./assemblers/config-xml-specification.html">config.xml Specification</a>
    </small></div>
                <div><small>      <a href="./assemblers/assembly-xml-specification.html">assembly.xml Specification</a>
    </small></div>
                <div><small>      <a href="./assemblers/environment-xml-specification.html">environment.xml Specification</a>
    </small></div>
                <div><small>      <a href="./bdg/blockinfo-specification.html">BlockInfo Specification</a>
    </small></div>
            </div>
        <div>
        <strong>For Developers</strong>
                <div><small>      <a href="./changes.html">Changes</a>
    </small></div>
                <div><small>      <a href="http://jakarta.apache.org/avalon/code-standards.html">Coding standards</a>
    </small></div>
                <div><small>      <a href="./for-developers-project-structure.html">Project Structure</a>
    </small></div>
                <div><small>      <a href="http://jakarta.apache.org/site/cvsindex.html">CVS Repositories</a>
    </small></div>
                <div><small>      <a href="http://jakarta.apache.org/site/mail.html">Mailing Lists</a>
    </small></div>
                <div><small>      <a href="http://nagoya.apache.org/bugzilla/buglist.cgi?bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&bug_status=RESOLVED&product=Avalon&component=Phoenix">TODO</a>
    </small></div>
                <div><small>      <a href="http://nagoya.apache.org/bugzilla/enter_bug.cgi?product=Avalon&component=Phoenix">Bug Database</a>
    </small></div>
                <div><small>      <a href="http://nagoya.apache.org/bugzilla/enter_bug.cgi?product=Avalon&component=Phoenix&bug_severity=Enhancement">Enhancement Requests</a>
    </small></div>
                <div><small>      <a href="./for-developers-alternate-kernel.html">Alternate Kernels</a>
    </small></div>
            </div>
                </div>
            </td>
            <td><div id="bodycol"><div class="app">
          <div class="h3">
              <h3><a name="Table of Contents">Table of Contents</a></h3>
                            <table cellpadding="3" cellspacing="2" border="1" width="100%">
                      <tr class="a">
                  <td
            >
                  Section
          </td>
                    <td
            >
                  Title
          </td>
                    <td
            >
                  Intended Audience
          </td>
          </tr>
                          <tr class="b">
                  <td
            >
                  
              1.
            
          </td>
                    <td
            >
                                
              
                                      <a href="guide-mx-structure.html">Organizing Structure for Management Data</a>
                              
            
                    </td>
                    <td
            >
                  
              Everyone
            
          </td>
          </tr>
                          <tr class="a">
                  <td
            >
                  
              2. 
            
          </td>
                    <td
            >
                                
              
                                      <a href="guide-mx-overview.html">Step by Step Overview</a>
                              
            
                    </td>
                    <td
            >
                  
              Everyone
            
          </td>
          </tr>
                          <tr class="b">
                  <td
            >
                  
              3.
            
          </td>
                    <td
            >
                                
              
                                      <a href="guide-mx-mxinfo.html">MXINFO files</a>
                              
            
                    </td>
                    <td
            >
                  
              Component Authors
            
          </td>
          </tr>
                          <tr class="a">
                  <td
            >
                  
              4.
            
          </td>
                    <td
            >
                                
              
                                      <a href="guide-mx-xdoctags.html">XDoclet Tagging</a>
                              
            
                    </td>
                    <td
            >
                  
              Component Authors
            
          </td>
          </tr>
                          <tr class="b">
                  <td
            >
                  
              5.
            
          </td>
                    <td
            >
                  
               [TODO] Container Responsibilities to Support Management
            
          </td>
                    <td
            >
                  
              Container Authors
            
          </td>
          </tr>
                          <tr class="a">
                  <td
            >
                  
              6.
            
          </td>
                    <td
            >
                  
               Link to javadocs
            
          </td>
                    <td
            >
                  
              Reference
            
          </td>
          </tr>
          </table>
                </div>
                </div>
  		<div align="right" id="authors">
  		 by   <a href="huw@apache.org">Huw Roberts</a>
  		</div>
            </div></td>
          </tr>
        </table>
  
        <!-- FOOTER -->
        <div id="footer">
          <table border="0" cellspacing="0" cellpadding="4">
            <tr>
              <td>Copyright &#169; 1999-2002, Apache Software Foundation</td>
            </tr>
          </table>
        </div>
  
      </body>
    </html>
  
  
  
  1.5       +7 -23     jakarta-avalon-site/docs/phoenix/assemblers/assembly-xml-specification.html
  
  Index: assembly-xml-specification.html
  ===================================================================
  RCS file: /home/cvs/jakarta-avalon-site/docs/phoenix/assemblers/assembly-xml-specification.html,v
  retrieving revision 1.4
  retrieving revision 1.5
  diff -u -r1.4 -r1.5
  --- assembly-xml-specification.html	6 Aug 2002 11:21:08 -0000	1.4
  +++ assembly-xml-specification.html	6 Sep 2002 23:31:51 -0000	1.5
  @@ -1,23 +1,5 @@
   <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
   
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
   <!-- This is a generated file.  Do not edit. -->
       <html>
       <head>
  @@ -28,7 +10,7 @@
         <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>
   
                         <meta name="author" value="Peter Donald">
  -  <meta name="email" value="peter @ apache.org">
  +  <meta name="email" value="peter at apache.org">
         
         <title>Avalon Phoenix - Specification of assembly.xml </title>
       </head>
  @@ -64,7 +46,7 @@
     </small></div>
                 <div><small>      <a href="../getting-started.html">Getting started</a>
     </small></div>
  -              <div><small>      <a href="http://jakarta.apache.org/builds/jakarta-avalon/release/phoenix">Download</a>
  +              <div><small>      <a href="http://jakarta.apache.org/builds/jakarta-avalon-phoenix">Download</a>
     </small></div>
                 <div><small>      <a href="../install.html">Install</a>
     </small></div>
  @@ -83,6 +65,8 @@
     </small></div>
                 <div><small>      <a href="../bdg/index.html">for Block Developers</a>
     </small></div>
  +              <div><small>      <a href="../mx/index.html">Management Guide</a>
  +  </small></div>
                 <div><small>      <a href="../guide-example-configuration.html">Example configuration</a>
     </small></div>
             </div>
  @@ -117,6 +101,8 @@
     </small></div>
                 <div><small>      <a href="http://nagoya.apache.org/bugzilla/enter_bug.cgi?product=Avalon&component=Phoenix&bug_severity=Enhancement">Enhancement Requests</a>
     </small></div>
  +              <div><small>      <a href="../for-developers-alternate-kernel.html">Alternate Kernels</a>
  +  </small></div>
             </div>
                 </div>
             </td>
  @@ -185,7 +171,7 @@
                 </div>
                 </div>
   		<div align="right" id="authors">
  -		 by   <a href="peter @ apache.org">Peter Donald</a>
  +		 by   <a href="peter at apache.org">Peter Donald</a>
   		</div>
             </div></td>
           </tr>
  @@ -202,5 +188,3 @@
   
       </body>
     </html>
  -
  -
  
  
  
  1.5       +7 -23     jakarta-avalon-site/docs/phoenix/assemblers/config-xml-specification.html
  
  Index: config-xml-specification.html
  ===================================================================
  RCS file: /home/cvs/jakarta-avalon-site/docs/phoenix/assemblers/config-xml-specification.html,v
  retrieving revision 1.4
  retrieving revision 1.5
  diff -u -r1.4 -r1.5
  --- config-xml-specification.html	6 Aug 2002 11:21:08 -0000	1.4
  +++ config-xml-specification.html	6 Sep 2002 23:31:51 -0000	1.5
  @@ -1,23 +1,5 @@
   <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
   
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
   <!-- This is a generated file.  Do not edit. -->
       <html>
       <head>
  @@ -28,7 +10,7 @@
         <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>
   
                         <meta name="author" value="Peter Donald">
  -  <meta name="email" value="peter @ apache.org">
  +  <meta name="email" value="peter at apache.org">
         
         <title>Avalon Phoenix - Specification of config.xml </title>
       </head>
  @@ -64,7 +46,7 @@
     </small></div>
                 <div><small>      <a href="../getting-started.html">Getting started</a>
     </small></div>
  -              <div><small>      <a href="http://jakarta.apache.org/builds/jakarta-avalon/release/phoenix">Download</a>
  +              <div><small>      <a href="http://jakarta.apache.org/builds/jakarta-avalon-phoenix">Download</a>
     </small></div>
                 <div><small>      <a href="../install.html">Install</a>
     </small></div>
  @@ -83,6 +65,8 @@
     </small></div>
                 <div><small>      <a href="../bdg/index.html">for Block Developers</a>
     </small></div>
  +              <div><small>      <a href="../mx/index.html">Management Guide</a>
  +  </small></div>
                 <div><small>      <a href="../guide-example-configuration.html">Example configuration</a>
     </small></div>
             </div>
  @@ -117,6 +101,8 @@
     </small></div>
                 <div><small>      <a href="http://nagoya.apache.org/bugzilla/enter_bug.cgi?product=Avalon&component=Phoenix&bug_severity=Enhancement">Enhancement Requests</a>
     </small></div>
  +              <div><small>      <a href="../for-developers-alternate-kernel.html">Alternate Kernels</a>
  +  </small></div>
             </div>
                 </div>
             </td>
  @@ -160,7 +146,7 @@
                 </div>
                 </div>
   		<div align="right" id="authors">
  -		 by   <a href="peter @ apache.org">Peter Donald</a>
  +		 by   <a href="peter at apache.org">Peter Donald</a>
   		</div>
             </div></td>
           </tr>
  @@ -177,5 +163,3 @@
   
       </body>
     </html>
  -
  -
  
  
  
  1.5       +7 -23     jakarta-avalon-site/docs/phoenix/assemblers/creating-a-server-application.html
  
  Index: creating-a-server-application.html
  ===================================================================
  RCS file: /home/cvs/jakarta-avalon-site/docs/phoenix/assemblers/creating-a-server-application.html,v
  retrieving revision 1.4
  retrieving revision 1.5
  diff -u -r1.4 -r1.5
  --- creating-a-server-application.html	6 Aug 2002 11:21:08 -0000	1.4
  +++ creating-a-server-application.html	6 Sep 2002 23:31:51 -0000	1.5
  @@ -1,23 +1,5 @@
   <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
   
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
   <!-- This is a generated file.  Do not edit. -->
       <html>
       <head>
  @@ -28,7 +10,7 @@
         <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>
   
                         <meta name="author" value="Peter Donald">
  -  <meta name="email" value="peter @ apache.org">
  +  <meta name="email" value="peter at apache.org">
         
         <title>Avalon Phoenix - Guide - Creating a Server Application</title>
       </head>
  @@ -64,7 +46,7 @@
     </small></div>
                 <div><small>      <a href="../getting-started.html">Getting started</a>
     </small></div>
  -              <div><small>      <a href="http://jakarta.apache.org/builds/jakarta-avalon/release/phoenix">Download</a>
  +              <div><small>      <a href="http://jakarta.apache.org/builds/jakarta-avalon-phoenix">Download</a>
     </small></div>
                 <div><small>      <a href="../install.html">Install</a>
     </small></div>
  @@ -83,6 +65,8 @@
     </small></div>
                 <div><small>      <a href="../bdg/index.html">for Block Developers</a>
     </small></div>
  +              <div><small>      <a href="../mx/index.html">Management Guide</a>
  +  </small></div>
                 <div><small>      <a href="../guide-example-configuration.html">Example configuration</a>
     </small></div>
             </div>
  @@ -117,6 +101,8 @@
     </small></div>
                 <div><small>      <a href="http://nagoya.apache.org/bugzilla/enter_bug.cgi?product=Avalon&component=Phoenix&bug_severity=Enhancement">Enhancement Requests</a>
     </small></div>
  +              <div><small>      <a href="../for-developers-alternate-kernel.html">Alternate Kernels</a>
  +  </small></div>
             </div>
                 </div>
             </td>
  @@ -269,7 +255,7 @@
                 </div>
                 </div>
   		<div align="right" id="authors">
  -		 by   <a href="peter @ apache.org">Peter Donald</a>
  +		 by   <a href="peter at apache.org">Peter Donald</a>
   		</div>
             </div></td>
           </tr>
  @@ -286,5 +272,3 @@
   
       </body>
     </html>
  -
  -
  
  
  
  1.5       +31 -45    jakarta-avalon-site/docs/phoenix/assemblers/environment-xml-specification.html
  
  Index: environment-xml-specification.html
  ===================================================================
  RCS file: /home/cvs/jakarta-avalon-site/docs/phoenix/assemblers/environment-xml-specification.html,v
  retrieving revision 1.4
  retrieving revision 1.5
  diff -u -r1.4 -r1.5
  --- environment-xml-specification.html	6 Aug 2002 11:21:08 -0000	1.4
  +++ environment-xml-specification.html	6 Sep 2002 23:31:51 -0000	1.5
  @@ -1,23 +1,5 @@
   <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
   
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
   <!-- This is a generated file.  Do not edit. -->
       <html>
       <head>
  @@ -28,7 +10,7 @@
         <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>
   
                         <meta name="author" value="Peter Donald">
  -  <meta name="email" value="peter @ apache.org">
  +  <meta name="email" value="peter at apache.org">
         
         <title>Avalon Phoenix - Specification of environment.xml</title>
       </head>
  @@ -64,7 +46,7 @@
     </small></div>
                 <div><small>      <a href="../getting-started.html">Getting started</a>
     </small></div>
  -              <div><small>      <a href="http://jakarta.apache.org/builds/jakarta-avalon/release/phoenix">Download</a>
  +              <div><small>      <a href="http://jakarta.apache.org/builds/jakarta-avalon-phoenix">Download</a>
     </small></div>
                 <div><small>      <a href="../install.html">Install</a>
     </small></div>
  @@ -83,6 +65,8 @@
     </small></div>
                 <div><small>      <a href="../bdg/index.html">for Block Developers</a>
     </small></div>
  +              <div><small>      <a href="../mx/index.html">Management Guide</a>
  +  </small></div>
                 <div><small>      <a href="../guide-example-configuration.html">Example configuration</a>
     </small></div>
             </div>
  @@ -117,6 +101,8 @@
     </small></div>
                 <div><small>      <a href="http://nagoya.apache.org/bugzilla/enter_bug.cgi?product=Avalon&component=Phoenix&bug_severity=Enhancement">Enhancement Requests</a>
     </small></div>
  +              <div><small>      <a href="../for-developers-alternate-kernel.html">Alternate Kernels</a>
  +  </small></div>
             </div>
                 </div>
             </td>
  @@ -244,33 +230,35 @@
         
     </p>
                                     <div id="source">
  -    <pre>&lt;logger version=&quot;1.1&quot;&gt;
  -&lt;factories&gt;
  -  &lt;factory type=&quot;file&quot;
  -           class=&quot;org.apache.avalon.excalibur.logger.factory.FileTargetFactory&quot;/&gt;
  -&lt;/factories&gt;
  -
  -&lt;categories&gt;
  -  &lt;category name=&quot;&quot; log-level=&quot;INFO&quot;&gt;
  -    &lt;log-target id-ref=&quot;default&quot;/&gt;
  -  &lt;/category&gt;
  -&lt;/categories&gt;
  -
  -&lt;targets&gt;
  -  &lt;file id=&quot;default&quot;&gt;
  -    &lt;filename&gt;{app.home}/logs/default-&lt;/filename&quot;&gt;
  -    &lt;append&gt;true&lt;/append&gt;
  -    &lt;rotation type=&quot;unique&quot; pattern=&quot;yyyyMMdd&quot; suffix=&quot;.log&quot;&gt;
  -      &lt;date&gt;yyyyMMdd&lt;/date&gt;
  -    &lt;/rotation&gt;
  -  &lt;/file&gt;
  -&lt;/targets&gt;
  -&lt;/logger&gt;</pre>
  +    <pre>&lt;?xml version=&quot;1.0&quot;?&gt;
  +&lt;environment&gt;
  +	&lt;logs version=&quot;1.1&quot;&gt;
  +	&lt;factories&gt;
  +	  &lt;factory type=&quot;file&quot; class=&quot;org.apache.avalon.excalibur.logger.factory.FileTargetFactory&quot;/&gt;
  +	&lt;/factories&gt;
  +
  +	&lt;categories&gt;
  +	  &lt;category name=&quot;&quot; log-level=&quot;INFO&quot;&gt;
  +	    &lt;log-target id-ref=&quot;default&quot;/&gt;
  +	  &lt;/category&gt;
  +	&lt;/categories&gt;
  +
  +	&lt;targets&gt;
  +	  &lt;file id=&quot;default&quot;&gt;
  +	    &lt;filename&gt;${app.home}/logs/default-&lt;/filename&gt;
  +	    &lt;append&gt;true&lt;/append&gt;
  +	    &lt;rotation type=&quot;unique&quot; pattern=&quot;yyyyMMdd&quot; suffix=&quot;.log&quot;&gt;
  +	      &lt;date&gt;yyyyMMdd&lt;/date&gt;
  +	    &lt;/rotation&gt;
  +	  &lt;/file&gt;
  +	&lt;/targets&gt;
  +&lt;/logs&gt;
  +&lt;/environment&gt;</pre>
     </div>
                 </div>
                 </div>
   		<div align="right" id="authors">
  -		 by   <a href="peter @ apache.org">Peter Donald</a>
  +		 by   <a href="peter at apache.org">Peter Donald</a>
   		</div>
             </div></td>
           </tr>
  @@ -287,5 +275,3 @@
   
       </body>
     </html>
  -
  -
  
  
  
  1.4       +5 -21     jakarta-avalon-site/docs/phoenix/assemblers/index.html
  
  Index: index.html
  ===================================================================
  RCS file: /home/cvs/jakarta-avalon-site/docs/phoenix/assemblers/index.html,v
  retrieving revision 1.3
  retrieving revision 1.4
  diff -u -r1.3 -r1.4
  --- index.html	20 Jun 2002 09:48:49 -0000	1.3
  +++ index.html	6 Sep 2002 23:31:51 -0000	1.4
  @@ -1,23 +1,5 @@
   <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
   
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
   <!-- This is a generated file.  Do not edit. -->
       <html>
       <head>
  @@ -64,7 +46,7 @@
     </small></div>
                 <div><small>      <a href="../getting-started.html">Getting started</a>
     </small></div>
  -              <div><small>      <a href="http://jakarta.apache.org/builds/jakarta-avalon/release/phoenix">Download</a>
  +              <div><small>      <a href="http://jakarta.apache.org/builds/jakarta-avalon-phoenix">Download</a>
     </small></div>
                 <div><small>      <a href="../install.html">Install</a>
     </small></div>
  @@ -83,6 +65,8 @@
     </small></div>
                 <div><small>      <a href="../bdg/index.html">for Block Developers</a>
     </small></div>
  +              <div><small>      <a href="../mx/index.html">Management Guide</a>
  +  </small></div>
                 <div><small>      <a href="../guide-example-configuration.html">Example configuration</a>
     </small></div>
             </div>
  @@ -117,6 +101,8 @@
     </small></div>
                 <div><small>      <a href="http://nagoya.apache.org/bugzilla/enter_bug.cgi?product=Avalon&component=Phoenix&bug_severity=Enhancement">Enhancement Requests</a>
     </small></div>
  +              <div><small>      <a href="../for-developers-alternate-kernel.html">Alternate Kernels</a>
  +  </small></div>
             </div>
                 </div>
             </td>
  @@ -218,5 +204,3 @@
   
       </body>
     </html>
  -
  -
  
  
  
  1.5       +7 -23     jakarta-avalon-site/docs/phoenix/assemblers/what-is-a-server-application.html
  
  Index: what-is-a-server-application.html
  ===================================================================
  RCS file: /home/cvs/jakarta-avalon-site/docs/phoenix/assemblers/what-is-a-server-application.html,v
  retrieving revision 1.4
  retrieving revision 1.5
  diff -u -r1.4 -r1.5
  --- what-is-a-server-application.html	6 Aug 2002 11:21:08 -0000	1.4
  +++ what-is-a-server-application.html	6 Sep 2002 23:31:51 -0000	1.5
  @@ -1,23 +1,5 @@
   <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
   
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
   <!-- This is a generated file.  Do not edit. -->
       <html>
       <head>
  @@ -28,7 +10,7 @@
         <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>
   
                         <meta name="author" value="Peter Donald">
  -  <meta name="email" value="peter @ apache.org">
  +  <meta name="email" value="peter at apache.org">
                   <meta name="author" value="Berin Loritsch">
     <meta name="email" value="bloritsch@apache.org">
         
  @@ -66,7 +48,7 @@
     </small></div>
                 <div><small>      <a href="../getting-started.html">Getting started</a>
     </small></div>
  -              <div><small>      <a href="http://jakarta.apache.org/builds/jakarta-avalon/release/phoenix">Download</a>
  +              <div><small>      <a href="http://jakarta.apache.org/builds/jakarta-avalon-phoenix">Download</a>
     </small></div>
                 <div><small>      <a href="../install.html">Install</a>
     </small></div>
  @@ -85,6 +67,8 @@
     </small></div>
                 <div><small>      <a href="../bdg/index.html">for Block Developers</a>
     </small></div>
  +              <div><small>      <a href="../mx/index.html">Management Guide</a>
  +  </small></div>
                 <div><small>      <a href="../guide-example-configuration.html">Example configuration</a>
     </small></div>
             </div>
  @@ -119,6 +103,8 @@
     </small></div>
                 <div><small>      <a href="http://nagoya.apache.org/bugzilla/enter_bug.cgi?product=Avalon&component=Phoenix&bug_severity=Enhancement">Enhancement Requests</a>
     </small></div>
  +              <div><small>      <a href="../for-developers-alternate-kernel.html">Alternate Kernels</a>
  +  </small></div>
             </div>
                 </div>
             </td>
  @@ -178,7 +164,7 @@
                 </div>
                 </div>
   		<div align="right" id="authors">
  -		 by   <a href="peter @ apache.org">Peter Donald</a>
  +		 by   <a href="peter at apache.org">Peter Donald</a>
   	  , <a href="bloritsch@apache.org">Berin Loritsch</a>
   		</div>
             </div></td>
  @@ -196,5 +182,3 @@
   
       </body>
     </html>
  -
  -
  
  
  
  1.5       +128 -89   jakarta-avalon-site/docs/phoenix/bdg/blockinfo-specification.html
  
  Index: blockinfo-specification.html
  ===================================================================
  RCS file: /home/cvs/jakarta-avalon-site/docs/phoenix/bdg/blockinfo-specification.html,v
  retrieving revision 1.4
  retrieving revision 1.5
  diff -u -r1.4 -r1.5
  --- blockinfo-specification.html	6 Aug 2002 11:21:08 -0000	1.4
  +++ blockinfo-specification.html	6 Sep 2002 23:31:51 -0000	1.5
  @@ -1,23 +1,5 @@
   <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
   
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
   <!-- This is a generated file.  Do not edit. -->
       <html>
       <head>
  @@ -28,7 +10,7 @@
         <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>
   
                         <meta name="author" value="Peter Donald">
  -  <meta name="email" value="peter @ apache.org">
  +  <meta name="email" value="peter at apache.org">
         
         <title>Avalon Phoenix - The BlockInfo Specification</title>
       </head>
  @@ -64,7 +46,7 @@
     </small></div>
                 <div><small>      <a href="../getting-started.html">Getting started</a>
     </small></div>
  -              <div><small>      <a href="http://jakarta.apache.org/builds/jakarta-avalon/release/phoenix">Download</a>
  +              <div><small>      <a href="http://jakarta.apache.org/builds/jakarta-avalon-phoenix">Download</a>
     </small></div>
                 <div><small>      <a href="../install.html">Install</a>
     </small></div>
  @@ -83,6 +65,8 @@
     </small></div>
                 <div><small>      <a href="../bdg/index.html">for Block Developers</a>
     </small></div>
  +              <div><small>      <a href="../mx/index.html">Management Guide</a>
  +  </small></div>
                 <div><small>      <a href="../guide-example-configuration.html">Example configuration</a>
     </small></div>
             </div>
  @@ -117,93 +101,151 @@
     </small></div>
                 <div><small>      <a href="http://nagoya.apache.org/bugzilla/enter_bug.cgi?product=Avalon&component=Phoenix&bug_severity=Enhancement">Enhancement Requests</a>
     </small></div>
  +              <div><small>      <a href="../for-developers-alternate-kernel.html">Alternate Kernels</a>
  +  </small></div>
             </div>
                 </div>
             </td>
             <td><div id="bodycol"><div class="app">
  -()
  -         (<section name="Block Metadata">
  -      <p>
  +        <div class="h3">
  +            <h3><a name="Block Metadata">Block Metadata</a></h3>
  +                        <p
  +        >                    
           The meta-data about each block is stored in a BlockInfo file. The info
  -        includes details on what version the block is, what <code>Service</code>s
  -        it depends upon and which <code>Service</code>s it can offer to other Blocks.
  +        includes details on what version the block is, what 
  +                              <code
  +        >      Service
  +  </code>
  +                          s
  +        it depends upon and which 
  +                              <code
  +        >      Service
  +  </code>
  +                          s it can offer to other Blocks.
           In the future the info will also store such data as the schema for configuring
           the block.
  -      </p>
  -
  -      <p>
  +      
  +            </p>
  +                                <p
  +        >                    
           The BlockInfo file has the same name as the Block except with the extention
  -        <code>.xinfo</code>. Thus if you were looking up the meta info for a block named
  -        <code>com.biz.cornerstone.blocks.MyBlock</code> you would look up the resource
  -        <code>com/biz/cornerstone/blocks/MyBlock.xinfo</code> in the same block jar file that
  +        
  +                              <code
  +        >      .xinfo
  +  </code>
  +                          . Thus if you were looking up the meta info for a block named
  +        
  +                              <code
  +        >      com.biz.cornerstone.blocks.MyBlock
  +  </code>
  +                           you would look up the resource
  +        
  +                              <code
  +        >      com/biz/cornerstone/blocks/MyBlock.xinfo
  +  </code>
  +                           in the same block jar file that
           the block was packaged in. The BlockInfo file is a simple XML format. An
           example of such a file follows.
  -      </p>
  -
  -      <source>
  -<![CDATA[
  -<?xml version="1.0"?>
  -
  -<blockinfo>
  -
  -  <block>
  -    <version>1.2.3</version>
  -  </block>
  -
  -  <services>
  -    <service name="com.biz.cornerstone.services.MyService"
  -             version="2.1.3" />
  -  </services>
  -
  -  <dependencies>
  -    <dependency>
  -      <role>com.biz.cornerstone.services.Authorizer</role>
  -      <service name="com.biz.cornerstone.service.Authorizer"
  -               version="1.2"/>
  -    </dependency>
  -    <dependency>
  -      <!-- note that role is not specified and defaults
  +      
  +            </p>
  +                                  <div id="source">
  +    <pre>&lt;?xml version=&quot;1.0&quot;?&gt;
  +
  +&lt;blockinfo&gt;
  +
  +  &lt;block&gt;
  +    &lt;version&gt;1.2.3&lt;/version&gt;
  +  &lt;/block&gt;
  +
  +  &lt;services&gt;
  +    &lt;service name=&quot;com.biz.cornerstone.services.MyService&quot;
  +             version=&quot;2.1.3&quot; /&gt;
  +  &lt;/services&gt;
  +
  +  &lt;dependencies&gt;
  +    &lt;dependency&gt;
  +      &lt;role&gt;com.biz.cornerstone.services.Authorizer&lt;/role&gt;
  +      &lt;service name=&quot;com.biz.cornerstone.service.Authorizer&quot;
  +               version=&quot;1.2&quot;/&gt;
  +    &lt;/dependency&gt;
  +    &lt;dependency&gt;
  +      &lt;!-- note that role is not specified and defaults
              to name of service. The service version is not
  -           specified and it defaults to "1.0" -->
  -      <service name="com.biz.cornerstone.service.RoleMapper"/>
  -    </dependency>
  -  </dependencies>
  -
  -</blockinfo>
  -
  -]]>
  -      </source>
  -      <p>
  +           specified and it defaults to &quot;1.0&quot; --&gt;
  +      &lt;service name=&quot;com.biz.cornerstone.service.RoleMapper&quot;/&gt;
  +    &lt;/dependency&gt;
  +  &lt;/dependencies&gt;
  +
  +&lt;/blockinfo&gt;</pre>
  +  </div>
  +                                <p
  +        >                    
           You will notice that the information in the BlockInfo file is separated into
  -        three main sections; <code>block</code>, <code>services</code> and
  -        <code>dependencies</code>.
  -      </p>
  -      <subsection name="BlockInfo 'block' Section">
  -        <p>The block section specifies the version of class. In the future this
  +        three main sections; 
  +                              <code
  +        >      block
  +  </code>
  +                          , 
  +                              <code
  +        >      services
  +  </code>
  +                           and
  +        
  +                              <code
  +        >      dependencies
  +  </code>
  +                          .
  +      
  +            </p>
  +                            <div class="h4">
  +            <h4><a name="BlockInfo 'block' Section">BlockInfo 'block' Section</a></h4>
  +                <p
  +        >                    The block section specifies the version of class. In the future this
           section will also specify the configuration schema if the block is
  -        <code>Configurable</code>.</p>
  -      </subsection>
  -      <subsection name="BlockInfo 'services' Section">
  -        <p>The services section documents the services that this block can offer other
  +        
  +                              <code
  +        >      Configurable
  +  </code>
  +                          .
  +            </p>
  +        </div>
  +                          <div class="h4">
  +            <h4><a name="BlockInfo 'services' Section">BlockInfo 'services' Section</a></h4>
  +                <p
  +        >      The services section documents the services that this block can offer other
           Blocks. The service instances indicate an interface and optionally a version
           (defaults to version 1.0 if not specified). This section is optional and a Block
  -        can choose to not offer any services.</p>
  -      </subsection>
  -      <subsection name="BlockInfo 'dependencies' Section">
  -        <p>The services section documents the services that this block requires to operate.
  +        can choose to not offer any services.
  +  </p>
  +        </div>
  +                          <div class="h4">
  +            <h4><a name="BlockInfo 'dependencies' Section">BlockInfo 'dependencies' Section</a></h4>
  +                <p
  +        >                    The services section documents the services that this block requires to operate.
           Required services are placed in the Blocks ServiceManager under the name
  -        specified by the <code>role</code> element of dependency. As is documented in the
  -        <a href="http://jakarta.apache.org/avalon/framework/guide-cop-in-avalon.html">components</a> section, the
  -        concept of Role is more than just a behavioural contract. A <code>Service</code> is
  +        specified by the 
  +                              <code
  +        >      role
  +  </code>
  +                           element of dependency. As is documented in the
  +        
  +                                    <a href="http://jakarta.apache.org/avalon/framework/guide-cop-in-avalon.html">components</a>
  +                             section, the
  +        concept of Role is more than just a behavioural contract. A 
  +                              <code
  +        >      Service
  +  </code>
  +                           is
           a behavioural contract and thus the necessity to support the role element. In most
           cases however the role element and the name attribute of the service will be
           identical. In these cases it is sufficient to just specify service element and role
  -        will default to name of service.</p>
  -      </subsection>
  -    </section>)
  +        will default to name of service.
  +            </p>
  +        </div>
  +            </div>
                 </div>
   		<div align="right" id="authors">
  -		 by   <a href="peter @ apache.org">Peter Donald</a>
  +		 by   <a href="peter at apache.org">Peter Donald</a>
   		</div>
             </div></td>
           </tr>
  @@ -220,6 +262,3 @@
   
       </body>
     </html>
  -()
  -
  -
  
  
  
  1.5       +7 -23     jakarta-avalon-site/docs/phoenix/bdg/creating-a-block.html
  
  Index: creating-a-block.html
  ===================================================================
  RCS file: /home/cvs/jakarta-avalon-site/docs/phoenix/bdg/creating-a-block.html,v
  retrieving revision 1.4
  retrieving revision 1.5
  diff -u -r1.4 -r1.5
  --- creating-a-block.html	6 Aug 2002 11:21:08 -0000	1.4
  +++ creating-a-block.html	6 Sep 2002 23:31:51 -0000	1.5
  @@ -1,23 +1,5 @@
   <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
   
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
   <!-- This is a generated file.  Do not edit. -->
       <html>
       <head>
  @@ -28,7 +10,7 @@
         <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>
   
                         <meta name="author" value="Peter Donald">
  -  <meta name="email" value="peter @ apache.org">
  +  <meta name="email" value="peter at apache.org">
         
         <title>Avalon Phoenix - Guide - Creating a Block</title>
       </head>
  @@ -64,7 +46,7 @@
     </small></div>
                 <div><small>      <a href="../getting-started.html">Getting started</a>
     </small></div>
  -              <div><small>      <a href="http://jakarta.apache.org/builds/jakarta-avalon/release/phoenix">Download</a>
  +              <div><small>      <a href="http://jakarta.apache.org/builds/jakarta-avalon-phoenix">Download</a>
     </small></div>
                 <div><small>      <a href="../install.html">Install</a>
     </small></div>
  @@ -83,6 +65,8 @@
     </small></div>
                 <div><small>      <a href="../bdg/index.html">for Block Developers</a>
     </small></div>
  +              <div><small>      <a href="../mx/index.html">Management Guide</a>
  +  </small></div>
                 <div><small>      <a href="../guide-example-configuration.html">Example configuration</a>
     </small></div>
             </div>
  @@ -117,6 +101,8 @@
     </small></div>
                 <div><small>      <a href="http://nagoya.apache.org/bugzilla/enter_bug.cgi?product=Avalon&component=Phoenix&bug_severity=Enhancement">Enhancement Requests</a>
     </small></div>
  +              <div><small>      <a href="../for-developers-alternate-kernel.html">Alternate Kernels</a>
  +  </small></div>
             </div>
                 </div>
             </td>
  @@ -253,7 +239,7 @@
                 </div>
                 </div>
   		<div align="right" id="authors">
  -		 by   <a href="peter @ apache.org">Peter Donald</a>
  +		 by   <a href="peter at apache.org">Peter Donald</a>
   		</div>
             </div></td>
           </tr>
  @@ -270,5 +256,3 @@
   
       </body>
     </html>
  -
  -
  
  
  
  1.4       +5 -21     jakarta-avalon-site/docs/phoenix/bdg/index.html
  
  Index: index.html
  ===================================================================
  RCS file: /home/cvs/jakarta-avalon-site/docs/phoenix/bdg/index.html,v
  retrieving revision 1.3
  retrieving revision 1.4
  diff -u -r1.3 -r1.4
  --- index.html	20 Jun 2002 09:48:49 -0000	1.3
  +++ index.html	6 Sep 2002 23:31:51 -0000	1.4
  @@ -1,23 +1,5 @@
   <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
   
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
   <!-- This is a generated file.  Do not edit. -->
       <html>
       <head>
  @@ -64,7 +46,7 @@
     </small></div>
                 <div><small>      <a href="../getting-started.html">Getting started</a>
     </small></div>
  -              <div><small>      <a href="http://jakarta.apache.org/builds/jakarta-avalon/release/phoenix">Download</a>
  +              <div><small>      <a href="http://jakarta.apache.org/builds/jakarta-avalon-phoenix">Download</a>
     </small></div>
                 <div><small>      <a href="../install.html">Install</a>
     </small></div>
  @@ -83,6 +65,8 @@
     </small></div>
                 <div><small>      <a href="../bdg/index.html">for Block Developers</a>
     </small></div>
  +              <div><small>      <a href="../mx/index.html">Management Guide</a>
  +  </small></div>
                 <div><small>      <a href="../guide-example-configuration.html">Example configuration</a>
     </small></div>
             </div>
  @@ -117,6 +101,8 @@
     </small></div>
                 <div><small>      <a href="http://nagoya.apache.org/bugzilla/enter_bug.cgi?product=Avalon&component=Phoenix&bug_severity=Enhancement">Enhancement Requests</a>
     </small></div>
  +              <div><small>      <a href="../for-developers-alternate-kernel.html">Alternate Kernels</a>
  +  </small></div>
             </div>
                 </div>
             </td>
  @@ -210,5 +196,3 @@
   
       </body>
     </html>
  -
  -
  
  
  
  1.4       +5 -21     jakarta-avalon-site/docs/phoenix/bdg/making-phoenix-compatible-comps.html
  
  Index: making-phoenix-compatible-comps.html
  ===================================================================
  RCS file: /home/cvs/jakarta-avalon-site/docs/phoenix/bdg/making-phoenix-compatible-comps.html,v
  retrieving revision 1.3
  retrieving revision 1.4
  diff -u -r1.3 -r1.4
  --- making-phoenix-compatible-comps.html	20 Jun 2002 09:48:49 -0000	1.3
  +++ making-phoenix-compatible-comps.html	6 Sep 2002 23:31:51 -0000	1.4
  @@ -1,23 +1,5 @@
   <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
   
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
   <!-- This is a generated file.  Do not edit. -->
       <html>
       <head>
  @@ -64,7 +46,7 @@
     </small></div>
                 <div><small>      <a href="../getting-started.html">Getting started</a>
     </small></div>
  -              <div><small>      <a href="http://jakarta.apache.org/builds/jakarta-avalon/release/phoenix">Download</a>
  +              <div><small>      <a href="http://jakarta.apache.org/builds/jakarta-avalon-phoenix">Download</a>
     </small></div>
                 <div><small>      <a href="../install.html">Install</a>
     </small></div>
  @@ -83,6 +65,8 @@
     </small></div>
                 <div><small>      <a href="../bdg/index.html">for Block Developers</a>
     </small></div>
  +              <div><small>      <a href="../mx/index.html">Management Guide</a>
  +  </small></div>
                 <div><small>      <a href="../guide-example-configuration.html">Example configuration</a>
     </small></div>
             </div>
  @@ -117,6 +101,8 @@
     </small></div>
                 <div><small>      <a href="http://nagoya.apache.org/bugzilla/enter_bug.cgi?product=Avalon&component=Phoenix&bug_severity=Enhancement">Enhancement Requests</a>
     </small></div>
  +              <div><small>      <a href="../for-developers-alternate-kernel.html">Alternate Kernels</a>
  +  </small></div>
             </div>
                 </div>
             </td>
  @@ -454,5 +440,3 @@
   
       </body>
     </html>
  -
  -
  
  
  
  1.5       +7 -23     jakarta-avalon-site/docs/phoenix/bdg/what-is-a-block-listener.html
  
  Index: what-is-a-block-listener.html
  ===================================================================
  RCS file: /home/cvs/jakarta-avalon-site/docs/phoenix/bdg/what-is-a-block-listener.html,v
  retrieving revision 1.4
  retrieving revision 1.5
  diff -u -r1.4 -r1.5
  --- what-is-a-block-listener.html	6 Aug 2002 11:21:08 -0000	1.4
  +++ what-is-a-block-listener.html	6 Sep 2002 23:31:51 -0000	1.5
  @@ -1,23 +1,5 @@
   <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
   
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
   <!-- This is a generated file.  Do not edit. -->
       <html>
       <head>
  @@ -28,7 +10,7 @@
         <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>
   
                         <meta name="author" value="Peter Donald">
  -  <meta name="email" value="peter @ apache.org">
  +  <meta name="email" value="peter at apache.org">
                   <meta name="author" value="Paul Hammant">
     <meta name="email" value="Paul_Hammant@yahoo.com">
         
  @@ -66,7 +48,7 @@
     </small></div>
                 <div><small>      <a href="../getting-started.html">Getting started</a>
     </small></div>
  -              <div><small>      <a href="http://jakarta.apache.org/builds/jakarta-avalon/release/phoenix">Download</a>
  +              <div><small>      <a href="http://jakarta.apache.org/builds/jakarta-avalon-phoenix">Download</a>
     </small></div>
                 <div><small>      <a href="../install.html">Install</a>
     </small></div>
  @@ -85,6 +67,8 @@
     </small></div>
                 <div><small>      <a href="../bdg/index.html">for Block Developers</a>
     </small></div>
  +              <div><small>      <a href="../mx/index.html">Management Guide</a>
  +  </small></div>
                 <div><small>      <a href="../guide-example-configuration.html">Example configuration</a>
     </small></div>
             </div>
  @@ -119,6 +103,8 @@
     </small></div>
                 <div><small>      <a href="http://nagoya.apache.org/bugzilla/enter_bug.cgi?product=Avalon&component=Phoenix&bug_severity=Enhancement">Enhancement Requests</a>
     </small></div>
  +              <div><small>      <a href="../for-developers-alternate-kernel.html">Alternate Kernels</a>
  +  </small></div>
             </div>
                 </div>
             </td>
  @@ -236,7 +222,7 @@
                 </div>
                 </div>
   		<div align="right" id="authors">
  -		 by   <a href="peter @ apache.org">Peter Donald</a>
  +		 by   <a href="peter at apache.org">Peter Donald</a>
   	  , <a href="Paul_Hammant@yahoo.com">Paul Hammant</a>
   		</div>
             </div></td>
  @@ -254,5 +240,3 @@
   
       </body>
     </html>
  -
  -
  
  
  
  1.4       +5 -21     jakarta-avalon-site/docs/phoenix/bdg/what-is-a-block.html
  
  Index: what-is-a-block.html
  ===================================================================
  RCS file: /home/cvs/jakarta-avalon-site/docs/phoenix/bdg/what-is-a-block.html,v
  retrieving revision 1.3
  retrieving revision 1.4
  diff -u -r1.3 -r1.4
  --- what-is-a-block.html	20 Jun 2002 09:48:49 -0000	1.3
  +++ what-is-a-block.html	6 Sep 2002 23:31:51 -0000	1.4
  @@ -1,23 +1,5 @@
   <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
   
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
   <!-- This is a generated file.  Do not edit. -->
       <html>
       <head>
  @@ -64,7 +46,7 @@
     </small></div>
                 <div><small>      <a href="../getting-started.html">Getting started</a>
     </small></div>
  -              <div><small>      <a href="http://jakarta.apache.org/builds/jakarta-avalon/release/phoenix">Download</a>
  +              <div><small>      <a href="http://jakarta.apache.org/builds/jakarta-avalon-phoenix">Download</a>
     </small></div>
                 <div><small>      <a href="../install.html">Install</a>
     </small></div>
  @@ -83,6 +65,8 @@
     </small></div>
                 <div><small>      <a href="../bdg/index.html">for Block Developers</a>
     </small></div>
  +              <div><small>      <a href="../mx/index.html">Management Guide</a>
  +  </small></div>
                 <div><small>      <a href="../guide-example-configuration.html">Example configuration</a>
     </small></div>
             </div>
  @@ -117,6 +101,8 @@
     </small></div>
                 <div><small>      <a href="http://nagoya.apache.org/bugzilla/enter_bug.cgi?product=Avalon&component=Phoenix&bug_severity=Enhancement">Enhancement Requests</a>
     </small></div>
  +              <div><small>      <a href="../for-developers-alternate-kernel.html">Alternate Kernels</a>
  +  </small></div>
             </div>
                 </div>
             </td>
  @@ -224,5 +210,3 @@
   
       </body>
     </html>
  -
  -
  
  
  
  1.4       +5 -21     jakarta-avalon-site/docs/phoenix/bdg/what-is-an-application-listener.html
  
  Index: what-is-an-application-listener.html
  ===================================================================
  RCS file: /home/cvs/jakarta-avalon-site/docs/phoenix/bdg/what-is-an-application-listener.html,v
  retrieving revision 1.3
  retrieving revision 1.4
  diff -u -r1.3 -r1.4
  --- what-is-an-application-listener.html	20 Jun 2002 09:48:49 -0000	1.3
  +++ what-is-an-application-listener.html	6 Sep 2002 23:31:51 -0000	1.4
  @@ -1,23 +1,5 @@
   <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
   
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
  -
   <!-- This is a generated file.  Do not edit. -->
       <html>
       <head>
  @@ -64,7 +46,7 @@
     </small></div>
                 <div><small>      <a href="../getting-started.html">Getting started</a>
     </small></div>
  -              <div><small>      <a href="http://jakarta.apache.org/builds/jakarta-avalon/release/phoenix">Download</a>
  +              <div><small>      <a href="http://jakarta.apache.org/builds/jakarta-avalon-phoenix">Download</a>
     </small></div>
                 <div><small>      <a href="../install.html">Install</a>
     </small></div>
  @@ -83,6 +65,8 @@
     </small></div>
                 <div><small>      <a href="../bdg/index.html">for Block Developers</a>
     </small></div>
  +              <div><small>      <a href="../mx/index.html">Management Guide</a>
  +  </small></div>
                 <div><small>      <a href="../guide-example-configuration.html">Example configuration</a>
     </small></div>
             </div>
  @@ -117,6 +101,8 @@
     </small></div>
                 <div><small>      <a href="http://nagoya.apache.org/bugzilla/enter_bug.cgi?product=Avalon&component=Phoenix&bug_severity=Enhancement">Enhancement Requests</a>
     </small></div>
  +              <div><small>      <a href="../for-developers-alternate-kernel.html">Alternate Kernels</a>
  +  </small></div>
             </div>
                 </div>
             </td>
  @@ -247,5 +233,3 @@
   
       </body>
     </html>
  -
  -
  
  
  
  1.1                  jakarta-avalon-site/docs/phoenix/mx/index.html
  
  Index: index.html
  ===================================================================
  <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  
  <!-- This is a generated file.  Do not edit. -->
      <html>
      <head>
        <style type="text/css">
          @import url("../css/tigris.css");
          @import url("../css/site.css");
        </style>
        <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>
  
                        <meta name="author" value="Huw Roberts">
    <meta name="email" value="huw@apache.org">
        
        <title>Avalon Phoenix - Management Guide</title>
      </head>
  
      <body marginwidth="0" marginheight="0" class="composite">
  
        <div id="banner">
          <table border="0" cellspacing="0" cellpadding="8" width="100%">
            <!-- TOP IMAGE -->
            <tr>
              <td>      <td align="left">
      <a href="http://jakarta.apache.org"><img src="http://jakarta.apache.org/images/jakarta-logo.gif" border="0"/></a>
      </td>
      <td align="right">
                <a href="http://jakarta.apache.org/avalon/phoenix"><img src="../images/header.gif" alt="Avalon Phoenix" border="0"/></a>
          </td>
    </td>
              <td><div align="right" valign="bottom"><b><font size="+3">Avalon Phoenix</font></b></div></td>
            </tr>
          </table>
        </div>
  
        <table border="0" cellspacing="0" cellpadding="8" width="100%" id="main">
          <tr valign="top">
            <!-- LEFT SIDE NAVIGATION -->
            <td id="leftcol" width="20%">
              <div id="navcolumn">
                    <div>
        <strong>Essentials</strong>
                <div><small>      <a href="../index.html">Overview</a>
    </small></div>
                <div><small>      <a href="../features.html">Features</a>
    </small></div>
                <div><small>      <a href="../getting-started.html">Getting started</a>
    </small></div>
                <div><small>      <a href="http://jakarta.apache.org/builds/jakarta-avalon-phoenix">Download</a>
    </small></div>
                <div><small>      <a href="../install.html">Install</a>
    </small></div>
            </div>
        <div>
        <strong>Guide</strong>
                <div><small>      <a href="../guide-architecture.html">Architectural Overview</a>
    </small></div>
                <div><small>      <a href="../guide-roles.html">Development Roles</a>
    </small></div>
                <div><small>      <a href="../guide-administrator.html">for Administrators</a>
    </small></div>
                <div><small>      <a href="../guide-deployers.html">for Deployers</a>
    </small></div>
                <div><small>      <a href="../assemblers/index.html">for Assemblers</a>
    </small></div>
                <div><small>      <a href="../bdg/index.html">for Block Developers</a>
    </small></div>
                <div><small>      <a href="../mx/index.html">Management Guide</a>
    </small></div>
                <div><small>      <a href="../guide-example-configuration.html">Example configuration</a>
    </small></div>
            </div>
        <div>
        <strong>Reference</strong>
                <div><small>      <a href="../api/index.html">API Docs</a>
    </small></div>
                <div><small>      <a href="../assemblers/config-xml-specification.html">config.xml Specification</a>
    </small></div>
                <div><small>      <a href="../assemblers/assembly-xml-specification.html">assembly.xml Specification</a>
    </small></div>
                <div><small>      <a href="../assemblers/environment-xml-specification.html">environment.xml Specification</a>
    </small></div>
                <div><small>      <a href="../bdg/blockinfo-specification.html">BlockInfo Specification</a>
    </small></div>
            </div>
        <div>
        <strong>For Developers</strong>
                <div><small>      <a href="../changes.html">Changes</a>
    </small></div>
                <div><small>      <a href="http://jakarta.apache.org/avalon/code-standards.html">Coding standards</a>
    </small></div>
                <div><small>      <a href="../for-developers-project-structure.html">Project Structure</a>
    </small></div>
                <div><small>      <a href="http://jakarta.apache.org/site/cvsindex.html">CVS Repositories</a>
    </small></div>
                <div><small>      <a href="http://jakarta.apache.org/site/mail.html">Mailing Lists</a>
    </small></div>
                <div><small>      <a href="http://nagoya.apache.org/bugzilla/buglist.cgi?bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&bug_status=RESOLVED&product=Avalon&component=Phoenix">TODO</a>
    </small></div>
                <div><small>      <a href="http://nagoya.apache.org/bugzilla/enter_bug.cgi?product=Avalon&component=Phoenix">Bug Database</a>
    </small></div>
                <div><small>      <a href="http://nagoya.apache.org/bugzilla/enter_bug.cgi?product=Avalon&component=Phoenix&bug_severity=Enhancement">Enhancement Requests</a>
    </small></div>
                <div><small>      <a href="../for-developers-alternate-kernel.html">Alternate Kernels</a>
    </small></div>
            </div>
                </div>
            </td>
            <td><div id="bodycol"><div class="app">
          <div class="h3">
              <h3><a name="Who Should Read This Book?">Who Should Read This Book?</a></h3>
                          <p
          >      This guide documents how a developer will go about enabling
              JMX Management support for their application or for the kernel.
              The text assumes that the reader has a basic understanding of
              JMX.
    </p>
                </div>
          <div class="h3">
              <h3><a name="Contents">Contents</a></h3>
                          <ol
          >                    
                  
                                <li
          >                                <a href="overview.html">Overview</a>
                  </li>
                            
                  
                                <li
          >                                <a href="structure.html">The Structure of Management hierarchy</a>
                  </li>
                            
                  
                                <li
          >                                <a href="mxinfo.html">The MXInfo format</a>
                  </li>
                            
                  
                                <li
          >                                <a href="xdoctags.html">Integration with XDoclet</a>
                  </li>
                            
              
              </ol>
                </div>
                </div>
  		<div align="right" id="authors">
  		 by   <a href="huw@apache.org">Huw Roberts</a>
  		</div>
            </div></td>
          </tr>
        </table>
  
        <!-- FOOTER -->
        <div id="footer">
          <table border="0" cellspacing="0" cellpadding="4">
            <tr>
              <td>Copyright &#169; 1999-2002, Apache Software Foundation</td>
            </tr>
          </table>
        </div>
  
      </body>
    </html>
  
  
  
  1.1                  jakarta-avalon-site/docs/phoenix/mx/mxinfo.html
  
  Index: mxinfo.html
  ===================================================================
  <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  
  <!-- This is a generated file.  Do not edit. -->
      <html>
      <head>
        <style type="text/css">
          @import url("../css/tigris.css");
          @import url("../css/site.css");
        </style>
        <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>
  
                        <meta name="author" value="Huw Roberts">
    <meta name="email" value="huw@apache.org">
        
        <title>Avalon Phoenix - Management Guide - MXINFO File Format</title>
      </head>
  
      <body marginwidth="0" marginheight="0" class="composite">
  
        <div id="banner">
          <table border="0" cellspacing="0" cellpadding="8" width="100%">
            <!-- TOP IMAGE -->
            <tr>
              <td>      <td align="left">
      <a href="http://jakarta.apache.org"><img src="http://jakarta.apache.org/images/jakarta-logo.gif" border="0"/></a>
      </td>
      <td align="right">
                <a href="http://jakarta.apache.org/avalon/phoenix"><img src="../images/header.gif" alt="Avalon Phoenix" border="0"/></a>
          </td>
    </td>
              <td><div align="right" valign="bottom"><b><font size="+3">Avalon Phoenix</font></b></div></td>
            </tr>
          </table>
        </div>
  
        <table border="0" cellspacing="0" cellpadding="8" width="100%" id="main">
          <tr valign="top">
            <!-- LEFT SIDE NAVIGATION -->
            <td id="leftcol" width="20%">
              <div id="navcolumn">
                    <div>
        <strong>Essentials</strong>
                <div><small>      <a href="../index.html">Overview</a>
    </small></div>
                <div><small>      <a href="../features.html">Features</a>
    </small></div>
                <div><small>      <a href="../getting-started.html">Getting started</a>
    </small></div>
                <div><small>      <a href="http://jakarta.apache.org/builds/jakarta-avalon-phoenix">Download</a>
    </small></div>
                <div><small>      <a href="../install.html">Install</a>
    </small></div>
            </div>
        <div>
        <strong>Guide</strong>
                <div><small>      <a href="../guide-architecture.html">Architectural Overview</a>
    </small></div>
                <div><small>      <a href="../guide-roles.html">Development Roles</a>
    </small></div>
                <div><small>      <a href="../guide-administrator.html">for Administrators</a>
    </small></div>
                <div><small>      <a href="../guide-deployers.html">for Deployers</a>
    </small></div>
                <div><small>      <a href="../assemblers/index.html">for Assemblers</a>
    </small></div>
                <div><small>      <a href="../bdg/index.html">for Block Developers</a>
    </small></div>
                <div><small>      <a href="../mx/index.html">Management Guide</a>
    </small></div>
                <div><small>      <a href="../guide-example-configuration.html">Example configuration</a>
    </small></div>
            </div>
        <div>
        <strong>Reference</strong>
                <div><small>      <a href="../api/index.html">API Docs</a>
    </small></div>
                <div><small>      <a href="../assemblers/config-xml-specification.html">config.xml Specification</a>
    </small></div>
                <div><small>      <a href="../assemblers/assembly-xml-specification.html">assembly.xml Specification</a>
    </small></div>
                <div><small>      <a href="../assemblers/environment-xml-specification.html">environment.xml Specification</a>
    </small></div>
                <div><small>      <a href="../bdg/blockinfo-specification.html">BlockInfo Specification</a>
    </small></div>
            </div>
        <div>
        <strong>For Developers</strong>
                <div><small>      <a href="../changes.html">Changes</a>
    </small></div>
                <div><small>      <a href="http://jakarta.apache.org/avalon/code-standards.html">Coding standards</a>
    </small></div>
                <div><small>      <a href="../for-developers-project-structure.html">Project Structure</a>
    </small></div>
                <div><small>      <a href="http://jakarta.apache.org/site/cvsindex.html">CVS Repositories</a>
    </small></div>
                <div><small>      <a href="http://jakarta.apache.org/site/mail.html">Mailing Lists</a>
    </small></div>
                <div><small>      <a href="http://nagoya.apache.org/bugzilla/buglist.cgi?bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&bug_status=RESOLVED&product=Avalon&component=Phoenix">TODO</a>
    </small></div>
                <div><small>      <a href="http://nagoya.apache.org/bugzilla/enter_bug.cgi?product=Avalon&component=Phoenix">Bug Database</a>
    </small></div>
                <div><small>      <a href="http://nagoya.apache.org/bugzilla/enter_bug.cgi?product=Avalon&component=Phoenix&bug_severity=Enhancement">Enhancement Requests</a>
    </small></div>
                <div><small>      <a href="../for-developers-alternate-kernel.html">Alternate Kernels</a>
    </small></div>
            </div>
                </div>
            </td>
            <td><div id="bodycol"><div class="app">
          <div class="h3">
              <h3><a name="Outline">Outline</a></h3>
                          <ul
          >                    
          
                                <li
          >      
            specified in the DTD, available here.[TODO]
          
    </li>
                            
          
                                <li
          >      
            explain the various elements
          
    </li>
                            
          
                                <li
          >      
            explain runtime requirements
          
    </li>
                            
        
              </ul>
                </div>
          <div class="h3">
              <h3><a name="Overview">Overview</a></h3>
                          <p
          >      
          The mxinfo file is contains information about how the object it describes can be managed.  It
          includes functional information intended for the management application, and descriptive data
          to help guide the user.
        
    </p>
                                  <p
          >      
          An mxinfo file is created at design time, either automatically using xdoclet tags (TODO described here) 
          or by hand.  At startup the mxinfo file is parsed, and in conjuntion with class introspection 
          is used to define the in-memory metadata for the management of the target object.
        
    </p>
                                  <p
          >      
          A target object is not restricted to having a single mxinfo file, although the specifics of how that
          works is dependant on the container (described [TODO] here).  Similarly it is expected that
          at runtime the mxinfo file will be located in the classpath of the Target class, in the same
          package as that class, but this is also under the control of the Container.  Finally, its worth
          pointing out that an mxinfo file generated from interface can be applied to
          any class that implements the interface.
        
    </p>
                </div>
          <div class="h3">
              <h3><a name="Example">Example</a></h3>
                          <p
          >      
          Since mxinfo files are somewhat confusing in the abstract, but straight forward in practice,
          the rest of this section describes an imaginary, yet somewhat plausible, mxinfo file.
        
    </p>
                                    <div id="source">
      <pre>&lt;?xml version=&quot;1.0&quot;?&gt;
  &lt;!DOCTYPE mxinfo PUBLIC &quot;-//PHOENIX/Mx Info DTD Version 1.0//EN&quot;
                    &quot;http://jakarta.apache.org/phoenix/mxinfo_1_0.dtd&quot;&gt;
  
  &lt;mxinfo&gt;
  
      &lt;topic name=&quot;ftpServer&quot; &gt;
  
        &lt;!-- attributes --&gt;
        &lt;attribute
          name=&quot;addressString&quot;
          description=&quot;Address String&quot;
          isWriteable=&quot;no&quot;
          type=&quot;java.lang.String&quot;
        /&gt;
        &lt;attribute
          name=&quot;serverAddress&quot;
          description=&quot;Server bind address.&quot;
          isWriteable=&quot;no&quot;
          type=&quot;java.net.InetAddress&quot;
        /&gt;
  
        &lt;!-- operations --&gt;
        &lt;operation
          name=&quot;getDefaultRoot&quot;
          description=&quot;Gets the default root&quot;
          type=&quot;java.lang.String&quot;
        &gt;
        &lt;/operation&gt;
        &lt;operation
          name=&quot;getServerPort&quot;
          description=&quot;Returns port that the server listens on&quot;
          type=&quot;java.lang.String&quot;
        &gt;
          &lt;param
            name=&quot;instance&quot;
            description=&quot;no description&quot;
            type=&quot;java.lang.Integer&quot;
          /&gt;
        &lt;/operation&gt;
  
      &lt;/topic&gt;
  
      &lt;proxy name=&quot;userManager&quot; /&gt;
  
  &lt;/mxinfo&gt;</pre>
    </div>
                </div>
                </div>
  		<div align="right" id="authors">
  		 by   <a href="huw@apache.org">Huw Roberts</a>
  		</div>
            </div></td>
          </tr>
        </table>
  
        <!-- FOOTER -->
        <div id="footer">
          <table border="0" cellspacing="0" cellpadding="4">
            <tr>
              <td>Copyright &#169; 1999-2002, Apache Software Foundation</td>
            </tr>
          </table>
        </div>
  
      </body>
    </html>
  
  
  
  1.1                  jakarta-avalon-site/docs/phoenix/mx/overview.html
  
  Index: overview.html
  ===================================================================
  <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  
  <!-- This is a generated file.  Do not edit. -->
      <html>
      <head>
        <style type="text/css">
          @import url("../css/tigris.css");
          @import url("../css/site.css");
        </style>
        <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>
  
                        <meta name="author" value="Huw Roberts">
    <meta name="email" value="huw@apache.org">
        
        <title>Avalon Phoenix - Guide - Step by Step Overview</title>
      </head>
  
      <body marginwidth="0" marginheight="0" class="composite">
  
        <div id="banner">
          <table border="0" cellspacing="0" cellpadding="8" width="100%">
            <!-- TOP IMAGE -->
            <tr>
              <td>      <td align="left">
      <a href="http://jakarta.apache.org"><img src="http://jakarta.apache.org/images/jakarta-logo.gif" border="0"/></a>
      </td>
      <td align="right">
                <a href="http://jakarta.apache.org/avalon/phoenix"><img src="../images/header.gif" alt="Avalon Phoenix" border="0"/></a>
          </td>
    </td>
              <td><div align="right" valign="bottom"><b><font size="+3">Avalon Phoenix</font></b></div></td>
            </tr>
          </table>
        </div>
  
        <table border="0" cellspacing="0" cellpadding="8" width="100%" id="main">
          <tr valign="top">
            <!-- LEFT SIDE NAVIGATION -->
            <td id="leftcol" width="20%">
              <div id="navcolumn">
                    <div>
        <strong>Essentials</strong>
                <div><small>      <a href="../index.html">Overview</a>
    </small></div>
                <div><small>      <a href="../features.html">Features</a>
    </small></div>
                <div><small>      <a href="../getting-started.html">Getting started</a>
    </small></div>
                <div><small>      <a href="http://jakarta.apache.org/builds/jakarta-avalon-phoenix">Download</a>
    </small></div>
                <div><small>      <a href="../install.html">Install</a>
    </small></div>
            </div>
        <div>
        <strong>Guide</strong>
                <div><small>      <a href="../guide-architecture.html">Architectural Overview</a>
    </small></div>
                <div><small>      <a href="../guide-roles.html">Development Roles</a>
    </small></div>
                <div><small>      <a href="../guide-administrator.html">for Administrators</a>
    </small></div>
                <div><small>      <a href="../guide-deployers.html">for Deployers</a>
    </small></div>
                <div><small>      <a href="../assemblers/index.html">for Assemblers</a>
    </small></div>
                <div><small>      <a href="../bdg/index.html">for Block Developers</a>
    </small></div>
                <div><small>      <a href="../mx/index.html">Management Guide</a>
    </small></div>
                <div><small>      <a href="../guide-example-configuration.html">Example configuration</a>
    </small></div>
            </div>
        <div>
        <strong>Reference</strong>
                <div><small>      <a href="../api/index.html">API Docs</a>
    </small></div>
                <div><small>      <a href="../assemblers/config-xml-specification.html">config.xml Specification</a>
    </small></div>
                <div><small>      <a href="../assemblers/assembly-xml-specification.html">assembly.xml Specification</a>
    </small></div>
                <div><small>      <a href="../assemblers/environment-xml-specification.html">environment.xml Specification</a>
    </small></div>
                <div><small>      <a href="../bdg/blockinfo-specification.html">BlockInfo Specification</a>
    </small></div>
            </div>
        <div>
        <strong>For Developers</strong>
                <div><small>      <a href="../changes.html">Changes</a>
    </small></div>
                <div><small>      <a href="http://jakarta.apache.org/avalon/code-standards.html">Coding standards</a>
    </small></div>
                <div><small>      <a href="../for-developers-project-structure.html">Project Structure</a>
    </small></div>
                <div><small>      <a href="http://jakarta.apache.org/site/cvsindex.html">CVS Repositories</a>
    </small></div>
                <div><small>      <a href="http://jakarta.apache.org/site/mail.html">Mailing Lists</a>
    </small></div>
                <div><small>      <a href="http://nagoya.apache.org/bugzilla/buglist.cgi?bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&bug_status=RESOLVED&product=Avalon&component=Phoenix">TODO</a>
    </small></div>
                <div><small>      <a href="http://nagoya.apache.org/bugzilla/enter_bug.cgi?product=Avalon&component=Phoenix">Bug Database</a>
    </small></div>
                <div><small>      <a href="http://nagoya.apache.org/bugzilla/enter_bug.cgi?product=Avalon&component=Phoenix&bug_severity=Enhancement">Enhancement Requests</a>
    </small></div>
                <div><small>      <a href="../for-developers-alternate-kernel.html">Alternate Kernels</a>
    </small></div>
            </div>
                </div>
            </td>
            <td><div id="bodycol"><div class="app">
          <div class="h3">
              <h3><a name="Overview">Overview</a></h3>
                          <p
          >      
                This section gives a quick overview of how to go from a blocks source code, to a managed object accessible
                in a management interface.  It does not cover every aspect, nor is it strictly 'correct'.
              
    </p>
                              <div class="h4">
              <h4><a name="In Development">In Development</a></h4>
                  <p
          >      
                    For a block to be manageable, the developer inserts a series of XDoclet tags
                    in the class file.  Right now these are:
                  
    </p>
                    <p
          >      
                  At the class level:
                  
    </p>
                      <div id="source">
      <pre>/**
   * Ftp server starting point. Avalon framework will load this
   * from the jar file. This is also the starting point of remote
   * admin.
   *
   * @phoenix:block
   * @phoenix:mx-topic name=&quot;ftpServer&quot;
   * @phoenix:service name=&quot;org.apache.avalon.ftpserver...
   */
  public class FtpServerImpl extends AbstractLogEnabled
  ...</pre>
    </div>
                    <p
          >      
                  where @phoenix:mx-topic marks the block as eligible for management.
                  
    </p>
                    <p
          >      
                  For each attribute:
                  
    </p>
                      <div id="source">
      <pre>/**
       * @phoenix:mx-attribute
       * @phoenix:mx-description Returns the top published directory
       * @phoenix:mx-isWriteable false
       */
      public String getDefaultRoot() {
      ...</pre>
    </div>
                    <p
          >      
                  and finally for each operation:
                  
    </p>
                      <div id="source">
      <pre>/**
       * @phoenix:mx-operation
       * @phoenix:mx-description Returns port that the server listens on
       */
      public String getServerPort(Integer instance) {
      ...</pre>
    </div>
                    <p
          >      
                      When this is compiled the PhoenixDoclet task extracts this and inserts it
                      into an mxinfo file.  If a method doesn't have a @pheonix:mx-attribute tag it is not exposed for
                      management.
                  
    </p>
                    <p
          >      
                      Here's what the entry generated from the tags above looks like:
                  
    </p>
                      <div id="source">
      <pre>&lt;?xml version=&quot;1.0&quot;?&gt;
  &lt;!DOCTYPE mxinfo PUBLIC &quot;-//PHOENIX/Mx Info DTD Version 1.0//EN&quot;
                    &quot;http://jakarta.apache.org/phoenix/mxinfo_1_0.dtd&quot;&gt;
  
  &lt;mxinfo&gt;
  
      &lt;topic name=&quot;ftpServer&quot; &gt;
  
        &lt;!-- attributes --&gt;
        &lt;attribute
          name=&quot;defaultRoot&quot;
          description=&quot;Returns the top published directory&quot;
          isWriteable=&quot;no&quot;
          type=&quot;java.lang.String&quot;
        /&gt;
  
        &lt;!-- operations --&gt;
        &lt;operation
          name=&quot;getServerPort&quot;
          description=&quot;Returns port that the server listens on&quot;
          type=&quot;java.lang.String&quot;
        &gt;
          &lt;param
            name=&quot;instance&quot;
            description=&quot;no description&quot;
            type=&quot;java.lang.Integer&quot;
          /&gt;
        &lt;/operation&gt;
  
      &lt;/topic&gt;
  
  &lt;/mxinfo&gt;</pre>
    </div>
                    <p
          >      
                      Alternatively, you could write the mxinfo file directly (particularly in cases
                      where you can't/don't want to modify the source code).
                      The DTD is available [TODO]here.
                  
    </p>
          </div>
                            <div class="h4">
              <h4><a name="At Startup">At Startup</a></h4>
                  <p
          >      
                      At startup, Phoenix registers each block to a local SystemManager context.  This
                      context determines where the block fits into the management hierarchy.
                  
    </p>
                      <div id="source">
      <pre>[TODO - code snippet on the register line]</pre>
    </div>
                    <p
          >      
                      The system manager uses the mxinfo file in conjunction with introspection to
                      generate a ModelMBeanInfo object for each topic.  A RequiredModelMBean is then
                      created and exposed for management.
                  
    </p>
          </div>
                            <div class="h4">
              <h4><a name="While Running">While Running</a></h4>
                  <p
          >      
                      In the default configuration, management is provided through MX4J.  The administrator can perform various
                      tasks such as deploying, starting and stopping applications and changing the configuration of various
                      blocks.
                  
    </p>
                    <p
          >      
                      The server is accessed on port 8082 of the server. eg. http://localhost:8082.
                  
    </p>
                    <p
          >      TODO: Include screenshot?
    </p>
          </div>
              </div>
                </div>
  		<div align="right" id="authors">
  		 by   <a href="huw@apache.org">Huw Roberts</a>
  		</div>
            </div></td>
          </tr>
        </table>
  
        <!-- FOOTER -->
        <div id="footer">
          <table border="0" cellspacing="0" cellpadding="4">
            <tr>
              <td>Copyright &#169; 1999-2002, Apache Software Foundation</td>
            </tr>
          </table>
        </div>
  
      </body>
    </html>
  
  
  
  1.1                  jakarta-avalon-site/docs/phoenix/mx/structure.html
  
  Index: structure.html
  ===================================================================
  <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  
  <!-- This is a generated file.  Do not edit. -->
      <html>
      <head>
        <style type="text/css">
          @import url("../css/tigris.css");
          @import url("../css/site.css");
        </style>
        <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>
  
                        <meta name="author" value="Huw Roberts">
    <meta name="email" value="huw@apache.org">
        
        <title>Avalon Phoenix - Management Guide - Organizing Structure</title>
      </head>
  
      <body marginwidth="0" marginheight="0" class="composite">
  
        <div id="banner">
          <table border="0" cellspacing="0" cellpadding="8" width="100%">
            <!-- TOP IMAGE -->
            <tr>
              <td>      <td align="left">
      <a href="http://jakarta.apache.org"><img src="http://jakarta.apache.org/images/jakarta-logo.gif" border="0"/></a>
      </td>
      <td align="right">
                <a href="http://jakarta.apache.org/avalon/phoenix"><img src="../images/header.gif" alt="Avalon Phoenix" border="0"/></a>
          </td>
    </td>
              <td><div align="right" valign="bottom"><b><font size="+3">Avalon Phoenix</font></b></div></td>
            </tr>
          </table>
        </div>
  
        <table border="0" cellspacing="0" cellpadding="8" width="100%" id="main">
          <tr valign="top">
            <!-- LEFT SIDE NAVIGATION -->
            <td id="leftcol" width="20%">
              <div id="navcolumn">
                    <div>
        <strong>Essentials</strong>
                <div><small>      <a href="../index.html">Overview</a>
    </small></div>
                <div><small>      <a href="../features.html">Features</a>
    </small></div>
                <div><small>      <a href="../getting-started.html">Getting started</a>
    </small></div>
                <div><small>      <a href="http://jakarta.apache.org/builds/jakarta-avalon-phoenix">Download</a>
    </small></div>
                <div><small>      <a href="../install.html">Install</a>
    </small></div>
            </div>
        <div>
        <strong>Guide</strong>
                <div><small>      <a href="../guide-architecture.html">Architectural Overview</a>
    </small></div>
                <div><small>      <a href="../guide-roles.html">Development Roles</a>
    </small></div>
                <div><small>      <a href="../guide-administrator.html">for Administrators</a>
    </small></div>
                <div><small>      <a href="../guide-deployers.html">for Deployers</a>
    </small></div>
                <div><small>      <a href="../assemblers/index.html">for Assemblers</a>
    </small></div>
                <div><small>      <a href="../bdg/index.html">for Block Developers</a>
    </small></div>
                <div><small>      <a href="../mx/index.html">Management Guide</a>
    </small></div>
                <div><small>      <a href="../guide-example-configuration.html">Example configuration</a>
    </small></div>
            </div>
        <div>
        <strong>Reference</strong>
                <div><small>      <a href="../api/index.html">API Docs</a>
    </small></div>
                <div><small>      <a href="../assemblers/config-xml-specification.html">config.xml Specification</a>
    </small></div>
                <div><small>      <a href="../assemblers/assembly-xml-specification.html">assembly.xml Specification</a>
    </small></div>
                <div><small>      <a href="../assemblers/environment-xml-specification.html">environment.xml Specification</a>
    </small></div>
                <div><small>      <a href="../bdg/blockinfo-specification.html">BlockInfo Specification</a>
    </small></div>
            </div>
        <div>
        <strong>For Developers</strong>
                <div><small>      <a href="../changes.html">Changes</a>
    </small></div>
                <div><small>      <a href="http://jakarta.apache.org/avalon/code-standards.html">Coding standards</a>
    </small></div>
                <div><small>      <a href="../for-developers-project-structure.html">Project Structure</a>
    </small></div>
                <div><small>      <a href="http://jakarta.apache.org/site/cvsindex.html">CVS Repositories</a>
    </small></div>
                <div><small>      <a href="http://jakarta.apache.org/site/mail.html">Mailing Lists</a>
    </small></div>
                <div><small>      <a href="http://nagoya.apache.org/bugzilla/buglist.cgi?bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&bug_status=RESOLVED&product=Avalon&component=Phoenix">TODO</a>
    </small></div>
                <div><small>      <a href="http://nagoya.apache.org/bugzilla/enter_bug.cgi?product=Avalon&component=Phoenix">Bug Database</a>
    </small></div>
                <div><small>      <a href="http://nagoya.apache.org/bugzilla/enter_bug.cgi?product=Avalon&component=Phoenix&bug_severity=Enhancement">Enhancement Requests</a>
    </small></div>
                <div><small>      <a href="../for-developers-alternate-kernel.html">Alternate Kernels</a>
    </small></div>
            </div>
                </div>
            </td>
            <td><div id="bodycol"><div class="app">
          <div class="h3">
              <h3><a name="Outline">Outline</a></h3>
                          <ul
          >                    
          
                                <li
          >      
  	  a conceptual overview for management
          
    </li>
                            
        
              </ul>
                </div>
          <div class="h3">
              <h3><a name="Elements">Elements</a></h3>
                          <p
          >      
          Management information is stored in a structured format that contains both a 
          functional definition of the actions (what can be done) and descriptive information
          about the actions (to help guide the user).  It is composed of the following elements:
        
    </p>
                              <div class="h4">
              <h4><a name="Context">Context</a></h4>
                  <p
          >      
            The Context contains a list of managed components called Targets, and a
            list of sub-Contexts.
          
    </p>
          </div>
                            <div class="h4">
              <h4><a name="Target">Target</a></h4>
                  <p
          >      
            A target is a manageable object.  Examples of Targets in Phoenix include the 
            components, the applications and the blocks.  Each target has one or more topics.
  	
    </p>
          </div>
                            <div class="h4">
              <h4><a name="Topic">Topic</a></h4>
                  <p
          >      
            A topic is a group of attributes that can be get and/or set on the Target and a group of operations that can be called on it.  It is intended that Topics group together
            a particular aspect of Targets manageability.
          
    </p>
          </div>
              </div>
          <div class="h3">
              <h3><a name="Hierarchy">Hierarchy</a></h3>
                          <p
          >      
  	This diagram illustrates how this might be presented in a management GUI:
        
    </p>
                                    <div id="source">
      <pre>Phoenix 
   | 
   +--Components 
   |   +-- Kernel 
   |   +-- Deployer 
   |   +-- etc. 
   | 
   +--Applications 
       +--Hello World 
       |    +-- Blocks
       |          +-- Block 1 
       |          +-- Block 2 
       | 
       +-- Ftp Server 
            +-- Blocks
                  +-- Block 1 
                  +-- Block 2</pre>
    </div>
                                  <p
          >      
          In this example Phoenix, Components and Blocks are Contexts.  Kernel, Deployer, Hello World, Block 1, etc are Targets.  Each Target will then have one or more Topics.  Topics might be Logging, Lifecycle, Deployer, etc.  
        
    </p>
                                  <p
          >      
          In a jmx environment each topic would most likely be exported as its own mbean 
          (so in the above example the jmx name would be 'Instance=Phoenix,Application=Hello_World,Block=Block_2,Topic=Logger'.  
        
    </p>
                                  <p
          >      
          In a swing environment each topic might have its own tab.
        
    </p>
                                  <p
          >      
  	In a command line environment, the syntax might be:
        
    </p>
                                    <div id="source">
      <pre>phoenix-mx.set( &quot;Phoenix/Applications/Hello World/Logging/LogLevel&quot;, &quot;DEBUG&quot; );
  phoenix-mx.describe( &quot;&quot;Phoenix/Applications/Hello World/Logging/LogLevel&quot; );</pre>
    </div>
                                  <p
          >      
          The point behind the 'Organizing Structure' is to keep the management specification 
          seperated from the  management agent, while at the same time providing enough definition 
          to keep a shared conceptual view.
        
    </p>
                </div>
          <div class="h3">
              <h3><a name="Management Proxies">Management Proxies</a></h3>
                          <p
          >      
          There is one remaining concept to cover, the proxy.  It is a class that can be used 
          to wrap access to the underlying target.  Posible uses include the mapping of data 
          types to more friendly type, (eg. from Date to String and back), cleaning up method names, providing backwards
          compatibility with older versions, and exposing methods from classes reFerenced by 
          the target class.
        
    </p>
                </div>
                </div>
  		<div align="right" id="authors">
  		 by   <a href="huw@apache.org">Huw Roberts</a>
  		</div>
            </div></td>
          </tr>
        </table>
  
        <!-- FOOTER -->
        <div id="footer">
          <table border="0" cellspacing="0" cellpadding="4">
            <tr>
              <td>Copyright &#169; 1999-2002, Apache Software Foundation</td>
            </tr>
          </table>
        </div>
  
      </body>
    </html>
  
  
  
  1.1                  jakarta-avalon-site/docs/phoenix/mx/xdoctags.html
  
  Index: xdoctags.html
  ===================================================================
  <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  
  <!-- This is a generated file.  Do not edit. -->
      <html>
      <head>
        <style type="text/css">
          @import url("../css/tigris.css");
          @import url("../css/site.css");
        </style>
        <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>
  
                        <meta name="author" value="Huw Roberts">
    <meta name="email" value="huw@apache.org">
        
        <title>Avalon Phoenix - Management Guide - XDoclet Tagging</title>
      </head>
  
      <body marginwidth="0" marginheight="0" class="composite">
  
        <div id="banner">
          <table border="0" cellspacing="0" cellpadding="8" width="100%">
            <!-- TOP IMAGE -->
            <tr>
              <td>      <td align="left">
      <a href="http://jakarta.apache.org"><img src="http://jakarta.apache.org/images/jakarta-logo.gif" border="0"/></a>
      </td>
      <td align="right">
                <a href="http://jakarta.apache.org/avalon/phoenix"><img src="../images/header.gif" alt="Avalon Phoenix" border="0"/></a>
          </td>
    </td>
              <td><div align="right" valign="bottom"><b><font size="+3">Avalon Phoenix</font></b></div></td>
            </tr>
          </table>
        </div>
  
        <table border="0" cellspacing="0" cellpadding="8" width="100%" id="main">
          <tr valign="top">
            <!-- LEFT SIDE NAVIGATION -->
            <td id="leftcol" width="20%">
              <div id="navcolumn">
                    <div>
        <strong>Essentials</strong>
                <div><small>      <a href="../index.html">Overview</a>
    </small></div>
                <div><small>      <a href="../features.html">Features</a>
    </small></div>
                <div><small>      <a href="../getting-started.html">Getting started</a>
    </small></div>
                <div><small>      <a href="http://jakarta.apache.org/builds/jakarta-avalon-phoenix">Download</a>
    </small></div>
                <div><small>      <a href="../install.html">Install</a>
    </small></div>
            </div>
        <div>
        <strong>Guide</strong>
                <div><small>      <a href="../guide-architecture.html">Architectural Overview</a>
    </small></div>
                <div><small>      <a href="../guide-roles.html">Development Roles</a>
    </small></div>
                <div><small>      <a href="../guide-administrator.html">for Administrators</a>
    </small></div>
                <div><small>      <a href="../guide-deployers.html">for Deployers</a>
    </small></div>
                <div><small>      <a href="../assemblers/index.html">for Assemblers</a>
    </small></div>
                <div><small>      <a href="../bdg/index.html">for Block Developers</a>
    </small></div>
                <div><small>      <a href="../mx/index.html">Management Guide</a>
    </small></div>
                <div><small>      <a href="../guide-example-configuration.html">Example configuration</a>
    </small></div>
            </div>
        <div>
        <strong>Reference</strong>
                <div><small>      <a href="../api/index.html">API Docs</a>
    </small></div>
                <div><small>      <a href="../assemblers/config-xml-specification.html">config.xml Specification</a>
    </small></div>
                <div><small>      <a href="../assemblers/assembly-xml-specification.html">assembly.xml Specification</a>
    </small></div>
                <div><small>      <a href="../assemblers/environment-xml-specification.html">environment.xml Specification</a>
    </small></div>
                <div><small>      <a href="../bdg/blockinfo-specification.html">BlockInfo Specification</a>
    </small></div>
            </div>
        <div>
        <strong>For Developers</strong>
                <div><small>      <a href="../changes.html">Changes</a>
    </small></div>
                <div><small>      <a href="http://jakarta.apache.org/avalon/code-standards.html">Coding standards</a>
    </small></div>
                <div><small>      <a href="../for-developers-project-structure.html">Project Structure</a>
    </small></div>
                <div><small>      <a href="http://jakarta.apache.org/site/cvsindex.html">CVS Repositories</a>
    </small></div>
                <div><small>      <a href="http://jakarta.apache.org/site/mail.html">Mailing Lists</a>
    </small></div>
                <div><small>      <a href="http://nagoya.apache.org/bugzilla/buglist.cgi?bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&bug_status=RESOLVED&product=Avalon&component=Phoenix">TODO</a>
    </small></div>
                <div><small>      <a href="http://nagoya.apache.org/bugzilla/enter_bug.cgi?product=Avalon&component=Phoenix">Bug Database</a>
    </small></div>
                <div><small>      <a href="http://nagoya.apache.org/bugzilla/enter_bug.cgi?product=Avalon&component=Phoenix&bug_severity=Enhancement">Enhancement Requests</a>
    </small></div>
                <div><small>      <a href="../for-developers-alternate-kernel.html">Alternate Kernels</a>
    </small></div>
            </div>
                </div>
            </td>
            <td><div id="bodycol"><div class="app">
          <div class="h3">
              <h3><a name="Outline">Outline</a></h3>
                          <ul
          >                    
          
                                <li
          >      
              describe the XDoclet tags and how they generate the mxinfo
          
    </li>
                            
          
                                <li
          >      
              including how defaults are generated
          
    </li>
                            
          
                                <li
          >      
              dependencies and how to set up ant to generate the mxinfo files
          
    </li>
                            
        
              </ul>
                </div>
          <div class="h3">
              <h3><a name="Overview">Overview</a></h3>
                          <p
          >      
          XDoclet tags can be inserted into source code to automatically generate the mxinfo file.
          There are a number of advantages to doing it this way:
        
    </p>
                                  <ul
          >                    
          
                                <li
          >      
            its a lot faster than writing mxinfo files by hand
          
    </li>
                            
          
                                <li
          >      
            its harder to make mistakes, since much of the data required for the mxinfo file is
            parsed out of the source code
          
    </li>
                            
          
                                <li
          >      
            useful defaults can be used by reading the standard javadoc.
          
    </li>
                            
        
              </ul>
                                  <p
          >      
          Any class or interface can be used to produce mxinfo files.  How they get used is up to 
          container and its Management subsystem.
        
    </p>
                </div>
          <div class="h3">
              <h3><a name="The Tags">The Tags</a></h3>
                          <p
          >      
          The following tags are defined:
        
    </p>
                              <div class="h4">
              <h4><a name="phoenix:mx-topic">phoenix:mx-topic</a></h4>
                    <table cellpadding="3" cellspacing="2" border="1" width="100%">
                      <tr class="a">
                  <td
            >
                  Scope
          </td>
                    <td
            >
                  
                Applies to a class and interfaces.
              
          </td>
          </tr>
                          <tr class="b">
                  <td
            >
                  Purpose
          </td>
                    <td
            >
                  
                Marks the class or interface as eligible for management.  
              
          </td>
          </tr>
                          <tr class="a">
                  <td
            >
                  Parameters
          </td>
                    <td
            >
                  
                It takes a single attribute, called name, that will be used
                to uniquely define the Topic for each Target that includes it.
                This name may be presented to the user in the management agent.
              
          </td>
          </tr>
                          <tr class="b">
                  <td
            >
                  Notes
          </td>
                    <td
            >
                  
           
              
          </td>
          </tr>
          </table>
                    <p
          >      
            Example:
          
    </p>
                      <div id="source">
      <pre>/**
   * This is the interface via which you can manager
   * the root container of Applications.
   *
   * @phoenix:mx-topic name=&quot;Kernel&quot;
   *
   * @author 
   */</pre>
    </div>
          </div>
                            <div class="h4">
              <h4><a name="phoenix:mx-attribute">phoenix:mx-attribute</a></h4>
                    <table cellpadding="3" cellspacing="2" border="1" width="100%">
                      <tr class="a">
                  <td
            >
                  Scope
          </td>
                    <td
            >
                  
                Applies to getter and setter methods.
              
          </td>
          </tr>
                          <tr class="b">
                  <td
            >
                  Purpose
          </td>
                    <td
            >
                  
                Marks the method as being a getter or setter and as eligible for
                management.  If the class defines a getter and setter, then just 
                getter should be marked up.  
              
          </td>
          </tr>
                          <tr class="a">
                  <td
            >
                  Parameters
          </td>
                    <td
            >
                  
                None
              
          </td>
          </tr>
                          <tr class="b">
                  <td
            >
                  Notes
          </td>
                    <td
            >
                  
                Often used in conjuntion with the mx-isWriteable tag
              
          </td>
          </tr>
          </table>
                    <p
          >      
            Example:
          
    </p>
                      <div id="source">
      <pre>/**
       * Gets the list of applications running in the container
       *
       * @phoenix:mx-attribute
       *
       * @return applicationNames The array of application names
       */
      String[] getApplicationNames();</pre>
    </div>
          </div>
                            <div class="h4">
              <h4><a name="phoenix:mx-operation">phoenix:mx-operation</a></h4>
                    <table cellpadding="3" cellspacing="2" border="1" width="100%">
                      <tr class="a">
                  <td
            >
                  Scope
          </td>
                    <td
            >
                  
                Applies to methods that are not getters or setters.
              
          </td>
          </tr>
                          <tr class="b">
                  <td
            >
                  Purpose
          </td>
                    <td
            >
                  
                Marks the method as elible to be a management operation.  
              
          </td>
          </tr>
                          <tr class="a">
                  <td
            >
                  Parameters
          </td>
                    <td
            >
                  
                None
              
          </td>
          </tr>
                          <tr class="b">
                  <td
            >
                  Notes
          </td>
                    <td
            >
                  
                The standard javadoc is used to generate descriptions for any parameters to the
                method.
              
          </td>
          </tr>
          </table>
                    <p
          >      
            Example:
          
    </p>
                      <div id="source">
      <pre>/**
       * Removes the application from the container
       *
       * @phoenix:mx-operation
       *
       * @param name the name of application to remove
       */
      void removeApplication( String name )</pre>
    </div>
          </div>
                            <div class="h4">
              <h4><a name="phoenix:mx-description">phoenix:mx-description</a></h4>
                    <table cellpadding="3" cellspacing="2" border="1" width="100%">
                      <tr class="a">
                  <td
            >
                  Scope
          </td>
                    <td
            >
                  
                Applies to manageable attributes and operations (i.e. to methods that also
                have the mx-operation or mx-attribute tag).
              
          </td>
          </tr>
                          <tr class="b">
                  <td
            >
                  Purpose
          </td>
                    <td
            >
                  
                The text following the tag is a description of the method suitable for presentation
                in the management agent.
              
          </td>
          </tr>
                          <tr class="a">
                  <td
            >
                  Parameters
          </td>
                    <td
            >
                  
                None
              
          </td>
          </tr>
                          <tr class="b">
                  <td
            >
                  Notes
          </td>
                    <td
            >
                  
                Optional.  If ommitted the javadoc definition is used.            
              
          </td>
          </tr>
          </table>
                    <p
          >      
            Example:
          
    </p>
                      <div id="source">
      <pre>/**
       * Retrieve a string identifying version of server.
       * Usually looks like &quot;v4.0.1a&quot;.
       *
       * @phoenix:mx-attribute
       * @phoenix:mx-description Retrieve a string identifying version of server.
       *
       * @return version string of server.
       */
      String getVersion();</pre>
    </div>
          </div>
                            <div class="h4">
              <h4><a name="phoenix:mx-proxy">phoenix:mx-proxy</a></h4>
                    <table cellpadding="3" cellspacing="2" border="1" width="100%">
                      <tr class="a">
                  <td
            >
                  Scope
          </td>
                    <td
            >
                  
                Applies to classes.
              
          </td>
          </tr>
                          <tr class="b">
                  <td
            >
                  Purpose
          </td>
                    <td
            >
                  
                The proxy tag is used to indicate that a proxy class should be used
                to manage some aspect(s) of this object.  At runtime, the management
                system will instantiate in instance of the proxy class passing in
                a reference to the managed object in the constructor.  Management
                calls are then made on the proxy instead of the managed object.
              
          </td>
          </tr>
                          <tr class="a">
                  <td
            >
                  Parameters
          </td>
                    <td
            >
                  
                Takes a single attribute, "name" that must be the full class name of a class to be used
                as proxy for the management of this class.
              
          </td>
          </tr>
                          <tr class="b">
                  <td
            >
                  Notes
          </td>
                    <td
            >
                  
                At runtime it is expected the manager will instantiate the proxy class and use
                it in place of the Target object.
              
          </td>
          </tr>
          </table>
                    <p
          >      
            Example:
          
    </p>
                      <div id="source">
      <pre>/**
   * Ftp server starting point. Avalon framework will load this
   * from the jar file. This is also the starting point of remote
   * admin.
   *
   * @phoenix:block
   * @phoenix:service name=&quot;org.apache.avalon.ftpserver.interfaces.FtpServerInterface&quot;
   *
   * @phoenix:mx-proxy class=&quot;org.apache.avalon.ftpserver.FtpServerMxProxy&quot;
   *
   * @author  Rana Bhattacharyya &lt;rana_b@yahoo.com&gt;
   * @author  Paul Hammant &lt;Paul_Hammant@yahoo.com&gt;
   * @version 1.0
   */</pre>
    </div>
          </div>
              </div>
          <div class="h3">
              <h3><a name="Build Instructions">Build Instructions</a></h3>
                          <p
          >      
          To have mxinfo files generated as part as your ant build
          script, include a task like that this:
        
    </p>
                                    <div id="source">
      <pre>&lt;!-- Make .mxinfo automatically for blocks --&gt;
  &lt;target name=&quot;phoenix-xdoclet&quot; depends=&quot;compile&quot;&gt;
  
    &lt;mkdir dir=&quot;${build.xdoclet}&quot;/&gt;
  
    &lt;taskdef name=&quot;phoenix-mxinfo&quot;
             classname=&quot;org.apache.avalon.phoenix.tools.xdoclet.PhoenixXDoclet&quot;
             classpathref=&quot;project.class.path&quot;/&gt;
  
    &lt;phoenix-mxinfo
       destdir=&quot;${build.xdoclet}&quot;
        classpathref=&quot;project.class.path&quot;&gt;
      &lt;fileset dir=&quot;${java.dir}&quot;&gt;
        &lt;include name=&quot;**&quot; /&gt;
      &lt;/fileset&gt;
      &lt;mxinfo/&gt;
    &lt;/phoenix-mxinfo&gt;
  
  &lt;/target&gt;</pre>
    </div>
                                  <p
          >      
          Where build.xdoclet is where the .mxinfo files should be placed, and java.dir 
          is the location of the source files.
        
    </p>
                                  <p
          >      
          The xdoclet jars, phoenix-client.jar and log4j.jar need to be in 
          ant's classpath.
        
    </p>
                </div>
                </div>
  		<div align="right" id="authors">
  		 by   <a href="huw@apache.org">Huw Roberts</a>
  		</div>
            </div></td>
          </tr>
        </table>
  
        <!-- FOOTER -->
        <div id="footer">
          <table border="0" cellspacing="0" cellpadding="4">
            <tr>
              <td>Copyright &#169; 1999-2002, Apache Software Foundation</td>
            </tr>
          </table>
        </div>
  
      </body>
    </html>
  
  
  

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


Mime
View raw message