Debian Codegraph @

PROPOSAL.html

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