xref: /aosp_15_r20/external/apache-commons-lang/src/site/xdoc/index.xml (revision 455610af95f3bf5f4bc8a9eda520f57e389a4c42)
1<?xml version="1.0"?>
2<!--
3Licensed to the Apache Software Foundation (ASF) under one or more
4contributor license agreements.  See the NOTICE file distributed with
5this work for additional information regarding copyright ownership.
6The ASF licenses this file to You under the Apache License, Version 2.0
7(the "License"); you may not use this file except in compliance with
8the License.  You may obtain a copy of the License at
9
10     http://www.apache.org/licenses/LICENSE-2.0
11
12Unless required by applicable law or agreed to in writing, software
13distributed under the License is distributed on an "AS IS" BASIS,
14WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15See the License for the specific language governing permissions and
16limitations under the License.
17-->
18<document>
19 <properties>
20  <title>Home</title>
21  <author email="[email protected]">Commons Documentation Team</author>
22 </properties>
23<body>
24<!-- ================================================== -->
25<section name="Commons Lang">
26
27<p>
28The standard Java libraries fail to provide enough methods for
29manipulation of its core classes. Apache Commons Lang provides
30these extra methods.
31</p>
32
33<p>
34Apache Commons Lang provides a host of helper utilities for the java.lang API, notably
35String manipulation methods, basic numerical methods, object reflection, concurrency, creation and serialization
36and System properties. Additionally it contains basic enhancements to java.util.Date and a series of utilities dedicated to help with
37building methods, such as hashCode, toString and equals.
38</p>
39<p>
40Note that Commons Lang 3.0 (and subsequent versions) use a different package (<em>org.apache.commons.lang3</em>) than the previous versions (<em>org.apache.commons.lang</em>),
41allowing Commons Lang 3 to be used at the same time as Commons Lang 2.
42</p>
43</section>
44<!-- ================================================== -->
45<section name="Documentation">
46<p>
47The package descriptions in the <a href="javadocs/api-release/index.html">Javadoc</a> give an overview of the available features
48and various <a href="project-reports.html">project reports</a> are provided.
49</p>
50<p>
51The Javadoc API documents are available online:
52</p>
53<ul>
54<li>The <a href="javadocs/api-release/index.html">current release</a> [Java 8 and up]</li>
55<li>The <a href="javadocs/api-2.6/index.html">legacy release 2.6</a> [Java 1.2 and up]</li>
56<li>Older releases - see the <a href="changes-report.html">Release History</a> page</li>
57</ul>
58<p>
59The <a href="scm.html">git repository</a> can be
60<a href="https://gitbox.apache.org/repos/asf?p=commons-lang.git">browsed</a>, or you can browse/contribute via <a href="https://github.com/apache/commons-lang">GitHub</a>.
61</p>
62</section>
63<!-- ================================================== -->
64<section name="Release Information">
65<p>Read about the latest release:</p>
66<ul>
67<li>Pull it using a build tool like Maven using a <a href="dependency-info.html">dependency management reference</a>.</li>
68<li>Download the latest release from a <a href="https://commons.apache.org/lang/download_lang.cgi">mirror</a>.</li>
69<li>Read the <a href="changes-report.html">change report</a>.</li>
70<li>Examine the <a href="article3_0.html">2.x to 3.0 upgrade notes</a>.</li>
71<li>Compare major versions via the <a href="lang2-lang3-clirr-report.html">Lang2 to Lang3 Clirr report</a>.</li>
72</ul>
73
74<p>
75For information on previous releases see the <a href="changes-report.html">Release History</a>, and to download previous releases see the <a href="https://archive.apache.org/dist/commons/lang/">Commons Lang Archive</a>.
76</p>
77</section>
78<!-- ================================================== -->
79<section name="Getting Involved">
80<p>
81The <a href="mail-lists.html">commons developer mailing list</a> is the main channel of communication for contributors. Please remember that the lists are shared between all commons components, so prefix your email by [lang]. </p>
82<p>You can also visit the #apache-commons IRC channel on irc.freenode.net or peruse <a href="issue-tracking.html">JIRA</a>. Specific links of interest for JIRA are:</p>
83<ul>
84<li>Ideas looking for code: <a href="https://issues.apache.org/jira/issues/?jql=project%20%3D%20LANG%20AND%20resolution%20%3D%20Unresolved%20AND%20fixVersion%20%3D%20%22Patch%20Needed%22%20ORDER%20BY%20priority%20DESC">Patch Needed</a></li>
85<li>Issues with patches, looking for reviews: <a href="https://issues.apache.org/jira/issues/?jql=fixVersion%20%3D%20%22Review%20Patch%22%20AND%20project%20%3D%20LANG%20AND%20resolution%20%3D%20Unresolved%20ORDER%20BY%20priority%20DESC">Review Patch</a></li>
86</ul>
87<p>Alternatively you can go through the <em>Needs Work</em> tags in the <a href="taglist.html">TagList report</a>.</p>
88<p>If you'd like to offer up pull requests via GitHub rather than applying patches to JIRA, we have a <a href="https://github.com/apache/commons-lang/">GitHub mirror</a>. </p>
89</section>
90<!-- ================================================== -->
91<section name="Support">
92<p>
93The <a href="mail-lists.html">commons mailing lists</a> act as the main support forum.
94The user list is suitable for most library usage queries.
95The dev list is intended for the development discussion.
96Please remember that the lists are shared between all commons components,
97so prefix your email by [lang].
98</p>
99<p>
100Bug reports and enhancements are also welcomed via the <a href="issue-tracking.html">JIRA</a> issue tracker.
101Please read the instructions carefully.
102</p>
103</section>
104<!-- ================================================== -->
105</body>
106</document>
107