[prev in list] [next in list] [prev in thread] [next in thread] 

List:       jakarta-commons-dev
Subject:    cvs commit: jakarta-commons/xdocs components.xml
From:       jstrachan () apache ! org
Date:       2001-09-21 10:00:44
[Download RAW message or body]

jstrachan    01/09/21 03:00:44

  Modified:    digester/src/java/org/apache/commons/digester Digester.java
               docs     beanutils.html charter.html collections.html
                        commons.html components.html contributors.html
                        directory.html index.html license.html
                        messenger.html releases.html sandbox.html
               docs/messenger/api allclasses-frame.html index-all.html
                        index.html packages.html serialized-form.html
               docs/messenger/api/org/apache/commons/messenger
                        DefaultMessenger.html JNDISessionFactory.html
                        Messenger.html MessengerDigester.html
                        MessengerManager.html MessengerSupport.html
                        ServerSessionPoolMessenger.html SessionFactory.html
                        package-frame.html package-summary.html
               xdocs    components.xml
  Log:
  Updated Messenger documentation
  
  Revision  Changes    Path
  1.19      +69 -12    \
jakarta-commons/digester/src/java/org/apache/commons/digester/Digester.java  
  Index: Digester.java
  ===================================================================
  RCS file: /home/cvs/jakarta-commons/digester/src/java/org/apache/commons/digester/Digester.java,v
  retrieving revision 1.18
  retrieving revision 1.19
  diff -u -r1.18 -r1.19
  --- Digester.java	2001/09/19 17:04:09	1.18
  +++ Digester.java	2001/09/21 10:00:41	1.19
  @@ -1,7 +1,7 @@
   /*
  - * $Header: /home/cvs/jakarta-commons/digester/src/java/org/apache/commons/digester/Digester.java,v \
                1.18 2001/09/19 17:04:09 sanders Exp $
  - * $Revision: 1.18 $
  - * $Date: 2001/09/19 17:04:09 $
  + * $Header: /home/cvs/jakarta-commons/digester/src/java/org/apache/commons/digester/Digester.java,v \
1.19 2001/09/21 10:00:41 jstrachan Exp $  + * $Revision: 1.19 $
  + * $Date: 2001/09/21 10:00:41 $
    *
    * ====================================================================
    *
  @@ -108,7 +108,7 @@
    *
    * @author Craig McClanahan
    * @author Scott Sanders
  - * @version $Revision: 1.18 $ $Date: 2001/09/19 17:04:09 $
  + * @version $Revision: 1.19 $ $Date: 2001/09/21 10:00:41 $
    */
   
   public class Digester extends DefaultHandler {
  @@ -667,7 +667,10 @@
                   rule.finish();
               } catch (Exception e) {
                   log("Finish event threw exception", e);
  -                throw new SAXException(e);
  +                throw createSAXException(e);
  +            } catch (Throwable t) {
  +                log("Finish event threw exception", t);
  +                throw createSAXException(t.getMessage());
               }
   	}
   
  @@ -708,8 +711,11 @@
                       rule.body(bodyText);
   		} catch (Exception e) {
   		    log("Body event threw exception", e);
  -		    throw new SAXException(e);
  -		}
  +		    throw createSAXException(e);
  +		} catch (Throwable t) {
  +                    log("Body event threw exception", t);
  +		    throw createSAXException(t.getMessage());
  +                }
   	    }
   	}
   
  @@ -727,8 +733,11 @@
                       rule.end();
   		} catch (Exception e) {
   		    log("End event threw exception", e);
  -		    throw new SAXException(e);
  -		}
  +		    throw createSAXException(e);
  +		} catch (Throwable t) {
  +		    log("End event threw exception", t);
  +		    throw createSAXException(t.getMessage());
  +                }
   	    }
   	}
   
  @@ -763,7 +772,7 @@
               if (stack.empty())
                   namespaces.remove(prefix);
           } catch (EmptyStackException e) {
  -            throw new SAXException("endPrefixMapping popped too many times");
  +            throw createSAXException("endPrefixMapping popped too many times");
           }
   
       }
  @@ -906,7 +915,10 @@
                       rule.begin(list);
   		} catch (Exception e) {
   		    log("Begin event threw exception", e);
  -		    throw new SAXException(e);
  +		    throw createSAXException(e);
  +		} catch (Throwable t) {
  +		    log("Begin event threw exception", t);
  +		    throw createSAXException(t.getMessage());
   		}
   	    }
   	}
  @@ -1011,7 +1023,7 @@
               InputStream stream = url.openStream();
               return (new InputSource(stream));
           } catch (Exception e) {
  -            throw new SAXException(e);
  +            throw createSAXException(e);
           }
   
       }
  @@ -1685,5 +1697,50 @@
   
       }
   
  +    /**
  +     * Create a SAX exception which also understands about the location in
  +     * the digester file where the exception occurs
  +     *
  +     * @return the new exception
  +     */
  +    protected SAXException createSAXException(String message, Exception e) {
  +        if ( locator != null ) {
  +            String error = "Error at (" + locator.getLineNumber() + ", " 
  +                + locator.getColumnNumber() + ": " + message;
  +            if ( e != null ) {
  +                return new SAXParseException( error, locator, e );
  +            }
  +            else {
  +                return new SAXParseException( error, locator );
  +            }
  +        }
  +        System.out.println( "No Locator!" );
  +        if ( e != null ) {
  +            return new SAXException(message, e);
  +        }
  +        else {
  +            return new SAXException(message);
  +        }
  +    }
  +    
  +    /**
  +     * Create a SAX exception which also understands about the location in
  +     * the digester file where the exception occurs
  +     *
  +     * @return the new exception
  +     */
  +    protected SAXException createSAXException(Exception e) {
  +        return createSAXException(e.getMessage(), e);
  +    }
  +    
  +    /**
  +     * Create a SAX exception which also understands about the location in
  +     * the digester file where the exception occurs
  +     *
  +     * @return the new exception
  +     */
  +    protected SAXException createSAXException(String message) {
  +        return createSAXException(message, null);
  +    }
   
   }
  
  
  
  1.14      +33 -5     jakarta-commons/docs/beanutils.html
  
  Index: beanutils.html
  ===================================================================
  RCS file: /home/cvs/jakarta-commons/docs/beanutils.html,v
  retrieving revision 1.13
  retrieving revision 1.14
  diff -u -r1.13 -r1.14
  --- beanutils.html	2001/09/19 02:16:02	1.13
  +++ beanutils.html	2001/09/21 10:00:42	1.14
  @@ -103,9 +103,32 @@
         </td></tr>
         <tr><td>
           <blockquote>
  -                                    [Element: <p/>]
  -                                                [Element: <ul/>]
  -                                                [Element: <p/>]
  +                                    <p>
  +Most Java developers are used to creating Java classes that conform to the
  +JavaBeans naming patterns for property getters and setters.  It is natural to
  +then access these methods directly, using calls to the corresponding
  +<code>getXxx</code> and <code>setXxx</code> methods.  However, there are some
  +occasions where dynamic access to Java object properties (without compiled-in
  +knowledge of the property getter and setter methods to be called) is needed.
  +Example use cases include:</p>
  +                                                <ul>
  +<li>Building scripting languages that interact with the Java object model
  +    (such as the Bean Scripting Framework).</li>
  +<li>Building template language processors for web presentation and similar
  +    uses (such as JSP or Velocity).</li>
  +<li>Building custom tag libraries for JSP and XSP environments (such as Jakarta
  +    Taglibs, Struts, Cocoon).</li>
  +<li>Consuming XML-based configuration resources (such as Ant build scripts, web
  +    application deployment descriptors, Tomcat's <code>server.xml</code>
  +    file).</li>
  +</ul>
  +                                                <p>
  +The Java language provides <em>Reflection</em> and <em>Introspection</em>
  +APIs (see the <code>java.lang.reflect</code> and <code>java.beans</code>
  +packages in the JDK Javadocs).  However, these APIs can be quite complex to
  +understand and utilize.  The  <em>BeanUtils</em> component provides
  +easy-to-use wrappers around these capabilities.
  +</p>
                               </blockquote>
           </p>
         </td></tr>
  @@ -119,7 +142,10 @@
         </td></tr>
         <tr><td>
           <blockquote>
  -                                    [Element: <p/>]
  +                                    <p>The <a \
href="http://jakarta.apache.org/commons/beanutils/api/index.html">  +JavaDoc API \
documents</a> are available online.  In particular, you should  +note the property \
reference syntax options described in the  +<code>PropertyUtils</code> class \
description.</p>  </blockquote>
           </p>
         </td></tr>
  @@ -133,7 +159,9 @@
         </td></tr>
         <tr><td>
           <blockquote>
  -                                    [Element: <ul/>]
  +                                    <ul>
  +<li><a href="http://jakarta.apache.org/builds/jakarta-commons/beanutils/v1.0/">Version \
1.0</a></li>  +</ul>
                               </blockquote>
           </p>
         </td></tr>
  
  
  
  1.14      +318 -79   jakarta-commons/docs/charter.html
  
  Index: charter.html
  ===================================================================
  RCS file: /home/cvs/jakarta-commons/docs/charter.html,v
  retrieving revision 1.13
  retrieving revision 1.14
  diff -u -r1.13 -r1.14
  --- charter.html	2001/09/19 02:13:32	1.13
  +++ charter.html	2001/09/21 10:00:42	1.14
  @@ -103,29 +103,106 @@
         </td></tr>
         <tr><td>
           <blockquote>
  -                                    [Element: <p/>]
  -                                                [Element: <strong/>]
  -                                                [Element: <p/>]
  -                                                [Element: <strong/>]
  -                                                [Element: <p/>]
  -                                                [Element: <p/>]
  -                                                [Element: <p/>]
  -                                                [Element: <p/>]
  -                                                [Element: <p/>]
  -                                                [Element: <p/>]
  -                                                [Element: <strong/>]
  -                                                [Element: <p/>]
  -                                                [Element: <strong/>]
  -                                                [Element: <p/>]
  -                                                [Element: <p/>]
  -                                                [Element: <p/>]
  -                                                [Element: <p/>]
  -                                                [Element: <p/>]
  -                                                [Element: <p/>]
  -                                                [Element: <p/>]
  -                                                [Element: <p/>]
  -                                                [Element: <strong/>]
  -                                                [Element: <p/>]
  +                                    <p>
  +The following charter for Jakarta Commons was approved by the Jakarta Project
  +Management Committee on March 19, 2001.
  +</p>
  +                                                <strong>(0) rationale</strong>
  +                                                <p>
  +Apache-Java and Jakarta originally hosted product-based subprojects,
  +consisting of one major deliverable. The Java language however is
  +package-based, and most of these products have many useful utilities.
  +Some products are beginning to break these out so that they can be used
  +independently. A Jakarta subproject to solely create and maintain
  +independent packages is proposed to accelerate and guide this process.
  +</p>
  +                                                <strong>(1) scope of the \
subproject</strong>  +                                                <p>
  +The subproject shall create and maintain packages written in the Java
  +language, intended for use  in server-related development, and designed
  +to be used independently of any larger product  or framework.
  +Each package will be managed in the same manner
  +as a larger Jakarta product.  To further this goal, the subproject
  +shall also host a workplace for Jakarta committers and a master
  +index of reusable packages related to Jakarta products.
  +</p>
  +                                                <p>
  +(1.5) interaction with other subprojects
  +</p>
  +                                                <p>
  +(1.5.1) the sandbox
  +</p>
  +                                                <p>
  +The subproject will host a CVS repository available to all Jakarta
  +committers as a workplace for new packages or other projects.
  +Before release to the public, code or documentation developed
  +here must be sponsored by a Jakarta subproject. The sponsoring
  +subproject(s) will distribute the code or documentation along
  +with the rest of their codebase.
  +</p>
  +                                                <p>
  +(1.5.2) the directory
  +</p>
  +                                                <p>The subproject will also \
catalog packages and other resources  +available to the public related to other \
Jakarta subprojects and  +ASF projects. This will be a dynamic catalog, like Bugzilla \
and Jyve,  +similar in functionality to <a \
href="http://download.com/">download.com</a>,  +<a \
href="http://cpan.org/">cpan.org</a>, or  +<a \
href="http://sourceforge.net/">SourceForge.net</a>.  +New entries may be added by \
Jakarta committers, developers,  +and users. Entries by developers and users will be \
approved  +by a committer before being made public.
  +</p>
  +                                                <strong>(2) identify the initial \
source from which the subproject is to be populated</strong>  +                       \
<p>  +The initial packages would be based on existing ASF codebases,
  +including those that provide services for DataSource/Database Pools,
  +XML Configuration, Message Resources and i18n, JNDI and Naming, and
  +Testing Suites. The initial committers have agreed to first create and maintain
  +a Database Connection Pool package, along with related
  +testing suites and subproject infrastructure.
  +</p>
  +                                                <strong>(3) identify the initial \
Jakarta resources to be created </strong>  +                                          \
<p>  +(3.1) mailing list(s)
  +</p>
  +                                                <p>
  +jakarta-commons
  +</p>
  +                                                <p>
  +(3.2) CVS repositories
  +</p>
  +                                                <p>
  +jakarta-commons<br />
  +jakarta-commons-sandbox
  +</p>
  +                                                <p>
  +(3.3) Bugzilla
  +</p>
  +                                                <p>
  +program - commons<br />
  +components - Web site, Directory, dbcp
  +</p>
  +                                                <p>
  +(3.4) Jyve FAQ (when available)
  +</p>
  +                                                <p>commons-general<br />
  +commons-dbcp<br />
  +commons-sandbox
  +</p>
  +                                                <strong>(4) identify the initial \
set of committers</strong>  +                                                <p>
  +Morgan Delagrange<br />
  +Ted Husted<br />
  +Conor MacNeill<br />
  +Geir Magnusson Jr.<br />
  +Costin Manolache<br />
  +Remy Maucherat<br />
  +Craig R. McClanahan<br />
  +Ignacio J. Ortega<br />
  +Rodney Waldhoff<br />
  +David Weinrich
  +</p>
                               </blockquote>
           </p>
         </td></tr>
  @@ -139,8 +216,116 @@
         </td></tr>
         <tr><td>
           <blockquote>
  -                                    [Element: <p/>]
  -                                                [Element: <p/>]
  +                                    <p> Note :
  +<ul>
  +  <li>
  +     <i>is, has, will, shall, must</i> - required.
  +  </li>
  +  <li>
  +    <i>may, should, are encouraged </i>- optional but recommended.
  +  </li>
  +</ul>
  +</p>
  +                                                <p>
  +<ol>
  +  <li>
  +     The primary unit of reuse and release is the package.
  +  </li>
  +
  +  <li>
  +     The package library is not a framework but a collection
  +     of components designed to be used independently.
  +  </li>
  +
  +  <li>
  +     Each package must have a clearly defined purpose,
  +     scope, and API -- Do one thing well, and keep your contracts.
  +  </li>
  +
  + <li>Each package is treated as a product in its own right.
  +    <ol>
  +      <li>Each package has its own status file, release schedule,
  +      version number, QA tests, documentation, mailing list, bug category, and \
individual JAR.  +      </li>
  +      <li>
  +        Each package must clearly specify any external dependencies,
  +        including any other Commons packages, and the earliest JDK version
  +        required.
  +        <ol>
  +          <li>External dependencies on optional and third-party
  +          codebases should be minimized.
  +          </li>
  +          <li>All necessary dependencies  must be recorded in the
  +          MANIFEST.MF file of the package JAR, in the manner recommended
  +          in the JDK 1.3 documentation describing 'system extensions'
  +          </li>
  +        </ol>
  +      </li>
  +      <li>
  +        Each package must maintain a list of its active committers in its status \
file.  +      </li>
  +    </ol>
  +  </li>
  +  <li>
  +     The packages should use a standard scheme for versioning,
  +     QA tests, and directory layouts, and a common format for
  +     documentation and Ant build files.
  +  </li>
  +  <li>
  +     The packages should fit within a unified package hierarchy.
  +  </li>
  +  <li>
  +     In general, packages should provide an interface and one or
  +     more implementations of that interface, or implement another
  +     interface already in use.
  +    <ul>
  +      <li>
  +      The packages should have boring functional names.
  +      Implementations may choose more 'exciting' designations.
  +      </li>
  +    </ul>
  +  </li>
  +  <li>
  +    Packages are encouraged to either use JavaBeans as core objects,
  +    a JavaBean-style API, or to provide an optional JavaBean wrapper.
  +  </li>
  +  <li>
  +      External configuration files are discouraged, but if required,
  +      XML format files are preferred for configuration options.
  +  </li>
  +  <li>
  +     Each package will be hosted on its own page on the subproject Web site,
  +     and will also be indexed in a master directory.
  +  </li>
  +  <li>
  +      The subproject directory will also provide a distribution
  +      mechanism, or catalog of packages and related resources.
  +  </li>
  +  <li>
  +       The subproject will also host a top-level 'general' mailing list
  +       in addition to any lists for specific packages.
  +  </li>
  +  <li>The subproject will also provide a single JAR of all stable package \
releases. It may also provide a second JAR with a subset of only JDK 1.1 compatible \
releases. A gump of nightly builds will also be provided.</li>  +  <li>Volunteers \
become committers to this subproject in the same way they are entered to any Jakarta \
subproject. Being a committer in another Jakarta subproject is not a \
prerequisite.</li>  +  <li>Each committer has karma to all the packages, but \
committers are required to add their name to a package's status file before their \
first commit to that package.</li>  +  <li>The committers shall elect a committee of \
three committers to provide general oversight, in the style of the Jakarta PMC.</li>  \
+  <li>New packages may be proposed to the Jakarta Commons mailing list. To be \
accepted, a package proposal must receive a positive super-majority vote of the \
subproject committers. Proposals are to identify the  +    rationale for the package, \
its scope, its interaction with other packages and products, the Commons resources, \
if any, to be created, the initial source from which the package is to be created, \
and the initial set of committers.  +    <ol>
  +      <li>The whole number of positive votes needed for a super majority is \
calculated by dividing the total number of active subproject committers by four, \
multiplying by three, and rounding to the nearest whole number (&gt;= .5 rounds \
up).</li>  +    </ol>
  +  </li>
  +  <li>It is expected that the scope of packages may sometimes overlap.</li>
  +  <li>Anyone may propose a new package to the Commons, and list themselves as the \
initial committers for the package. The vote on the proposal is then also a vote to \
enter new committers to the subproject as needed.</li>  +  <li>A CVS repository will \
be available to all Jakarta committers as a  workplace for new packages or other \
projects.  +  Before release to the public,
  + code or documentation developed here must be sponsored by Jakarta subproject.
  + The sponsoring subproject(s) will distribute the code or documentation along with \
the  +    rest of their codebase.</li>
  +  <li>The subproject catalog will also list packages and resources available to \
the public related to other Jakarta subprojects and ASF projects.</li>  +  <li>As a \
Jakarta subproject, the Commons adopts all other guidelines and procedures of Jakarta \
and the Apache Software Foundation, as they may be amended from time to time.</li>  \
+</ol>  +</p>
                               </blockquote>
           </p>
         </td></tr>
  @@ -154,30 +339,48 @@
         </td></tr>
         <tr><td>
           <blockquote>
  -                                    [Element: <strong/>]
  -                                                [Element: <p/>]
  -                                                [Element: <p/>]
  -                                                [Element: <p/>]
  -                                                [Element: <p/>]
  -                                                [Element: <p/>]
  -                                                [Element: <p/>]
  -                                                [Element: <p/>]
  -                                                [Element: <ul/>]
  -                                                [Element: <p/>]
  -                                                [Element: <p/>]
  -                                                [Element: <p/>]
  -                                                [Element: <p/>]
  -                                                [Element: <p/>]
  -                                                [Element: <p/>]
  -                                                [Element: <p/>]
  -                                                [Element: <p/>]
  -                                                [Element: <p/>]
  -                                                [Element: <p/>]
  -                                                [Element: <p/>]
  -                                                [Element: <p/>]
  -                                                [Element: <p/>]
  -                                                [Element: <p/>]
  -                                                [Element: <p/>]
  +                                    <strong>Proposal for Database Connection Pool \
Package</strong>  +                                                <p>(0) \
rationale</p>  +                                                <p>
  +Many Jakarta products support interaction with a relational database. Creating a \
new connection for each user  can be time consuming (often requiring multiple seconds \
of clock time), in order to perform a database transaction that might take \
milliseconds. Opening a connection per user can be unfeasible in a  +publicly-hosted \
Internet application where the number of simultaneous users can be be very large. \
Accordingly, developers often wish to share a "pool" of open connections between all \
of the application's current users. The number of users actually performing a request \
at any given time is usually a very small percentage of the total number of active \
users, and during request processing is the only time that a database connection is \
required. The application itself logs into the DBMS, and a handles any user account \
issues internally.  +</p>
  +                                                <p>There are several Database \
Connection Pools already available, both within Jakarta products and elsewhere.  +A \
Commons package would give committers an opportunity to coordinate their efforts to  \
+create and maintain a efficient, feature-rich package  +under the ASF license.
  +</p>
  +                                                <p>(1) scope of the package</p>
  +                                                <p>
  +The package shall create and maintain a database connection pool package written \
in the Java language to be distributed under the ASF license. The package shall be \
available as a pseudo-JDBC driver and via a DataSource interface. The package shall  \
+also support multiple logins to multiple database systems, reclamation of stale or \
dead connections, testing for valid connections, PreparedStatement pooling, and other \
features.</p>  +                                                <p>(1.5) interaction \
with other packages</p>  +                                                \
<p>Subclasses of the package should also be able to :</p>  +                          \
<ul>  +    <li>be configured via an external file (e.g. Turbine), and</li>
  +    <li>expose its status, exceptions, or other events to an external logging \
system (e.g. Log4)..</li>  +  </ul>
  +                                                <p>(2) identify the initial source \
for the package</p>  +                                                <p>The initial \
codebase was contributed by Rodney Waldhoff from a working project and can be \
distributed under the Apache license. The source is available as dbpool.jar from &lt; \
<a href="http://www.webappcabaret.com/rwald/dbcp/">http://www.webappcabaret.com/rwald/dbcp/</a> \
&gt;</p>  +                                                <p>(2.1) identify the base \
name for the package</p>  +                                                \
<p>org.apache.commons.dbcp</p>  +                                                \
<p>(3) identify any Jakarta-Commons resources to be created</p>  +                    \
<p>(3.1) mailing list</p>  +                                                <p>Until \
traffic justifies, the package will use the Jakarta-Commons list for \
communications.</p>  +                                                <p>(3.2) CVS \
repositories</p>  +                                                <p>For the time \
being, the package will use a root branch of the Jakarta-Commons CVS.</p>  +          \
<p>(3.3) Bugzilla</p>  +                                                <p>The \
package should be listed as a component of under the Jakarta-Commons Bugzilla \
entry.</p>  +                                                <p>(3.4) Jyve FAQ (when \
available)</p>  +                                                <p>commons-dbcp</p>
  +                                                <p>(4) identify the initial set of \
committers to be listed in the Status File.</p>  +                                    \
<p>  +Morgan Delagrange<br />
  +Geir Magnusson Jr.<br />
  +Craig R. McClanahan<br />
  +Rodney Waldhoff<br />
  +David Weinrich
  +</p>
                               </blockquote>
           </p>
         </td></tr>
  @@ -191,24 +394,39 @@
         </td></tr>
         <tr><td>
           <blockquote>
  -                                    [Element: <p/>]
  -                                                [Element: <p/>]
  -                                                [Element: <blockquote/>]
  -                                                [Element: <p/>]
  -                                                [Element: <p/>]
  -                                                [Element: <p/>]
  -                                                [Element: <p/>]
  -                                                [Element: <p/>]
  -                                                [Element: <p/>]
  -                                                [Element: <p/>]
  -                                                [Element: <p/>]
  -                                                [Element: <p/>]
  -                                                [Element: <p/>]
  -                                                [Element: <p/>]
  -                                                [Element: <p/>]
  -                                                [Element: <p/>]
  -                                                [Element: <p/>]
  -                                                [Element: <p/>]
  +                                    <p><b>What are the actual requirements for a \
Commons package?</b></p>  +                                                <p>
  +Most of the guidelines are advisory and meant to describe 'best practices'.
  +The hard requirements boil down to 'clearly declare your API and dependencies'.
  +Or, taken from the guidelines:
  +</p>
  +                                                <blockquote>
  +<p>3. Each package <b> must</b> have a clearly defined purpose, scope, and API --
  +Do one thing well, and keep your contracts.</p>
  +
  +<p>4.1. Each package <b> must</b> clearly specify any external dependencies, \
including any other Commons packages, and the earliest JDK version required.</p>  \
+<p>4.1.2. All necessary dependencies <b>  must</b> be recorded in the MANIFEST.MF \
file of the package JAR, in the manner recommended in the JDK 1.3 documentation \
describing 'system extensions'.</p>  +</blockquote>
  +                                                <p>Of course, the other \
requirement is that the authors submit a proposal to the Commons committers for \
approval.</p>  +                                                <p><b>Why not have a \
separate CVS tree for each package?</b></p>  +                                        \
<p>It's possible that we may, but the decision should be deferred until we have more \
packages to manage.</p>  +                                                <p>For now, \
we just ask that a Commons committer enter their name in the Status File of a package \
before making their first commit/  +</p>
  +                                                <p><b>Should other Jakarta \
subprojects move their utility packages to the Commons?</b></p>  +                    \
<p>They are welcome to do so. If they would like to experiment with refactoring a \
package outside their own CVS tree, they can setup shop in the Commons sandbox. Any \
Jakarta committer is entitled to write access to this CVS repository upon request. \
They  +could then decide to propose the package to the Commons, and thereby become \
committers to the Commons, or to move it back to their own CVS, and just list it in \
the Commons directory where other developers and users can find it.</p>  +            \
<p><b>What will be listed in the Commons directory?</b></p>  +                        \
<p>Any package or other resource that is related to a Jakarta product may be entered \
into the directory. This will be a dynamic application, like Bugzilla or Jyve. Users \
and developers can complete an online form with their entry, which will be reviewed  \
+by a Commons committer before public release. Jakarta committers may have a higher \
level of access so that their entry goes online without review.</p>  +                \
<p><b>Why not just enroll all the Jakarta committers in the Commons?</b></p>  +       \
<p>If Jakarta adopts an open-door policy for all its subprojects, then of course the \
Commons will follow suit.</p>  +                                                <p>We \
do have an open-door policy for the sandbox CVS (jakarta-commons-sandbox). Any \
Jakarta committer is entitled to write access to the sandbox upon request, no vote \
required, no questions asked. Just subscribe to jakarta-commons-sandbox, and request  \
+authorization.</p>  +                                                <p><b>Why not \
just do this within Avalon, or another existing subproject?</b></p>  +                \
<p>Avalon is a large subproject that is being refactored. It's possible that the \
charter of one of the ensuing pieces may overlap with the Commons.</p>  +             \
<p>The focus of the Commons is squarely and solely on developing packages that can be \
reused by multiple products, both within and without Jakarta. To garner the interest \
of committers, it is important that the Commons and each of its packages be perceived \
as an  +independent entity. Since this is a volunteer meritocracy, the perception of \
committers is vital. No subproject can succeed without the earnest support of \
individual committers.</p>  +                                                <p>It is \
our firm position that the Commons will attract more committers on its own than if it \
were aligned with any existing subproject. What "committers will commit to" has to be \
the prime consideration. Darwin has been trying to tell us that; it's time we \
listened.</p>  </blockquote>
           </p>
         </td></tr>
  @@ -222,18 +440,39 @@
         </td></tr>
         <tr><td>
           <blockquote>
  -                                    [Element: <p/>]
  -                                                [Element: <p/>]
  -                                                [Element: <p/>]
  -                                                [Element: <p/>]
  -                                                [Element: <ul/>]
  -                                                [Element: <p/>]
  -                                                [Element: <p/>]
  -                                                [Element: <ul/>]
  -                                                [Element: <p/>]
  -                                                [Element: <ul/>]
  -                                                [Element: <p/>]
  -                                                [Element: <p/>]
  +                                    <p>
  +<ul>
  +  <li><b>Jakarta Guidelines</b></li>
  +  <li>- <a href="http://jakarta.apache.org/site/guidelines.html">http://jakarta.apache.org/site/guidelines.html</a></li>
  +  <li><b>Code Conventions for the Java Programming Language</b><br />
  +    - <a href="http://java.sun.com/docs/codeconv/html/CodeConvTOC.doc.html">http://java.sun.com/docs/codeconv/html/CodeConvTOC.doc.html</a></li>
  +  <li><b>Javadoc Tool Home Page</b><br />
  +    - <a href="http://java.sun.com/j2se/javadoc/index.html">http://java.sun.com/j2se/javadoc/index.html</a></li>
  +  <li><b>Elements of Java Style - 6. Packaging Conventions</b><br />
  +    - <a href="http://www.ambysoft.com/elementsJavaStyle.html">http://www.ambysoft.com/elementsJavaStyle.html</a></li>
  +</ul>
  +</p>
  +                                                <p><b>From the Elements of Java \
Style - 6. Packaging Conventions</b></p>  +                                           \
<p><i>Rules and Principles only - commentary omitted (<a \
href="http://www.amazon.com/exec/obidos/ISBN=0521777682/">buy the book!</a>)</i></p>  \
+                                                <p>104. Place types that are \
commonly used, changed, and released together, or mutually dependant on each other, \
into the same package.</p>  +                                                <ul>
  +    <li><i>The Common Reuse Principle</i> - A package consists of classes you \
reuse together. If you use one of the classes in the package, you use all of \
them.</li>  +    <li><i>The Common Closure Principle</i> - A package consists of \
classes, all closed against the same kind of changes. A change that affects the \
package affects all the classes in that package</li>  +    <li><i>The Reuse/Release \
Equivalence Principle</i> - The unit of reuse is the unit of release. Effective reuse \
requires tracking of releases from a change control system. The package is the \
effective unit of reuse and release.</li>  +    <li><i>The Acyclic Dependencies \
Principle</i> - The dependency structure between packages must be a direct acyclic \
graph; there must be no cycles in the dependency structure.</li>  +  </ul>
  +                                                <p>105. Isolate volatile classes \
and interfaces in separate packages.</p>  +                                           \
<p>106. Avoid making packages that are difficult to change dependent on packages that \
are easy to change.</p>  +                                                <ul>
  +    <li><i>The Stable Dependencies Principle</i> - The dependencies between \
packages should be orientated in the direction of increasing stability. A package \
should only depend on packages more stable than it is.</li>  +  </ul>
  +                                                <p>107. Maximize abstraction to \
maximize stability.</p>  +                                                <ul>
  +    <li><i>The Stable Abstractions Principle </i>- The stability exhibited by a \
package is directly proportional to its level of abstraction. The more abstract a \
package is, the most stable it tends to be. The more concrete a package is, the more \
unstable  +      it tends to be.</li>
  +  </ul>
  +                                                <p>108. Capture high-level design \
and architecture as stable abstractions organized into stable packages.</p>  +        \
<p><i>For more about these rules, and 103 others - <a \
href="http://www.ambysoft.com/elementsJavaStyle.html">get the book</a> - highly \
recommended.</i></p>  </blockquote>
           </p>
         </td></tr>
  
  
  
  1.4       +31 -5     jakarta-commons/docs/collections.html
  
  Index: collections.html
  ===================================================================
  RCS file: /home/cvs/jakarta-commons/docs/collections.html,v
  retrieving revision 1.3
  retrieving revision 1.4
  diff -u -r1.3 -r1.4
  --- collections.html	2001/09/19 02:13:32	1.3
  +++ collections.html	2001/09/21 10:00:42	1.4
  @@ -103,8 +103,26 @@
         </td></tr>
         <tr><td>
           <blockquote>
  -                                    [Element: <p/>]
  -                                                [Element: <p/>]
  +                                    <p>
  +The introduction of the <a \
href="http://java.sun.com/products/jdk/1.2/docs/guide/collections/">Collections \
API</a> 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.
  +</p>
  +                                                <p>
  +However, there are certain holes left unfilled by Sun's
  +implementations, and the <a \
href="http://jakarta.apache.org/commons/">Jakarta-Commons</a> Collections Component \
strives  +to fulfill them. Among the features of this package are:
  +<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>
  +</p>
                               </blockquote>
           </p>
         </td></tr>
  @@ -118,8 +136,13 @@
         </td></tr>
         <tr><td>
           <blockquote>
  -                                    [Element: <p/>]
  -                                                [Element: <p/>]
  +                                    <p>
  +An alphabetical list of the package can be found in the <a \
href="http://cvs.apache.org/viewcvs/~checkout~/jakarta-commons/collections/STATUS.html?rev=1.7">collections
  +status document</a>.
  +</p>
  +                                                <p>
  +The <a href="collections/api/index.html">JavaDoc API documents</a> are available \
online.  +</p>
                               </blockquote>
           </p>
         </td></tr>
  @@ -133,7 +156,10 @@
         </td></tr>
         <tr><td>
           <blockquote>
  -                                    [Element: <ul/>]
  +                                    <ul>
  +<li><a href="http://jakarta.apache.org/builds/jakarta-commons/release/commons-collections/v1.0/">Version
  +1.0</a></li>
  +</ul>
                               </blockquote>
           </p>
         </td></tr>
  
  
  
  1.14      +50 -6     jakarta-commons/docs/commons.html
  
  Index: commons.html
  ===================================================================
  RCS file: /home/cvs/jakarta-commons/docs/commons.html,v
  retrieving revision 1.13
  retrieving revision 1.14
  diff -u -r1.13 -r1.14
  --- commons.html	2001/09/19 02:13:32	1.13
  +++ commons.html	2001/09/21 10:00:42	1.14
  @@ -103,9 +103,27 @@
         </td></tr>
         <tr><td>
           <blockquote>
  -                                    [Element: <p/>]
  -                                                [Element: <p/>]
  -                                                [Element: <p/>]
  +                                    <p>
  +  The Commons Proper is dedicated to one principal
  +  goal: creating and maintaining reusable Java components.  The Commons 
  +  Proper is a place for collaboration and sharing, where
  +  developers from throughout the Jakarta community can work together 
  +  on projects to be shared by the Jakarta projects and Jakarta users.  
  +</p>
  +                                                <p>
  +  Commons developers will make an effort to ensure that their
  +  components have minimal dependencies on other libraries, so that
  +  these components can be deployed easily.  In addition, Commons components
  +  will keep their interfaces as stable as possible, so that Jakarta users
  +  (including other Jakarta subprojects) can implement these
  +  components without having to worry about changes in the future. 
  +</p>
  +                                                <p>
  +  We welcome participation from all that are interested, at all skill levels.
  +  Coding, documentation and testing are all critical parts of the software
  +  development process.  If you are interested in participating in any of 
  +  these aspects, please join us!
  +</p>
                               </blockquote>
           </p>
         </td></tr>
  @@ -119,9 +137,35 @@
         </td></tr>
         <tr><td>
           <blockquote>
  -                                    [Element: <p/>]
  -                                                [Element: <ul/>]
  -                                                [Element: <p/>]
  +                                    <p>
  +The following proposals for new Commons Proper projects are currently pending :
  +</p>
  +                                                <ul>
  +
  + <li>
  +   <b>BeanUtils Package</b> : Craig McClanahan 
  + </li>
  +
  + <li>
  +   <b>Database Connection Pool Package</b> : Rodney Waldhoff
  + </li>
  +
  + <li>
  +   <b>Object Pooling Package</b> : Rodney Waldhoff
  + </li>
  +
  + <li>
  +   <b>Collections Package</b> : Rodney Waldhoff
  + </li>
  +
  + <li>
  +   <b> Cactus, the renamed J2EEUnit</b> : Vincent Massol
  + </li>
  +
  +</ul>
  +                                                <p>
  +Please see the jakarta-commons mail list for further details.
  +</p>
                               </blockquote>
           </p>
         </td></tr>
  
  
  
  1.3       +183 -6    jakarta-commons/docs/components.html
  
  Index: components.html
  ===================================================================
  RCS file: /home/cvs/jakarta-commons/docs/components.html,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- components.html	2001/09/19 02:13:32	1.2
  +++ components.html	2001/09/21 10:00:42	1.3
  @@ -103,7 +103,12 @@
         </td></tr>
         <tr><td>
           <blockquote>
  -                                    [Element: <p/>]
  +                                    <p>
  +    The <em>Jakarta Commons</em> project differs from many other Jakarta
  +    hosted projects because it is comprised of multiple, independently
  +    released packages. This page provides an overview of the
  +    <em>Commons</em> components that are currently available.
  +   </p>
                               </blockquote>
           </p>
         </td></tr>
  @@ -117,7 +122,64 @@
         </td></tr>
         <tr><td>
           <blockquote>
  -                                    [Element: <dl/>]
  +                                    <dl>
  +
  +    <!-- BeanUtils -->
  +    <dt><b><big><a href="beanutils.html">BeanUtils</a></big></b></dt>
  +    <dd>
  +     Commons-BeanUtils provides easy-to-use wrappers around the Java
  +     reflection and introspection APIs.
  +     <br />
  +     Releases:
  +     <ul>
  +       <li><a href="http://jakarta.apache.org/builds/jakarta-commons/release/commons-beanutils/v1.0/">Release \
1.0</a> - 14 July 2001</li>  +     </ul>
  +    </dd>
  +    <!-- /BeanUtils -->
  +
  +    <!-- Cactus -->
  +    <dt><b><big><a href="cactus/">Cactus</a></big></b></dt>
  +    <dd>
  +     Commons-Cactus is a framework for testing server-side
  +     (J2EE) Java code using in-container extensions to
  +     <a href="http://junit.org/">JUnit</a>.
  +     <br />
  +     Releases:
  +     <ul>
  +       <li><a href="http://jakarta.apache.org/builds/jakarta-commons/release/commons-cactus/v1.1/">Release \
1.1</a> - 18 June 2001</li>  +       <li><a \
href="http://jakarta.apache.org/builds/jakarta-commons/release/commons-cactus/v1.0/">Release \
1.0</a> - 2 May 2001</li>  +     </ul>
  +    </dd>
  +    <!-- /Cactus -->
  +
  +    <!-- Collections -->
  +    <dt><b><big><a href="collections.html">Collections</a></big></b></dt>
  +    <dd>
  +     Commons-Collections provides a suite of classes that
  +     extend or augment the
  +     <a href="http://java.sun.com/products/jdk/1.2/docs/guide/collections/">Java \
Collections Framework</a>.  +     <br />
  +     Releases:
  +     <ul>
  +       <li><a href="http://jakarta.apache.org/builds/jakarta-commons/release/commons-collections/v1.0/">Release \
1.0</a> - 14 July 2001</li>  +     </ul>
  +    </dd>
  +    <!-- /Collections -->
  +
  +    <!-- Digester -->
  +    <dt><b><big><a \
href="http://cvs.apache.org/viewcvs/jakarta-commons/digester/">Digester</a></big></b></dt>
  +    <dd>
  +     Commons-Digester is an XML-to-Java-object mapping utility commonly
  +     used for parsing XML configuration files.
  +     <br />
  +     Releases:
  +     <ul>
  +       <li><a href="http://jakarta.apache.org/builds/jakarta-commons/release/commons-digester/v1.0/">Release \
1.0</a> - 14 July 2001</li>  +     </ul>
  +    </dd>
  +    <!-- /Digester -->
  +
  +   </dl>
                               </blockquote>
           </p>
         </td></tr>
  @@ -131,8 +193,11 @@
         </td></tr>
         <tr><td>
           <blockquote>
  -                                    [Element: <dt/>]
  -                                                [Element: <dd/>]
  +                                    <dt><b><big><a \
href="http://jakarta.apache.org/builds/jakarta-commons/release/commons-latka/v1.0/">Latka</a></big></b></dt>
  +                                                <dd>
  +     Commons-Latka is an HTTP functional testing suite for automated QA, \
acceptance and regression  +     testing.
  +    </dd>
                               </blockquote>
           </p>
         </td></tr>
  @@ -146,7 +211,37 @@
         </td></tr>
         <tr><td>
           <blockquote>
  -                                    [Element: <dl/>]
  +                                    <dl>
  +   <!-- DBCP -->
  +    <dt><b><big><a \
href="http://cvs.apache.org/viewcvs/jakarta-commons/dbcp/">DBCP</a></big></b></dt>  + \
<dd>  +     Commons-DBCP provides database connection and object pooling services.
  +    </dd>
  +   <!-- /DBCP -->
  +
  +   <!-- HTTP Client -->
  +    <dt><b><big><a \
href="http://cvs.apache.org/viewcvs/jakarta-commons/httpclient/">HTTP \
Client</a></big></b></dt>  +    <dd>
  +     Commons-HTTP Client provides a framework for working with the client-side of \
the HTTP protocol.  +    </dd>
  +   <!-- /HTTP Client -->
  +
  +   <!-- JXPath -->
  +    <dt><b><big><a \
href="http://cvs.apache.org/viewcvs/jakarta-commons/jxpath/">JXPath</a></big></b></dt>
  +    <dd>
  +     Commons-JXPath provides utilities for manipulating Java classes that conform \
to the  +     JavaBeans naming conventions using the XPath syntax.
  +    </dd>
  +   <!-- /JXPath -->
  +
  +   <!-- Pool -->
  +    <dt><b><big><a \
href="http://cvs.apache.org/viewcvs/jakarta-commons/pool/">Pool</a></big></b></dt>  + \
<dd>  +     Commons-Pool provides generic object pooling services.
  +    </dd>
  +   <!-- /Pool -->
  +
  +   </dl>
                               </blockquote>
           </p>
         </td></tr>
  @@ -160,7 +255,89 @@
         </td></tr>
         <tr><td>
           <blockquote>
  -                                    [Element: <dl/>]
  +                                    <dl>
  +
  +    <!-- Betwixt -->
  +    <dt><b><big><a \
href="http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/betwixt/">Betwixt</a></big></b></dt>
  +    <dd>
  +     Betwixt provides services for mapping JavaBeans to XML documents, and vice \
versa.  +    </dd>
  +    <!-- /Betwixt -->
  +
  +    <!-- Cache -->
  +    <dt><b><big><a \
href="http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/cache/">Cache</a></big></b></dt>
  +    <dd>
  +     Cache provides object caching services.
  +    </dd>
  +    <!-- /Cache -->
  +
  +    <!-- CJAN -->
  +    <dt><b><big><a \
href="http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/cjan/">CJAN</a></big></b></dt>
  +    <dd>
  +     CJAN provides CPAN like services for Java libraries.
  +    </dd>
  +    <!-- /CJAN -->
  +
  +    <!-- Email -->
  +    <dt><b><big><a \
href="http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/email/">Mail</a></big></b></dt>
  +    <dd>
  +     Mail provides a simple library for sending e-mail from Java.
  +    </dd>
  +    <!-- /Email -->
  +
  +    <!-- JJar -->
  +    <dt><b><big><a \
href="http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/jjar/">JJar</a></big></b></dt>
  +    <dd>
  +     Jakarta JAR Archive Repository
  +    </dd>
  +    <!-- /JJar -->
  +
  +    <!-- Messenger -->
  +    <dt><b><big><a \
href="http://jakarta.apache.org/commons/messenger.html">Messenger</a></big></b></dt>  \
+    <dd>  +     Messenger provides a simple facade over the JMS API.
  +    </dd>
  +    <!-- /Messenger -->
  +
  +    <!-- Resources -->
  +    <dt><b><big><a \
href="http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/resources/">Resources</a></big></b></dt>
  +    <dd>
  +     Resources provides a lightweight framework for defining and looking up
  +     internationalized message strings keyed by a java.util.Locale and a
  +     message key.
  +    </dd>
  +    <!-- /Resources -->
  +
  +    <!-- Threading -->
  +    <dt><b><big><a \
href="http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/threading/">Threading</a></big></b></dt>
  +    <dd>
  +     Threading provides utility interfaces and classes that aid in coordinating \
and  +     communication between multiple threads in a single Java Virtual Machine.
  +    </dd>
  +    <!-- /Threading -->
  +
  +    <!-- Util -->
  +    <dt><b><big><a \
href="http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/util/">Util</a></big></b></dt>
  +    <dd>
  +     <i>Someone please describe Util here.</i>
  +    </dd>
  +    <!-- /Util -->
  +
  +    <!-- Workflow -->
  +    <dt><b><big><a \
href="http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/workflow/">Workflow</a></big></b></dt>
  +    <dd>
  +     Workflow provides a framework for building workflow management systems.
  +    </dd>
  +    <!-- /Workflow -->
  +
  +    <!-- XMLUnit -->
  +    <dt><b><big><a \
href="http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/xmlunit/">XMLUnit</a></big></b></dt>
  +    <dd>
  +     XMLUnit is a JUnit extension for unit testing applications that generate or \
manipulate XML.  +    </dd>
  +    <!-- /XMLUnit -->
  +
  +   </dl>
                               </blockquote>
           </p>
         </td></tr>
  
  
  
  1.16      +23 -3     jakarta-commons/docs/contributors.html
  
  Index: contributors.html
  ===================================================================
  RCS file: /home/cvs/jakarta-commons/docs/contributors.html,v
  retrieving revision 1.15
  retrieving revision 1.16
  diff -u -r1.15 -r1.16
  --- contributors.html	2001/09/19 02:13:32	1.15
  +++ contributors.html	2001/09/21 10:00:42	1.16
  @@ -103,9 +103,29 @@
         </td></tr>
         <tr><td>
           <blockquote>
  -                                    [Element: <p/>]
  -                                                [Element: <ul/>]
  -                                                [Element: <p/>]
  +                                    <p>We are the participants in Commons:</p>
  +                                                <ul>
  +        <li>Morgan Delagrange</li>
  +        <li>B.C. Holmes</li>
  +        <li>Ted Husted</li>
  +        <li>Conor MacNeill</li>
  +        <li>Geir Magnusson Jr.</li>
  +        <li>Costin Manolache</li>
  +        <li>Vincent Massol</li>
  +        <li>Remy Maucherat</li>
  +        <li>Craig R. McClanahan</li>
  +        <li>Ignacio J. Ortega</li>
  +        <li>Sung-Gu Park</li>
  +        <li>Juergen Pill</li>
  +        <li>Doug Sale</li>
  +        <li>Scott Sanders</li>
  +        <li>James Strachan</li>
  +        <li>Dirk Verbeeck</li>
  +        <li>Rodney Waldhoff</li>
  +        <li>David Weinrich</li>
  +        <li>Jari Worsley</li>
  +      </ul>
  +                                                <p>Join us!</p>
                               </blockquote>
           </p>
         </td></tr>
  
  
  
  1.13      +10 -3     jakarta-commons/docs/directory.html
  
  Index: directory.html
  ===================================================================
  RCS file: /home/cvs/jakarta-commons/docs/directory.html,v
  retrieving revision 1.12
  retrieving revision 1.13
  diff -u -r1.12 -r1.13
  --- directory.html	2001/09/19 02:13:32	1.12
  +++ directory.html	2001/09/21 10:00:42	1.13
  @@ -103,9 +103,16 @@
         </td></tr>
         <tr><td>
           <blockquote>
  -                                    [Element: <p/>]
  -                                                [Element: <p/>]
  -                                                [Element: <p/>]
  +                                    <p>
  +The Directory is an online catalog of software and other
  +resources available throughout the Jakarta community.
  +</p>
  +                                                <p>
  +New entries may be added by Jakarta committers, developers and users.
  +</p>
  +                                                <p>
  +The Directory part of Commons hasn't begun.  If you are interested in \
participating, let us know.  +</p>
                               </blockquote>
           </p>
         </td></tr>
  
  
  
  1.18      +89 -15    jakarta-commons/docs/index.html
  
  Index: index.html
  ===================================================================
  RCS file: /home/cvs/jakarta-commons/docs/index.html,v
  retrieving revision 1.17
  retrieving revision 1.18
  diff -u -r1.17 -r1.18
  --- index.html	2001/09/19 02:13:32	1.17
  +++ index.html	2001/09/21 10:00:42	1.18
  @@ -103,12 +103,31 @@
         </td></tr>
         <tr><td>
           <blockquote>
  -                                    [Element: <b/>]
  -                                                [Element: <p/>]
  -                                                [Element: <p/>]
  -                                                [Element: <ul/>]
  -                                                [Element: <p/>]
  -                                                [Element: <p/>]
  +                                    <b>Welcome to the Commons!</b>
  +                                                <p>
  +  The Commons is a new Jakarta subproject focused on all aspects of
  +  reusable Java components.
  +         </p>
  +                                                <p>The Jakarta Commons project is \
composed of two parts:</p>  +                                                <ul>
  +				<li>
  +  <a href="#The Commons Proper">The Commons Proper</a> -
  +  A repository of reusable Java components.
  +            </li>
  +				<li>
  +  <a href="#The Sandbox">The Sandbox</a> -
  +  A workspace for Java component development.
  +            </li>
  +			</ul>
  +                                                <p>
  +  The <a href="components.html">components</a> page
  +  lists the components currently available in both the
  +  Sandbox and Commons Proper.
  +         </p>
  +                                                <p>
  +  You may also read our <a href="charter.html">charter</a>,
  +  which spells out the goals of the project in greater detail.
  +         </p>
                               </blockquote>
           </p>
         </td></tr>
  @@ -122,9 +141,27 @@
         </td></tr>
         <tr><td>
           <blockquote>
  -                                    [Element: <p/>]
  -                                                [Element: <p/>]
  -                                                [Element: <p/>]
  +                                    <p>
  +  The Commons Proper is dedicated to one principal
  +  goal: creating and maintaining reusable Java components.  The Commons
  +  Proper is a place for collaboration and sharing, where
  +  developers from throughout the Jakarta community can work together
  +  on projects to be shared by the Jakarta projects and Jakarta users.
  +         </p>
  +                                                <p>
  +  Commons developers will make an effort to ensure that their
  +  components have minimal dependencies on other libraries, so that
  +  these components can be deployed easily.  In addition, Commons components
  +  will keep their interfaces as stable as possible, so that Jakarta users
  +  (including other Jakarta subprojects) can implement these
  +  components without having to worry about changes in the future.
  +         </p>
  +                                                <p>
  +  We welcome participation from all that are interested, at all skill levels.
  +  Coding, documentation and testing are all critical parts of the software
  +  development process.  If you are interested in participating in any of
  +  these aspects, please join us!
  +         </p>
                               </blockquote>
           </p>
         </td></tr>
  @@ -138,7 +175,14 @@
         </td></tr>
         <tr><td>
           <blockquote>
  -                                    [Element: <p/>]
  +                                    <p>
  +  This project also contains a workspace that is open to all
  +  Jakarta committers.  It's a place to try out new ideas and prepare
  +  for inclusion into the Commons portion of the project or into another
  +  Jakarta project.  Users are free to experiment with the components
  +  developed in the sandbox, but sandbox components will not necessarily
  +  be maintained, particularly in their current state.
  +         </p>
                               </blockquote>
           </p>
         </td></tr>
  @@ -152,7 +196,11 @@
         </td></tr>
         <tr><td>
           <blockquote>
  -                                    [Element: <p/>]
  +                                    <p>
  +  The individual components have independent releases.  The releases
  +  currently available can be seen on the
  +  <a href="components.html">components</a> page.
  +         </p>
                               </blockquote>
           </p>
         </td></tr>
  @@ -166,8 +214,16 @@
         </td></tr>
         <tr><td>
           <blockquote>
  -                                    [Element: <p/>]
  -                                                [Element: <p/>]
  +                                    <p>
  +  Nightly snapshots of the Commons CVS can be found
  +  <a href="http://jakarta.apache.org/builds/jakarta-commons/nightly/">here</a>.
  +         </p>
  +                                                <p>
  +  These are meant to provide easy access to the actual project CVS tree.
  +  As this is our live development workspace, there are
  +  no guarantees as to what you will find there, although we do our
  +  best to maintain a buildable source tree.
  +         </p>
                               </blockquote>
           </p>
         </td></tr>
  @@ -181,8 +237,26 @@
         </td></tr>
         <tr><td>
           <blockquote>
  -                                    [Element: <p/>]
  -                                                [Element: <ul/>]
  +                                    <p>
  +  The Commons project really needs and appreciates any contributions,
  +  including documentation help, source code and feedback.
  +         </p>
  +                                                <ul>
  +				<li>
  +  Discussion occurs on the
  +  <a href="http://jakarta.apache.org/getinvolved/mail.html">Commons mailing \
list</a>.  +            </li>
  +				<li>
  +  Access to the CVS <strong>jakarta-commons</strong> repository is available both
  +  <a href="http://cvs.apache.org/viewcvs/jakarta-commons/">online</a>
  +  and with a <a href="http://jakarta.apache.org/getinvolved/cvsindex.html">cvs \
client</a>.  +            </li>
  +				<li>
  +  Access to the CVS <strong>jakarta-commons-sandbox</strong> repository is \
available both  +  <a \
href="http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/">online</a>  +  and with \
a <a href="http://jakarta.apache.org/getinvolved/cvsindex.html">cvs client</a>.  +    \
</li>  +			</ul>
                               </blockquote>
           </p>
         </td></tr>
  
  
  
  1.13      +4 -1      jakarta-commons/docs/license.html
  
  Index: license.html
  ===================================================================
  RCS file: /home/cvs/jakarta-commons/docs/license.html,v
  retrieving revision 1.12
  retrieving revision 1.13
  diff -u -r1.12 -r1.13
  --- license.html	2001/09/19 02:13:32	1.12
  +++ license.html	2001/09/21 10:00:42	1.13
  @@ -104,7 +104,10 @@
         </td></tr>
         <tr><td>
           <blockquote>
  -                                    [Element: <p/>]
  +                                    <p>
  +All source and documentation of the Commons project is copyrighted by
  +the Apache Software Foundation, and made available under the following license :
  +</p>
                                                       <div align="left">
       <table cellspacing="4" cellpadding="0" border="0">
       <tr>
  
  
  
  1.6       +91 -18    jakarta-commons/docs/messenger.html
  
  Index: messenger.html
  ===================================================================
  RCS file: /home/cvs/jakarta-commons/docs/messenger.html,v
  retrieving revision 1.5
  retrieving revision 1.6
  diff -u -r1.5 -r1.6
  --- messenger.html	2001/09/19 02:13:32	1.5
  +++ messenger.html	2001/09/21 10:00:42	1.6
  @@ -103,7 +103,30 @@
         </td></tr>
         <tr><td>
           <blockquote>
  -                                    [Element: <p/>]
  +                                    <p>
  +  <ol>
  +
  +    <li>
  +      <a href="messenger.html#Introduction">Introduction</a>
  +    </li>
  +
  +    <li>
  +      <a href="messenger.html#Documentation">Documentation</a>
  +    </li>
  +
  +    <li>
  +      <a href="messenger.html#Example Config">Example Configuration</a>
  +    </li>    
  +
  +    <li>
  +      <a href="messenger.html#Example Code">Example Code</a>
  +    </li>    
  +
  +    <li>
  +      <a href="messenger.html#Configuration">Configuration</a>
  +    </li>    
  +  </ol>
  +</p>
                               </blockquote>
           </p>
         </td></tr>
  @@ -117,11 +140,26 @@
         </td></tr>
         <tr><td>
           <blockquote>
  -                                    [Element: <p/>]
  -                                                [Element: <p/>]
  -                                                [E


[prev in list] [next in list] [prev in thread] [next in thread] 

Configure | About | News | Add a list | Sponsored by KoreLogic