proposal for lang in xdoc form
git-svn-id: https://svn.apache.org/repos/asf/jakarta/commons/proper/lang/trunk@137798 13f79535-47bb-0310-9956-ffa450edef68
This commit is contained in:
parent
7737b36cc6
commit
b2fd164c2e
|
@ -0,0 +1,81 @@
|
||||||
|
<document>
|
||||||
|
<properties>
|
||||||
|
<title>Proposal for Lang Package</title>
|
||||||
|
</properties>
|
||||||
|
<body>
|
||||||
|
|
||||||
|
|
||||||
|
<section name="Proposal for Lang Package">
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
<subsection name="(0) Rationale">
|
||||||
|
|
||||||
|
<p>The standard Java libraries fail to provide enough methods for
|
||||||
|
manipulation of its main components. The <em>Lang</em> Package provides
|
||||||
|
these extra methods. There are other classes which might justifiably
|
||||||
|
be included in java.lang someday, this package also provides for them.</p>
|
||||||
|
|
||||||
|
|
||||||
|
</subsection>
|
||||||
|
<subsection name="(1) Scope of the Package">
|
||||||
|
|
||||||
|
<p>This proposal is to create a package of Java utility classes for the
|
||||||
|
classes that are in java.lang's hierarchy, or are considered to be so
|
||||||
|
standard as to justify existence in java.lang. The <em>Lang</em> Package
|
||||||
|
also applies to primitives and arrays.</p>
|
||||||
|
|
||||||
|
|
||||||
|
</subsection>
|
||||||
|
<subsection name="(1.5) Interaction With Other Packages">
|
||||||
|
|
||||||
|
<p><em>Lang</em> relies only on standard JDK 1.2 (or later) APIs for
|
||||||
|
production deployment. It utilizes the JUnit unit testing framework for
|
||||||
|
developing and executing unit tests, but this is of interest only to
|
||||||
|
developers of the component. Lang will be a dependency for
|
||||||
|
several existing components in the open source world.</p>
|
||||||
|
|
||||||
|
<p>No external configuration files are utilized.</p>
|
||||||
|
|
||||||
|
|
||||||
|
</subsection>
|
||||||
|
<subsection name="(2) Initial Source of the Package">
|
||||||
|
|
||||||
|
<p>The initial classes came from the Commons.Util subproject.</p>
|
||||||
|
|
||||||
|
<p>The proposed package name for the new component is
|
||||||
|
<code>org.apache.commons.lang</code>.</p>
|
||||||
|
|
||||||
|
|
||||||
|
</subsection>
|
||||||
|
<subsection name="(3) Required Jakarta-Commons Resources">
|
||||||
|
|
||||||
|
<ul>
|
||||||
|
<li>CVS Repository - New directory <code>lang</code> in the
|
||||||
|
<code>jakarta-commons</code> CVS repository.</li>
|
||||||
|
<li>Mailing List - Discussions will take place on the general
|
||||||
|
<em>commons-dev@jakarta.apache.org</em> mailing list. To help
|
||||||
|
list subscribers identify messages of interest, it is suggested that
|
||||||
|
the message subject of messages about this component be prefixed with
|
||||||
|
[lang].</li>
|
||||||
|
<li>Bugzilla - New component "Lang" under the "Commons" product
|
||||||
|
category, with appropriate version identifiers as needed.</li>
|
||||||
|
<li>Jyve FAQ - New category "commons-lang" (when available).</li>
|
||||||
|
</ul>
|
||||||
|
|
||||||
|
|
||||||
|
</subsection>
|
||||||
|
<subsection name="(4) Initial Committers">
|
||||||
|
|
||||||
|
<p>The initial committers on the Lang component shall be as follows:
|
||||||
|
<ul>
|
||||||
|
<li>Henri Yandell (bayard)</li>
|
||||||
|
<li>Daniel Rall (dlr)</li>
|
||||||
|
<li>Stephen Colebourne (scolebourne)</li>
|
||||||
|
</ul>
|
||||||
|
</p>
|
||||||
|
|
||||||
|
</subsection>
|
||||||
|
</section>
|
||||||
|
</body>
|
||||||
|
</document>
|
Loading…
Reference in New Issue