harmony-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From nadi...@apache.org
Subject svn commit: r517663 [3/14] - in /harmony/standard/site: docs/ docs/documentation/ docs/subcomponents/classlibrary/ docs/subcomponents/drlvm/ xdocs/ xdocs/documentation/ xdocs/stylesheets/ xdocs/subcomponents/classlibrary/ xdocs/subcomponents/drlvm/
Date Tue, 13 Mar 2007 12:17:45 GMT
Modified: harmony/standard/site/docs/subcomponents/classlibrary/rmi_provider.html
URL: http://svn.apache.org/viewvc/harmony/standard/site/docs/subcomponents/classlibrary/rmi_provider.html?view=diff&rev=517663&r1=517662&r2=517663
==============================================================================
--- harmony/standard/site/docs/subcomponents/classlibrary/rmi_provider.html (original)
+++ harmony/standard/site/docs/subcomponents/classlibrary/rmi_provider.html Tue Mar 13 05:17:43 2007
@@ -1,498 +1,498 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
-
-<!--
-Licensed to the Apache Software Foundation (ASF) under one or more
-contributor license agreements.  See the NOTICE file distributed with
-this work for additional information regarding copyright ownership.
-The ASF licenses this file to You under the Apache License, Version 2.0
-(the "License"); you may not use this file except in compliance with
-the License.  You may obtain a copy of the License at
-
-http://www.apache.org/licenses/LICENSE-2.0
-
-Unless required by applicable law or agreed to in writing, software
-distributed under the License is distributed on an "AS IS" BASIS,
-WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-See the License for the specific language governing permissions and
-limitations under the License.
--->
-
-
-<!-- start the processing -->
-    <!-- ====================================================================== -->
-    <!-- GENERATED FILE, DO NOT EDIT, EDIT THE XML FILE IN xdocs INSTEAD! -->
-    <!-- Main Page Section -->
-    <!-- ====================================================================== -->
-    <html>
-        <head>
-            <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>
-
-                                                    <meta name="author" value="Harmony Documentation Team">
-            <meta name="email" value="dev@harmony.apache.org">
-            
-           
-            
-            
-            
-            
-            
-            <title>Apache Harmony - RMI Provider</title>
-
-                        
-                        
-        <link rel="stylesheet" type="text/css" href="../../site.css"/>
-        </head>
-
-        <body>        
-            <table  width="100%" cellspacing="0">
-                <!-- TOP IMAGE -->
-                <tr>
-                    <td align='LEFT'>
-                    <table><tr><td>
-                    <td>
-<a href="http://harmony.apache.org/"><img  src="../../images/harmony-logo-new.png" alt="Apache Harmony" /></a>
-</td>
-</td>
-                    </td></tr></table>
-                    </td>
-                    <td align='RIGHT'>
-                    <a href="http://www.apachecon.com/2007/EU/index.html">
-                    <img src="http://www.apache.org/ads/ApacheCon/2007-europe-234x60.png"
-                    	alt="ApacheCon Europe 2007" /></a>                    
-                    </td>
-                </tr>
-            </table>
-            <table width="100%" cellspacing="4">
-                <tr><td colspan="2">
-                    <hr noshade="" size="1"/>
-                </td></tr>
-
-                <tr>
-                    <!-- LEFT SIDE NAVIGATION -->
-                    <td class="menuItem" width="20%" nowrap="true">
-
-                    <!-- special ACon Logo - leave here for next time
-                    <a href="http://www.us.apachecon.com/">
-                        <img src="http://www.apache.org/ads/ApacheCon/2007-europe-125x125.png"
-                             alt="ApacheCon Europe 2007" />
-                    </a> -->
-
-                   <!-- regular menu -->
-
-                    
-    <!-- ============================================================ -->
-
-                <p class="menuItem"><strong>General</strong></p>
-        <ul>
-                    <li class="menuItem">    <a href="../../index.html">Home</a>
-</li>
-           
-                        
-                    <li class="menuItem">    <a href="../../license.html">License</a>
-</li>
-           
-                        
-                    <li class="menuItem">    <a href="http://apache.org">ASF</a>
-</li>
-           
-                        
-                    <li class="menuItem">    <a href="../../contribution_policy.html">Contribution Policy</a>
-</li>
-           
-                        
-                    <li class="menuItem">    <a href="../../downloads.html">Downloads</a>
-</li>
-           
-                        
-                    <li class="menuItem">    <a href="../../faq.html">FAQ</a>
-</li>
-           
-                        
-        
-        </ul>
-            <p class="menuItem"><strong>Community</strong></p>
-        <ul>
-                    <li class="menuItem">    <a href="../../get-involved.html">Get Involved</a>
-</li>
-           
-                        
-                    <li class="menuItem">    <a href="../../contributors.html">Who we are</a>
-</li>
-           
-                        
-                    <li class="menuItem">    <a href="../../mailing.html">Mailing Lists</a>
-</li>
-           
-                        
-                    <li class="menuItem">    <a href="http://issues.apache.org/jira/browse/HARMONY">Bug Tracker</a>
-</li>
-           
-                        
-                    <li class="menuItem">    <a href="../../related.html">Other Projects</a>
-</li>
-           
-                        
-        
-        </ul>
-            <p class="menuItem"><strong>Development</strong></p>
-        <ul>
-                    <li class="menuItem">    <a href="../../svn.html">Source Code</a>
-</li>
-           
-                        
-                    <li class="menuItem">    <a href="../../quickhelp_contributors.html">Getting Started</a>
-</li>
-           
-                        
-                    <li class="menuItem">    <a href="../../roadmap.html">Project Roadmap</a>
-</li>
-           
-                        
-                    <li class="menuItem">    <a href="../../issue_resolution_guideline.html">Resolution Guideline</a>
-</li>
-           
-                        
-                    <li class="menuItem">    <a href="../../performance.html">Performance</a>
-</li>
-           
-                        
-        
-        </ul>
-            <p class="menuItem"><strong>Documentation</strong></p>
-        <ul>
-                    <li class="menuItem">    <a href="../../sitemap.html">Sitemap</a>
-</li>
-           
-                        
-                    <li class="menuItem">    <a href="http://wiki.apache.org/harmony">Wiki</a>
-</li>
-           
-                        
-                    <li class="menuItem">    <a href="../../hdk.html">HDK</a>
-</li>
-           
-                        
-                    <li class="menuItem">    <a href="../../subcomponents/drlvm/index.html">DRLVM</a>
-</li>
-           
-                        
-                    <li class="menuItem">    <a href="../../subcomponents/classlibrary/index.html">Class Library</a>
-</li>
-           
-                        
-                    <li class="menuItem">    <a href="../../subcomponents/buildtest/index.html">Build-test Framework</a>
-</li>
-           
-                        
-        
-        </ul>
-                        </td>
-                    <td width="80%" valign="top"><a name="top"></a>
-                                        
-                                                                <div>
-<!--
-    Licensed to the Apache Software Foundation (ASF) under one or more
-    contributor license agreements. See the NOTICE file distributed with
-    this work for additional information regarding copyright ownership.
-    The ASF licenses this file to You under the Apache License, Version 2.0
-    (the "License"); you may not use this file except in compliance with
-    the License. You may obtain a copy of the License at
-
-       http://www.apache.org/licenses/LICENSE-2.0
-
-    Unless required by applicable law or agreed to in writing, software
-    distributed under the License is distributed on an "AS IS" BASIS,
-    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-    See the License for the specific language governing permissions and
-    limitations under the License.
--->
-<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
-"http://www.w3.org/TR/html4/loose.dtd">
-<html>
-   <head>
-      <meta http-equiv="Content-Type" content=
-      "text/html; charset=ISO-8859-1">
-      <title>
-         DRL RMI Registry Service Provider for JNDI
-      </title>
-   </head>
-   <body>
-      
-<h1> <a name="top"></a>DRL RMI Registry Service Provider for JNDI </h1>
-      <p class="TOCHeading">
-         <a href="#Revision_History">Revision History</a>
-      </p>
-      <p class="TOCHeading">
-         <a href="#About_This_Document">About This Document</a>
-      </p>
-      <p class="TOC">
-         <a href="#Purpose">Purpose</a>
-      </p>
-      <p class="TOC">
-         <a href="#Intended_Audience">Intended Audience</a>
-      </p>
-      <p class="TOC">
-         <a href="#Documentation_Conventions">Documentation Conventions</a>
-      </p>
-      <p class="TOCHeading">
-         <a href="#overview">RMI Provider Overview</a>
-      </p>
-      <p class="TOCHeading">
-         <a href="#drl">RMI Provider in DRL</a>
-      </p>
-      <p class="TOC">
-         <a href="#about">About</a>
-      </p>
-      <p class="TOC">
-         <a href="#environment">Environment Properties</a>
-      </p>
-      <p class="TOC">
-         <a href="#urls">RMI URLs</a>
-      </p>
-      <p class="TOC">
-         <a href="#bindings">Binding Registry Contexts and Remote Objects</a>
-      </p>
-      <p class="TOCHeading">
-         <a href="#References">References</a>
-      </p>
-      <h1>
-         <a name="Revision_History"></a>Revision History
-      </h1>
-      <table border="0" cellpadding="0" width="100%">
-         <tr>
-            <th width="24%" class="TableHeading">
-               Version
-            </th>
-            <th width="49%" class="TableHeading">
-               Version Information
-            </th>
-            <th class="TableHeading">
-               Date
-            </th>
-         </tr>
-         <tr>
-            <td width="24%" class="TableCell">
-               Initial version
-            </td>
-            <td width="49%" class="TableCell">
-               Vasily Zakharov, Nadya Morozova: document created.
-            </td>
-            <td class="TableCell">
-               March 23, 2006
-            </td>
-         </tr>
-		<tr>
-            <td width="24%" class="TableCell">
-               Formatting update
-            </td>
-            <td width="49%" class="TableCell">
-              Nadya Morozova: document created.
-            </td>
-            <td class="TableCell">
-              September 21, 2006
-            </td>
-         </tr>
-         <tr>
-            <td width="24%" class="TableCell">
-               Linking update
-            </td>
-            <td width="49%" class="TableCell">
-              Sveta Konovalova: incorporating in website, removing disclaimer.
-            </td>
-            <td class="TableCell">
-              March 2007
-            </td>
-         </tr>
-      </table>
-     
-      <h1>
-         <a name="About_This_Document"></a>About This Document
-      </h1>
-      <h2>
-         <a name="Purpose"></a>Purpose
-      </h2>
-      
-<p> This document describes the functionality of the DRL RMI  [<a href="#RMIspec">2</a>] Registry Service 
-  Provider for JNDI [<a href="#Sunjndi">1</a>]. The document gives details on the provider design. </p>
-      <h2>
-         <a name="Intended_Audience"></a>Intended Audience
-      </h2>
-      
-<p> The target audience for the document includes a wide community of engineers 
-  interested in using the RMI registry in their JNDI applications and in further 
-  work with the product to contribute to its development. The document assumes 
-  that readers are familiar with RMI, JNDI and the Java programming language. 
-</p>
-      <h2>
-         <a name="Documentation_Conventions"></a>Documentation Conventions
-      </h2>
-      
-<p> This document uses the <a href="../../documentation/conventions.html">
-unified conventions</a> for the DRL documentation kit. </p>
-      <p class="backtotop">
-         <a href="#top">Back to Top</a>
-      </p>
-      <h1>
-         <a name="overview"></a>RMI Provider Overview
-      </h1>
-      
-<p> The RMI registry context, based on a registry location, and the RMI Registry 
-  Service Provider allow JNDI applications to access remote objects bound in the 
-  RMI registry, as described in the Java<a name="*">*</a> RMI Specification  [<a href="#RMIspec">2</a>]. </p>
-      <p>
-         The provider supplies JNDI with the same essential functionality as
-         the <code>java.rmi.Naming</code> class does.
-      </p>
-      <p class="backtotop">
-         <a href="#top">Back to Top</a>
-      </p>
-      
-<h1> <a name="drl"></a>RMI Provider in DRL</h1>
-      <h2>
-         <a name="about"></a>About
-      </h2>
-      
-<p> The DRL RMI Service Provider is an independent implementation of the RMI Service Provider for JNDI. 
-You can also consult additional information resources on RMI [<a href="#RMIspec">2</a>], RMI Service Provider [<a href="#RMIprovider">3</a>] and JNDI in general [<a href="#Sunjndi">1</a>]. </p>
-      
-<p>The provider can store <code>java.rmi.Remote</code>, <code>javax.naming.Reference</code> 
-  and <code>javax.naming.Referenceable</code> objects. The RMI registry context 
-  and references to individual RMI objects can be bound into other JNDI contexts. 
-  The DRL provider does not support binding other contexts into the RMI registry, 
-  so that you cannot address objects in this context using composite name requests 
-  through the registry. </p>
-      <p class="backtotop">
-         <a href="#top">Back to Top</a>
-      </p>
-      <h2>
-         <a name="environment"></a>Environment Properties
-      </h2>
-      
-<p> In addition to the general properties [<a href="#RMIprovider">3</a>], the DRL RMI Registry 
-  Provider uses the following JNDI environment properties: </p>
-      <dl>
-         <dt>
-            <a name="prop_initial"></a>
-            <code>java.naming.factory.initial</code>
-         </dt>
-         <dd>
-		 <p>
-            Specifies the RMI registry service provider class name as the
-            initial context factory to be used by the
-            <code>javax.naming.InitialContext</code> class. </p>
-            <p class="example">
-               Example
-            </p>
-    <pre class="exampletext">
-  env.put(Context.INITIAL_CONTEXT_FACTORY,
-        "org.apache.harmony.jndi.provider.rmi.registry.RegistryContextFactory");
-</pre> <p class="exampletext">
-            Use this property with the <code>java.naming.provider.url
-            </code>property, which specifies the location of the RMI registry
-            for the usage of the initial context. Otherwise, the initial
-            context you created can only resolve complete RMI URLs.
-			</p>
-         </dd>
-      </dl>
-      <dl>
-         
-  <dt> <a name="prop_socket"></a> <code>org.apache.harmony.jndi.provider.rmi.registry.clientSocketFactory</code> 
-  </dt>
-         
-  <dd> Can contain the name of a class implementing the<code> java.rmi.server.RMIClientSocketFactory</code> 
-    interface. The instance of this class is passed to the <code>java.rmi.registry.LocateRegistry.getRegistry()</code> 
-    method. </dd>
-      </dl>
-      <p class="backtotop">
-         <a href="#top">Back to Top</a>
-      </p>
-      <h2>
-         <a name="urls"></a>RMI URLs
-      </h2>
-      
-<p> The URL context factory, <code>org.apache.harmony.jndi.provider.rmi.rmiURLContextFactory</code>, 
-  enables passing RMI URLs as names to the JNDI initial context. </p>
-      <p class="backtotop">
-         <a href="#top">Back to Top</a>
-      </p>
-      <h2>
-         <a name="bindings"></a>Binding Registry Contexts and Remote Objects
-      </h2>
-      
-<p> The class <code>org.apache.harmony.jndi.provider.rmi.registry.</code><code>RegistryContextFactory</code> 
-  implements the <code>javax.naming.spi.</code><code>ObjectFactory </code> interface 
-  and provides converting registry references into the corresponding registry 
-  contexts or remote objects. </p>
-      <p class="backtotop">
-         <a href="#top">Back to Top</a>
-      </p>
-      <h1>
-         <a name="References"></a>References
-      </h1>
-      <p>
-         [<a name="Sunjndi">1</a>] Sun about JNDI, <a href= 
-         "http://java.sun.com/j2se/1.5.0/docs/guide/jndi/" target=
-         "_blank">http://java.sun.com/j2se/1.5.0/docs/guide/jndi/</a>
-      </p>
-      <p>
-         [<a name="RMIspec">2</a>] RMI Specification, <a href= 
-         "http://java.sun.com/j2se/1.5.0/docs/guide/rmi/spec/rmiTOC.html" target=
-         "_blank">http://java.sun.com/j2se/1.5.0/docs/guide/rmi/spec/rmiTOC.html</a>
-      </p>
-	  <p>
-         [<a name="RMIprovider">3</a>] Sun's RMI Provider, <a href= 
-         "http://java.sun.com/j2se/1.5.0/docs/guide/jndi/jndi-rmi.html" target=
-         "_blank">http://java.sun.com/j2se/1.5.0/docs/guide/jndi/jndi-rmi.html</a>
-      </p>
-      <p class="backtotop">
-         <a href="#top">Back to Top</a>
-      </p>
-      <p>
-         <a name="*">*</a> Other brands and names are the property of their
-         respective owners.
-      </p>
-   </body>
-</html>
-
-
-
-</div>
-                                        </td>
-                </tr>
-
-                <!-- FOOTER -->
-                <tr><td colspan="2">
-                    <hr noshade="" size="1"/>
-                </td></tr>
-                <tr><td colspan="2">
-                    <div class="special"><em>
-                    Copyright &#169; 2003-2007, The Apache Software Foundation
-                    </em></div>
-                </td></tr>
-            </table>
-        </body>
-    </html>
-<!-- end the processing -->
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+
+<!--
+Licensed to the Apache Software Foundation (ASF) under one or more
+contributor license agreements.  See the NOTICE file distributed with
+this work for additional information regarding copyright ownership.
+The ASF licenses this file to You under the Apache License, Version 2.0
+(the "License"); you may not use this file except in compliance with
+the License.  You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+-->
+
+
+<!-- start the processing -->
+    <!-- ====================================================================== -->
+    <!-- GENERATED FILE, DO NOT EDIT, EDIT THE XML FILE IN xdocs INSTEAD! -->
+    <!-- Main Page Section -->
+    <!-- ====================================================================== -->
+    <html>
+        <head>
+            <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>
+
+                                                    <meta name="author" value="Harmony Documentation Team">
+            <meta name="email" value="dev@harmony.apache.org">
+            
+           
+            
+            
+            
+            
+            
+            <title>Apache Harmony - RMI Provider</title>
+
+                        
+                        
+        <link rel="stylesheet" type="text/css" href="../../site.css"/>
+        </head>
+
+        <body>        
+            <table  width="100%" cellspacing="0">
+                <!-- TOP IMAGE -->
+                <tr>
+                    <td align='LEFT'>
+                    <table><tr><td>
+                    <td>
+<a href="http://harmony.apache.org/"><img  src="../../images/harmony-logo-new.png" alt="Apache Harmony" /></a>
+</td>
+</td>
+                    </td></tr></table>
+                    </td>
+                    <td align='RIGHT'>
+                    <a href="http://www.apachecon.com/2007/EU/index.html">
+                    <img src="http://www.apache.org/ads/ApacheCon/2007-europe-234x60.png"
+                    	alt="ApacheCon Europe 2007" /></a>                    
+                    </td>
+                </tr>
+            </table>
+            <table width="100%" cellspacing="4">
+                <tr><td colspan="2">
+                    <hr noshade="" size="1"/>
+                </td></tr>
+
+                <tr>
+                    <!-- LEFT SIDE NAVIGATION -->
+                    <td class="menuItem" width="20%" nowrap="true">
+
+                    <!-- special ACon Logo - leave here for next time
+                    <a href="http://www.us.apachecon.com/">
+                        <img src="http://www.apache.org/ads/ApacheCon/2007-europe-125x125.png"
+                             alt="ApacheCon Europe 2007" />
+                    </a> -->
+
+                   <!-- regular menu -->
+
+                    
+    <!-- ============================================================ -->
+
+                <p class="menuItem"><strong>General</strong></p>
+        <ul>
+                    <li class="menuItem">    <a href="../../index.html">Home</a>
+</li>
+           
+                        
+                    <li class="menuItem">    <a href="../../license.html">License</a>
+</li>
+           
+                        
+                    <li class="menuItem">    <a href="http://apache.org">ASF</a>
+</li>
+           
+                        
+                    <li class="menuItem">    <a href="../../contribution_policy.html">Contribution Policy</a>
+</li>
+           
+                        
+                    <li class="menuItem">    <a href="../../downloads.html">Downloads</a>
+</li>
+           
+                        
+                    <li class="menuItem">    <a href="../../faq.html">FAQ</a>
+</li>
+           
+                        
+        
+        </ul>
+            <p class="menuItem"><strong>Community</strong></p>
+        <ul>
+                    <li class="menuItem">    <a href="../../get-involved.html">Get Involved</a>
+</li>
+           
+                        
+                    <li class="menuItem">    <a href="../../contributors.html">Who we are</a>
+</li>
+           
+                        
+                    <li class="menuItem">    <a href="../../mailing.html">Mailing Lists</a>
+</li>
+           
+                        
+                    <li class="menuItem">    <a href="http://issues.apache.org/jira/browse/HARMONY">Bug Tracker</a>
+</li>
+           
+                        
+                    <li class="menuItem">    <a href="../../related.html">Other Projects</a>
+</li>
+           
+                        
+        
+        </ul>
+            <p class="menuItem"><strong>Development</strong></p>
+        <ul>
+                    <li class="menuItem">    <a href="../../svn.html">Source Code</a>
+</li>
+           
+                        
+                    <li class="menuItem">    <a href="../../quickhelp_contributors.html">Getting Started</a>
+</li>
+           
+                        
+                    <li class="menuItem">    <a href="../../roadmap.html">Project Roadmap</a>
+</li>
+           
+                        
+                    <li class="menuItem">    <a href="../../issue_resolution_guideline.html">Resolution Guideline</a>
+</li>
+           
+                        
+                    <li class="menuItem">    <a href="../../performance.html">Performance</a>
+</li>
+           
+                        
+        
+        </ul>
+            <p class="menuItem"><strong>Documentation</strong></p>
+        <ul>
+                    <li class="menuItem">    <a href="../../sitemap.html">Sitemap</a>
+</li>
+           
+                        
+                    <li class="menuItem">    <a href="http://wiki.apache.org/harmony">Wiki</a>
+</li>
+           
+                        
+                    <li class="menuItem">    <a href="../../hdk.html">HDK</a>
+</li>
+           
+                        
+                    <li class="menuItem">    <a href="../../subcomponents/drlvm/index.html">DRLVM</a>
+</li>
+           
+                        
+                    <li class="menuItem">    <a href="../../subcomponents/classlibrary/index.html">Class Library</a>
+</li>
+           
+                        
+                    <li class="menuItem">    <a href="../../subcomponents/buildtest/index.html">Build-test Framework</a>
+</li>
+           
+                        
+        
+        </ul>
+                        </td>
+                    <td width="80%" valign="top"><a name="top"></a>
+                                        
+                                                                <div>
+<!--
+    Licensed to the Apache Software Foundation (ASF) under one or more
+    contributor license agreements. See the NOTICE file distributed with
+    this work for additional information regarding copyright ownership.
+    The ASF licenses this file to You under the Apache License, Version 2.0
+    (the "License"); you may not use this file except in compliance with
+    the License. You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+-->
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
+"http://www.w3.org/TR/html4/loose.dtd">
+<html>
+   <head>
+      <meta http-equiv="Content-Type" content=
+      "text/html; charset=ISO-8859-1">
+      <title>
+         DRL RMI Registry Service Provider for JNDI
+      </title>
+   </head>
+   <body>
+      
+<h1> <a name="top"></a>DRL RMI Registry Service Provider for JNDI </h1>
+      <p class="TOCHeading">
+         <a href="#Revision_History">Revision History</a>
+      </p>
+      <p class="TOCHeading">
+         <a href="#About_This_Document">About This Document</a>
+      </p>
+      <p class="TOC">
+         <a href="#Purpose">Purpose</a>
+      </p>
+      <p class="TOC">
+         <a href="#Intended_Audience">Intended Audience</a>
+      </p>
+      <p class="TOC">
+         <a href="#Documentation_Conventions">Documentation Conventions</a>
+      </p>
+      <p class="TOCHeading">
+         <a href="#overview">RMI Provider Overview</a>
+      </p>
+      <p class="TOCHeading">
+         <a href="#drl">RMI Provider in DRL</a>
+      </p>
+      <p class="TOC">
+         <a href="#about">About</a>
+      </p>
+      <p class="TOC">
+         <a href="#environment">Environment Properties</a>
+      </p>
+      <p class="TOC">
+         <a href="#urls">RMI URLs</a>
+      </p>
+      <p class="TOC">
+         <a href="#bindings">Binding Registry Contexts and Remote Objects</a>
+      </p>
+      <p class="TOCHeading">
+         <a href="#References">References</a>
+      </p>
+      <h1>
+         <a name="Revision_History"></a>Revision History
+      </h1>
+      <table border="0" cellpadding="0" width="100%">
+         <tr>
+            <th width="24%" class="TableHeading">
+               Version
+            </th>
+            <th width="49%" class="TableHeading">
+               Version Information
+            </th>
+            <th class="TableHeading">
+               Date
+            </th>
+         </tr>
+         <tr>
+            <td width="24%" class="TableCell">
+               Initial version
+            </td>
+            <td width="49%" class="TableCell">
+               Vasily Zakharov, Nadya Morozova: document created.
+            </td>
+            <td class="TableCell">
+               March 23, 2006
+            </td>
+         </tr>
+		<tr>
+            <td width="24%" class="TableCell">
+               Formatting update
+            </td>
+            <td width="49%" class="TableCell">
+              Nadya Morozova: document created.
+            </td>
+            <td class="TableCell">
+              September 21, 2006
+            </td>
+         </tr>
+         <tr>
+            <td width="24%" class="TableCell">
+               Linking update
+            </td>
+            <td width="49%" class="TableCell">
+              Sveta Konovalova: incorporating in website, removing disclaimer.
+            </td>
+            <td class="TableCell">
+              March 2007
+            </td>
+         </tr>
+      </table>
+     
+      <h1>
+         <a name="About_This_Document"></a>About This Document
+      </h1>
+      <h2>
+         <a name="Purpose"></a>Purpose
+      </h2>
+      
+<p> This document describes the functionality of the DRL RMI  [<a href="#RMIspec">2</a>] Registry Service 
+  Provider for JNDI [<a href="#Sunjndi">1</a>]. The document gives details on the provider design. </p>
+      <h2>
+         <a name="Intended_Audience"></a>Intended Audience
+      </h2>
+      
+<p> The target audience for the document includes a wide community of engineers 
+  interested in using the RMI registry in their JNDI applications and in further 
+  work with the product to contribute to its development. The document assumes 
+  that readers are familiar with RMI, JNDI and the Java programming language. 
+</p>
+      <h2>
+         <a name="Documentation_Conventions"></a>Documentation Conventions
+      </h2>
+      
+<p> This document uses the <a href="../../documentation/conventions.html">
+unified conventions</a> for the DRL documentation kit. </p>
+      <p class="backtotop">
+         <a href="#top">Back to Top</a>
+      </p>
+      <h1>
+         <a name="overview"></a>RMI Provider Overview
+      </h1>
+      
+<p> The RMI registry context, based on a registry location, and the RMI Registry 
+  Service Provider allow JNDI applications to access remote objects bound in the 
+  RMI registry, as described in the Java<a name="*">*</a> RMI Specification  [<a href="#RMIspec">2</a>]. </p>
+      <p>
+         The provider supplies JNDI with the same essential functionality as
+         the <code>java.rmi.Naming</code> class does.
+      </p>
+      <p class="backtotop">
+         <a href="#top">Back to Top</a>
+      </p>
+      
+<h1> <a name="drl"></a>RMI Provider in DRL</h1>
+      <h2>
+         <a name="about"></a>About
+      </h2>
+      
+<p> The DRL RMI Service Provider is an independent implementation of the RMI Service Provider for JNDI. 
+You can also consult additional information resources on RMI [<a href="#RMIspec">2</a>], RMI Service Provider [<a href="#RMIprovider">3</a>] and JNDI in general [<a href="#Sunjndi">1</a>]. </p>
+      
+<p>The provider can store <code>java.rmi.Remote</code>, <code>javax.naming.Reference</code> 
+  and <code>javax.naming.Referenceable</code> objects. The RMI registry context 
+  and references to individual RMI objects can be bound into other JNDI contexts. 
+  The DRL provider does not support binding other contexts into the RMI registry, 
+  so that you cannot address objects in this context using composite name requests 
+  through the registry. </p>
+      <p class="backtotop">
+         <a href="#top">Back to Top</a>
+      </p>
+      <h2>
+         <a name="environment"></a>Environment Properties
+      </h2>
+      
+<p> In addition to the general properties [<a href="#RMIprovider">3</a>], the DRL RMI Registry 
+  Provider uses the following JNDI environment properties: </p>
+      <dl>
+         <dt>
+            <a name="prop_initial"></a>
+            <code>java.naming.factory.initial</code>
+         </dt>
+         <dd>
+		 <p>
+            Specifies the RMI registry service provider class name as the
+            initial context factory to be used by the
+            <code>javax.naming.InitialContext</code> class. </p>
+            <p class="example">
+               Example
+            </p>
+    <pre class="exampletext">
+  env.put(Context.INITIAL_CONTEXT_FACTORY,
+        "org.apache.harmony.jndi.provider.rmi.registry.RegistryContextFactory");
+</pre> <p class="exampletext">
+            Use this property with the <code>java.naming.provider.url
+            </code>property, which specifies the location of the RMI registry
+            for the usage of the initial context. Otherwise, the initial
+            context you created can only resolve complete RMI URLs.
+			</p>
+         </dd>
+      </dl>
+      <dl>
+         
+  <dt> <a name="prop_socket"></a> <code>org.apache.harmony.jndi.provider.rmi.registry.clientSocketFactory</code> 
+  </dt>
+         
+  <dd> Can contain the name of a class implementing the<code> java.rmi.server.RMIClientSocketFactory</code> 
+    interface. The instance of this class is passed to the <code>java.rmi.registry.LocateRegistry.getRegistry()</code> 
+    method. </dd>
+      </dl>
+      <p class="backtotop">
+         <a href="#top">Back to Top</a>
+      </p>
+      <h2>
+         <a name="urls"></a>RMI URLs
+      </h2>
+      
+<p> The URL context factory, <code>org.apache.harmony.jndi.provider.rmi.rmiURLContextFactory</code>, 
+  enables passing RMI URLs as names to the JNDI initial context. </p>
+      <p class="backtotop">
+         <a href="#top">Back to Top</a>
+      </p>
+      <h2>
+         <a name="bindings"></a>Binding Registry Contexts and Remote Objects
+      </h2>
+      
+<p> The class <code>org.apache.harmony.jndi.provider.rmi.registry.</code><code>RegistryContextFactory</code> 
+  implements the <code>javax.naming.spi.</code><code>ObjectFactory </code> interface 
+  and provides converting registry references into the corresponding registry 
+  contexts or remote objects. </p>
+      <p class="backtotop">
+         <a href="#top">Back to Top</a>
+      </p>
+      <h1>
+         <a name="References"></a>References
+      </h1>
+      <p>
+         [<a name="Sunjndi">1</a>] Sun about JNDI, <a href= 
+         "http://java.sun.com/j2se/1.5.0/docs/guide/jndi/" target=
+         "_blank">http://java.sun.com/j2se/1.5.0/docs/guide/jndi/</a>
+      </p>
+      <p>
+         [<a name="RMIspec">2</a>] RMI Specification, <a href= 
+         "http://java.sun.com/j2se/1.5.0/docs/guide/rmi/spec/rmiTOC.html" target=
+         "_blank">http://java.sun.com/j2se/1.5.0/docs/guide/rmi/spec/rmiTOC.html</a>
+      </p>
+	  <p>
+         [<a name="RMIprovider">3</a>] Sun's RMI Provider, <a href= 
+         "http://java.sun.com/j2se/1.5.0/docs/guide/jndi/jndi-rmi.html" target=
+         "_blank">http://java.sun.com/j2se/1.5.0/docs/guide/jndi/jndi-rmi.html</a>
+      </p>
+      <p class="backtotop">
+         <a href="#top">Back to Top</a>
+      </p>
+      <p>
+         <a name="*">*</a> Other brands and names are the property of their
+         respective owners.
+      </p>
+   </body>
+</html>
+
+
+
+</div>
+                                        </td>
+                </tr>
+
+                <!-- FOOTER -->
+                <tr><td colspan="2">
+                    <hr noshade="" size="1"/>
+                </td></tr>
+                <tr><td colspan="2">
+                    <div class="special"><em>
+                    Copyright &#169; 2003-2007, The Apache Software Foundation
+                    </em></div>
+                </td></tr>
+            </table>
+        </body>
+    </html>
+<!-- end the processing -->
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+

Modified: harmony/standard/site/docs/subcomponents/drlvm/DoxygenStart.html
URL: http://svn.apache.org/viewvc/harmony/standard/site/docs/subcomponents/drlvm/DoxygenStart.html?view=diff&rev=517663&r1=517662&r2=517663
==============================================================================
--- harmony/standard/site/docs/subcomponents/drlvm/DoxygenStart.html (original)
+++ harmony/standard/site/docs/subcomponents/drlvm/DoxygenStart.html Tue Mar 13 05:17:43 2007
@@ -1,311 +1,311 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
-
-<!--
-Licensed to the Apache Software Foundation (ASF) under one or more
-contributor license agreements.  See the NOTICE file distributed with
-this work for additional information regarding copyright ownership.
-The ASF licenses this file to You under the Apache License, Version 2.0
-(the "License"); you may not use this file except in compliance with
-the License.  You may obtain a copy of the License at
-
-http://www.apache.org/licenses/LICENSE-2.0
-
-Unless required by applicable law or agreed to in writing, software
-distributed under the License is distributed on an "AS IS" BASIS,
-WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-See the License for the specific language governing permissions and
-limitations under the License.
--->
-
-
-<!-- start the processing -->
-    <!-- ====================================================================== -->
-    <!-- GENERATED FILE, DO NOT EDIT, EDIT THE XML FILE IN xdocs INSTEAD! -->
-    <!-- Main Page Section -->
-    <!-- ====================================================================== -->
-    <html>
-        <head>
-            <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>
-
-                                                    <meta name="author" value="Harmony Documentation Team">
-            <meta name="email" value="dev@harmony.apache.org">
-            
-           
-            
-            
-            
-            
-            
-            <title>Apache Harmony - Apache Harmony DRL Virtual Machine Doc Index</title>
-
-                        
-                        
-        <link rel="stylesheet" type="text/css" href="../../site.css"/>
-        </head>
-
-        <body>        
-            <table  width="100%" cellspacing="0">
-                <!-- TOP IMAGE -->
-                <tr>
-                    <td align='LEFT'>
-                    <table><tr><td>
-                    <td>
-<a href="http://harmony.apache.org/"><img  src="../../images/harmony-logo-new.png" alt="Apache Harmony" /></a>
-</td>
-</td>
-                    </td></tr></table>
-                    </td>
-                    <td align='RIGHT'>
-                    <a href="http://www.apachecon.com/2007/EU/index.html">
-                    <img src="http://www.apache.org/ads/ApacheCon/2007-europe-234x60.png"
-                    	alt="ApacheCon Europe 2007" /></a>                    
-                    </td>
-                </tr>
-            </table>
-            <table width="100%" cellspacing="4">
-                <tr><td colspan="2">
-                    <hr noshade="" size="1"/>
-                </td></tr>
-
-                <tr>
-                    <!-- LEFT SIDE NAVIGATION -->
-                    <td class="menuItem" width="20%" nowrap="true">
-
-                    <!-- special ACon Logo - leave here for next time
-                    <a href="http://www.us.apachecon.com/">
-                        <img src="http://www.apache.org/ads/ApacheCon/2007-europe-125x125.png"
-                             alt="ApacheCon Europe 2007" />
-                    </a> -->
-
-                   <!-- regular menu -->
-
-                    
-    <!-- ============================================================ -->
-
-                <p class="menuItem"><strong>General</strong></p>
-        <ul>
-                    <li class="menuItem">    <a href="../../index.html">Home</a>
-</li>
-           
-                        
-                    <li class="menuItem">    <a href="../../license.html">License</a>
-</li>
-           
-                        
-                    <li class="menuItem">    <a href="http://apache.org">ASF</a>
-</li>
-           
-                        
-                    <li class="menuItem">    <a href="../../contribution_policy.html">Contribution Policy</a>
-</li>
-           
-                        
-                    <li class="menuItem">    <a href="../../downloads.html">Downloads</a>
-</li>
-           
-                        
-                    <li class="menuItem">    <a href="../../faq.html">FAQ</a>
-</li>
-           
-                        
-        
-        </ul>
-            <p class="menuItem"><strong>Community</strong></p>
-        <ul>
-                    <li class="menuItem">    <a href="../../get-involved.html">Get Involved</a>
-</li>
-           
-                        
-                    <li class="menuItem">    <a href="../../contributors.html">Who we are</a>
-</li>
-           
-                        
-                    <li class="menuItem">    <a href="../../mailing.html">Mailing Lists</a>
-</li>
-           
-                        
-                    <li class="menuItem">    <a href="http://issues.apache.org/jira/browse/HARMONY">Bug Tracker</a>
-</li>
-           
-                        
-                    <li class="menuItem">    <a href="../../related.html">Other Projects</a>
-</li>
-           
-                        
-        
-        </ul>
-            <p class="menuItem"><strong>Development</strong></p>
-        <ul>
-                    <li class="menuItem">    <a href="../../svn.html">Source Code</a>
-</li>
-           
-                        
-                    <li class="menuItem">    <a href="../../quickhelp_contributors.html">Getting Started</a>
-</li>
-           
-                        
-                    <li class="menuItem">    <a href="../../roadmap.html">Project Roadmap</a>
-</li>
-           
-                        
-                    <li class="menuItem">    <a href="../../issue_resolution_guideline.html">Resolution Guideline</a>
-</li>
-           
-                        
-                    <li class="menuItem">    <a href="../../performance.html">Performance</a>
-</li>
-           
-                        
-        
-        </ul>
-            <p class="menuItem"><strong>Documentation</strong></p>
-        <ul>
-                    <li class="menuItem">    <a href="../../sitemap.html">Sitemap</a>
-</li>
-           
-                        
-                    <li class="menuItem">    <a href="http://wiki.apache.org/harmony">Wiki</a>
-</li>
-           
-                        
-                    <li class="menuItem">    <a href="../../hdk.html">HDK</a>
-</li>
-           
-                        
-                    <li class="menuItem">    <a href="../../subcomponents/drlvm/index.html">DRLVM</a>
-</li>
-           
-                        
-                    <li class="menuItem">    <a href="../../subcomponents/classlibrary/index.html">Class Library</a>
-</li>
-           
-                        
-                    <li class="menuItem">    <a href="../../subcomponents/buildtest/index.html">Build-test Framework</a>
-</li>
-           
-                        
-        
-        </ul>
-                        </td>
-                    <td width="80%" valign="top"><a name="top"></a>
-                                                                    <h1>
-      <a name="DRLVM Source Code Generated Documentation Index">DRLVM Source Code Generated Documentation Index</a>
-    </h1>
-                        <p>This is a landing page for Doxygen source code reference generated automatically from interface headers.
-Each link should lead to a documentation bundle generated from a component-related set of header files. 
-The purpose of these documents is to provide a complete reference of available code in DRLVM interfaces. 
-Because the code base is being actively developed, not all interfaces are well-documented at this point, so that
-you can find some interfaces not documented. Everyone's welcome to contribute to this initiative.
-</p>
-                                <p>
-The documentation bundles were generated automatically and posted on the site server. You can regenerate the docs
-from your source files locally, as described in section <a href="#Regenerating the Reference">Regenerating the Reference</a>.
-</p>
-                                    
-    <h2>
-        <a name="Doxygen API Reference for DRLVM Sources">Doxygen API Reference for DRLVM Sources</a>
-    </h2>
-      
-                        <p>This is a list of links to generated  source code documentation bundles. 
-    </p>
-                                <ul>
-      <li><a href="doxygen/intf/html/index.html">DRLVM Interfaces</a> - the high-level interface headers</li>
-      <li><a href="doxygen/em/html/index.html">Execution Manager</a></li>
-      <li>Garbage Collectors:
-      <ul>
-          <li><a href="doxygen/gc_cc/html/index.html">Copying/Compacting Garbage Collector</a></li>
-          <li><a href="doxygen/gc_gen/html/index.html">Generational Garbage Collector</a></li>
-          <li><a href="doxygen/gcv4/html/index.html">Obsolete v.4 Garbage Collector</a></li>
-      </ul></li>
-      <li><a href="doxygen/interpreter/html/index.html">Interpreter</a></li>
-      <li><a href="doxygen/jitrino/html/index.html">Jitrino</a>- the just-in-time compiler </li>
-      <li><a href="doxygen/port/html/index.html">Porting Layer</a> - the extensions to APR</li>
-      <li><a href="doxygen/thread/html/index.html">Thread Manager</a></li>
-      <li><a href="doxygen/vmcore/html/index.html">VM Infrastructure</a> - the VM core component interfaces</li>
-      <li><a href="doxygen/vmi/html/index.html">Class Library Support</a> -  the VMI interface</li>
-      <li><a href="doxygen/vmstart/html/index.html">Component Manager</a></li>
-      <li><a href="doxygen/tests/html/index.html">DTLVM Tests</a></li>
-      <li><a href="doxygen/drlvm/html/index.html">All DRLVM</a> - the big bundle with all of the above</li>
-    </ul>
-                   
-                                    
-    <h2>
-        <a name="Other Useful DRLVM documents">Other Useful DRLVM documents</a>
-    </h2>
-      
-                        <ul>
-      <li><a href="index.html" target="_blank">DRLVM
-      website documentation page</a> with links to all DRLVM documents</li>
-      <li><a href="http://wiki.apache.org/harmony/DRLVM_Documentation_Quality">Status
-      metrics for Doxygen API reference</a>, Wiki page with metrics that show improvement metrics for the reference </li>
-    </ul>
-                   
-                <p><a href="#top">Back to top</a></p>
-                                                <h1>
-      <a name="Regenerating the Reference">Regenerating the Reference</a>
-    </h1>
-                        <p>
-Follow these instructions to regenerate reference materials analogous to those posted on the website. You can also adjust
-the list of files to include into a specific documentation bundle and configure Doxygen to produce a different output,
-see section <a href="#Advanced Tasks">Advanced Tasks</a>
-</p>
-                                <p>TBD</p>
-                                    
-    <h2>
-        <a name="Advanced Tasks">Advanced Tasks</a>
-    </h2>
-      
-                        <p>
-Generation of Doxygen reference is adjusted by the following files located in <code>trunk/vm/doc</code>:
-</p>
-                                <ul>
-<li><code>doc.properties</code> defines the input and output directories and the files included in each bundle
-</li>
-<li><code>build.xml</code> lists all doc build targets
-</li>
-<li><code>vm.cfg</code> is a copy of classlib configuration files and defines formatting and other output properties for Doxygen
-</li>
-
-</ul>
-                   
-                <p><a href="#top">Back to top</a></p>
-                    
-                                                            </td>
-                </tr>
-
-                <!-- FOOTER -->
-                <tr><td colspan="2">
-                    <hr noshade="" size="1"/>
-                </td></tr>
-                <tr><td colspan="2">
-                    <div class="special"><em>
-                    Copyright &#169; 2003-2007, The Apache Software Foundation
-                    </em></div>
-                </td></tr>
-            </table>
-        </body>
-    </html>
-<!-- end the processing -->
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+
+<!--
+Licensed to the Apache Software Foundation (ASF) under one or more
+contributor license agreements.  See the NOTICE file distributed with
+this work for additional information regarding copyright ownership.
+The ASF licenses this file to You under the Apache License, Version 2.0
+(the "License"); you may not use this file except in compliance with
+the License.  You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+-->
+
+
+<!-- start the processing -->
+    <!-- ====================================================================== -->
+    <!-- GENERATED FILE, DO NOT EDIT, EDIT THE XML FILE IN xdocs INSTEAD! -->
+    <!-- Main Page Section -->
+    <!-- ====================================================================== -->
+    <html>
+        <head>
+            <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>
+
+                                                    <meta name="author" value="Harmony Documentation Team">
+            <meta name="email" value="dev@harmony.apache.org">
+            
+           
+            
+            
+            
+            
+            
+            <title>Apache Harmony - Apache Harmony DRL Virtual Machine Doc Index</title>
+
+                        
+                        
+        <link rel="stylesheet" type="text/css" href="../../site.css"/>
+        </head>
+
+        <body>        
+            <table  width="100%" cellspacing="0">
+                <!-- TOP IMAGE -->
+                <tr>
+                    <td align='LEFT'>
+                    <table><tr><td>
+                    <td>
+<a href="http://harmony.apache.org/"><img  src="../../images/harmony-logo-new.png" alt="Apache Harmony" /></a>
+</td>
+</td>
+                    </td></tr></table>
+                    </td>
+                    <td align='RIGHT'>
+                    <a href="http://www.apachecon.com/2007/EU/index.html">
+                    <img src="http://www.apache.org/ads/ApacheCon/2007-europe-234x60.png"
+                    	alt="ApacheCon Europe 2007" /></a>                    
+                    </td>
+                </tr>
+            </table>
+            <table width="100%" cellspacing="4">
+                <tr><td colspan="2">
+                    <hr noshade="" size="1"/>
+                </td></tr>
+
+                <tr>
+                    <!-- LEFT SIDE NAVIGATION -->
+                    <td class="menuItem" width="20%" nowrap="true">
+
+                    <!-- special ACon Logo - leave here for next time
+                    <a href="http://www.us.apachecon.com/">
+                        <img src="http://www.apache.org/ads/ApacheCon/2007-europe-125x125.png"
+                             alt="ApacheCon Europe 2007" />
+                    </a> -->
+
+                   <!-- regular menu -->
+
+                    
+    <!-- ============================================================ -->
+
+                <p class="menuItem"><strong>General</strong></p>
+        <ul>
+                    <li class="menuItem">    <a href="../../index.html">Home</a>
+</li>
+           
+                        
+                    <li class="menuItem">    <a href="../../license.html">License</a>
+</li>
+           
+                        
+                    <li class="menuItem">    <a href="http://apache.org">ASF</a>
+</li>
+           
+                        
+                    <li class="menuItem">    <a href="../../contribution_policy.html">Contribution Policy</a>
+</li>
+           
+                        
+                    <li class="menuItem">    <a href="../../downloads.html">Downloads</a>
+</li>
+           
+                        
+                    <li class="menuItem">    <a href="../../faq.html">FAQ</a>
+</li>
+           
+                        
+        
+        </ul>
+            <p class="menuItem"><strong>Community</strong></p>
+        <ul>
+                    <li class="menuItem">    <a href="../../get-involved.html">Get Involved</a>
+</li>
+           
+                        
+                    <li class="menuItem">    <a href="../../contributors.html">Who we are</a>
+</li>
+           
+                        
+                    <li class="menuItem">    <a href="../../mailing.html">Mailing Lists</a>
+</li>
+           
+                        
+                    <li class="menuItem">    <a href="http://issues.apache.org/jira/browse/HARMONY">Bug Tracker</a>
+</li>
+           
+                        
+                    <li class="menuItem">    <a href="../../related.html">Other Projects</a>
+</li>
+           
+                        
+        
+        </ul>
+            <p class="menuItem"><strong>Development</strong></p>
+        <ul>
+                    <li class="menuItem">    <a href="../../svn.html">Source Code</a>
+</li>
+           
+                        
+                    <li class="menuItem">    <a href="../../quickhelp_contributors.html">Getting Started</a>
+</li>
+           
+                        
+                    <li class="menuItem">    <a href="../../roadmap.html">Project Roadmap</a>
+</li>
+           
+                        
+                    <li class="menuItem">    <a href="../../issue_resolution_guideline.html">Resolution Guideline</a>
+</li>
+           
+                        
+                    <li class="menuItem">    <a href="../../performance.html">Performance</a>
+</li>
+           
+                        
+        
+        </ul>
+            <p class="menuItem"><strong>Documentation</strong></p>
+        <ul>
+                    <li class="menuItem">    <a href="../../sitemap.html">Sitemap</a>
+</li>
+           
+                        
+                    <li class="menuItem">    <a href="http://wiki.apache.org/harmony">Wiki</a>
+</li>
+           
+                        
+                    <li class="menuItem">    <a href="../../hdk.html">HDK</a>
+</li>
+           
+                        
+                    <li class="menuItem">    <a href="../../subcomponents/drlvm/index.html">DRLVM</a>
+</li>
+           
+                        
+                    <li class="menuItem">    <a href="../../subcomponents/classlibrary/index.html">Class Library</a>
+</li>
+           
+                        
+                    <li class="menuItem">    <a href="../../subcomponents/buildtest/index.html">Build-test Framework</a>
+</li>
+           
+                        
+        
+        </ul>
+                        </td>
+                    <td width="80%" valign="top"><a name="top"></a>
+                                                                    <h1>
+      <a name="DRLVM Source Code Generated Documentation Index">DRLVM Source Code Generated Documentation Index</a>
+    </h1>
+                        <p>This is a landing page for Doxygen source code reference generated automatically from interface headers.
+Each link should lead to a documentation bundle generated from a component-related set of header files. 
+The purpose of these documents is to provide a complete reference of available code in DRLVM interfaces. 
+Because the code base is being actively developed, not all interfaces are well-documented at this point, so that
+you can find some interfaces not documented. Everyone's welcome to contribute to this initiative.
+</p>
+                                <p>
+The documentation bundles were generated automatically and posted on the site server. You can regenerate the docs
+from your source files locally, as described in section <a href="#Regenerating the Reference">Regenerating the Reference</a>.
+</p>
+                                    
+    <h2>
+        <a name="Doxygen API Reference for DRLVM Sources">Doxygen API Reference for DRLVM Sources</a>
+    </h2>
+      
+                        <p>This is a list of links to generated  source code documentation bundles. 
+    </p>
+                                <ul>
+      <li><a href="doxygen/intf/html/index.html">DRLVM Interfaces</a> - the high-level interface headers</li>
+      <li><a href="doxygen/em/html/index.html">Execution Manager</a></li>
+      <li>Garbage Collectors:
+      <ul>
+          <li><a href="doxygen/gc_cc/html/index.html">Copying/Compacting Garbage Collector</a></li>
+          <li><a href="doxygen/gc_gen/html/index.html">Generational Garbage Collector</a></li>
+          <li><a href="doxygen/gcv4/html/index.html">Obsolete v.4 Garbage Collector</a></li>
+      </ul></li>
+      <li><a href="doxygen/interpreter/html/index.html">Interpreter</a></li>
+      <li><a href="doxygen/jitrino/html/index.html">Jitrino</a>- the just-in-time compiler </li>
+      <li><a href="doxygen/port/html/index.html">Porting Layer</a> - the extensions to APR</li>
+      <li><a href="doxygen/thread/html/index.html">Thread Manager</a></li>
+      <li><a href="doxygen/vmcore/html/index.html">VM Infrastructure</a> - the VM core component interfaces</li>
+      <li><a href="doxygen/vmi/html/index.html">Class Library Support</a> -  the VMI interface</li>
+      <li><a href="doxygen/vmstart/html/index.html">Component Manager</a></li>
+      <li><a href="doxygen/tests/html/index.html">DTLVM Tests</a></li>
+      <li><a href="doxygen/drlvm/html/index.html">All DRLVM</a> - the big bundle with all of the above</li>
+    </ul>
+                   
+                                    
+    <h2>
+        <a name="Other Useful DRLVM documents">Other Useful DRLVM documents</a>
+    </h2>
+      
+                        <ul>
+      <li><a href="index.html" target="_blank">DRLVM
+      website documentation page</a> with links to all DRLVM documents</li>
+      <li><a href="http://wiki.apache.org/harmony/DRLVM_Documentation_Quality">Status
+      metrics for Doxygen API reference</a>, Wiki page with metrics that show improvement metrics for the reference </li>
+    </ul>
+                   
+                <p><a href="#top">Back to top</a></p>
+                                                <h1>
+      <a name="Regenerating the Reference">Regenerating the Reference</a>
+    </h1>
+                        <p>
+Follow these instructions to regenerate reference materials analogous to those posted on the website. You can also adjust
+the list of files to include into a specific documentation bundle and configure Doxygen to produce a different output,
+see section <a href="#Advanced Tasks">Advanced Tasks</a>
+</p>
+                                <p>TBD</p>
+                                    
+    <h2>
+        <a name="Advanced Tasks">Advanced Tasks</a>
+    </h2>
+      
+                        <p>
+Generation of Doxygen reference is adjusted by the following files located in <code>trunk/vm/doc</code>:
+</p>
+                                <ul>
+<li><code>doc.properties</code> defines the input and output directories and the files included in each bundle
+</li>
+<li><code>build.xml</code> lists all doc build targets
+</li>
+<li><code>vm.cfg</code> is a copy of classlib configuration files and defines formatting and other output properties for Doxygen
+</li>
+
+</ul>
+                   
+                <p><a href="#top">Back to top</a></p>
+                    
+                                                            </td>
+                </tr>
+
+                <!-- FOOTER -->
+                <tr><td colspan="2">
+                    <hr noshade="" size="1"/>
+                </td></tr>
+                <tr><td colspan="2">
+                    <div class="special"><em>
+                    Copyright &#169; 2003-2007, The Apache Software Foundation
+                    </em></div>
+                </td></tr>
+            </table>
+        </body>
+    </html>
+<!-- end the processing -->
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+



Mime
View raw message