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/03/07 14:29:13 UTC
svn commit: r515560 [2/3] - in /harmony/standard/site:
docs/subcomponents/classlibrary/ docs/subcomponents/drlvm/ xdocs/
xdocs/documentation/ xdocs/subcomponents/classlibrary/
xdocs/subcomponents/drlvm/
Modified: harmony/standard/site/xdocs/sitemap.xml
URL: http://svn.apache.org/viewvc/harmony/standard/site/xdocs/sitemap.xml?view=diff&rev=515560&r1=515559&r2=515560
==============================================================================
--- harmony/standard/site/xdocs/sitemap.xml (original)
+++ harmony/standard/site/xdocs/sitemap.xml Wed Mar 7 05:29:12 2007
@@ -1,444 +1,444 @@
-<?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>
- </section>
-
- <section name="General Issues">
- <p>
- <a href="http://harmony.apache.org/">Home</a> - general
- information about the project, its status, Harmony news and external news stories
- about the Harmony project
- </p>
-
- <p>
- <a href="license.html">Apache License</a> - terms and
- conditions for use, reproduction, and distribution
- </p>
-
- <p>
- <a href=" http://apache.org/">Apache Software Foundation</a> - home page of
- the Apache Software Foundation providing general information about the project,
- its status, news, etc.
- </p>
- <p>
- <a href="contribution_policy.html">Contribution Policy</a> -
- information on division of the repository, limitations on committer
- contributions and policies for committers and contributors
- </p>
- <ul>
- <li>
- <a href="auth_cont_quest.html">
- Authorized Contributor Questionnaire
- </a> - an authorized contributor
- questionnaire
- </li>
-
- <li>
- <a href="bulk_contribution_checklist.html">
- Bulk Contribution Checklist
- </a> - a bulk contribution checklist
- </li>
- </ul>
- <br />
- <p>
- <a href="guidelines.html">Project Guidelines </a> - definition of
- the Apache Harmony Project guidelines and definitions of how conflict
- is resolved by voting, who is able to vote, and the procedures to follow for
- proposing and making changes to the Apache products
- </p>
-
-
- <p>
- <a href="newshistory.html">Harmony News Archive</a> - description of
- the project develment
- </p>
-
- <subsection name="For Users">
- <p>
- <a href="quickhelp_users.html">
- Getting
- Started for Users
- </a> - the getting started guide for those that
- wish to use <a href="downloads.html"> pre-built snapshots</a> of
- Apache Harmony
- </p>
- <p>
- <a href="downloads.html">Project Downloads</a> -
- you can find all project downloads here, such as snapshot builds and
- Subversion
- </p>
- <p>
- <a href="faq.html">FAQ</a> - frequently asked questions
- </p>
- </subsection>
-
- </section>
-
- <section name="Community">
- <p>
- <a href="get-involved.html">Get Involved</a> -
- general information on how to contribute, give feedback, fix
- bugs and so on
- </p>
-
- <p>
- <a href="contributors.html">Who We Are - Apache Harmony Committers</a> -
- description of the Harmony community and its structure
- </p>
- <p>
- <a href="subcomponents/classlibrary/agreements.html">
- Harmony Developer Agreements and Recommendations
- </a> - the summary of agreements
- and recommendations that were discussed on the development mailing list
- <i>dev@harmony.apache.org</i>
- </p>
- <p>
- <a href="mailing.html">Mailing Lists</a> - the Apache
- Harmony mailing lists where you can share all your ideas, ask
- questions and discuss plans
- </p>
- <p>
- <a href="http://issues.apache.org/jira/browse/HARMONY">Bug Tracker</a> - the
- project to post bugs and other issues on
- </p>
- <p>
- <a href="code_scan_tools.html">
- Code Scanning Tools
- </a> - tools to examine code in a more efficient way
- </p>
-
- <p>
- <a href="related.html">Related Projects</a> - the list of other projects
- related to open source Java
- </p>
- </section>
-
- <section name="Development">
-
- <p>
- <a href="quickhelp_contributors.html">
- Getting Started for Contributors
- </a> - the getting started guide for
- those that wish to checkout and build the source of Apache Harmony
- </p>
- <p>
- <a href="http://harmony.apache.org/svn.html">Apache Harmony Source Code</a> -
- description of the, the repository and access to it</p>
-
- <p>
- <a href="roadmap.html">Roadmap and TODO</a> -
- an approximate roadmap for what the project hopes to achieve in the next
- year and a collection of things that the project community has listed
- as needing to be done
- </p>
- <p>
- <a href="issue_resolution_guideline.html">
- When an Issue Occurs
- </a> - description of action item types, such as
- long term plans, short term plans, a release plan, a release testing,
- showstoppers, product changes; general rules for commiters, information
- on reporting, resolving and closing issues
-
- </p>
- <p>
- <a href="documentation/build_website.html">
- Building and Deploying the Apache Harmony Website
- </a> - tools required
- for the Harmony website build, building and deploying instructions
- </p>
-
- <p>
- <a href="status.html">What Can We Do Now?</a> -
- reflects the position of the project
- </p>
- <p>
- <a href="documentation/dev_eclipse.html">
- Getting Started with Eclipse
- </a> - instructions on how to set up
- Eclipse to develop Java code in Apache Harmony, with sections for
- both DRLVM and class library development
- </p>
- <p>
- <a href="documentation/dev_eclipse_movie.html">
- Eclipse Movie
- </a> - a brief webcast for those who want to see a step-by-step
- guide to configuring Eclipse, and developing a patch to the classlibrary code
- </p>
- <p>
- <a href="performance.html">
- Performance Data
- </a> - results obtained on different benchmarks and various hardware and
- software system configurations
- </p>
-
- </section>
- <section name="Documentation">
- <p>
- <a href="http://wiki.apache.org/harmony/">Harmony Wiki</a> -
- the project for additional documentation and discussions
- </p>
- <p>
- <a href="subcomponents/classlibrary/hdk.html">
- Harmony Development Kit</a> - description of the HDK layout and its contents
- </p>
-
- <subsection name="DRLVM">
- <p>
- <a href="subcomponents/drlvm/index.html">
- DRLVM Navigator
- </a> - documentation links specific to DRLVM effort
- underway at Apache Harmony
- </p>
- <p>
- <strong>
- Developing and Building the Code Documentation
- </strong>
- </p>
- <p>
- <a href="subcomponents/drlvm/debugging_VM_and_JIT.html">
- Debugging the DRL Virtual Machine and the JIT Compiler
- </a> - practical instructions on how to debug the DRL virtual machine and its
- baseline just-in-time compiler Jitrino.JET
- </p>
- <p>
- <a href="subcomponents/drlvm/getting_started.html">
- Getting Started with DRLVM
- </a> - basic usage scenarios of VM: starting an
- application, working in Eclipse
- </p>
- <p>
- <a href="https://svn.apache.org/viewcvs.cgi/*checkout*/harmony/enhanced/drlvm/trunk/README.txt">
- README
- </a> - source package and building instructions for
- the VM source code
- </p>
- <p>
- <strong>Architecture and Component Documentation</strong>
- </p>
-
- <p>
- <a href="subcomponents/drlvm/developers_guide.html">
- DRLVM Developer's Guide
- </a> - in-depth description of the DRLVM
- internal architecture and components' interaction
- </p>
- <ul>
- <li>
-
- <a href="subcomponents\drlvm\encoder_library.html">
- Encoder Library for
- IA-32/Intel64
- </a> - description of the encoder library for code generation; the document focuses
- on the specifics of the current implementation
- showing the encoder library structure and role inside the DRL virtual machine
-
- </li>
- <li>
- <a href="subcomponents/drlvm/EM.html">
- Execution
- Manager Component Description
- </a> - detailed description of the Execution
- Manager current implementation
- </li>
- <li>
-
- <a href="subcomponents/drlvm/JIT.html">
- Jitrino Just-in-time Compiler
- </a> - detailed description of the DRLVM Jitrino just-in-time
- compiler implementation; gives details on the internal architecture of the
- Jitrino.JET baseline compiler and Jitrino.OPT optimizing compiler, as
- well as processes running inside them
-
- <ul>
- <li>
-
- <a href="subcomponents/drlvm/internal_profiler.html">Jitrino Internal Profiler Description</a> -
- description of the code generator's internal profiler tool (iprof) for Jitrino.OPT just-in-time
- compiler, which defines the tool, illustrates its sample output and configuration mechanisms
-
- </li>
- <li>
-
- <a href="subcomponents/drlvm/JIT_PMF.html">
- Jitrino
- Pipeline Management Framework
- </a> - detailed description of the pipeline
- management framework that provides complete control over just-in-time
- compilation process through the Java property mechanism; the description
- covers the PMF application to the command-line interface and to the
- Jitrino logging system
-
- </li>
- </ul>
- </li>
- <li>
-
- <a href="subcomponents/drlvm/JVMTI-PopFrame.html">JVMTI Pop Frame</a> -
- details on the PopFrame implementation as currently done in DRLVM, description of the functions
- responsible for the operation and gives info on specifics of the current implementation
-
-
- </li>
- <li>
-
- <a href="subcomponents/drlvm/kernel_classes.html">
- Kernel Classes
- </a> - detailed description of the kernel classes implementation
- with focus on the native part of kernel classes and the internal kernel classes
- interface
-
- </li>
- <li>
-
- <a href="subcomponents/drlvm/TM.html">Thread Manager</a> -
- detailed description of the Thread Manager current implementation
-
- </li>
- </ul>
-
- <p>
- <a href="subcomponents/drlvm/DoxygenStart.html">DRLVM Source Code Generated Documentation Index</a> -
- a landing page with links to autogenerated Doxygen documentation for DRLVM interface headers
- </p>
-
- <p>
- <strong>How-tos and Guides</strong>
- </p>
- <p>
-
- <a href="subcomponents/drlvm/emguide.html">
- Configuring Execution Manager
- </a> - guide to Execution Manager (EM)
- options and configuration file format
- </p>
-
- <p>
- <a href="subcomponents/drlvm/gc-howto.html">
- How to Write DRL GC
- </a> - instructions on creating a custom garbage collector
- implementation in C++ and configuring the DRL virtual machine to use it
- with a real-life example of a copying GC implementation (source included)
- </p>
-
- </subsection>
-
- <subsection name="Class Library">
- <p>
- <a href="subcomponents/classlibrary/index.html">
- Class Library Navigator
- </a> - documentation links specific to the
- class library effort underway at Apache Harmony
- </p>
- <p>
- <a href="subcomponents/classlibrary/status.html">
- Class Library Component Status
- </a> - comparisons of JDK 1.4 and JDK 1.5. against
- the Harmony class library snapshots
- </p>
-
- <p>
- <strong>
- Project Conventions
- </strong>
- </p>
- <p>
- <a href="subcomponents/classlibrary/pkgnaming.html">
- Class Library Package Naming Conventions
- </a> - the package naming conventions used in the Apache Harmony Class Library
- </p>
-
- <p>
- <a href="subcomponents/classlibrary/testing.html">
- Class Library Testing Conventions
- </a> - description of the PROPOSED
- placement and package naming conventions for different types of Harmony
- class library tests; general guidlines and recomendations
- that might be adapted/modified to reflect module specifics
- </p>
- <p>
- <a href="subcomponents/classlibrary/compat.html">
- Compatibility Guidelines</a> - compatibility goals in the Apache Harmony Class Library
- </p>
- <p>
- <a href="subcomponents/classlibrary/ser_testing.html">
- Framework for Testing Serialization
- </a> - guidelines for creating tests and
- conventions for resource files
- </p>
- <p>
- <strong>Architecture and Guides Documentation</strong>
- </p>
- <p>
- <a href="subcomponents/classlibrary/asn1_framework.html">
- ASN.1 Framework
- </a> - introduction to the ASN.1 (Abstract Syntax Notation) framework
- with an overview of ASN.1 types and encoding rules focusing on the
- characteristics of the current implementation
- </p>
- <p>
- <a href="subcomponents/classlibrary/awt.html">
- Abstract Window Toolkit Framework
- </a> - description of the AWT (Abstract Window Toolkit) framework covering
- major design features and internal implementation specifics, such as the
- event handling mechanism, the focus dispatching flow, appearance handling
- with custom visual themes and multi-threading support
- </p>
- <p>
- <a href="subcomponents/classlibrary/dns_support.html">
- DNS Service Provider
- </a> - implementation description of the DNS service provider
- for the Java Naming Directory Interface (JNDI) including a package overview, a
- design description and a guide to using the provider
- </p>
- <p>
- <a href="subcomponents/classlibrary/java2d.html">
- Java 2D
- </a> - introduction to the Java two-dimensional (2D) graphics
- and image processing technology implementation focusing on the internal
- specifics of implementation
- </p>
- <p>
- <a href="subcomponents/classlibrary/regexp.html">
- Regex Processing Framework
- </a> - overview of the <code>java.util.regex</code>
- package and implementation architecture focusing on the performance
- improvement aspects
- </p>
- <p>
- <a href="subcomponents/classlibrary/rmi_provider.html">
- RMI Registry Service Provider</a> - description of the functionality of the
- DRL RMI Registry Service Provider for the Java Naming Directory Interface (JNDI)
- including details on the provider design</p>
- </subsection>
-</section>
-</body>
-</document>
+<?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>
+ </section>
+
+ <section name="General Issues">
+ <p>
+ <a href="http://harmony.apache.org/">Home</a> - general
+ information about the project, its status, Harmony news and external news stories
+ about the Harmony project
+ </p>
+
+ <p>
+ <a href="license.html">Apache License</a> - terms and
+ conditions for use, reproduction, and distribution
+ </p>
+
+ <p>
+ <a href=" http://apache.org/">Apache Software Foundation</a> - home page of
+ the Apache Software Foundation providing general information about the project,
+ its status, news, etc.
+ </p>
+ <p>
+ <a href="contribution_policy.html">Contribution Policy</a> -
+ information on division of the repository, limitations on committer
+ contributions and policies for committers and contributors
+ </p>
+ <ul>
+ <li>
+ <a href="auth_cont_quest.html">
+ Authorized Contributor Questionnaire
+ </a> - an authorized contributor
+ questionnaire
+ </li>
+
+ <li>
+ <a href="bulk_contribution_checklist.html">
+ Bulk Contribution Checklist
+ </a> - a bulk contribution checklist
+ </li>
+ </ul>
+ <br />
+ <p>
+ <a href="guidelines.html">Project Guidelines </a> - definition of
+ the Apache Harmony Project guidelines and definitions of how conflict
+ is resolved by voting, who is able to vote, and the procedures to follow for
+ proposing and making changes to the Apache products
+ </p>
+
+
+ <p>
+ <a href="newshistory.html">Harmony News Archive</a> - description of
+ the project develment
+ </p>
+
+ <subsection name="For Users">
+ <p>
+ <a href="quickhelp_users.html">
+ Getting
+ Started for Users
+ </a> - the getting started guide for those that
+ wish to use <a href="downloads.html"> pre-built snapshots</a> of
+ Apache Harmony
+ </p>
+ <p>
+ <a href="downloads.html">Project Downloads</a> -
+ you can find all project downloads here, such as snapshot builds and
+ Subversion
+ </p>
+ <p>
+ <a href="faq.html">FAQ</a> - frequently asked questions
+ </p>
+ </subsection>
+
+ </section>
+
+ <section name="Community">
+ <p>
+ <a href="get-involved.html">Get Involved</a> -
+ general information on how to contribute, give feedback, fix
+ bugs and so on
+ </p>
+
+ <p>
+ <a href="contributors.html">Who We Are - Apache Harmony Committers</a> -
+ description of the Harmony community and its structure
+ </p>
+ <p>
+ <a href="subcomponents/classlibrary/agreements.html">
+ Harmony Developer Agreements and Recommendations
+ </a> - the summary of agreements
+ and recommendations that were discussed on the development mailing list
+ <i>dev@harmony.apache.org</i>
+ </p>
+ <p>
+ <a href="mailing.html">Mailing Lists</a> - the Apache
+ Harmony mailing lists where you can share all your ideas, ask
+ questions and discuss plans
+ </p>
+ <p>
+ <a href="http://issues.apache.org/jira/browse/HARMONY">Bug Tracker</a> - the
+ project to post bugs and other issues on
+ </p>
+ <p>
+ <a href="code_scan_tools.html">
+ Code Scanning Tools
+ </a> - tools to examine code in a more efficient way
+ </p>
+
+ <p>
+ <a href="related.html">Related Projects</a> - the list of other projects
+ related to open source Java
+ </p>
+ </section>
+
+ <section name="Development">
+
+ <p>
+ <a href="quickhelp_contributors.html">
+ Getting Started for Contributors
+ </a> - the getting started guide for
+ those that wish to checkout and build the source of Apache Harmony
+ </p>
+ <p>
+ <a href="http://harmony.apache.org/svn.html">Apache Harmony Source Code</a> -
+ description of the, the repository and access to it</p>
+
+ <p>
+ <a href="roadmap.html">Roadmap and TODO</a> -
+ an approximate roadmap for what the project hopes to achieve in the next
+ year and a collection of things that the project community has listed
+ as needing to be done
+ </p>
+ <p>
+ <a href="issue_resolution_guideline.html">
+ When an Issue Occurs
+ </a> - description of action item types, such as
+ long term plans, short term plans, a release plan, a release testing,
+ showstoppers, product changes; general rules for commiters, information
+ on reporting, resolving and closing issues
+
+ </p>
+ <p>
+ <a href="documentation/build_website.html">
+ Building and Deploying the Apache Harmony Website
+ </a> - tools required
+ for the Harmony website build, building and deploying instructions
+ </p>
+
+ <p>
+ <a href="status.html">What Can We Do Now?</a> -
+ reflects the position of the project
+ </p>
+ <p>
+ <a href="documentation/dev_eclipse.html">
+ Getting Started with Eclipse
+ </a> - instructions on how to set up
+ Eclipse to develop Java code in Apache Harmony, with sections for
+ both DRLVM and class library development
+ </p>
+ <p>
+ <a href="documentation/dev_eclipse_movie.html">
+ Eclipse Movie
+ </a> - a brief webcast for those who want to see a step-by-step
+ guide to configuring Eclipse, and developing a patch to the classlibrary code
+ </p>
+ <p>
+ <a href="performance.html">
+ Performance Data
+ </a> - results obtained on different benchmarks and various hardware and
+ software system configurations
+ </p>
+
+ </section>
+ <section name="Documentation">
+ <p>
+ <a href="http://wiki.apache.org/harmony/">Harmony Wiki</a> -
+ the project for additional documentation and discussions
+ </p>
+ <p>
+ <a href="subcomponents/classlibrary/hdk.html">
+ Harmony Development Kit</a> - description of the HDK layout and its contents
+ </p>
+
+ <subsection name="DRLVM">
+ <p>
+ <a href="subcomponents/drlvm/index.html">
+ DRLVM Navigator
+ </a> - documentation links specific to DRLVM effort
+ underway at Apache Harmony
+ </p>
+ <p>
+ <strong>
+ Developing and Building the Code Documentation
+ </strong>
+ </p>
+ <p>
+ <a href="subcomponents/drlvm/debugging_VM_and_JIT.html">
+ Debugging the DRL Virtual Machine and the JIT Compiler
+ </a> - practical instructions on how to debug the DRL virtual machine and its
+ baseline just-in-time compiler Jitrino.JET
+ </p>
+ <p>
+ <a href="subcomponents/drlvm/getting_started.html">
+ Getting Started with DRLVM
+ </a> - basic usage scenarios of VM: starting an
+ application, working in Eclipse
+ </p>
+ <p>
+ <a href="https://svn.apache.org/viewcvs.cgi/*checkout*/harmony/enhanced/drlvm/trunk/README.txt">
+ README
+ </a> - source package and building instructions for
+ the VM source code
+ </p>
+ <p>
+ <strong>Architecture and Component Documentation</strong>
+ </p>
+
+ <p>
+ <a href="subcomponents/drlvm/developers_guide.html">
+ DRLVM Developer's Guide
+ </a> - in-depth description of the DRLVM
+ internal architecture and components' interaction
+ </p>
+ <ul>
+ <li>
+
+ <a href="subcomponents\drlvm\encoder_library.html">
+ Encoder Library for
+ IA-32/Intel64
+ </a> - description of the encoder library for code generation; the document focuses
+ on the specifics of the current implementation
+ showing the encoder library structure and role inside the DRL virtual machine
+
+ </li>
+ <li>
+ <a href="subcomponents/drlvm/EM.html">
+ Execution
+ Manager Component Description
+ </a> - detailed description of the Execution
+ Manager current implementation
+ </li>
+ <li>
+
+ <a href="subcomponents/drlvm/JIT.html">
+ Jitrino Just-in-time Compiler
+ </a> - detailed description of the DRLVM Jitrino just-in-time
+ compiler implementation; gives details on the internal architecture of the
+ Jitrino.JET baseline compiler and Jitrino.OPT optimizing compiler, as
+ well as processes running inside them
+
+ <ul>
+ <li>
+
+ <a href="subcomponents/drlvm/internal_profiler.html">Jitrino Internal Profiler Description</a> -
+ description of the code generator's internal profiler tool (iprof) for Jitrino.OPT just-in-time
+ compiler, which defines the tool, illustrates its sample output and configuration mechanisms
+
+ </li>
+ <li>
+
+ <a href="subcomponents/drlvm/JIT_PMF.html">
+ Jitrino
+ Pipeline Management Framework
+ </a> - detailed description of the pipeline
+ management framework that provides complete control over just-in-time
+ compilation process through the Java property mechanism; the description
+ covers the PMF application to the command-line interface and to the
+ Jitrino logging system
+
+ </li>
+ </ul>
+ </li>
+ <li>
+
+ <a href="subcomponents/drlvm/JVMTI-PopFrame.html">JVMTI Pop Frame</a> -
+ details on the PopFrame implementation as currently done in DRLVM, description of the functions
+ responsible for the operation and gives info on specifics of the current implementation
+
+
+ </li>
+ <li>
+
+ <a href="subcomponents/drlvm/kernel_classes.html">
+ Kernel Classes
+ </a> - detailed description of the kernel classes implementation
+ with focus on the native part of kernel classes and the internal kernel classes
+ interface
+
+ </li>
+ <li>
+
+ <a href="subcomponents/drlvm/TM.html">Thread Manager</a> -
+ detailed description of the Thread Manager current implementation
+
+ </li>
+ </ul>
+
+ <p>
+ <a href="subcomponents/drlvm/DoxygenStart.html">DRLVM Source Code Generated Documentation Index</a> -
+ a landing page with links to autogenerated Doxygen documentation for DRLVM interface headers
+ </p>
+
+ <p>
+ <strong>How-tos and Guides</strong>
+ </p>
+ <p>
+
+ <a href="subcomponents/drlvm/emguide.html">
+ Configuring Execution Manager
+ </a> - guide to Execution Manager (EM)
+ options and configuration file format
+ </p>
+
+ <p>
+ <a href="subcomponents/drlvm/gc-howto.html">
+ How to Write DRL GC
+ </a> - instructions on creating a custom garbage collector
+ implementation in C++ and configuring the DRL virtual machine to use it
+ with a real-life example of a copying GC implementation (source included)
+ </p>
+
+ </subsection>
+
+ <subsection name="Class Library">
+ <p>
+ <a href="subcomponents/classlibrary/index.html">
+ Class Library Navigator
+ </a> - documentation links specific to the
+ class library effort underway at Apache Harmony
+ </p>
+ <p>
+ <a href="subcomponents/classlibrary/status.html">
+ Class Library Component Status
+ </a> - comparisons of JDK 1.4 and JDK 1.5. against
+ the Harmony class library snapshots
+ </p>
+
+ <p>
+ <strong>
+ Project Conventions
+ </strong>
+ </p>
+ <p>
+ <a href="subcomponents/classlibrary/pkgnaming.html">
+ Class Library Package Naming Conventions
+ </a> - the package naming conventions used in the Apache Harmony Class Library
+ </p>
+
+ <p>
+ <a href="subcomponents/classlibrary/testing.html">
+ Class Library Testing Conventions
+ </a> - description of the PROPOSED
+ placement and package naming conventions for different types of Harmony
+ class library tests; general guidlines and recomendations
+ that might be adapted/modified to reflect module specifics
+ </p>
+ <p>
+ <a href="subcomponents/classlibrary/compat.html">
+ Compatibility Guidelines</a> - compatibility goals in the Apache Harmony Class Library
+ </p>
+ <p>
+ <a href="subcomponents/classlibrary/ser_testing.html">
+ Framework for Testing Serialization
+ </a> - guidelines for creating tests and
+ conventions for resource files
+ </p>
+ <p>
+ <strong>Architecture and Guides Documentation</strong>
+ </p>
+ <p>
+ <a href="subcomponents/classlibrary/asn1_framework.html">
+ ASN.1 Framework
+ </a> - introduction to the ASN.1 (Abstract Syntax Notation) framework
+ with an overview of ASN.1 types and encoding rules focusing on the
+ characteristics of the current implementation
+ </p>
+ <p>
+ <a href="subcomponents/classlibrary/awt.html">
+ Abstract Window Toolkit Framework
+ </a> - description of the AWT (Abstract Window Toolkit) framework covering
+ major design features and internal implementation specifics, such as the
+ event handling mechanism, the focus dispatching flow, appearance handling
+ with custom visual themes and multi-threading support
+ </p>
+ <p>
+ <a href="subcomponents/classlibrary/dns_support.html">
+ DNS Service Provider
+ </a> - implementation description of the DNS service provider
+ for the Java Naming Directory Interface (JNDI) including a package overview, a
+ design description and a guide to using the provider
+ </p>
+ <p>
+ <a href="subcomponents/classlibrary/java2d.html">
+ Java 2D
+ </a> - introduction to the Java two-dimensional (2D) graphics
+ and image processing technology implementation focusing on the internal
+ specifics of implementation
+ </p>
+ <p>
+ <a href="subcomponents/classlibrary/regexp.html">
+ Regex Processing Framework
+ </a> - overview of the <code>java.util.regex</code>
+ package and implementation architecture focusing on the performance
+ improvement aspects
+ </p>
+ <p>
+ <a href="subcomponents/classlibrary/rmi_provider.html">
+ RMI Registry Service Provider</a> - description of the functionality of the
+ DRL RMI Registry Service Provider for the Java Naming Directory Interface (JNDI)
+ including details on the provider design</p>
+ </subsection>
+</section>
+</body>
+</document>
Modified: harmony/standard/site/xdocs/subcomponents/classlibrary/ASN1Framework.html
URL: http://svn.apache.org/viewvc/harmony/standard/site/xdocs/subcomponents/classlibrary/ASN1Framework.html?view=diff&rev=515560&r1=515559&r2=515560
==============================================================================
--- harmony/standard/site/xdocs/subcomponents/classlibrary/ASN1Framework.html (original)
+++ harmony/standard/site/xdocs/subcomponents/classlibrary/ASN1Framework.html Wed Mar 7 05:29:12 2007
@@ -1,10 +1,10 @@
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
- contributor license agreements. See the NOTICE file distributed with
+ 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
+ the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
@@ -15,10 +15,6 @@
limitations under the License.
-->
-<!--
-Author: Nadezhda Morozova, Stepan M. Mishura
-Version: $Revision$
--->
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
@@ -1407,6 +1403,7 @@
</p>
</body>
</html>
+
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=515560&r1=515559&r2=515560
==============================================================================
--- harmony/standard/site/xdocs/subcomponents/classlibrary/RMIprovider.html (original)
+++ harmony/standard/site/xdocs/subcomponents/classlibrary/RMIprovider.html Wed Mar 7 05:29:12 2007
@@ -1,3 +1,19 @@
+<!--
+ 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>
@@ -245,5 +261,6 @@
</p>
</body>
</html>
+
Modified: harmony/standard/site/xdocs/subcomponents/classlibrary/Regexp.html
URL: http://svn.apache.org/viewvc/harmony/standard/site/xdocs/subcomponents/classlibrary/Regexp.html?view=diff&rev=515560&r1=515559&r2=515560
==============================================================================
--- harmony/standard/site/xdocs/subcomponents/classlibrary/Regexp.html (original)
+++ harmony/standard/site/xdocs/subcomponents/classlibrary/Regexp.html Wed Mar 7 05:29:12 2007
@@ -1,3 +1,19 @@
+ <!--
+ 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 XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
@@ -548,6 +564,7 @@
</p>
</body>
</html>
+
Modified: harmony/standard/site/xdocs/subcomponents/classlibrary/asn1_framework.xml
URL: http://svn.apache.org/viewvc/harmony/standard/site/xdocs/subcomponents/classlibrary/asn1_framework.xml?view=diff&rev=515560&r1=515559&r2=515560
==============================================================================
--- harmony/standard/site/xdocs/subcomponents/classlibrary/asn1_framework.xml (original)
+++ harmony/standard/site/xdocs/subcomponents/classlibrary/asn1_framework.xml Wed Mar 7 05:29:12 2007
@@ -25,4 +25,4 @@
<body>
<docinclude name="subcomponents/classlibrary/ASN1Framework.html"/>
</body>
-</document>
+</document>
Modified: harmony/standard/site/xdocs/subcomponents/classlibrary/regexp.xml
URL: http://svn.apache.org/viewvc/harmony/standard/site/xdocs/subcomponents/classlibrary/regexp.xml?view=diff&rev=515560&r1=515559&r2=515560
==============================================================================
--- harmony/standard/site/xdocs/subcomponents/classlibrary/regexp.xml (original)
+++ harmony/standard/site/xdocs/subcomponents/classlibrary/regexp.xml Wed Mar 7 05:29:12 2007
@@ -26,4 +26,4 @@
<body>
<docinclude name="subcomponents/classlibrary/Regexp.html"/>
</body>
-</document>
+</document>
Modified: harmony/standard/site/xdocs/subcomponents/classlibrary/rmi_provider.xml
URL: http://svn.apache.org/viewvc/harmony/standard/site/xdocs/subcomponents/classlibrary/rmi_provider.xml?view=diff&rev=515560&r1=515559&r2=515560
==============================================================================
--- harmony/standard/site/xdocs/subcomponents/classlibrary/rmi_provider.xml (original)
+++ harmony/standard/site/xdocs/subcomponents/classlibrary/rmi_provider.xml Wed Mar 7 05:29:12 2007
@@ -1,30 +1,30 @@
-<?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>RMI Provider</title>
- <author email="dev@harmony.apache.org">Harmony Documentation Team</author>
- </properties>
-
- <body>
- <docinclude name="subcomponents/classlibrary/RMIprovider.html"/>
- </body>
-</document>
+<?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>RMI Provider</title>
+ <author email="dev@harmony.apache.org">Harmony Documentation Team</author>
+ </properties>
+
+ <body>
+ <docinclude name="subcomponents/classlibrary/RMIprovider.html"/>
+ </body>
+</document>
Modified: harmony/standard/site/xdocs/subcomponents/drlvm/DoxygenStart.xml
URL: http://svn.apache.org/viewvc/harmony/standard/site/xdocs/subcomponents/drlvm/DoxygenStart.xml?view=diff&rev=515560&r1=515559&r2=515560
==============================================================================
--- harmony/standard/site/xdocs/subcomponents/drlvm/DoxygenStart.xml (original)
+++ harmony/standard/site/xdocs/subcomponents/drlvm/DoxygenStart.xml Wed Mar 7 05:29:12 2007
@@ -1,95 +1,95 @@
-<?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 DRL Virtual Machine Doc Index</title>
- <author email="dev@harmony.apache.org">Harmony Documentation Team</author>
- </properties>
-
- <body>
-
-<section name="DRLVM Source Code Generated Documentation Index">
-<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>
- <subsection name="Doxygen API Reference for DRLVM Sources">
- <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>
- </subsection>
-
- <subsection name="Other Useful DRLVM documents">
- <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>
- </subsection>
-</section>
-<section name="Regenerating the Reference">
-<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>
-<subsection name="Advanced Tasks">
-<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>
-</subsection>
-</section>
-</body>
+<?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 DRL Virtual Machine Doc Index</title>
+ <author email="dev@harmony.apache.org">Harmony Documentation Team</author>
+ </properties>
+
+ <body>
+
+<section name="DRLVM Source Code Generated Documentation Index">
+<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>
+ <subsection name="Doxygen API Reference for DRLVM Sources">
+ <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>
+ </subsection>
+
+ <subsection name="Other Useful DRLVM documents">
+ <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>
+ </subsection>
+</section>
+<section name="Regenerating the Reference">
+<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>
+<subsection name="Advanced Tasks">
+<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>
+</subsection>
+</section>
+</body>
</document>
Modified: harmony/standard/site/xdocs/subcomponents/drlvm/EM.html
URL: http://svn.apache.org/viewvc/harmony/standard/site/xdocs/subcomponents/drlvm/EM.html?view=diff&rev=515560&r1=515559&r2=515560
==============================================================================
--- harmony/standard/site/xdocs/subcomponents/drlvm/EM.html (original)
+++ harmony/standard/site/xdocs/subcomponents/drlvm/EM.html Wed Mar 7 05:29:12 2007
@@ -1,3 +1,19 @@
+<!--
+ 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 XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
@@ -653,6 +669,7 @@
</p>
</body>
</html>
+
Modified: harmony/standard/site/xdocs/subcomponents/drlvm/JVMTI-PopFrame.xml
URL: http://svn.apache.org/viewvc/harmony/standard/site/xdocs/subcomponents/drlvm/JVMTI-PopFrame.xml?view=diff&rev=515560&r1=515559&r2=515560
==============================================================================
--- harmony/standard/site/xdocs/subcomponents/drlvm/JVMTI-PopFrame.xml (original)
+++ harmony/standard/site/xdocs/subcomponents/drlvm/JVMTI-PopFrame.xml Wed Mar 7 05:29:12 2007
@@ -1,263 +1,263 @@
-<?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>JVMTI Implementation of Pop Frame</title>
- <author email="dev@harmony.apache.org">Harmony Documentation Team</author>
-
- </properties>
-
- <body>
- <section name="JVMTI Pop Frame">
- <p>
- Here is a description of how popping a frame is currently
- implemented in the DRLVM tool interface (JVMTI). For a
- definition of the pop frame functionality, consult the JVMTI
- specification [<a href="#JVMTISpec">1</a>]. For generic
- information on JVMTI in the DRL virtual machine and for definition
- of related terms, see the <a href="developers_guide.html" title="DRLVM Developer's Guide">developer's
- guide</a>.
- </p>
-
- <subsection name="Introduction">
- <p> Popping a stack frame becomes necessary when execution is in a native
- function and a <a href="developers_guide.html#M2nFrame">managed-to-native
- frame</a> (M2nFrame) is on the stack. This means that the JVMTI
- component pops the M2nFrame and the Java frame above it. A frame is popped
- each time the JVMTI function <code>PopFrame()</code> is
- called. The current pop-frame implementation is based on the exception
- handling mechanism for transferring execution control. This way, VM pops
- frames on the current thread only. To pop frames on other threads, VM
- uses the M2nFrame flag system and callbacks.</p>
- </subsection>
- <subsection name="How to Pop a Frame">
- <p>To pop a frame on the current thread, refer to the following core
- functions:
- </p>
- <table>
- <tr>
- <th class="TableHeading">
- Function Name </th>
- <th class="TableHeading">
- Role</th>
- </tr>
- <tr>
- <td class="TableCell">
- <code>jvmti_jit_prepare_pop_frame</code>
- </td>
- <td class="TableCell">
- Finds register context for the previous frame using the
- <a href="developers_guide.html#Stack_Iterator">stack iterator</a>.</td>
- </tr>
- <tr>
- <td class="TableCell">
- <code>jvmti_jit_complete_pop_frame</code>
- </td>
- <td class="TableCell">
- Transfers control to the saved register context for the
- popped frame.
- </td>
- </tr>
- <tr>
- <td class="TableCell">
- <code>jvmti_ji_do_pop_frame</code>
- </td>
- <td class="TableCell">
- Transfers control to the previous frame. This function is
- a simple and fast combination of sequential calls of
- <code>jvmti_jit_prepare_pop_frame</code> and
- <code>jvmti_jit_complete_pop_frame</code>.
- </td>
- </tr>
- </table>
- <p>The state of a frame with regard to popping is indicated in the
- <code>frame_type</code>
- field. This field can have the following values: </p>
- <table>
- <tr>
- <th class="TableHeading">
- Flag Name
- </th>
- <th class="TableHeading">
- Meaning</th>
- </tr>
- <tr>
- <td class="TableCell">
- <code>FRAME_UNPOPABLE</code>
- </td>
- <td class="TableCell">
- The frame cannot be popped.
- </td>
- </tr>
- <tr>
- <td class="TableCell">
- <code>FRAME_POPABLE</code>
- </td>
- <td class="TableCell">
- The frame can be popped but is not.
- </td>
- </tr>
- <tr>
- <td class="TableCell">
- <code>FRAME_POP_NOW</code>
- </td>
- <td class="TableCell">
- The frame is popped and the state of VM can be
- unpredictable and unexpected. JVMTI cannot work in this
- state and waits until the popped frame is resumed and the
- frame state is changed.
- </td>
- </tr>
- <tr>
- <td class="TableCell">
- <code>FRAME_POP_DONE =
- FRAME_POPABLE |FRAME_POP_NOW</code>
- </td>
- <td class="TableCell">
- The frame is popped now but VM state is OK and JVMTI can
- work without thread resume.
- </td>
- </tr>
- </table>
- <p>
- In the current implementation, popping a frame goes in the
- following way:
- </p>
- <ol>
- <li>
- VM suspends the popped thread in one of these functions:
- <code>thread_suspend_disable()</code> or in <code>hythread_safe_point()</code>.
- </li>
- <li>
- The JVMTI Agent calls <code>PopFrame()</code> and does the following:
- <ol>
- <li>
- Checks that the flag for the topmost M2nFrame is set to <code>FRAME_POPABLE</code>,
- which means that the frame can be popped.
- </li>
- <li>
- Changes the flag
- to <code>FRAME_POP_NOW</code>.
- </li>
- <li>
- Sets the safe point for the callback function. The suspended thread
- executes the callback while staying in the function where the
- thread is suspended.
- </li>
- </ol>
- </li>
- <li>
- The callback
- function pops the frame in one of the following ways depending on
- the function and on area of the stack:
- <ol>
- <li>
- For <b>hythread_safe_point():</b>
- <ol>
- <li>
- VM finds the register
- context for the previous frame and saves it in the current M2nFrame.
- The frame type flag changed to <code>FRAME_POP_DONE</code>.
- </li>
- <li>
- VM exits the safe point and checks the frame status. If
- the frame is popped, VM transfers control to the saved register
- context. Otherwise, VM exits normally.
- </li>
- </ol>
- </li>
- <li>
- For the <b>suspend_disable()</b> function in an <a href="developers_guide.html#Exception_Handling">
- unwindable
- area of the stack
- </a>:
- <ol>
- <li>
- The callback explicitly calls <code>hythread_safe_point()</code> to
- stop the current thread in the safe point and wait until
- the thread is resumed by another thread.
- </li>
- <li>
- When the thread is resumed, the callback pops the frame
- for the current thread and transfers control to the previous
- frame.
- </li>
- </ol>
- </li>
- <li>
- For the <strong>suspend_disable()</strong> function in a <a href="developers_guide.html#Exception_Handling">
- non-unwindable
- area of the stack
- </a>:
- <ol>
- <li>
- VM raises a special exception object and waits for the end
- of the area.
- </li>
- <li>
- After exiting the area, VM checks whether the exception
- is set and pops the frame for the current thread and transfers
- control to the previous frame.
- </li>
- </ol>
- </li>
- </ol>
- </li>
- </ol>
- </subsection>
- <subsection name="Implementation Specifics">
-
-
- <ul>
- <li>Because the implementation re-uses the exception scheme, popping
- a frame does not transfer control to the beginning of the bytecode
- invoke instruction, but to the native call instruction. This is possible
- because the JIT compiles an invoke instruction into
- several native instructions including the call.<br />
- A better way of handling the operation is to make VM transfer
- control to the beginning of the invoke instruction block. </li>
- <li> In the exception handling mechanism, control is returned to the
- instruction pointer (IP) after the call instruction. This way, VM
- must find the call IP of the previous instruction by using
- information on JIT calling conventions.<br />
-It is advisory to move the corresponding functionality to JIT so that VM has no data
-on JIT calling conventions. </li>
- <li> Object references in popped frames can become outdated during
- garbage collection because VM components do not enumerate the stack
- for such frames. For GC purposes, JVM TI enumerates popped frames
- until the thread is resumed and control is transferred. </li>
- <li> Due to specifics of the current thread manager implementation,
- the pop frame cannot guarantee synchronization of thread-suspend
- states across different threads. This way, if Thread A suspends
- Thread B, the current implementation cannot guarantee that Thread
- B is not resumed by another thread. In such a situation, operation of
- Thread A can be unstable because it relies on Thread B being
- suspended. </li>
- </ul>
- </subsection>
- <subsection name="Related Information">
-
- <p>[<a name="JVMTISpec" id="JVMTISpec"></a>1] JVM
- Tool Interface Specification, <a
-href="http://java.sun.com/j2se/1.5.0/docs/guide/jvmti/jvmti.html"
-target="_blank">http://java.sun.com/j2se/1.5.0/docs/guide/jvmti/jvmti.html</a> </p>
- </subsection>
- </section>
-</body>
+<?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>JVMTI Implementation of Pop Frame</title>
+ <author email="dev@harmony.apache.org">Harmony Documentation Team</author>
+
+ </properties>
+
+ <body>
+ <section name="JVMTI Pop Frame">
+ <p>
+ Here is a description of how popping a frame is currently
+ implemented in the DRLVM tool interface (JVMTI). For a
+ definition of the pop frame functionality, consult the JVMTI
+ specification [<a href="#JVMTISpec">1</a>]. For generic
+ information on JVMTI in the DRL virtual machine and for definition
+ of related terms, see the <a href="developers_guide.html" title="DRLVM Developer's Guide">developer's
+ guide</a>.
+ </p>
+
+ <subsection name="Introduction">
+ <p> Popping a stack frame becomes necessary when execution is in a native
+ function and a <a href="developers_guide.html#M2nFrame">managed-to-native
+ frame</a> (M2nFrame) is on the stack. This means that the JVMTI
+ component pops the M2nFrame and the Java frame above it. A frame is popped
+ each time the JVMTI function <code>PopFrame()</code> is
+ called. The current pop-frame implementation is based on the exception
+ handling mechanism for transferring execution control. This way, VM pops
+ frames on the current thread only. To pop frames on other threads, VM
+ uses the M2nFrame flag system and callbacks.</p>
+ </subsection>
+ <subsection name="How to Pop a Frame">
+ <p>To pop a frame on the current thread, refer to the following core
+ functions:
+ </p>
+ <table>
+ <tr>
+ <th class="TableHeading">
+ Function Name </th>
+ <th class="TableHeading">
+ Role</th>
+ </tr>
+ <tr>
+ <td class="TableCell">
+ <code>jvmti_jit_prepare_pop_frame</code>
+ </td>
+ <td class="TableCell">
+ Finds register context for the previous frame using the
+ <a href="developers_guide.html#Stack_Iterator">stack iterator</a>.</td>
+ </tr>
+ <tr>
+ <td class="TableCell">
+ <code>jvmti_jit_complete_pop_frame</code>
+ </td>
+ <td class="TableCell">
+ Transfers control to the saved register context for the
+ popped frame.
+ </td>
+ </tr>
+ <tr>
+ <td class="TableCell">
+ <code>jvmti_ji_do_pop_frame</code>
+ </td>
+ <td class="TableCell">
+ Transfers control to the previous frame. This function is
+ a simple and fast combination of sequential calls of
+ <code>jvmti_jit_prepare_pop_frame</code> and
+ <code>jvmti_jit_complete_pop_frame</code>.
+ </td>
+ </tr>
+ </table>
+ <p>The state of a frame with regard to popping is indicated in the
+ <code>frame_type</code>
+ field. This field can have the following values: </p>
+ <table>
+ <tr>
+ <th class="TableHeading">
+ Flag Name
+ </th>
+ <th class="TableHeading">
+ Meaning</th>
+ </tr>
+ <tr>
+ <td class="TableCell">
+ <code>FRAME_UNPOPABLE</code>
+ </td>
+ <td class="TableCell">
+ The frame cannot be popped.
+ </td>
+ </tr>
+ <tr>
+ <td class="TableCell">
+ <code>FRAME_POPABLE</code>
+ </td>
+ <td class="TableCell">
+ The frame can be popped but is not.
+ </td>
+ </tr>
+ <tr>
+ <td class="TableCell">
+ <code>FRAME_POP_NOW</code>
+ </td>
+ <td class="TableCell">
+ The frame is popped and the state of VM can be
+ unpredictable and unexpected. JVMTI cannot work in this
+ state and waits until the popped frame is resumed and the
+ frame state is changed.
+ </td>
+ </tr>
+ <tr>
+ <td class="TableCell">
+ <code>FRAME_POP_DONE =
+ FRAME_POPABLE |FRAME_POP_NOW</code>
+ </td>
+ <td class="TableCell">
+ The frame is popped now but VM state is OK and JVMTI can
+ work without thread resume.
+ </td>
+ </tr>
+ </table>
+ <p>
+ In the current implementation, popping a frame goes in the
+ following way:
+ </p>
+ <ol>
+ <li>
+ VM suspends the popped thread in one of these functions:
+ <code>thread_suspend_disable()</code> or in <code>hythread_safe_point()</code>.
+ </li>
+ <li>
+ The JVMTI Agent calls <code>PopFrame()</code> and does the following:
+ <ol>
+ <li>
+ Checks that the flag for the topmost M2nFrame is set to <code>FRAME_POPABLE</code>,
+ which means that the frame can be popped.
+ </li>
+ <li>
+ Changes the flag
+ to <code>FRAME_POP_NOW</code>.
+ </li>
+ <li>
+ Sets the safe point for the callback function. The suspended thread
+ executes the callback while staying in the function where the
+ thread is suspended.
+ </li>
+ </ol>
+ </li>
+ <li>
+ The callback
+ function pops the frame in one of the following ways depending on
+ the function and on area of the stack:
+ <ol>
+ <li>
+ For <b>hythread_safe_point():</b>
+ <ol>
+ <li>
+ VM finds the register
+ context for the previous frame and saves it in the current M2nFrame.
+ The frame type flag changed to <code>FRAME_POP_DONE</code>.
+ </li>
+ <li>
+ VM exits the safe point and checks the frame status. If
+ the frame is popped, VM transfers control to the saved register
+ context. Otherwise, VM exits normally.
+ </li>
+ </ol>
+ </li>
+ <li>
+ For the <b>suspend_disable()</b> function in an <a href="developers_guide.html#Exception_Handling">
+ unwindable
+ area of the stack
+ </a>:
+ <ol>
+ <li>
+ The callback explicitly calls <code>hythread_safe_point()</code> to
+ stop the current thread in the safe point and wait until
+ the thread is resumed by another thread.
+ </li>
+ <li>
+ When the thread is resumed, the callback pops the frame
+ for the current thread and transfers control to the previous
+ frame.
+ </li>
+ </ol>
+ </li>
+ <li>
+ For the <strong>suspend_disable()</strong> function in a <a href="developers_guide.html#Exception_Handling">
+ non-unwindable
+ area of the stack
+ </a>:
+ <ol>
+ <li>
+ VM raises a special exception object and waits for the end
+ of the area.
+ </li>
+ <li>
+ After exiting the area, VM checks whether the exception
+ is set and pops the frame for the current thread and transfers
+ control to the previous frame.
+ </li>
+ </ol>
+ </li>
+ </ol>
+ </li>
+ </ol>
+ </subsection>
+ <subsection name="Implementation Specifics">
+
+
+ <ul>
+ <li>Because the implementation re-uses the exception scheme, popping
+ a frame does not transfer control to the beginning of the bytecode
+ invoke instruction, but to the native call instruction. This is possible
+ because the JIT compiles an invoke instruction into
+ several native instructions including the call.<br />
+ A better way of handling the operation is to make VM transfer
+ control to the beginning of the invoke instruction block. </li>
+ <li> In the exception handling mechanism, control is returned to the
+ instruction pointer (IP) after the call instruction. This way, VM
+ must find the call IP of the previous instruction by using
+ information on JIT calling conventions.<br />
+It is advisory to move the corresponding functionality to JIT so that VM has no data
+on JIT calling conventions. </li>
+ <li> Object references in popped frames can become outdated during
+ garbage collection because VM components do not enumerate the stack
+ for such frames. For GC purposes, JVM TI enumerates popped frames
+ until the thread is resumed and control is transferred. </li>
+ <li> Due to specifics of the current thread manager implementation,
+ the pop frame cannot guarantee synchronization of thread-suspend
+ states across different threads. This way, if Thread A suspends
+ Thread B, the current implementation cannot guarantee that Thread
+ B is not resumed by another thread. In such a situation, operation of
+ Thread A can be unstable because it relies on Thread B being
+ suspended. </li>
+ </ul>
+ </subsection>
+ <subsection name="Related Information">
+
+ <p>[<a name="JVMTISpec" id="JVMTISpec"></a>1] JVM
+ Tool Interface Specification, <a
+href="http://java.sun.com/j2se/1.5.0/docs/guide/jvmti/jvmti.html"
+target="_blank">http://java.sun.com/j2se/1.5.0/docs/guide/jvmti/jvmti.html</a> </p>
+ </subsection>
+ </section>
+</body>
</document>
Modified: harmony/standard/site/xdocs/subcomponents/drlvm/Jitrino.html
URL: http://svn.apache.org/viewvc/harmony/standard/site/xdocs/subcomponents/drlvm/Jitrino.html?view=diff&rev=515560&r1=515559&r2=515560
==============================================================================
--- harmony/standard/site/xdocs/subcomponents/drlvm/Jitrino.html (original)
+++ harmony/standard/site/xdocs/subcomponents/drlvm/Jitrino.html Wed Mar 7 05:29:12 2007
@@ -1,3 +1,19 @@
+<!--
+ 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 XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
@@ -2526,4 +2542,5 @@
</p>
</body>
</html>
+
Modified: harmony/standard/site/xdocs/subcomponents/drlvm/Jitrino_PMF.html
URL: http://svn.apache.org/viewvc/harmony/standard/site/xdocs/subcomponents/drlvm/Jitrino_PMF.html?view=diff&rev=515560&r1=515559&r2=515560
==============================================================================
--- harmony/standard/site/xdocs/subcomponents/drlvm/Jitrino_PMF.html (original)
+++ harmony/standard/site/xdocs/subcomponents/drlvm/Jitrino_PMF.html Wed Mar 7 05:29:12 2007
@@ -1,3 +1,22 @@
+<!--
+ 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 XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type"
@@ -1290,4 +1309,4 @@
name="*">*</a> Other brands and names are the property of
their respective owners.</p>
</body>
-</html>
\ No newline at end of file
+</html>