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