--- jsr166/src/main/intro.html 2003/08/24 23:31:23 1.13 +++ jsr166/src/main/intro.html 2004/07/29 11:44:00 1.17 @@ -10,35 +10,20 @@ by Doug Lea

-This is an updated version of the specification submitted for JCP -Community Draft review. To check for further updates, access a -preliminary prototype release of main functionality, or join a mailing -list discussing this JSR, go to: -http://altair.cs.oswego.edu/mailman/listinfo/concurrency-interest -.

+http://altair.cs.oswego.edu/mailman/listinfo/concurrency-interest. - Disclaimer. The prototype implementation is experimental -code developed as part of JCP JSR-166 is made available to the -developer community for use as-is. It is not a supported product. Use -it at your own risk. The specification, language and implementation -are subject to change as a result of your feedback. Because these -features have not yet been approved for addition to the Java language, -there is no schedule for their inclusion in a product. - -

Disclaimer. This draft specification was produced -using JDK1.4 tools plus some preprocessing. The resulting javadocs do -not yet correctly render other planned JDK1.5 constructs on which -JSR-166 relies, most notably the use of generic types. We are -releasing this version now (before the availability of JDK1.5-based -tools) because, even though they are misformatted and sometimes lack -proper cross-referencing, they otherwise convey the intended -specifications. +

Note: The javadocs here includes some existing java.util +Collection interfaces and classes that are not part of the JSR-166 +spec, but are included because JSR-166 methods implement or inherit +from their specifications.

JSR-166 introduces package java.util.concurrent containing utility classes commonly useful in concurrent programming. Like package java.util, it includes a few small -standardized extensible frameworks, as well as some classes that +standardized extensible frameworks, as well as other classes that provide useful functionality and are otherwise tedious or difficult to implement. @@ -50,8 +35,8 @@ pools. This diversity reflects the range of contexts in which developers of concurrent programs have been found to require or desire support not previously available in J2SE, which also keeping the -resulting package small; providing only that minimial support for -which it makes sense to standardize. +resulting package small; providing only functionality that has been +found to be worthwhile to standardize.

Descriptions and brief motivations for the main components may be found in the associated package documentation. JSR-166 also includes @@ -87,7 +72,7 @@ InterruptedExceptions.

  • The destroy method, which has never been implemented, has finally been deprecated. This is just a spec change, reflecting - the fact that that the reason it has never been implmented is that + the fact that that the reason it has never been implemented is that it was undesirable and unworkable. @@ -106,6 +91,5 @@
    -
    Doug Lea