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/19 15:12:08 UTC
svn commit: r519951 [4/5] - in /harmony/standard/site: docs/
docs/subcomponents/classlibrary/ docs/subcomponents/drlvm/ xdocs/
xdocs/subcomponents/classlibrary/ xdocs/subcomponents/drlvm/
Modified: harmony/standard/site/xdocs/newshistory.xml
URL: http://svn.apache.org/viewvc/harmony/standard/site/xdocs/newshistory.xml?view=diff&rev=519951&r1=519950&r2=519951
==============================================================================
--- harmony/standard/site/xdocs/newshistory.xml (original)
+++ harmony/standard/site/xdocs/newshistory.xml Mon Mar 19 07:12:06 2007
@@ -25,59 +25,34 @@
<section name="Older Harmony News">
<dl>
<dt>New JRE and HDK Snapshots Posted</dt>
- <dd>
- <p>
- Our <a href="downloads.html">latest snapshots</a> have
+ <dd> Our <a href="downloads.html">latest snapshots</a> have
lots of new fixes and features. The VM has a new GC,
almost complete JVMTI, and now can co-exist with
<a href="http://www.ibm.com/developerworks/java/jdk/harmony">the IBM VME</a> in
the Harmony JRE structure. Our classlibrary continues to grow with new
classes, notably CORBA, thanks to <a href="http://incubator.apache.org/yoko">
- Apache Yoko</a>.
+ Apache Yoko</a>.
Also, the classlibrary includes many new fixes and updates.
Choose the JRE to test your favorite applications, and
<a href="mailing.html">give us feedback</a> on how
we are doing, or use the HDK to enable faster development of the Harmony classlibrary.
(<i>2006-09-28</i>)
- </p>
- </dd>
-
+ </dd>
<dt>Can Apache Harmony Help Sun Open Java?</dt>
- <dd>
- <p>
- We're happy to <a href="http://www.businessreviewonline.com/os/archives/2006/08/open_source_jav.html">help</a>
- (<i>2006-08-16</i>)
- </p>
- </dd>
-
+ <dd>We're happy to <a href="http://www.businessreviewonline.com/os/archives/2006/08/open_source_jav.html">help</a>
+ (<i>2006-08-16</i>)</dd>
<dt>New Snapshot Posted</dt>
- <dd>
- <p>
- Lots of fixes and additions in the latest snapshot. (<i>2006-08-16</i>)
- </p>
- </dd>
-
+ <dd>Lots of fixes and additions in the latest snapshot. (<i>2006-08-16</i>)</dd>
<dt>DRLVM Documentation Update</dt>
- <dd>
- <p>
- Check our new documentation on <a href="subcomponents/drlvm/index.html">DRLVM</a>
+ <dd>Check our new documentation on <a href="subcomponents/drlvm/index.html">DRLVM</a>
including guides for building, using, debugging, GC architecture and execution manager
- architecture. (<i>2006-08-05</i>)
- </p>
- </dd>
-
+ architecture. (<i>2006-08-05</i>)</dd>
<dt>New HDK and JRE Snapshots Available</dt>
- <dd>
- <p>
- New <a href="http://people.apache.org/builds/harmony/snapshots/">snapshots</a>
+ <dd>New <a href="http://people.apache.org/builds/harmony/snapshots/">snapshots</a>
of the HDK and JRE are now available with lots of bugfixes. (<i>2006-08-04</i>)
- </p>
</dd>
-
<dt>HDK and JRE Snapshots Available</dt>
- <dd>
- <p>
- Harmony now <a href="http://people.apache.org/builds/harmony/snapshots/">offers a snapshot</a>
+ <dd>Harmony now <a href="http://people.apache.org/builds/harmony/snapshots/">offers a snapshot</a>
of it's JRE and HDK builds.
The JRE snapshot is our in-progress Java Runtime Environment,
including both the virtual machine and classlibrary. Note that
@@ -87,26 +62,18 @@
to complete the most popular parts of the classlibrary first. The HDK
snapshot is a developers build, complete with classlibrary jars and
native libraries, header files, and build scripts. (<i>2006-07-22</i>)
- </p>
- </dd>
-
+ </dd>
<dt>New class library snapshot build available</dt>
- <dd>
- <p>
- A new stable snapshot of the class libraries code is available
+ <dd>A new stable snapshot of the class libraries code is available
for download from the <a href="downloads.html">Harmony downloads page</a>.
These are made available for people to evaluate and experiment
with the code. This snapshot contains the recently integrated
Swing, AWT, and Java2D code. As always, please report bugs
(and successes!) to the <a href="mailing.html">Harmony developers mailing list</a>.
(<i>2006-06-30</i>)
- </p>
- </dd>
-
+ </dd>
<dt>AWT, Java2D and Swing Code Contribution</dt>
- <dd>
- <p>
- On May 30th, 2006 the Apache Harmony project received a
+ <dd>On May 30th, 2006 the Apache Harmony project received a
<a href="https://issues.apache.org/jira/browse/HARMONY-528">
substantial contribution</a> of class library code into the project.
The code for AWT, Java2D, and Swing implementation has been contributed by Alexey
@@ -114,75 +81,50 @@
on the <a href="mailing.html">Harmony developers mailing list</a>. Thanks to
Alexey and his colleagues in the Intel Middleware Products Division!
(<i>2006-05-31</i>)
- </p>
</dd>
-
<dt>New class library snapshot build available</dt>
- <dd>
- <p>
- A new stable snapshot of the class libraries code is available
+ <dd> A new stable snapshot of the class libraries code is available
for download from the <a href="downloads.html">Harmony downloads page</a>.
There are source and binary downloads available for people to
evaluate and experiment with the code. As always, please report bugs
(and successes!) to the <a href="mailing.html">Harmony developers mailing list</a>.
(<i>2006-05-12</i>)
- </p>
- </dd>
-
+ </dd>
<dt>DRL Virtual Machine Contribution</dt>
- <dd>
- <p>
- On May 3rd, 2006 the Apache Harmony project received a
+ <dd> On May 3rd, 2006 the Apache Harmony project received a
<a href="http://issues.apache.org/jira/browse/HARMONY-438">
substantial contribution </a> of virtual machine (VM) code into the project,
containing a JIT, core VM, GC, bytecode verifier, etc. This was contributed by
Andrey Chernyshev on behalf of Intel Corp. The full announcement can
be found on the <a href="mailing.html">Harmony developers mailing list</a>.
- (<i>2006-05-03</i>)
- </p>
- </dd>
-
+ (<i>2006-05-03</i>)</dd>
<dt>Java Security Code Contribution</dt>
- <dd>
- <p>
- On December 30th, 2005 the Apache Harmony project accepted additional
+ <dd>On December 30th, 2005 the Apache Harmony project accepted additional
class library code into the project. The code had been contributed by
Mikhail Loenko on behalf of Intel corp. The new class library code
includes security, cryptography, javax.net and unit tests. Thanks to
Mikhail and his collegues in the Intel Managed Runtime Division!
(<i>2006-01-16</i>)
- </p>
</dd>
-
<dt>VM Interface and Core Classes Contribution</dt>
- <dd>
- <p>
- IBM has offered the Apache Harmony project a set of core
+ <dd>IBM has offered the Apache Harmony project a set of core
Java classes and an implementation of a VM/class library
- interface. Tim Ellison wrote:
- </p>
- <p>
+ interface. Tim Ellison wrote:<br />
<i>
- I'm delighted to be able to make a code contribution to the
+ "I'm delighted to be able to make a code contribution to the
Harmony project on behalf of IBM. The code comprises a concrete implementation
of the interface between virtual machine and class library that we have
- been discussing recently, together with a set of core Java classes.
- </i>
- </p>
- <p>
+ been discussing recently, together with a set of core Java classes."
+ </i><br />
This contribution is sufficient to run Ant and the Eclipse Java
compiler, to provide a basic self-hosting environment. IBM also
made a version of their J9 VM
<a href="http://www.ibm.com/developerworks/java/jdk/harmony">
available </a> for use by the project in evaluating this contribution.
Thanks Tim and IBM :) (<i>2005-11-08</i>)
- </p>
</dd>
-
<dt>"Bootstrap JVM" Contributed to Apache Harmony</dt>
- <dd>
- <p>
- Daniel Lydickto the Harmony project of a basic Java Virtual Machine entitled
+ <dd> Daniel Lydickto the Harmony project of a basic Java Virtual Machine entitled
the "Apache Harmony Bootstrap JVM." Dan offered the VM with the following goals in mind:
<ul>
<li>Basic platform for learning about VMs</li>
@@ -190,24 +132,15 @@
<li>Help spur architectural discussion about core component designs</li>
</ul>
Thanks Dan! (<i>2005-09-30</i>)
- </p>
</dd>
-
<dt>Source for JCVM Contributed to Apache Harmony</dt>
- <dd>
- <p>
- Archie Cobbs has offered for contribution to the Apache Harmony project
+ <dd>Archie Cobbs has offered for contribution to the Apache Harmony project
a copy of the <a href="http://jcvm.sourceforge.net/">JCVM</a> codebase. Come and
help us build on this interesting VM. Thanks Archie! (<i>2005-09-25</i>)
- </p>
</dd>
-
<dt>Project accepted by Apache Incubator</dt>
- <dd>
- <p>
- The Apache Harmony project was accepted formally accepted for
+ <dd>The Apache Harmony project was accepted formally accepted for
inubation by the Apache Incubator PMC. (<i>2005-05-18</i>)
- </p>
</dd>
</dl>
</section>
Modified: harmony/standard/site/xdocs/quickhelp_users.xml
URL: http://svn.apache.org/viewvc/harmony/standard/site/xdocs/quickhelp_users.xml?view=diff&rev=519951&r1=519950&r2=519951
==============================================================================
--- harmony/standard/site/xdocs/quickhelp_users.xml (original)
+++ harmony/standard/site/xdocs/quickhelp_users.xml Mon Mar 19 07:12:06 2007
@@ -20,13 +20,13 @@
<document>
<properties>
- <title>Getting Started For Users</title>
- <author email="dev@harmony.apache.org">Harmony Documentation Team</author>
+ <title>Getting Started For Users</title>
+ <author email="dev@harmony.apache.org">Harmony Documentation Team</author>
</properties>
<body>
- <section name="Getting Started For Users">
+ <section name="Getting Started For Users">
<p>
The current document provides basic instructions for people that
@@ -38,8 +38,7 @@
For more information on how to get you machine configured to build and
work with the Apache Harmony source code, refer to
<a href="quickhelp_contributors.html">
- Getting Started For Contributors
- </a>.
+ Getting Started For Contributors</a>.
</p>
<p>
The required dependencies are listed below per platform.
@@ -72,40 +71,32 @@
directory. Further in the document we refer to this directory
as the <i>root directory</i> of the distribution.
</p>
+<dl>
+ <dt>Linux Users</dt>
- <strong>Linux Users</strong>
-
- <p>
+ <dd>
Use the <code>tar</code> program as follows:
- </p>
-
- <source>
-$ tar -tzf latest-harmony-jre-linux.tar.gz
- </source>
-
- <p>
+<pre>$ tar -tzf latest-harmony-jre-linux.tar.gz</pre>
+</dd>
+ <dd>
This will unpack the JRE directory tree into the current directory.
- </p>
-
- <strong>Windows Users</strong>
-
- <p>
+ </dd>
+ <dt>Windows Users</dt>
+ <dd>
Use one of <code>zip</code> utilities available for Windows to
unpack the distribution. The three popular ones are listed
below, but anything that can handle a <code>zip</code> file
will work:
- </p>
-
<ul>
<li><a href="http://www.info-zip.org/">Info-ZIP</a>
(open source software)</li>
<li><a href="http://www.7-zip.org/">7-Zip</a> (free software)</li>
<li><a href="http://www.winzip.com/">Winzip</a> (commercial)</li>
- </ul>
- <p>
+ </ul></dd>
+ <dd>
To create the JRE directory tree, extract the
distribution <code>zip</code> file using the utility.
- </p>
+ </dd></dl>
</subsection>
<subsection name="Configuring Your Environment">
@@ -114,68 +105,49 @@
sometimes other programs do. Also, it is convenient to have
the Apache Harmony executables on your path.
</p>
-
<p>
To set your <code>JAVA_HOME</code> and <code>PATH</code>
environment variables, use the commands appropriate to your
operating system and/or shell you are using.
</p>
-
- <strong>
- Linux Users</strong>
-
- <p>
+<dl>
+ <dt>
+ Linux Users</dt>
+ <dd>
The following command works for the Bash shell:
- </p>
-
- <source>
-$ cd jre
+<pre>$ cd jre
$ export JAVA_HOME=`pwd`
$ cd bin
-$ export PATH=`pwd`:$PATH
- </source>
-
- <p>
+$ export PATH=`pwd`:$PATH</pre>
+</dd>
+ <dd>
The given command assumes your current directory is the parent
directory of the Harmony JRE.
- </p>
+ </dd>
<p class="note">Note</p>
<p class="notetext">The <code>`</code> character is a backtick character,
not an apostrophe.</p>
-
- <strong>Windows Users</strong>
-
- <p>
+ <dt>Windows Users</dt>
+ <dd>
The following example assumes you unpacked the <code>zip</code>
file into the root directory <code>C:\</code>.
Please adjust as necessary.
- </p>
-
- <source>
- C:> cd jre
- C:\jre>set JAVA_HOME=C:\jre
- C:\jre> cd bin
- C:\jre\bin> set PATH=C:\jre\bin;%PATH%
- </source>
-
-
+<pre>C:> cd jre
+C:\jre>set JAVA_HOME=C:\jre
+C:\jre> cd bin
+C:\jre\bin> set PATH=C:\jre\bin;%PATH%</pre>
+</dd>
+ </dl>
</subsection>
-
<subsection name="Using Apache Harmony">
-
<p>
After performing aforementioned steps, you should be ready to use
Apache Harmony. Note that we have not yet included
<code>javac</code>, so continue to use the compiler from some
other JRE. You should have no problems running programs.
</p>
-
- <source>
-$ java Foo
-$ java -jar myjar.jar
- </source>
-
-
+<pre>$ java Foo
+$ java -jar myjar.jar</pre>
</subsection>
</section>
</body>
Modified: harmony/standard/site/xdocs/related.xml
URL: http://svn.apache.org/viewvc/harmony/standard/site/xdocs/related.xml?view=diff&rev=519951&r1=519950&r2=519951
==============================================================================
--- harmony/standard/site/xdocs/related.xml (original)
+++ harmony/standard/site/xdocs/related.xml Mon Mar 19 07:12:06 2007
@@ -1,12 +1,11 @@
<?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
+ 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
@@ -16,7 +15,7 @@
See the License for the specific language governing permissions and
limitations under the License.
-->
-
+
<document>
<properties>
@@ -30,25 +29,22 @@
<p>
Besides our own DRLVM virtual machine, there are also other virtual
- machines that work with the Apache Harmony classlibrary :
+ machines that work with the Apache Harmony class library:
</p>
<ul>
- <li><a href="http://www.ibm.com/developerworks/java/jdk/harmony/">IBM J9</a> : IBM has
+ <li><a href="http://www.ibm.com/developerworks/java/jdk/harmony/">IBM J9</a>: IBM has
made their production-grade virtual machine available for project use under
- a non-open source, evaluation binary license. This VM works with the Harmony
+ a non-open source, evaluation binary license. This VM works with the Harmony
class library.
</li>
- <li><a href="http://dev2dev.bea.com/jrockit/jrockitVM/">BEA JRockit</a> : BEA has
+ <li><a href="http://dev2dev.bea.com/jrockit/jrockitVM/">BEA JRockit</a>: BEA has
made their production-grade virtual machine available for project use under
- a non-open source, evaluation binary license. This VM works with the Harmony
+ a non-open source, evaluation binary license. This VM works with the Harmony
class library.
</li>
</ul>
-
</section>
-
-
<section name="Other Projects">
<p>
@@ -72,4 +68,4 @@
</body>
</document>
-
+
Modified: harmony/standard/site/xdocs/roadmap.xml
URL: http://svn.apache.org/viewvc/harmony/standard/site/xdocs/roadmap.xml?view=diff&rev=519951&r1=519950&r2=519951
==============================================================================
--- harmony/standard/site/xdocs/roadmap.xml (original)
+++ harmony/standard/site/xdocs/roadmap.xml Mon Mar 19 07:12:06 2007
@@ -1,12 +1,11 @@
<?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
+ 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
@@ -29,12 +28,12 @@
<p>
Are roadmap and goals are always subject to discussion on the
- <a href="mailing.html">developer's list.</a> As new people join with new focus and
+ <a href="mailing.html">developer's list.</a> As new people join with new focus and
interests, the things we do as a project adapt.
</p>
<p>
- If you have an idea, come join the community and talk about it. Note that you will
+ If you have an idea, come join the community and talk about it. Note that you will
need to subscribe to the <a href="mailing.html">mail list</a>
</p>
@@ -44,7 +43,7 @@
<p>
Our project goal is an open source, compatible implementation of Java SE 5.
- It's a major task being done by a community of volunteers. Thus, the following
+ It's a major task being done by a community of volunteers. Thus, the following
is an approximate roadmap for what the project hopes to achieve in the next year.
</p>
<ul>
@@ -120,9 +119,9 @@
Q4 2007: Apache Harmony SE 6 JDK and JRE released
</li>
<li>
- Q? 2008: Apache Harmony SE 7 JDK and JRE released. Note: The Java SE 7
- JSR has not yet been proposed by Sun. We assume 18
- months from start of JSR to completion. We hope to
+ Q? 2008: Apache Harmony SE 7 JDK and JRE released. Note: The Java SE 7
+ JSR has not yet been proposed by Sun. We assume 18
+ months from start of JSR to completion. We hope to
deliver Harmony's implementation of Java SE 7 at the
same time Sun does.
</li>
@@ -133,7 +132,7 @@
<p>
The following is a collection of things that the project community
- has listed as needing to be done. This list is not exhaustive. If
+ has listed as needing to be done. This list is not exhaustive. If
you wish to add an item to this list, or discuss or even volunteer
to work on an item, please join us on the <a href="mailing.html">
Harmony
@@ -180,34 +179,33 @@
<p>
As part of the JDK that Harmony will distribute, we'll include
the full set of tools that Java programmers expect to find in
- any JDK. For maximum portablility, we plan to write all of the
+ any JDK. For maximum portablility, we plan to write all of the
tools in Java, using the Harmony launcher as the portable native
- code that starts the VM and invokes the tool. Currently, we have
+ code that starts the VM and invokes the tool. Currently, we have
javac completed via the Eclipse compiler, but we need the following:
</p>
<ul>
<li>
- javac (Done), javadoc, apt, appletviewer, jar, jdb, javah, javap, extcheck
- </li>
- <li>
- keytool, jarsigner, policytool, kinit, klist, ktab
- </li>
- <li>
- native2ascii,rmic, rmiregistry, rmid, serialver
- </li>
- <li>
- tnameserv, idlj, orbd, servertool
- </li>
- <li>
- pack200, unpack200
- </li>
- <li>
- htmlconverter, javaws
+ <code>javac (Done), javadoc, apt, appletviewer, jar, jdb, javah, javap, extcheck</code>
+ </li>
+ <li>
+ <code>keytool, jarsigner, policytool, kinit, klist, ktab</code>
+ </li>
+ <li>
+ <code>native2ascii,rmic, rmiregistry, rmid, serialver</code>
+ </li>
+ <li>
+ <code>tnameserv, idlj, orbd, servertool</code>
+ </li>
+ <li>
+ <code>pack200, unpack200</code>
+ </li>
+ <li>
+ <code>htmlconverter, javaws</code>
</li>
</ul>
-
- <p>
+ <p>
Again, we have the portable launcher framework - we just need volunteers.
</p>
@@ -215,7 +213,7 @@
<h3>2. Modularity</h3>
<p>
From the beginning of our project, we've had a strong interest and focus
- on modularity This dedication has paid off in our class library development,
+ on modularity. This dedication has paid off in our class library development,
as we've been able to evaluate competing implementations of RMI and math, as
well as allow developers to isolate development on one module.
</p>
@@ -227,29 +225,27 @@
goal being able to define a set of standard interfaces to which modular
VM components can be written.
</p>
-
</subsection>
<subsection name="Build Engineering">
<p>
Build engineering in Harmony is a complicated subject, as we are building
- on multiple platforms in multiple languages. So far, we have support for
+ on multiple platforms in multiple languages. So far, we have support for
our Windows and Linux ports, but our porting plans indiciate that we'll need
- to revisit given the differnet toolchains. There are many things to do
+ to revisit given the differnet toolchains. There are many things to do
in this area, many not listed.
</p>
-
<p>
Currently, the project has been releasing snapshots of our class library,
but now that we have the DRLVM virtual machine, we can start doing complete
- snapshot builds of a JRE, as well as the HDK
+ snapshot builds of a JRE, as well as the HDK.
</p>
<ul>
<li>
Switch to use system libraries, dynamically where appropriate
- - libz, libpng, libjpeg, liblcms, libicu*, etc.
+ - <code>libz, libpng, libjpeg, liblcms, libicu*,</code> etc.
</li>
<li>
Create regular schedule for snapshots and automate.
@@ -276,7 +272,7 @@
</li>
<li>
Remove assumption in class library build system that all that uses make is
- linux.
+ Linux.
</li>
</ul>
</subsection>
@@ -290,20 +286,17 @@
</p>
<p>
- There is an
- <a href="http://svn.apache.org/viewvc/harmony/enhanced/buildtest/">
- initial implementation
- </a> in place in SVN, but much more work is needed.
+ There is an <a href="http://svn.apache.org/viewvc/harmony/enhanced/buildtest/">
+ initial implementation</a> in place in SVN, but much more work is needed.
Ideas include:
</p>
-
<ul>
<li>
Send mail to project on success/fail transition
</li>
<li>
Create live "status dashboard" with a summary of results from all tested platforms,
- as wella s history for each tested platform.
+ as well as history for each tested platform.
</li>
<li>
Integrate with <a href="http://www.kaffe.org/~stuart/japi/">JAPI</a>
@@ -313,8 +306,8 @@
class library testing
</li>
<li>
- Integrate with test-coverage tool (ex <a href="http://emma.sourceforge.net/">emma</a>
- for auto-generated reports.
+ Integrate with test-coverage tool (for example, <a href="http://emma.sourceforge.net/">emma</a>
+ for auto-generated reports).
</li>
<li>
Externalize local properties into a 'test.properties' file for easy of localization.
@@ -352,28 +345,27 @@
<p>
The class library is an important (and large!) part of the Java SE
- platform. While we have made significant progress so far (~80% at last
- check), there are many, many interesting things remaining to be done
+ platform. While we have made significant progress so far (~80% at last
+ check), there are many, many interesting things remaining to be done.
</p>
-
<ul>
<li>
<a href="subcomponents/classlibrary/status.html">General package completion</a>
</li>
<li>
- java.util.concurrency: integration of Doug Lea's RI package. Goal is to
+ <code>java.util.concurrency</code>: integration of Doug Lea's RI package. Goal is to
use unmodified code from the 166 expert group and implent whatever
- support is needed by the VM and rest of class library. (in progress)
+ support is needed by the VM and rest of class library. (<i>in progress</i>)
</li>
<li>
CORBA: re-use the Apache Yoko project (currently in incubator)
as the required implementation of CORBA nad related support
- classes (in progress)
+ classes (<i>in progress</i>)
</li>
<li>
JMX: currently we have the standard MX4J jars integrated, but
looking to see what kind of collaboration or unification we can
- achieve with the MX4J project. (in progress)
+ achieve with the MX4J project. (<i>in progress</i>)
</li>
<li>
Test coverage - we need to greatly increase our unit tests (functionaly,
@@ -384,9 +376,8 @@
<subsection name="DRLVM">
<p>
- VM is a critical part of the Java SE platform. As usual, there are many, many interesting things remaining to be done
- </p>
-
+ VM is a critical part of the Java SE platform. As usual, there are many, many interesting
+ things remaining to be done.</p>
<ul>
<li>
<a href="http://wiki.apache.org/harmony/CoreVmDevelopmentItems">Core VM Development Items</a>
@@ -415,7 +406,7 @@
<p>
Another motivation of the Harmony project is to provide a
portable implementation that is available on many
- platforms and operating systems. Currently, our interests
+ platforms and operating systems. Currently, our interests
are:
</p>
<table>
@@ -495,16 +486,12 @@
</table>
<p>
<b>Legend</b>
- <dl>
- <dt>"+"</dt>
- <dd>Supported (sure-to-work)</dd>
- <dt>"?"</dt>
- <dd>In progress</dd>
- <dt>"-"</dt>
- <dd>Will Not Support</dd>
- <dt>" " (empty)</dt>
- <dd>N/A or Maybe</dd>
- </dl>
+ <ul>
+ <li>"+" - Supported (sure-to-work)</li>
+ <li>"?" - In progress</li>
+ <li>"-" - Will Not Support</li>
+ <li>" " (empty) - N/A or Maybe</li>
+ </ul>
</p>
</subsection>
@@ -513,10 +500,10 @@
As we now have a fairly usable class library and virtual machine, we wish to
make it easy for the broad Java user community to help us ensure that
the Harmony class library supports the classes necessary for the most popular
- and used applications out there. While we will complete the class library,
+ and used applications out there. While we will complete the class library,
tools like this will help us do it in a way that prioritizes the most useful
first, enabling even more users to test our software and participate in
- the project. So far, there have been a few tools donated, but no concerted
+ the project. So far, there have been a few tools donated, but no concerted
effort to package for ease of use.
</p>
@@ -528,8 +515,7 @@
</li>
<li>
<a href="https://issues.apache.org/jira/browse/HARMONY-565">
- Harmony-565
- </a> - another tool for reporting class coverage for applications
+ Harmony-565</a> - another tool for reporting class coverage for applications
</li>
</ul>
</subsection>
@@ -538,6 +524,7 @@
</body>
</document>
+
Modified: harmony/standard/site/xdocs/sitemap.xml
URL: http://svn.apache.org/viewvc/harmony/standard/site/xdocs/sitemap.xml?view=diff&rev=519951&r1=519950&r2=519951
==============================================================================
--- harmony/standard/site/xdocs/sitemap.xml (original)
+++ harmony/standard/site/xdocs/sitemap.xml Mon Mar 19 07:12:06 2007
@@ -218,39 +218,32 @@
</a> - documentation links specific to DRLVM effort
underway at Apache Harmony
</p>
- <p>
- <strong>
- Developing and Building the Code Documentation
- </strong>
- </p>
- <p>
+ <dl>
+ <dt>Developing and Building the Code Documentation</dt>
+ <dd>
<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">
+ </dd>
+ <dd><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>
+ </dd>
+ <dd>
<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>
+ </dd>
+ <dt>Architecture and Component Documentation</dt>
+ <dd>
<a href="subcomponents/drlvm/developers_guide.html">
DRLVM Developer's Guide
</a> - in-depth description of the DRLVM
internal architecture and components' interaction
- </p>
+ </dd>
<ul>
<li>
@@ -299,6 +292,7 @@
</li>
</ul>
+
</li>
<li>
@@ -306,7 +300,6 @@
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>
@@ -325,30 +318,27 @@
</li>
</ul>
- <p>
+ <dd>
<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>
+ </dd>
- <p>
- <strong>How-tos and Guides</strong>
- </p>
- <p>
-
+ <dt>How-tos and Guides</dt>
+ <dd>
<a href="subcomponents/drlvm/emguide.html">
Configuring Execution Manager
</a> - guide to Execution Manager (EM)
options and configuration file format
- </p>
+ </dd>
- <p>
+ <dd>
<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>
-
+ </dd>
+</dl>
</subsection>
<subsection name="Class Library">
@@ -364,80 +354,75 @@
</a> - comparisons of JDK 1.4 and JDK 1.5. against
the Harmony class library snapshots
</p>
-
- <p>
- <strong>
- Project Conventions
- </strong>
- </p>
- <p>
+<dl>
+ <dt>Project Conventions</dt>
+ <dd>
<a href="subcomponents/classlibrary/pkgnaming.html">
Class Library Package Naming Conventions
</a> - the package naming conventions used in the Apache Harmony Class Library
- </p>
+ </dd>
- <p>
+ <dd>
<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>
+ </dd>
+ <dd>
<a href="subcomponents/classlibrary/compat.html">
Compatibility Guidelines</a> - compatibility goals in the Apache Harmony Class Library
- </p>
- <p>
+ </dd>
+ <dd>
<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>
+ </dd>
+ <dt>Architecture and Guides Documentation</dt>
+ <dd>
<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>
+ </dd>
+ <dd>
<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>
+ </dd>
+ <dd>
<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>
+ </dd>
+ <dd>
<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>
+ </dd>
+ <dd>
<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>
+ </dd>
+ <dd>
<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>
+ including details on the provider design</dd>
+ </dl>
</subsection>
</section>
</body>
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=519951&r1=519950&r2=519951
==============================================================================
--- harmony/standard/site/xdocs/subcomponents/classlibrary/ASN1Framework.html (original)
+++ harmony/standard/site/xdocs/subcomponents/classlibrary/ASN1Framework.html Mon Mar 19 07:12:06 2007
@@ -319,197 +319,199 @@
</p>
<table cellspacing="0" cellpadding="0" align="center" width="60%">
<tr>
- <th class="TableHeading" colspan="2">
+ <th class="TableHeading">
+ </th>
+ <th class="TableHeading">
ASN.1 Type
</th>
- <th class="TableHeading" style="text-align: center" width="25%">
+ <th class="TableHeading">
Java<a href="#*">*</a> Type
</th>
- <th class="TableHeading" width="30%">
+ <th class="TableHeading">
Framework Class
</th>
</tr>
<tr>
- <th class="TableHeading" rowspan="5" width="11%">
+ <th class="TableHeading" rowspan="5">
<a id="Primitive" name="Primitive">Primitive</a>
- </td>
+ </th>
</tr>
<tr>
- <td width="30%">
+ <td class="TableCell" width="30%">
<code>INTEGER</code>
</td>
- <td align="center" width="25%">
+ <td class="TableCell" align="center" width="25%">
<code>byte[]</code>
</td>
- <td width="25%">
+ <td class="TableCell" width="25%">
<code><a href="#ASN1Integer">ASN1Integer</a></code>
</td>
</tr>
<tr>
- <td width="30%">
+ <td class="TableCell" width="30%">
<code>ENUMERATED</code>
</td>
- <td align="center" width="25%">
+ <td class="TableCell" align="center" width="25%">
<code>byte[]</code>
</td>
- <td width="30%">
+ <td class="TableCell" width="30%">
<code><a href="#ASN1Enumerated">ASN1Enumerated</a></code>
</td>
</tr>
<tr>
- <td width="30%">
+ <td class="TableCell" width="30%">
<code>OBJECT IDENTIFIER</code>
</td>
- <td align="center" width="25%">
+ <td class="TableCell" align="center" width="25%">
<code>int[]</code>
</td>
- <td width="30%">
+ <td class="TableCell" width="30%">
<code><a href="#ASN1Oid">ASN1Oid</a></code>
</td>
</tr>
<tr>
- <td width="30%">
+ <td class="TableCell" width="30%">
<code>BOOLEAN</code>
</td>
- <td align="center" width="25%">
+ <td class="TableCell" align="center" width="25%">
<code>java.lang.Boolean</code>
</td>
- <td width="30%">
+ <td class="TableCell" width="30%">
<code><a href="#ASN1Boolean">ASN1Boolean</a></code>
</td>
</tr>
<tr>
- <th class="TableHeading" rowspan="12" width="11%">
+ <th class="TableHeading" rowspan="12">
<a id="String" name="String">String</a>
</th>
- <td width="30%">
+ <td class="TableCell" width="30%">
<code>BitString</code>
</td>
- <td align="center" width="25%">
+ <td class="TableCell" align="center" width="25%">
<code>asn1.BitString</code>
</td>
- <td width="30%">
+ <td class="TableCell" width="30%">
<code><a href="#ASN1BitString">ASN1BitString</a></code>
</td>
</tr>
<tr>
- <td width="30%">
+ <td class="TableCell" width="30%">
<code>OctetString</code>
</td>
- <td align="center" width="25%">
+ <td class="TableCell" align="center" width="25%">
<code>byte[]</code>
</td>
- <td width="30%">
+ <td class="TableCell" width="30%">
<code><a href="#ASN1OctetString">ASN1OctetString</a></code>
</td>
</tr>
<tr>
- <td width="30%">
+ <td class="TableCell" width="30%">
<code>PrintableString</code>
</td>
- <td align="center" width="25%">
+ <td class="TableCell" align="center" width="25%">
<code>java.lang.String</code>
</td>
- <td width="30%">
+ <td class="TableCell" width="30%">
<code><a href="#ASN1StringType">ASN1StringType</a></code>
</td>
</tr>
<tr>
- <td width="30%">
+ <td class="TableCell" width="30%">
<code>T61String</code>
</td>
- <td align="center" width="25%">
+ <td class="TableCell" align="center" width="25%">
<code>java.lang.String</code>
</td>
- <td width="30%">
+ <td class="TableCell" width="30%">
<code><a href="#ASN1StringType">ASN1StringType</a></code>
</td>
</tr>
<tr>
- <td width="30%">
+ <td class="TableCell" width="30%">
<code>IA5String</code>
</td>
- <td align="center" width="25%">
+ <td class="TableCell" align="center" width="25%">
<code>java.lang.String</code>
</td>
- <td width="30%">
+ <td class="TableCell" width="30%">
<code><a href="#ASN1StringType">ASN1StringType</a></code>
</td>
</tr>
<tr>
- <td width="30%">
+ <td class="TableCell" width="30%">
<code>UTF8String</code>
</td>
- <td align="center" width="25%">
+ <td class="TableCell" align="center" width="25%">
<code>java.lang.String</code>
</td>
- <td width="30%">
+ <td class="TableCell" width="30%">
<code><a href="#ASN1StringType">ASN1StringType</a></code>
</td>
</tr>
<tr>
- <td width="30%">
+ <td class="TableCell" width="30%">
<code>BMPString</code>
</td>
- <td align="center" width="25%">
+ <td class="TableCell" align="center" width="25%">
<code>java.lang.String</code>
</td>
- <td width="30%">
+ <td class="TableCell" width="30%">
<code><a href="#ASN1StringType">ASN1StringType</a></code>
</td>
</tr>
<tr>
- <td width="30%">
+ <td class="TableCell" width="30%">
<code>GeneralString</code>
</td>
- <td align="center" width="25%">
+ <td class="TableCell" align="center" width="25%">
<code>java.lang.String</code>
</td>
- <td width="30%">
+ <td class="TableCell" width="30%">
<code><a href="#ASN1StringType">ASN1StringType</a></code>
</td>
</tr>
<tr>
- <td width="30%">
+ <td class="TableCell" width="30%">
<code>TeletexString</code>
</td>
- <td align="center" width="25%">
+ <td class="TableCell" align="center" width="25%">
<code>java.lang.String</code>
</td>
- <td width="30%">
+ <td class="TableCell" width="30%">
<code><a href="#ASN1StringType">ASN1StringType</a></code>
</td>
</tr>
<tr>
- <td width="30%">
+ <td class="TableCell" width="30%">
<code>UniversalString</code>
</td>
- <td align="center" width="25%">
+ <td class="TableCell" align="center" width="25%">
<code>java.lang.String</code>
</td>
- <td width="30%">
+ <td class="TableCell" width="30%">
<code><a href="#ASN1StringType">ASN1StringType</a></code>
</td>
</tr>
<tr>
- <td width="30%">
+ <td class="TableCell" width="30%">
<code>UTCTime</code>
</td>
- <td align="center" width="25%">
+ <td class="TableCell" align="center" width="25%">
<code>java.util.Date</code>
</td>
- <td width="30%">
+ <td class="TableCell" width="30%">
<code><a href="#ASN1UTCTime">ASN1UTCTime</a></code>
</td>
</tr>
<tr>
- <td width="30%">
+ <td class="TableCell" width="30%">
<code>GeneralizedTime</code>
</td>
- <td align="center" width="25%">
+ <td class="TableCell" align="center" width="25%">
<code>java.util.Date</code>
</td>
- <td width="30%">
+ <td class="TableCell" width="30%">
<code><a href="#ASN1UTCTime">ASN1GeneralizedTime</a></code>
</td>
</tr>
@@ -517,35 +519,35 @@
<th rowspan="3" class="TableHeading">
<a id="Constructed" name="Constructed">Constructed</a>
</th>
- <td width="30%">
+ <td class="TableCell" width="30%">
<code>SEQUENCE</code>
</td>
- <td align="center" width="25%">
+ <td class="TableCell" align="center" width="25%">
<code>Object[]</code>
</td>
- <td width="30%">
+ <td class="TableCell" width="30%">
<code><a href="#ASN1Sequence">ASN1Sequence</a></code>
</td>
</tr>
<tr>
- <td width="30%">
+ <td class="TableCell" width="30%">
<code>SEQUENCE OF</code>
</td>
- <td align="center" width="25%">
+ <td class="TableCell" align="center" width="25%">
<code>java.util.List</code>
</td>
- <td width="30%">
+ <td class="TableCell" width="30%">
<code><a href="#ASN1SequenceOf">ASN1SequenceOf</a></code>
</td>
</tr>
<tr>
- <td width="30%">
+ <td class="TableCell" width="30%">
<code>SET OF</code>
</td>
- <td width="25%" align="center">
+ <td class="TableCell" width="25%" align="center">
<code>java.util.List</code>
</td>
- <td width="30%">
+ <td class="TableCell" width="30%">
<code><a href="#ASN1SetOf">ASN1SetOf</a></code>
</td>
</tr>
@@ -553,24 +555,24 @@
<th rowspan="2" width="11%" class="TableHeading">
<a id="Tagged" name="Tagged">Tagged</a>
</th>
- <td width="30%">
+ <td class="TableCell" width="30%">
<code>EXPLICIT</code>
</td>
- <td width="25%" style="text-align: center">
+ <td class="TableCell" width="25%" style="text-align: center">
<i>based type</i>
</td>
- <td width="30%">
+ <td class="TableCell" width="30%">
<a href="#ASN1Explicit"><code>ASN1Explicit</code></a>
</td>
</tr>
<tr>
- <td width="30%">
+ <td class="TableCell" width="30%">
<code>IMPLICIT</code>
</td>
- <td align="center" width="25%" style="text-align: center">
+ <td class="TableCell" align="center" width="25%" style="text-align: center">
<i>based type</i>
</td>
- <td width="30%">
+ <td class="TableCell" width="30%">
<a href="#Class_ASNImplicit"><code>ASN1Implicit</code></a>
</td>
</tr>
@@ -578,24 +580,24 @@
<th rowspan="2" width="11%" class="TableHeading">
<a id="Other" name="Other">Other</a>
</th>
- <td width="30%">
+ <td class="TableCell" width="30%">
<code>ANY</code>
</td>
- <td align="center" width="25%">
+ <td class="TableCell" align="center" width="25%">
<code>byte[]</code>
</td>
- <td width="30%">
+ <td class="TableCell" width="30%">
<code><a href="#Class_ASNAny">ASN1Any</a></code>
</td>
</tr>
<tr>
- <td width="30%">
+ <td class="TableCell" width="30%">
<code>CHOICE</code>
</td>
- <td align="center" width="25%" style="text-align: center">
+ <td class="TableCell" align="center" width="25%" style="text-align: center">
<i>one of chosen types</i>
</td>
- <td width="30%">
+ <td class="TableCell" width="30%">
<code><a href="#Class_ASNChoice">ASN1Choice</a></code>
</td>
</tr>
@@ -1216,5 +1218,6 @@
</p>
</body>
</html>
+
Modified: harmony/standard/site/xdocs/subcomponents/classlibrary/AWT.html
URL: http://svn.apache.org/viewvc/harmony/standard/site/xdocs/subcomponents/classlibrary/AWT.html?view=diff&rev=519951&r1=519950&r2=519951
==============================================================================
--- harmony/standard/site/xdocs/subcomponents/classlibrary/AWT.html (original)
+++ harmony/standard/site/xdocs/subcomponents/classlibrary/AWT.html Mon Mar 19 07:12:06 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
@@ -372,14 +372,14 @@
name="Native_Event_classification"></a>Native Events Classification
</p>
<p>
- Figure 3 below demonstrates how native events can be classified by
+ Figure 2 below demonstrates how native events can be classified by
their role in the AWT framework.
</p>
<p style="text-align: center">
<img alt="Native events: 4 subtypes" src="images/NativeEventCL.gif" />
</p>
<p class="special">
- Figure 3: Native Events Classification
+ Figure 2: Native Events Classification
</p>
<ul>
<li>
@@ -413,7 +413,7 @@
package. The platform-dependent and platform-independent levels
cooperate via three main interfaces of this
package: <code>NativeEventListener</code>, <code>NativeEvent</code>,
- and <code>NativeEventQueue</code>, as shown in Figure 2. Classes
+ and <code>NativeEventQueue</code>, as shown in Figure 3. Classes
implementing the <code>NativeEvent</code>
and <code>NativeEventQueue</code> interfaces are platform-specific.
For example, the <code>NativeEvent</code> interface is implemented by
@@ -427,11 +427,9 @@
src="images/ImplementationDetails.gif" />
</p>
<p class="special">
- Figure 2: Interfaces for Abstracting the Native Platform
- </p>
- <p>
-
+ Figure 3: Interfaces for Abstracting the Native Platform
</p>
+
<p>
Classes of the <code>NativeEvent</code> interface convert information
about native events to a platform-independent format.
@@ -1495,6 +1493,7 @@
</p>
</body>
</html>
+
Modified: harmony/standard/site/xdocs/subcomponents/classlibrary/agreements.xml
URL: http://svn.apache.org/viewvc/harmony/standard/site/xdocs/subcomponents/classlibrary/agreements.xml?view=diff&rev=519951&r1=519950&r2=519951
==============================================================================
--- harmony/standard/site/xdocs/subcomponents/classlibrary/agreements.xml (original)
+++ harmony/standard/site/xdocs/subcomponents/classlibrary/agreements.xml Mon Mar 19 07:12:06 2007
@@ -1,13 +1,12 @@
<?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
+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
@@ -30,133 +29,140 @@
<section name="Harmony developer agreements and recommendations">
<p>
<big><em>The summary of agreements and recommendations that were
- discussed on the development mailing list <code>dev@harmony.apache.org</code>.
+ discussed on the development mailing list <code>dev@harmony.apache.org</code>.
Please feel free to send your comments and questions there.</em></big>
</p>
<subsection name="Development">
<ul>
- <li>serialVersionUID MUST be explicitly specified for each Serializable class to provide compatibility
- (<a href="http://mail-archives.apache.org/mod_mbox/harmony-dev/200601.mbox/%3c906dd82e0601190059x3162c6c6u533928579c226572@mail.gmail.com%3e">
- [classlib] serialVersionUIDs for Serializable classes</a>)
+ <li><code>serialVersionUID</code> MUST be explicitly specified for each Serializable class to
+ provide compatibility.<br />
+ <a href="http://mail-archives.apache.org/mod_mbox/harmony-dev/200601.mbox/%3c906dd82e0601190059x3162c6c6u533928579c226572@mail.gmail.com%3e">
+ [classlib] serialVersionUIDs for Serializable classes</a>
</li>
- <li>Exception messages MUST be internationalized
- (<a href="http://mail-archives.apache.org/mod_mbox/harmony-dev/200604.mbox/%3c44478DC3.4070206@gmail.com%3e">
- Internationalized messages</a>)
+ <li>Exception messages MUST be internationalized.<br />
+ <a href="http://mail-archives.apache.org/mod_mbox/harmony-dev/200604.mbox/%3c44478DC3.4070206@gmail.com%3e">
+ Internationalized messages</a>
</li>
- <li>A golden ticket MUST be acquired to update java.lang.String class
- (<a href="http://mail-archives.apache.org/mod_mbox/harmony-dev/200604.mbox/%3c444788A0.6000102@gmail.com%3e">
- [classlib] String is special</a>)
+ <li>A golden ticket MUST be acquired to update the <code>java.lang.String</code> class.<br />
+ <a href="http://mail-archives.apache.org/mod_mbox/harmony-dev/200604.mbox/%3c444788A0.6000102@gmail.com%3e">
+ [classlib] String is special
+ </a>
</li>
- <li>Mark deprecated stuff with @deprecated keyword
- (<a href="http://mail-archives.apache.org/mod_mbox/harmony-dev/200603.mbox/%3c4405BE70.1020307@gmail.com%3e">
- deprecated methods , javadocs</a>)
- </li>
+ <li>Mark deprecated stuff with <code>@deprecated</code> keyword.<br />
+ <a href="http://mail-archives.apache.org/mod_mbox/harmony-dev/200603.mbox/%3c4405BE70.1020307@gmail.com%3e">
+ deprecated methods, javadocs</a>
+</li>
- <li>Error messages should contain helpfull information
- (<a href="http://mail-archives.apache.org/mod_mbox/harmony-dev/200603.mbox/%3cfcb9f9160603240835i792de7dobabfc43a44e7c752@mail.gmail.com%3e">
- More helpful error messages</a>)
+<li>
+ Error messages should contain helpfull information.<br />
+ <a href="http://mail-archives.apache.org/mod_mbox/harmony-dev/200603.mbox/%3cfcb9f9160603240835i792de7dobabfc43a44e7c752@mail.gmail.com%3e">
+ More helpful error messages</a>
</li>
<li>We clarify/add Harmony classlib specific to javadoc, provide examples.
- Also javadoc should contain a reference to Sun's javadoc
- (<a href="http://mail-archives.apache.org/mod_mbox/harmony-dev/200601.mbox/%3c43C38BCC.6070308@gmail.com%3e">
- Writing JavaDoc</a>)
- </li>
-
- <li>Implementation code should not contain logging.
- (<a href="http://mail-archives.apache.org/mod_mbox/harmony-dev/200605.mbox/%3c447C3186.4000208@gmail.com%3e">
- [classlib] JNDI provider's dependency on logging</a>) and
- (<a href="http://mail-archives.apache.org/mod_mbox/harmony-dev/200605.mbox/%3c447C6E8B.8020202@pobox.com%3e">
- [classlib] logging from within our implementation</a>)
- </li>
-
- <li>java.util.concurrent issue was resolved by taking code from
- independent source(Doug Lea). And we'll offer fixes made in Harmony back to
- original repository.
- (<a href="http://mail-archives.apache.org/mod_mbox/harmony-dev/200606.mbox/%3c4486FEAE.5000607@pobox.com%3e">
- [classlib] proposal - resolution to java.util.concurrent issue</a>),
- (<a href="http://mail-archives.apache.org/mod_mbox/harmony-dev/200607.mbox/%3c005401c6a56e$79234ce0$0c01a8c0@LITTLEGUY%3e">
- [classlib][concurrent] java.util.concurrent module proposal</a>) and
- (<a href="http://mail-archives.apache.org/mod_mbox/harmony-dev/200607.mbox/%3c44B60C4E.80003@gmail.com%3e">
- [legal] taking concurrency utils code into the project</a>)
- </li>
+ Also javadoc should contain a reference to Sun's javadoc.<br />
+ <a href="http://mail-archives.apache.org/mod_mbox/harmony-dev/200601.mbox/%3c43C38BCC.6070308@gmail.com%3e">
+ Writing JavaDoc</a>
+ </li>
+
+ <li>Implementation code should not contain logging.<br />
+ <a href="http://mail-archives.apache.org/mod_mbox/harmony-dev/200605.mbox/%3c447C3186.4000208@gmail.com%3e">
+ [classlib] JNDI provider's dependency on logging</a> and
+ <a href="http://mail-archives.apache.org/mod_mbox/harmony-dev/200605.mbox/%3c447C6E8B.8020202@pobox.com%3e">
+ [classlib] logging from within our implementation</a>
+ </li>
+
+ <li>The <code>java.util.concurrent</code> issue was resolved by taking code from
+ independent source (Doug Lea). And we'll offer fixes made in Harmony back to
+ original repository.<br />
+ <a href="http://mail-archives.apache.org/mod_mbox/harmony-dev/200606.mbox/%3c4486FEAE.5000607@pobox.com%3e">
+ [classlib] proposal - resolution to java.util.concurrent issue</a>,
+ <a href="http://mail-archives.apache.org/mod_mbox/harmony-dev/200607.mbox/%3c005401c6a56e$79234ce0$0c01a8c0@LITTLEGUY%3e">
+ [classlib][concurrent] java.util.concurrent module proposal</a> and
+ <a href="http://mail-archives.apache.org/mod_mbox/harmony-dev/200607.mbox/%3c44B60C4E.80003@gmail.com%3e">
+ [legal] taking concurrency utils code into the project</a></li>
<li>Ant build files should use 1.6 style (using macros and avoiding
- antcall invocations).
- (<a href="http://mail-archives.apache.org/mod_mbox/harmony-dev/200606.mbox/%3c20060629155612.72153.qmail@web55112.mail.re4.yahoo.com%3e">
- [classlib] build file stuff</a>)
+ antcall invocations).<br />
+ <a href="http://mail-archives.apache.org/mod_mbox/harmony-dev/200606.mbox/%3c20060629155612.72153.qmail@web55112.mail.re4.yahoo.com%3e">
+ [classlib] build file stuff</a>
</li>
- <li>It is OK to use Sun's messages for expections and toString() methods
- (<a href="http://mail-archives.apache.org/mod_mbox/harmony-dev/200607.mbox/%3c44BAE039.3060903@pobox.com%3e">
- [general] Sun's permission to use exception messages and toString() formats</a>)
+ <li>It is OK to use Sun's messages for expections and <code>toString()</code> methods.<br />
+ <a href="http://mail-archives.apache.org/mod_mbox/harmony-dev/200607.mbox/%3c44BAE039.3060903@pobox.com%3e">
+ [general] Sun's permission to use exception messages and toString() formats</a>
</li>
- <li>We use Apache Yoko as CORBA for Harmony
- (<a href="http://mail-archives.apache.org/mod_mbox/harmony-dev/200607.mbox/%3cc3755b3a0607180804r2ac264aei8adb967e6e64ae35@mail.gmail.com%3e">
- [classlib] Using Yoko as CORBA for Harmony</a>).
- And CORBA v.2.4 is acceptable (1.5 spec requires CORBA v.2.3.1).
- (<a href="http://mail-archives.apache.org/mod_mbox/harmony-dev/200607.mbox/%3cc3755b3a0607260005j6c51c983k511828945dbf4412@mail.gmail.com%3e">
- Yoko is CORBA 2.4. Is this acceptable for Harmony?</a>).
- </li>
+ <li>We use Apache Yoko as CORBA for Harmony.<br />
+ <a href="http://mail-archives.apache.org/mod_mbox/harmony-dev/200607.mbox/%3cc3755b3a0607180804r2ac264aei8adb967e6e64ae35@mail.gmail.com%3e">
+ [classlib] Using Yoko as CORBA for Harmony</a><br />
+ And CORBA v.2.4 is acceptable (1.5 spec requires CORBA v.2.3.1).<br />
+ <a href="http://mail-archives.apache.org/mod_mbox/harmony-dev/200607.mbox/%3cc3755b3a0607260005j6c51c983k511828945dbf4412@mail.gmail.com%3e">
+ Yoko is CORBA 2.4. Is this acceptable for Harmony?</a>
+</li>
- <li>We will support 3.2 and 4.01 versions of HTML (RI is based on 3.2)
- (<a href="http://mail-archives.apache.org/mod_mbox/harmony-dev/200607.mbox/%3c9b6bea40607211316t36e7c665g7452feea3f99b8ce@mail.gmail.com%3e">
- [classlib][html] HTML 3.2 or 4.01</a>)
+<li>
+ We will support 3.2 and 4.01 versions of HTML (RI is based on 3.2).<br />
+ <a href="http://mail-archives.apache.org/mod_mbox/harmony-dev/200607.mbox/%3c9b6bea40607211316t36e7c665g7452feea3f99b8ce@mail.gmail.com%3e">
+ [classlib][html] HTML 3.2 or 4.01</a>
</li>
- <li>sun.* classes issue was resolved by creating suncompat.jar
- (<a href="http://mail-archives.apache.org/mod_mbox/harmony-dev/200608.mbox/%3c44DB0537.6090408@gmail.com%3e">
- [classlib][suncompat] created</a>)
- </li>
+ <li><code>sun.*</code> classes issue was resolved by creating <code>suncompat.jar</code>.<br />
+ <a href="http://mail-archives.apache.org/mod_mbox/harmony-dev/200608.mbox/%3c44DB0537.6090408@gmail.com%3e">
+ [classlib][suncompat] created</a>
+</li>
- <li>Throws clause of stub method should include
+<li>
+ Throws clause of stub method should include
<a href="http://svn.apache.org/viewvc/incubator/harmony/enhanced/classlib/trunk/modules/luni/src/main/java/org/apache/harmony/luni/util/NotImplementedException.java?view=markup">
- NotImplementedException</a> to be recognized by Japi tool.
- (<a href="http://mail-archives.apache.org/mod_mbox/harmony-dev/200611.mbox/%3cba76afd90611071842w264a2519q1f5a123154759ad6@mail.gmail.com%3e">
- Japi diffs for harmony</a>)
- </li>
+ NotImplementedException</a> to be recognized by Japi tool.<br />
+ <a href="http://mail-archives.apache.org/mod_mbox/harmony-dev/200611.mbox/%3cba76afd90611071842w264a2519q1f5a123154759ad6@mail.gmail.com%3e">
+ Japi diffs for harmony</a>
+</li>
</ul>
</subsection>
<subsection name="Testing">
<ul>
- <li>Follow <a href="http://www.javaworld.com/javaworld/jw-12-2000/jw-1221-junit_p.html">guidelines</a> for unit tests
- (<a href="http://mail-archives.apache.org/mod_mbox/harmony-dev/200603.mbox/%3c442B7857.7040002@gmail.com%3e">
- [Testing Convention] Keep tests small and fast</a>)
- </li>
-
- <li>There is no separate regression testsuite. Regression tests are
- added to unit tests with comments pointing out to JIRA bug.
- (<a href="http://mail-archives.apache.org/mod_mbox/harmony-dev/200512.mbox/%3ce3b630230512300651t574d876ex5de59ad667697acb@mail.gmail.com%3e">
- regression test suite</a>)
- (<a href="http://mail-archives.apache.org/mod_mbox/harmony-dev/200603.mbox/%3c6e47b64f0603280346u3dc491edp8f06bacdbd04c626@mail.gmail.com%3e">
- Regression tests</a>)
- </li>
-
- <li>Create separate test suites for exotic configurations
- (<a href="http://mail-archives.apache.org/mod_mbox/harmony-dev/200601.mbox/%3c906dd82e0601260338i61bc439fr708c664181dc8f20@mail.gmail.com%3e">
- [testing] code for exotic configurations</a>)
- </li>
-
- <li>No logging for unit tests
- (<a href="http://mail-archives.apache.org/mod_mbox/harmony-dev/200601.mbox/%3c906dd82e0601232340n5de6f561v8bb6db7ac4756f1c@mail.gmail.com%3e">
- [classlib] Unit and performance testing</a>)
- </li>
-
- <li>All resource files are located in <module root>/src/test/resources folder and added to classpath
- (<a href="http://mail-archives.apache.org/mod_mbox/harmony-dev/200603.mbox/%3c44126B5C.1020104@gmail.com%3e">
- Location of test data files</a>)
+<li>
+ Follow <a href="http://www.javaworld.com/javaworld/jw-12-2000/jw-1221-junit_p.html">guidelines</a> for unit tests.<br />
+ <a href="http://mail-archives.apache.org/mod_mbox/harmony-dev/200603.mbox/%3c442B7857.7040002@gmail.com%3e">
+ [Testing Convention] Keep tests small and fast</a>
+</li>
+
+<li>
+ There is no separate regression testsuite. Regression tests are
+ added to unit tests with comments pointing out to JIRA bug.<br />
+ <a href="http://mail-archives.apache.org/mod_mbox/harmony-dev/200512.mbox/%3ce3b630230512300651t574d876ex5de59ad667697acb@mail.gmail.com%3e">
+ regression test suite</a> and
+ <a href="http://mail-archives.apache.org/mod_mbox/harmony-dev/200603.mbox/%3c6e47b64f0603280346u3dc491edp8f06bacdbd04c626@mail.gmail.com%3e">
+ Regression tests</a>
+ </li>
+
+ <li>Create separate test suites for exotic configurations.<br />
+ <a href="http://mail-archives.apache.org/mod_mbox/harmony-dev/200601.mbox/%3c906dd82e0601260338i61bc439fr708c664181dc8f20@mail.gmail.com%3e">
+ [testing] code for exotic configurations</a>
+ </li>
+
+ <li>No logging for unit tests.<br />
+ <a href="http://mail-archives.apache.org/mod_mbox/harmony-dev/200601.mbox/%3c906dd82e0601232340n5de6f561v8bb6db7ac4756f1c@mail.gmail.com%3e">
+ [classlib] Unit and performance testing</a>
</li>
- <li>Network tests should use embedded jetty server
- (<a href="http://mail-archives.apache.org/mod_mbox/harmony-dev/200605.mbox/%3c446DF7A9.6040702@gmail.com%3e">
- [classlib] jetty based tests</a>)
+ <li>All resource files are located in <module root>/src/test/resources folder and added to classpath.<br />
+ <a href="http://mail-archives.apache.org/mod_mbox/harmony-dev/200603.mbox/%3c44126B5C.1020104@gmail.com%3e">
+ Location of test data files</a>
+</li>
+
+<li>
+ Network tests should use embedded jetty server.<br />
+ <a href="http://mail-archives.apache.org/mod_mbox/harmony-dev/200605.mbox/%3c446DF7A9.6040702@gmail.com%3e">
+ [classlib] jetty based tests</a>
</li>
</ul>
@@ -164,29 +170,31 @@
<subsection name="Others">
<ul>
- <li>Separate module for providers should be created
- (<a href="http://mail-archives.apache.org/mod_mbox/harmony-dev/200601.mbox/%3c6e47b64f0601170332k3d418fabwd25a264c5e0f1532@mail.gmail.com%3e">
- componentization: more modules might be necessary</a>)
+ <li>Separate module for providers should be created.<br />
+ <a href="http://mail-archives.apache.org/mod_mbox/harmony-dev/200601.mbox/%3c6e47b64f0601170332k3d418fabwd25a264c5e0f1532@mail.gmail.com%3e">
+ componentization: more modules might be necessary</a>
</li>
- <li>JIRA issue can be reassigned if it is not marked as 'In Progress'
- (<a href="http://mail-archives.apache.org/mod_mbox/harmony-dev/200601.mbox/%3c43D76E6A.90509@gmail.com%3e">
- Stealing JIRA issues</a>)
+ <li>
+ JIRA issue can be reassigned if it is not marked as 'In Progress'.<br />
+ <a href="http://mail-archives.apache.org/mod_mbox/harmony-dev/200601.mbox/%3c43D76E6A.90509@gmail.com%3e">
+ Stealing JIRA issues</a>
</li>
- <li>New files should be created with svn property eol-style=native
- (<a href="http://mail-archives.apache.org/mod_mbox/harmony-dev/200603.mbox/%3c442AF8CD.6040004@gmail.com%3e">
- EOL differences in svn diffs</a>)
+ <li>New files should be created with svn property <code>eol-style=native</code>.<br />
+ <a href="http://mail-archives.apache.org/mod_mbox/harmony-dev/200603.mbox/%3c442AF8CD.6040004@gmail.com%3e">
+ EOL differences in svn diffs</a>
</li>
- <li>Mail threads should have subject with prefix
- (<a href="http://mail-archives.apache.org/mod_mbox/harmony-dev/200604.mbox/%3c443133C5.3010602@pobox.com%3e">
- [admin] prefixes?</a>)
+ <li>Mail threads should have subject with prefix.<br />
+ <a href="http://mail-archives.apache.org/mod_mbox/harmony-dev/200604.mbox/%3c443133C5.3010602@pobox.com%3e">
+ [admin] prefixes?</a>
</li>
- <li>Create component status pages and keep them up to date
- (<a href="http://mail-archives.apache.org/mod_mbox/harmony-dev/200603.mbox/%3c440D8F7B.3080902@googlemail.com%3e">
- Component status pages</a>)
+ <li>
+ Create component status pages and keep them up to date.<br />
+ <a href="http://mail-archives.apache.org/mod_mbox/harmony-dev/200603.mbox/%3c440D8F7B.3080902@googlemail.com%3e">
+ Component status pages</a>
</li>
</ul>
</subsection>
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=519951&r1=519950&r2=519951
==============================================================================
--- harmony/standard/site/xdocs/subcomponents/classlibrary/asn1_framework.xml (original)
+++ harmony/standard/site/xdocs/subcomponents/classlibrary/asn1_framework.xml Mon Mar 19 07:12:06 2007
@@ -1,11 +1,11 @@
<?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
+ 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