Get 'mvn clean site' to work.
[commons-testing.git] / target / site / proposal.html
1 <!DOCTYPE html>
2 <!--
3 | Generated by Apache Maven Doxia at 04 February 2018
4 | Rendered using Apache Maven Fluido Skin 1.3.0
5 -->
6 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
7 <head>
8 <meta charset="UTF-8" />
9 <meta name="viewport" content="width=device-width, initial-scale=1.0" />
10 <meta name="Date-Revision-yyyymmdd" content="20180204" />
11 <meta http-equiv="Content-Language" content="en" />
12 <title>Lang &#x2013; Proposal for Lang Package</title>
13
14 <link rel="stylesheet" href="./css/bootstrap.min.css" type="text/css" />
15 <link rel="stylesheet" href="./css/site.css" type="text/css" />
16 <link rel="stylesheet" href="./css/print.css" media="print" />
17
18 <script type="text/javascript" src="./js/jquery.min.js"></script>
19 <script type="text/javascript" src="./js/bootstrap.min.js"></script>
20 <script type="text/javascript" src="./js/prettify.min.js"></script>
21 <script type="text/javascript" src="./js/site.js"></script>
22
23
24 </head>
25
26 <body class="composite">
27 <a href="http://commons.apache.org/" id="bannerLeft" title="Apache Commons logo">
28 <img class="logo-left" src="./images/commons-logo.png" alt="Apache Commons logo"/>
29 </a>
30 <a href="index.html" id="bannerRight">
31 <img class="logo-right" src="images/logo.png" alt="Commons Testing"/>
32 </a>
33 <div class="clear"></div>
34
35 <div class="navbar">
36 <div class="navbar-inner">
37 <div class="container-fluid">
38 <a class="brand" href="http://commons.apache.org/proper/commons-testing/">Apache Commons Testing Parent POM &trade;</a>
39 <ul class="nav">
40
41 <li id="publishDate">Last Published: 04 February 2018</li>
42 <li class="divider">|</li> <li id="projectVersion">Version: 1.0.0-SNAPSHOT</li>
43 </ul>
44 <div class="pull-right"> <ul class="nav">
45 <li>
46 <a href="http://www.apachecon.com/" class="externalLink" title="ApacheCon">
47 ApacheCon</a>
48 </li>
49 <li>
50 <a href="http://www.apache.org" class="externalLink" title="Apache">
51 Apache</a>
52 </li>
53 <li>
54 <a href="../../" title="Commons">
55 Commons</a>
56 </li>
57 </ul>
58 </div>
59 </div>
60 </div>
61 </div>
62
63 <div class="container-fluid">
64 <table class="layout-table">
65 <tr>
66 <td class="sidebar">
67 <div class="well sidebar-nav">
68 <ul class="nav nav-list">
69 <li class="nav-header">Testing</li>
70 <li class="none">
71 <a href="index.html" title="Overview">
72 Overview</a>
73 </li>
74 <li class="none">
75 <a href="download_lang.cgi" title="Download">
76 Download</a>
77 </li>
78 <li class="none">
79 <a href="javadocs/api-1.0.0/index.html" title="Javadoc (1.0.0)">
80 Javadoc (1.0.0)</a>
81 </li>
82 <li class="none">
83 <a href="javadocs/api-release/index.html" title="Javadoc (Latest)">
84 Javadoc (Latest)</a>
85 </li>
86 </ul>
87 <ul class="nav nav-list">
88 <li class="nav-header"><i class="icon-cog"></i>Development</li>
89 <li class="none">
90 <a href="building.html" title="Building">
91 Building</a>
92 </li>
93 <li class="none">
94 <a href="mail-lists.html" title="Mailing Lists">
95 Mailing Lists</a>
96 </li>
97 <li class="none">
98 <a href="issue-tracking.html" title="Issue Tracking">
99 Issue Tracking</a>
100 </li>
101 <li class="none">
102 <a href="developerguide.html" title="Developer Guide">
103 Developer Guide</a>
104 </li>
105 <li class="none">
106 <a href="source-repository.html" title="Source Repository">
107 Source Repository</a>
108 </li>
109 <li class="none">
110 <a href="apidocs/index.html" title="Javadoc (GIT latest)">
111 Javadoc (GIT latest)</a>
112 </li>
113 </ul>
114 <ul class="nav nav-list">
115 <li class="nav-header"><i class="icon-cog"></i>Components</li>
116 <li class="none">
117 <a href="index.html" title="Parent">
118 Parent</a>
119 </li>
120 <li class="none">
121 <a href="commons-testing-generic/index.html" title="Generic">
122 Generic</a>
123 </li>
124 <li class="none">
125 <a href="commons-testing-junit4/index.html" title="JUnit 4">
126 JUnit 4</a>
127 </li>
128 </ul>
129 <ul class="nav nav-list">
130 <li class="nav-header"><i class="icon-info-sign"></i>Project Documentation</li>
131 <li class="collapsed">
132 <a href="project-info.html" title="Project Information">
133 Project Information</a>
134 </li>
135 <li class="collapsed">
136 <a href="project-reports.html" title="Project Reports">
137 Project Reports</a>
138 </li>
139 </ul>
140 <ul class="nav nav-list">
141 <li class="nav-header">Commons</li>
142 <li class="none">
143 <a href="../../" title="Home">
144 Home</a>
145 </li>
146 <li class="none">
147 <a href="http://www.apache.org/licenses/" class="externalLink" title="License">
148 License</a>
149 </li>
150 <li class="collapsed">
151 <a href="../../components.html" title="Components">
152 Components</a>
153 </li>
154 <li class="collapsed">
155 <a href="../../sandbox/index.html" title="Sandbox">
156 Sandbox</a>
157 </li>
158 <li class="collapsed">
159 <a href="../../dormant/index.html" title="Dormant">
160 Dormant</a>
161 </li>
162 </ul>
163 <ul class="nav nav-list">
164 <li class="nav-header">General Information</li>
165 <li class="none">
166 <a href="../../security.html" title="Security">
167 Security</a>
168 </li>
169 <li class="none">
170 <a href="../../volunteering.html" title="Volunteering">
171 Volunteering</a>
172 </li>
173 <li class="none">
174 <a href="../../patches.html" title="Contributing Patches">
175 Contributing Patches</a>
176 </li>
177 <li class="none">
178 <a href="../../building.html" title="Building Components">
179 Building Components</a>
180 </li>
181 <li class="none">
182 <a href="../../commons-parent-pom.html" title="Commons Parent Pom">
183 Commons Parent Pom</a>
184 </li>
185 <li class="none">
186 <a href="../../build-plugin/index.html" title="Commons Build Plugin">
187 Commons Build Plugin</a>
188 </li>
189 <li class="none">
190 <a href="../../releases/index.html" title="Releasing Components">
191 Releasing Components</a>
192 </li>
193 <li class="none">
194 <a href="http://wiki.apache.org/commons/FrontPage" class="externalLink" title="Wiki">
195 Wiki</a>
196 </li>
197 </ul>
198 <ul class="nav nav-list">
199 <li class="nav-header">ASF</li>
200 <li class="none">
201 <a href="http://www.apache.org/foundation/how-it-works.html" class="externalLink" title="How the ASF works">
202 How the ASF works</a>
203 </li>
204 <li class="none">
205 <a href="http://www.apache.org/foundation/getinvolved.html" class="externalLink" title="Get Involved">
206 Get Involved</a>
207 </li>
208 <li class="none">
209 <a href="http://www.apache.org/dev/" class="externalLink" title="Developer Resources">
210 Developer Resources</a>
211 </li>
212 <li class="none">
213 <a href="http://www.apache.org/foundation/policies/conduct.html" class="externalLink" title="Code of Conduct">
214 Code of Conduct</a>
215 </li>
216 <li class="none">
217 <a href="http://www.apache.org/foundation/sponsorship.html" class="externalLink" title="Sponsorship">
218 Sponsorship</a>
219 </li>
220 <li class="none">
221 <a href="http://www.apache.org/foundation/thanks.html" class="externalLink" title="Thanks">
222 Thanks</a>
223 </li>
224 </ul>
225 </div>
226 <div id="poweredBy">
227 <a href="http://www.apache.org/events/current-event.html" title="ApacheCon" class="builtBy">
228 <img class="builtBy" alt="ApacheCon" src="http://www.apache.org/events/current-event-125x125.png" />
229 </a>
230 <a href="http://maven.apache.org/" title="Maven" class="builtBy">
231 <img class="builtBy" alt="Maven" src="http://maven.apache.org/images/logos/maven-feather.png" />
232 </a>
233 </div>
234 </td>
235 <td class="content">
236
237
238
239
240 <div class="section">
241 <h2><a name="Proposal_for_Lang_Package"></a>Proposal for Lang Package</h2>
242
243
244
245
246 <div class="section">
247 <h3><a name="a.280.29_Rationale"></a>(0) Rationale</h3>
248
249
250 <p>The standard Java libraries fail to provide enough methods for
251 manipulation of its main components. The <i>Lang</i> Package provides
252 these extra methods. There are other classes which might justifiably
253 be included in java.lang someday, this package also provides for them.</p>
254
255
256 </div>
257
258 <div class="section">
259 <h3><a name="a.281.29_Scope_of_the_Package"></a>(1) Scope of the Package</h3>
260
261
262 <p>This proposal is to create a package of Java utility classes for the
263 classes that are in java.lang's hierarchy, or are considered to be so
264 standard as to justify existence in java.lang. The <i>Lang</i> Package
265 also applies to primitives and arrays.</p>
266
267
268 </div>
269
270 <div class="section">
271 <h3><a name="a.281.5.29_Interaction_With_Other_Packages"></a>(1.5) Interaction With Other Packages</h3>
272
273
274 <p><i>Lang</i> relies only on standard JDK 1.2 (or later) APIs for
275 production deployment. It utilizes the JUnit unit testing framework for
276 developing and executing unit tests, but this is of interest only to
277 developers of the component. Lang will be a dependency for
278 several existing components in the open source world.</p>
279
280
281 <p>No external configuration files are utilized.</p>
282
283
284 </div>
285
286 <div class="section">
287 <h3><a name="a.282.29_Initial_Source_of_the_Package"></a>(2) Initial Source of the Package</h3>
288
289
290 <p>The initial classes came from the Commons.Util subproject.</p>
291
292
293 <p>The proposed package name for the new component is
294 <tt>org.apache.commons.lang</tt>.</p>
295
296
297 </div>
298
299 <div class="section">
300 <h3><a name="a.283.29__Required_Jakarta-Commons_Resources"></a>(3) Required Jakarta-Commons Resources</h3>
301
302
303 <ul>
304
305 <li>CVS Repository - New directory <tt>lang</tt> in the
306 <tt>jakarta-commons</tt> CVS repository.</li>
307
308 <li>Mailing List - Discussions will take place on the general
309 <i>dev@commons.apache.org</i> mailing list. To help
310 list subscribers identify messages of interest, it is suggested that
311 the message subject of messages about this component be prefixed with
312 [lang].</li>
313
314 <li>Bugzilla - New component &quot;Lang&quot; under the &quot;Commons&quot; product
315 category, with appropriate version identifiers as needed.</li>
316
317 <li>Jyve FAQ - New category &quot;commons-lang&quot; (when available).</li>
318 </ul>
319
320
321 </div>
322
323 <div class="section">
324 <h3><a name="a.284.29_Initial_Committers"></a>(4) Initial Committers</h3>
325
326
327 <p>The initial committers on the Lang component shall be as follows:
328 </p>
329 <ul>
330
331 <li>Henri Yandell (bayard)</li>
332
333 <li>Daniel Rall (dlr)</li>
334
335 <li>Stephen Colebourne (scolebourne)</li>
336 </ul>
337
338
339 </div>
340 </div>
341
342
343 </td>
344 </tr>
345 </table>
346 </div>
347
348 <div class="footer">
349 <p>Copyright &copy; 2017-2018
350 <a href="https://www.apache.org/">The Apache Software Foundation</a>.
351 All Rights Reserved.</p>
352 </div>
353 </body>
354
355 </html>