You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@harmony.apache.org by na...@apache.org on 2007/01/18 18:26:34 UTC

svn commit: r497506 [5/5] - in /harmony/standard/site: docs/ docs/documentation/ docs/subcomponents/buildtest/ docs/subcomponents/classlibrary/ docs/subcomponents/drlvm/ docs/subcomponents/jchevm/ docs/subcomponents/stresstest/ xdocs/ xdocs/stylesheets...

Modified: harmony/standard/site/docs/svn.html
URL: http://svn.apache.org/viewvc/harmony/standard/site/docs/svn.html?view=diff&rev=497506&r1=497505&r2=497506
==============================================================================
--- harmony/standard/site/docs/svn.html (original)
+++ harmony/standard/site/docs/svn.html Thu Jan 18 09:26:27 2007
@@ -86,124 +86,102 @@
         <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="./contribution_policy.html">Contribution Policy</a>
+                    <li class="menuItem">    <a href="http://apache.org">ASF</a>
 </li>
-            
            
                         
-                    <li class="menuItem">    <a href="./guidelines.html">Project Guidelines</a>
+                    <li class="menuItem">    <a href="./contribution_policy.html">Contribution Policy</a>
 </li>
-            
            
                         
-                    <li class="menuItem">    <a href="http://www.apache.org/">ASF</a>
+                    <li class="menuItem">    <a href="./downloads.html">Downloads</a>
 </li>
-            
            
                         
-                    <li class="menuItem">    <a href="./downloads.html">Downloads</a>
+                    <li class="menuItem">    <a href="./faq.html">FAQ</a>
 </li>
-            
            
                         
-                </ul>
+        
+        </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">Committers</a>
+                    <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="./documentation/documentation.html">Documentation</a>
+                    <li class="menuItem">    <a href="http://issues.apache.org/jira/browse/HARMONY">Bug Tracker</a>
 </li>
-            
            
                         
-                    <li class="menuItem">    <a href="./faq.html">FAQ</a>
-</li>
-            
-           
-                        
-                    <li class="menuItem">    <a href="http://wiki.apache.org/harmony">Wiki</a>
+                    <li class="menuItem">    <a href="./related.html">Other Projects</a>
 </li>
-            
            
                         
-                </ul>
+        
+        </ul>
             <p class="menuItem"><strong>Development</strong></p>
         <ul>
-                    <li class="menuItem">    <a href="./status.html">How Are We Doing?</a>
+                    <li class="menuItem">    <a href="./svn.html">Source Code</a>
 </li>
-            
            
                         
-                    <li class="menuItem">    <a href="./roadmap.html">Road Map / TODO</a>
+                    <li class="menuItem">    <a href="./quickhelp_contributors.html">Getting Started</a>
 </li>
-            
            
                         
-                    <li class="menuItem">    <a href="./svn.html">Source Code</a>
+                    <li class="menuItem">    <a href="./roadmap.html">Project Roadmap</a>
 </li>
-            
            
                         
-                    <li class="menuItem">    <a href="http://issues.apache.org/jira/browse/HARMONY">JIRA</a>
+                    <li class="menuItem">    <a href="./issue_resolution_guideline.html">Resolution Guideline</a>
 </li>
-            
            
                         
-                    <li class="menuItem">    <a href="./related.html">Other Projects</a>
+        
+        </ul>
+            <p class="menuItem"><strong>Documentation</strong></p>
+        <ul>
+                    <li class="menuItem">    <a href="./sitemap.html">Sitemap</a>
 </li>
-            
            
                         
-                </ul>
-            <p class="menuItem"><strong>Subcomponents</strong></p>
-        <ul>
-                    <li class="menuItem">    <a href="./subcomponents/buildtest/index.html">Build-Test Framework</a>
+                    <li class="menuItem">    <a href="http://wiki.apache.org/harmony">Wiki</a>
 </li>
-            
            
                         
-                    <li class="menuItem">    <a href="./subcomponents/classlibrary/index.html">Class Library</a>
+                    <li class="menuItem">    <a href="./hdk.html">HDK</a>
 </li>
-            
            
-                           <table>
-              <tr><td class="menuItem">
-                &nbsp;&nbsp;&nbsp;&nbsp;    <a href="./subcomponents/classlibrary/status.html">Status</a>
-                </td></tr>
-              </table>
                         
                     <li class="menuItem">    <a href="./subcomponents/drlvm/index.html">DRLVM</a>
 </li>
-            
            
                         
-                    <li class="menuItem">    <a href="./subcomponents/jchevm/index.html">JCHEVM</a>
+                    <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>
+        
+        </ul>
                         </td>
                     <td width="80%" valign="top"><a name="top"></a>
                                                                     <h1>

Added: harmony/standard/site/xdocs/hdk.xml
URL: http://svn.apache.org/viewvc/harmony/standard/site/xdocs/hdk.xml?view=auto&rev=497506
==============================================================================
--- harmony/standard/site/xdocs/hdk.xml (added)
+++ harmony/standard/site/xdocs/hdk.xml Thu Jan 18 09:26:27 2007
@@ -0,0 +1,137 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<!--
+
+    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.
+-->
+
+<document>
+
+ <properties>
+  <title>Harmony Development Kit for the Apache Harmony Class Library</title>
+  <author email="dev@harmony.apache.org">Harmony Documentation Team</author>
+ </properties>
+
+<body>
+
+<section name="Harmony Development Kit for the Apache Harmony Class Library">
+	<p>
+		The Harmony Development Kit (HDK) allows a Harmony developer to 
+		rebuild	any module of the Harmony Classlib in a standalone way by providing all the 
+		necesary supplementary binaries and header files. This document describes the layout 
+		of such an HDK and its contents.
+	</p>
+
+<subsection name="Layout of the HDK">
+	<p>
+		An HDK contains all the header files and binaries, both native and Java, required
+		for a Harmony classlib developer to build against. The directory structure for an
+		HDK is as follows:
+		<blockquote>
+		<pre>
+&lt;hdkbase&gt;
+     |
+     |---build
+     |     |---make
+     |     |---patternsets
+     |     \---test
+     |
+     |---jdk
+     |    |---jre
+     |    \---include
+     |
+     |---include
+     |
+     \---lib
+     
+		</pre>
+		</blockquote>
+		
+		The directories laid out above are used in the following manner:
+		
+		<ul>
+			<li><code>&lt;hdkbase&gt;/build/make</code> - this directory contains include
+			files used by native makefiles.
+			</li>
+			
+			<li><code>&lt;hdkbase&gt;/build/patternsets</code> - this directory contains
+			patternsets describing jar content.
+			</li>
+			
+			<li><code>&lt;hdkbase&gt;/build/test</code> - this directory contains test
+			support classes, bundled up into a jar file.
+			</li>
+			
+			<li><code>&lt;hdkbase&gt;/jdk/jre</code> - this directory contains the standard
+			jre layout, including <code>bin</code> and <code>lib</code> directories.
+			</li>
+			
+			<li><code>&lt;hdkbase&gt;/jdk/include</code> - this directory contains the standard
+			jdk header files. For example, jni.h is held here.
+			</li>
+			
+			<li><code>&lt;hdkbase&gt;/include</code> - this directory contains header files that
+			are Harmony specific and are used across multiple classlib modules.
+			</li>
+			
+			<li><code>&lt;hdkbase&gt;/lib</code> - this directory is used in HDKs on Windows for
+			.lib files and on Linux for .a files necessary for linking during compilation of 
+			classlib natives.
+			</li>
+		</ul>
+	</p>		
+</subsection>
+<subsection name="Building Classlib Against an HDK">
+	<p>
+		<i>Note: The HDK and relevant build system changes are work in progress. 
+		Not all of the Ant targets/properties described	exist yet, and thus not 
+		all of what is described below currently works. This disclaimer will be 
+		removed once work on the HDK is completed.</i><br/>
+		<br/>
+		The Harmony Class Library can be built at the global or modular level.
+		At the modular level, there are three ways to build:
+		<ul>
+			<li><b>Building the default target</b> - An HDK is not required here, and the class
+			library is built against and into the default (deploy) directory. This is the
+			standard way to build, and is what happens when you just run "ant" at the
+			command line.</li>
+			<li><b>Building against an HDK</b> - The location of an HDK must be specified at
+			the Ant command line, and the ouptut will be built into the default (deploy)
+			directory. The command line for this is "ant -DHY.HDK=path/to/HDK".</li>
+			<li><b>Building against an HDK and into a target directory</b> - The location of
+			an HDK and of a target directory must be specified on the Ant command line.
+			The Class Library code will be compiled against the libraries contained in
+			the HDK, and the output of those compiles will be placed into the specified
+			target directory. The command line for this is "ant -DHY.HDK=path/to/HDK
+			-DHY.TARGET=path/to/target".</li>
+		</ul>
+		
+		So, for example, if you wanted to build only the luni module against
+		an HDK, and put the resulting artifacts into a separate target directory,
+		you would do the following:
+		<ol>
+			<li>Checkout the luni module</li>
+			<li>cd into the root directory of the module</li>
+			<li>Execute "ant -DHY.HDK=path/to/hdk -DHY.TARGET=path/to/target"</li>
+		</ol>
+		The luni Java and native code will be built against the HDK location
+		specified, and all produced binaries placed under the target directory, laid
+		out in the HDK structure described at the top of this page.
+	</p>
+</subsection>
+</section>
+</body>
+</document>
\ No newline at end of file

Added: harmony/standard/site/xdocs/sitemap.xml
URL: http://svn.apache.org/viewvc/harmony/standard/site/xdocs/sitemap.xml?view=auto&rev=497506
==============================================================================
--- harmony/standard/site/xdocs/sitemap.xml (added)
+++ harmony/standard/site/xdocs/sitemap.xml Thu Jan 18 09:26:27 2007
@@ -0,0 +1,37 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+
+<!--
+
+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.
+-->
+
+<document>
+
+<properties>
+<title>Apache Harmony Site Map</title>
+<author email="dev@harmony.apache.org">Harmony Documentation Team</author>
+</properties>
+
+<body>
+  <section name="Site Map">
+    <p>The Apache Harmony site map helps the visitors to understand the site structure 
+    and layout and thus, quickly gain access to what the site has to offer. This map 
+    reflects links to all relevant Apache Harmony website pages. 
+    </p>
+    <p>The site map is currently under construction.</p>
+     </section>
+</body>
+</document>

Modified: harmony/standard/site/xdocs/stylesheets/project.xml
URL: http://svn.apache.org/viewvc/harmony/standard/site/xdocs/stylesheets/project.xml?view=diff&rev=497506&r1=497505&r2=497506
==============================================================================
--- harmony/standard/site/xdocs/stylesheets/project.xml (original)
+++ harmony/standard/site/xdocs/stylesheets/project.xml Thu Jan 18 09:26:27 2007
@@ -10,36 +10,34 @@
     <menu name="General">
         <item name="Home"                   href="/index.html"/>
         <item name="License"                href="/license.html"/>
+        <item name="ASF"                    href="http://apache.org"/>
         <item name="Contribution Policy"    href="/contribution_policy.html"/>
-        <item name="Project Guidelines"     href="/guidelines.html"/>
-        <item name="ASF"                    href="http://www.apache.org/"/>
         <item name="Downloads"              href="/downloads.html"/>
-    </menu>
+        <item name="FAQ"                    href="/faq.html"/>
+        </menu>
 
     <menu name="Community">
         <item name="Get Involved"           href="/get-involved.html"/>
-        <item name="Committers"           href="/contributors.html"/>
+        <item name="Who we are"             href="/contributors.html"/>
         <item name="Mailing Lists"          href="/mailing.html"/>
-        <item name="Documentation"          href="/documentation/documentation.html"/>
-        <item name="FAQ"                    href="/faq.html"/>
-        <item name="Wiki"                   href="http://wiki.apache.org/harmony"/>
+        <item name="Bug Tracker"            href="http://issues.apache.org/jira/browse/HARMONY"/>
+        <item name="Other Projects"         href="/related.html"/>
     </menu>
 
     <menu name="Development">
-        <item name="How Are We Doing?"		href="/status.html" />
-        <item name="Road Map / TODO"        href="/roadmap.html"/>
         <item name="Source Code"            href="/svn.html"/>
-        <item name="JIRA"                   href="http://issues.apache.org/jira/browse/HARMONY"/>
-        <item name="Other Projects"       href="/related.html"/>
+        <item name="Getting Started"        href="/quickhelp_contributors.html"/>
+        <item name="Project Roadmap"        href="/roadmap.html"/>
+        <item name="Resolution Guideline"   href="/issue_resolution_guideline.html"/>
     </menu>
 
-    <menu name="Subcomponents">
-        <item name="Build-Test Framework"   href="/subcomponents/buildtest/index.html" />
-        <item name="Class Library"          href="/subcomponents/classlibrary/index.html" >
-          <subitem name="Status"            href="/subcomponents/classlibrary/status.html" />
-        </item>
-        <item name="DRLVM" href="/subcomponents/drlvm/index.html" />
-        <item name="JCHEVM" href="/subcomponents/jchevm/index.html" />
+    <menu name="Documentation">
+        <item name="Sitemap"                href="/sitemap.html"/>
+        <item name="Wiki"                   href="http://wiki.apache.org/harmony"/>
+        <item name="HDK"                    href="/hdk.html"/>
+        <item name="DRLVM"                  href="/subcomponents/drlvm/index.html"/>
+        <item name="Class Library"          href="/subcomponents/classlibrary/index.html"/>
+        <item name="Build-test Framework"   href="/subcomponents/buildtest/index.html"/>
     </menu>
     
     </body>

Modified: harmony/standard/site/xdocs/subcomponents/classlibrary/RMIprovider.html
URL: http://svn.apache.org/viewvc/harmony/standard/site/xdocs/subcomponents/classlibrary/RMIprovider.html?view=diff&rev=497506&r1=497505&r2=497506
==============================================================================
--- harmony/standard/site/xdocs/subcomponents/classlibrary/RMIprovider.html (original)
+++ harmony/standard/site/xdocs/subcomponents/classlibrary/RMIprovider.html Thu Jan 18 09:26:27 2007
@@ -3,7 +3,7 @@
 <html>
    <head>
       <meta http-equiv="Content-Type" content=
-      "text/html; charset=windows-1252">
+      "text/html; charset=ISO-8859-1">
       <title>
          DRL RMI Registry Service Provider for JNDI
       </title>