leosimons 2003/03/23 03:20:18
Modified: compatibility/src/java/org/apache/avalon/excalibur/cli
package.html
compatibility/src/java/org/apache/avalon/excalibur/collections
package.html
compatibility/src/java/org/apache/avalon/excalibur/concurrent
package.html
compatibility/src/xdocs book.xml
Log:
docsdocsdocs
Revision Changes Path
1.2 +5 -1
avalon-excalibur/compatibility/src/java/org/apache/avalon/excalibur/cli/package.html
Index: package.html
===================================================================
RCS file:
/home/cvs/avalon-excalibur/compatibility/src/java/org/apache/avalon/excalibur/cli/package.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- package.html 11 Mar 2003 13:29:16 -0000 1.1
+++ package.html 23 Mar 2003 11:20:18 -0000 1.2
@@ -5,6 +5,10 @@
<body bgcolor="white">
Utility code for parsing command-line options.
<br><br>
+<p><strong>These classes have all been deprecated in favor of
+the <a href="http://jakarta.apache.org/commons/";>Jakarta Commons</a>
+version of the CLI classes.</strong></p>
+
<h3>Introduction</h3>
<p>The utilities in <code>org.apache.avalon.excalibur.cli</code> assist
you in parsing command line options during startup time. It allows you
@@ -34,7 +38,7 @@
/**
* Define the understood options. Each CLOptionDescriptor contains:
* - The "long" version of the option. Eg, "help" means that "--help" will
- * be recognised.
+ * be recognised.
* - The option flags, governing the option's argument(s).
* - The "short" version of the option. Eg, 'h' means that "-h" will be
* recognised.
1.2 +22 -1
avalon-excalibur/compatibility/src/java/org/apache/avalon/excalibur/collections/package.html
Index: package.html
===================================================================
RCS file:
/home/cvs/avalon-excalibur/compatibility/src/java/org/apache/avalon/excalibur/collections/package.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- package.html 11 Mar 2003 13:29:16 -0000 1.1
+++ package.html 23 Mar 2003 11:20:18 -0000 1.2
@@ -2,8 +2,29 @@
<body>
<p>Collection utilities including binaryHeap, fixed,
variable and circular buffers, and priority queues.</p>
+
<p><strong>These classes have all been deprecated in favor of
the <a href="http://jakarta.apache.org/commons/";>Jakarta Commons</a>
-version of the collection classes.</p>
+version of the collection classes.</strong></p>
+
+<h3>Overview</h3>
+ <p>
+ The introduction of the Collections API by Sun in JDK 1.2 has been
+ a boon to quick and effective Java programming. Ready access to powerful
+ data structures has accelerated development by reducing the need for
+ custom container classes around each core object. Most Java2 APIs are
+ significantly easier to use because of the Collections API.
+
+ However, there are certain holes left unfilled by Sun's implementations,
+ and the Jakarta-Commons Collections Component strives to fulfill them.
+ Among the features of this package are:
+ </p>
+ <ul>
+ <li>Special-purpose implementations of Lists and Maps for fast access</li>
+ <li>Adapter classes from Java1-style containers (arrays, enumerations)
+ to Java2-style collections</li>
+ <li>Methods to test or create typical set-theory properties of
+ collections such as union, intersection, and closure</li>
+ </ul>
</body>
</html>
1.2 +17 -0
avalon-excalibur/compatibility/src/java/org/apache/avalon/excalibur/concurrent/package.html
Index: package.html
===================================================================
RCS file:
/home/cvs/avalon-excalibur/compatibility/src/java/org/apache/avalon/excalibur/concurrent/package.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- package.html 11 Mar 2003 13:29:17 -0000 1.1
+++ package.html 23 Mar 2003 11:20:18 -0000 1.2
@@ -2,5 +2,22 @@
<body>
<p>Concurrency control utilities.</p>
<p><strong>This is deprecated in favor of Doug Lea's concurrency utils</strong></p>
+
+<h3>Overview</h3>
+ <p>This package provides utility classes commonly needed in
+ concurrent java programming. They include important thread
+ handling classes like Lock (a Mutex implementation),
+ DjikstraSemaphore, ThreadBarrier, and ConditionalEvent. Read
+ the javadocs for more information, and check out the
+ <a href="http://www.apache.org/dyn/closer.cgi/avalon/excalibur/v4.1";
+ >excalibur 4.1 release</a> for sample usage.
+ </p>
+<h3>Move to Doug Lea's concurrency package!</h3>
+ <p>
+ <a
href="http://gee.cs.oswego.edu/dl/classes/EDU/oswego/cs/dl/util/concurrent/intro.html";
+ >Doug Lea's util.concurrent</a> package is the de-facto standard for
+ concurrency management, and it provides all the functionality of
+ Excalibur Concurrent. It is intended to be the replacement of the
+ Collections code in Excalibur.</p>
</body>
</html>
1.2 +4 -1 avalon-excalibur/compatibility/src/xdocs/book.xml
Index: book.xml
===================================================================
RCS file: /home/cvs/avalon-excalibur/compatibility/src/xdocs/book.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- book.xml 11 Mar 2003 14:08:27 -0000 1.1
+++ book.xml 23 Mar 2003 11:20:18 -0000 1.2
@@ -9,7 +9,10 @@
<menu-item href="http://avalon.apache.org/excalibur/index.html";
label="Excalibur Home"/>
<menu-item href="http://avalon.apache.org/bindownload.cgi"; label="Download"/>
<menu-item label="API Docs"
href="http://avalon.apache.org/excalibur/compatibility/api/"/>
-
+ <menu-item
href="http://avalon.apache.org/excalibur/compatibility/api/org/apache/avalon/excalibur/cli/package-summary.html#package_description";
label="CLI package"/>
+ <menu-item
href="http://avalon.apache.org/excalibur/compatibility/api/org/apache/avalon/excalibur/collections/package-summary.html#package_description";
label="Collections package"/>
+ <menu-item
href="http://avalon.apache.org/excalibur/compatibility/api/org/apache/avalon/excalibur/concurrent/package-summary.html#package_description";
label="Concurrent package"/>
+ <menu-item
href="http://avalon.apache.org/excalibur/compatibility/api/org/apache/avalon/excalibur/io/package-summary.html#package_description";
label="I/O package"/>
</menu>
</book>
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
