|
|
|
@@ -0,0 +1,311 @@ |
|
|
|
|
|
|
|
|
|
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> |
|
|
|
<html lang="en"> |
|
|
|
<!-- GENERATED FILE, DO NOT EDIT, EDIT THE XML FILE IN xdocs INSTEAD! --> |
|
|
|
<head> |
|
|
|
<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> |
|
|
|
<title>Apache Ant - Ant Libraries - Charter</title> |
|
|
|
<link type="text/css" href="../page.css" rel="stylesheet"> |
|
|
|
</head> |
|
|
|
|
|
|
|
<body> |
|
|
|
<p class="navpath"> |
|
|
|
<script src="../breadcrumbs.js" language="JavaScript" type="text/javascript"></script> |
|
|
|
</p> |
|
|
|
|
|
|
|
<div class="logobar"> |
|
|
|
<table width="100%" border="0" cellspacing="0" cellpadding="0"> |
|
|
|
<tr> |
|
|
|
<td align="left"><img border="0" alt="Apache Ant site" src="../images/group-logo.gif"></td> |
|
|
|
<td align="center" width="100%"><img alt="Apache Ant logo" border="0" src="../images/project-logo.gif"></td> |
|
|
|
<td align="right"> |
|
|
|
<form target="_blank" onsubmit="q.value = query.value + ' site:ant.apache.org'" action="http://www.google.com/search" method="get"> |
|
|
|
<table summary="search" border="0" cellspacing="0" cellpadding="0" bgcolor="#4C6C8F"> |
|
|
|
<tr> |
|
|
|
<td colspan="3"><img height="10" width="1" alt="" src="../images/spacer.gif"></td> |
|
|
|
</tr> |
|
|
|
<tr> |
|
|
|
<td><img height="1" width="1" alt="" src="../images/spacer.gif"></td> |
|
|
|
<td nowrap="nowrap" class="searchcaption"> |
|
|
|
<input name="q" type="hidden"> |
|
|
|
<input size="15" id="query" type="text"> |
|
|
|
<img height="1" width="5" alt="" src="../images/spacer.gif"> |
|
|
|
<input name="Search" value="Search" type="submit"> |
|
|
|
<br> |
|
|
|
the Apache Ant site |
|
|
|
</td> |
|
|
|
<td><img height="1" width="1" alt="" src="../images/spacer.gif"></td> |
|
|
|
</tr> |
|
|
|
<tr> |
|
|
|
<td><img alt="" border="0" height="10" width="9" src="../images/search-left.gif"></td> |
|
|
|
<td><img height="1" width="1" alt="" src="../images/spacer.gif"></td> |
|
|
|
<td><img alt="" border="0" height="10" width="9" src="../images/search-right.gif"></td> |
|
|
|
</tr> |
|
|
|
</table> |
|
|
|
</form> |
|
|
|
</td> |
|
|
|
</tr> |
|
|
|
</table> |
|
|
|
</div> |
|
|
|
|
|
|
|
<div class="tab"> |
|
|
|
<table summary="tab bar" border="0" cellpadding="0" cellspacing="0"> |
|
|
|
<tr> |
|
|
|
<td width="5"><img alt="" height="8" width="8" src="../images/spacer.gif"></td><td valign="bottom"> |
|
|
|
<table summary="non selected tab" style="height: 1.4em" border="0" cellpadding="0" cellspacing="0"> |
|
|
|
<tr> |
|
|
|
<td valign="top" width="5" bgcolor="#B2C4E0"><img height="5" width="5" alt="" src="../images/tab-left.gif"></td><td valign="middle" bgcolor="#B2C4E0"><a href="../index.html"><font size="2" face="Arial, Helvetica, Sans-serif">Home</font></a></td><td valign="top" width="5" bgcolor="#B2C4E0"><img height="5" width="5" alt="" src="../images/tab-right.gif"></td> |
|
|
|
</tr> |
|
|
|
</table> |
|
|
|
</td> |
|
|
|
<td width="8"><img alt="" height="5" width="8" src="../images/spacer.gif"></td><td valign="bottom"> |
|
|
|
<table summary="selected tab" style="height: 1.5em" border="0" cellpadding="0" cellspacing="0"> |
|
|
|
<tr> |
|
|
|
<td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../images/tabSel-left.gif"></td><td valign="middle" bgcolor="#4C6C8F"><font color="#ffffff" size="2" face="Arial, Helvetica, Sans-serif"><b>Projects</b></font></td><td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5" alt="" src="../images/tabSel-right.gif"></td> |
|
|
|
</tr> |
|
|
|
</table> |
|
|
|
</td> |
|
|
|
</tr> |
|
|
|
</table> |
|
|
|
</div> |
|
|
|
|
|
|
|
<div class="bluebar"></div> |
|
|
|
|
|
|
|
<div class="menucontainer"> |
|
|
|
<div align="center"> |
|
|
|
<a href="http://ApacheCon.Com/"><img width="135" height="50" |
|
|
|
border="0" style="background-color: white" |
|
|
|
src="http://apache.org/images/ac2005eu_135x50.gif" |
|
|
|
alt="ApacheCon!" title="Come to ApacheCon!"/></a> |
|
|
|
</div> |
|
|
|
<div class="menu"> |
|
|
|
<ul> |
|
|
|
<li class="menuheader">Projects |
|
|
|
<ul> |
|
|
|
<li> |
|
|
|
<a href="../projects/index.html">Welcome</a> |
|
|
|
</li> |
|
|
|
</ul> |
|
|
|
</li> |
|
|
|
<li class="menuheader">Ant Libraries |
|
|
|
<ul> |
|
|
|
<li> |
|
|
|
<a href="../antlibs/index.html">Introduction</a> |
|
|
|
</li> |
|
|
|
<li> |
|
|
|
<a href="../antlibs/charter.html">Charter</a> |
|
|
|
</li> |
|
|
|
<li> |
|
|
|
<a href="../antlibs/proper.html">Ant Libraries</a> |
|
|
|
</li> |
|
|
|
<li> |
|
|
|
<a href="../antlibs/sandbox.html">Sandbox Ant Libraries</a> |
|
|
|
</li> |
|
|
|
</ul> |
|
|
|
</li> |
|
|
|
</ul> |
|
|
|
</div> |
|
|
|
<img style="float: left" height="10" width="10" border="0" alt="" src="../images/menu-left.gif"> |
|
|
|
<img style="float: right" height="10" width="10" border="0" alt="" src="../images/menu-right.gif"> |
|
|
|
</div> |
|
|
|
<div class="lightbluebar"> </div> |
|
|
|
<div class="main"> |
|
|
|
<div class="content"> |
|
|
|
<h1 class="title">Ant Libraries - Charter</h1> |
|
|
|
<h3 class="section"> |
|
|
|
<a name="Charter"></a> |
|
|
|
Charter |
|
|
|
</h3> |
|
|
|
<p>Below is the text of the proposal that has been accepted by |
|
|
|
the Ant PMC. Further amendments are expected.</p> |
|
|
|
<pre class="code"> |
|
|
|
Proposal to Create a Ant-Libraries Sub-Project in Apache Ant |
|
|
|
============================================================ |
|
|
|
|
|
|
|
(0) rationale |
|
|
|
|
|
|
|
Ant itself has accumulated lots and lots of tasks over time. So many, |
|
|
|
that Ant developers have become reluctant to adding new |
|
|
|
task. Furthermore any new task in Ant would be tied to Ant's release |
|
|
|
schedule which is too slow for a thriving, fresh piece of code. |
|
|
|
|
|
|
|
The proposal allows Ant tasks and types to be developed under the Ant |
|
|
|
umbrella by Ant developers but have much shorter release cycles than |
|
|
|
Ant itself. In addition it would new committers who would have commit |
|
|
|
access to a single Ant library instead of the whole of Ant. |
|
|
|
|
|
|
|
(1) scope of the subproject |
|
|
|
|
|
|
|
The subproject shall create and maintain libraries of Ant tasks and |
|
|
|
types. Each library will be managed in the same manner as the Ant |
|
|
|
project itself, the PMC is ultimately responsible for it. |
|
|
|
|
|
|
|
Common Java libraries that only happen to provide Ant tasks as well |
|
|
|
are out of scope of the subproject. Providing the tasks or types has |
|
|
|
to be the primary goal of the library. |
|
|
|
|
|
|
|
To further this goal, the subproject shall also host a workplace for |
|
|
|
Ant committers. |
|
|
|
|
|
|
|
(1.5) interaction with other subprojects |
|
|
|
|
|
|
|
(1.5.1) the sandbox |
|
|
|
|
|
|
|
The subproject will host a SVN repository available to all Ant |
|
|
|
committers as a workplace for new Ant libraries. |
|
|
|
|
|
|
|
Before a library can have a public release it has to get promoted to |
|
|
|
the "proper" Ant libraries subproject. This also means it has to match |
|
|
|
the requirements of an Ant library as defined in section (4) under |
|
|
|
Guidelines below. |
|
|
|
|
|
|
|
The status of any library developed in the sandbox shall be reviewed |
|
|
|
after six months and the library gets either promoted or removed - or |
|
|
|
it has to be re-evaluated after another six months. |
|
|
|
|
|
|
|
(2) identify the initial source from which the subproject is to be populated |
|
|
|
|
|
|
|
Some Ant committers have developed tasks or libraries inside of the |
|
|
|
Ant CVS module under the proposal/sandbox directory. Committers are |
|
|
|
free to move them over to the new sandbox subproject or remove them |
|
|
|
completely. |
|
|
|
|
|
|
|
Libraries expected to move to the sandbox subproject initially are |
|
|
|
|
|
|
|
* the .NET tasks under proposal/sandbox/dotnet |
|
|
|
|
|
|
|
* the Subversion support tasks under proposal/sandbox/svn |
|
|
|
|
|
|
|
(3) identify the initial Apache resources to be created |
|
|
|
|
|
|
|
(3.1) mailing list(s) |
|
|
|
|
|
|
|
None. At least at the beginning we don't expect too much traffic and |
|
|
|
the existing mailing lists of the Ant projects will be used. |
|
|
|
|
|
|
|
(3.2) SVN repositories |
|
|
|
|
|
|
|
Create <http://svn.apache.org/repos/asf/ant/> |
|
|
|
|
|
|
|
Expected are sub-directories |
|
|
|
|
|
|
|
antlibs/ |
|
|
|
| |
|
|
|
-----> proper/ |
|
|
|
| | |
|
|
|
| -----> library1 |
|
|
|
| | | |
|
|
|
| | -----------> trunk |
|
|
|
| | -----------> tags |
|
|
|
| | -----------> branches |
|
|
|
| -----> library2 |
|
|
|
| | |
|
|
|
| -----------> trunk |
|
|
|
| -----------> tags |
|
|
|
| -----------> branches |
|
|
|
| |
|
|
|
-----> sandbox/ |
|
|
|
| |
|
|
|
-----> library1 |
|
|
|
| | |
|
|
|
| -----------> trunk |
|
|
|
| -----------> tags |
|
|
|
| -----------> branches |
|
|
|
-----> library2 |
|
|
|
| |
|
|
|
-----------> trunk |
|
|
|
-----------> tags |
|
|
|
-----------> branches |
|
|
|
|
|
|
|
And potentially collections of all-trunks using svn:external as shown |
|
|
|
by the current Jakarta Commons structure. |
|
|
|
|
|
|
|
(3.3) Bugzilla |
|
|
|
|
|
|
|
New components under product "Ant" for each new library. |
|
|
|
|
|
|
|
(4) identify the initial set of committers |
|
|
|
|
|
|
|
All current Ant PMC members plus the active Ant committers who are not |
|
|
|
PMC members yet. |
|
|
|
|
|
|
|
Guidelines |
|
|
|
---------- |
|
|
|
|
|
|
|
Note: |
|
|
|
|
|
|
|
* is, has, will, shall, must - required. |
|
|
|
|
|
|
|
* may, should, are encouraged - optional but recommended. |
|
|
|
|
|
|
|
(1) The primary unit of reuse and release is the Ant library. |
|
|
|
|
|
|
|
(2) The library is not a framework or a general library but a |
|
|
|
collection of Ant tasks and types. |
|
|
|
|
|
|
|
(3) Each library must have a clearly defined purpose, scope, and API. |
|
|
|
|
|
|
|
(4) Each library is treated as a product in its own right. |
|
|
|
|
|
|
|
(4.1) Each library has its own status file, release schedule, version |
|
|
|
number, QA tests, documentation, bug category, and individual |
|
|
|
JAR. |
|
|
|
|
|
|
|
(4.2) Each library must clearly specify any external dependencies, |
|
|
|
including any other libraries, and the earliest JDK version |
|
|
|
required. |
|
|
|
|
|
|
|
(4.3) Each library must maintain a list of its active committers in |
|
|
|
its status file. |
|
|
|
|
|
|
|
(4.4) The libraries should use a standard scheme for versioning, QA |
|
|
|
tests, and directory layouts, and a common format for |
|
|
|
documentation and Ant build files. |
|
|
|
|
|
|
|
(4.4) Each library will be hosted on its own page on the subproject |
|
|
|
Web site, and will also be indexed in a master directory. |
|
|
|
|
|
|
|
(4.5) Volunteers become committers to this subproject in the same way |
|
|
|
they are entered to any Apache subproject. |
|
|
|
|
|
|
|
Once the required infrastructure is in place, volunteers may |
|
|
|
become committers for a single Ant library only. |
|
|
|
|
|
|
|
(4.6) New libraries may be proposed to the Ant dev mailing list. To be |
|
|
|
accepted, a library proposal must receive majority approval of |
|
|
|
the Ant PMC. Proposals are to identify the rationale for the |
|
|
|
library, its scope, the initial source from which the library is |
|
|
|
to be created, and the initial set of committers. |
|
|
|
|
|
|
|
(4.7) As stated in the Ant guidelines, an action requiring majority |
|
|
|
approval must receive at least 3 binding +1 votes and more +1 |
|
|
|
votes than -1 votes. |
|
|
|
|
|
|
|
(4.8) Each Ant library needs at least three committers, at least one |
|
|
|
of them has to be an Ant PMC member. |
|
|
|
</pre> |
|
|
|
|
|
|
|
</div> |
|
|
|
</div> |
|
|
|
|
|
|
|
<p class="copyright"> |
|
|
|
Copyright © 2000-2005 The Apache Software Foundation. All rights reserved. |
|
|
|
<script type="text/javascript" language="JavaScript"><!-- |
|
|
|
document.write(" - "+"Last Published: " + document.lastModified); |
|
|
|
// --> |
|
|
|
</script> |
|
|
|
</p> |
|
|
|
</body> |
|
|
|
</html> |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Stefan Bodewig