1<!-- 2Licensed to the Apache Software Foundation (ASF) under one or more 3contributor license agreements. See the NOTICE file distributed with 4this work for additional information regarding copyright ownership. 5The ASF licenses this file to You under the Apache License, Version 2.0 6(the "License"); you may not use this file except in compliance with 7the License. You may obtain a copy of the License at 8 9 http://www.apache.org/licenses/LICENSE-2.0 10 11Unless required by applicable law or agreed to in writing, software 12distributed under the License is distributed on an "AS IS" BASIS, 13WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 14See the License for the specific language governing permissions and 15limitations under the License. 16--> 17<document> 18<properties> 19<title>Proposal for Lang Package</title> 20</properties> 21<body> 22 23 24<section name="Proposal for Lang Package"> 25 26 27 28<subsection name="(0) Rationale"> 29 30<p>The standard Java libraries fail to provide enough methods for 31manipulation of its main components. The <em>Lang</em> Package provides 32these extra methods. There are other classes which might justifiably 33be included in java.lang someday, this package also provides for them.</p> 34 35 36</subsection> 37<subsection name="(1) Scope of the Package"> 38 39<p>This proposal is to create a package of Java utility classes for the 40classes that are in java.lang's hierarchy, or are considered to be so 41standard as to justify existence in java.lang. The <em>Lang</em> Package 42also applies to primitives and arrays.</p> 43 44 45</subsection> 46<subsection name="(1.5) Interaction With Other Packages"> 47 48<p><em>Lang</em> relies only on standard JDK 1.2 (or later) APIs for 49production deployment. It utilizes the JUnit unit testing framework for 50developing and executing unit tests, but this is of interest only to 51developers of the component. Lang will be a dependency for 52several existing components in the open source world.</p> 53 54<p>No external configuration files are utilized.</p> 55 56 57</subsection> 58<subsection name="(2) Initial Source of the Package"> 59 60<p>The initial classes came from the Commons.Util subproject.</p> 61 62<p>The proposed package name for the new component is 63<code>org.apache.commons.lang</code>.</p> 64 65 66</subsection> 67<subsection name="(3) Required Jakarta-Commons Resources"> 68 69<ul> 70<li>CVS Repository - New directory <code>lang</code> in the 71 <code>jakarta-commons</code> CVS repository.</li> 72<li>Mailing List - Discussions will take place on the general 73 <em>dev@commons.apache.org</em> mailing list. To help 74 list subscribers identify messages of interest, it is suggested that 75 the message subject of messages about this component be prefixed with 76 [lang].</li> 77<li>Bugzilla - New component "Lang" under the "Commons" product 78 category, with appropriate version identifiers as needed.</li> 79<li>Jyve FAQ - New category "commons-lang" (when available).</li> 80</ul> 81 82 83</subsection> 84<subsection name="(4) Initial Committers"> 85 86<p>The initial committers on the Lang component shall be as follows: 87<ul> 88<li>Henri Yandell (bayard)</li> 89<li>Daniel Rall (dlr)</li> 90<li>Stephen Colebourne (scolebourne)</li> 91</ul> 92</p> 93 94</subsection> 95</section> 96</body> 97</document> 98