Skip to content

Commit 9eb351e

Browse files
author
Scott Sanders
committed
Initial proposal of IO package
git-svn-id: https://svn.apache.org/repos/asf/jakarta/commons/proper/io/trunk@140285 13f79535-47bb-0310-9956-ffa450edef68
1 parent 9423d7d commit 9eb351e

5 files changed

Lines changed: 435 additions & 0 deletions

File tree

PROPOSAL.html

Lines changed: 70 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,70 @@
1+
<html>
2+
<head>
3+
<title>Proposal for IO Package</title>
4+
</head>
5+
<body bgcolor="white">
6+
7+
<div align="center">
8+
<h1>Proposal for <em>IO</em> Package</h1>
9+
</div>
10+
11+
<h3>(0) Rationale</h3>
12+
13+
<p>Many software projects have a need to perform I/O in various ways,
14+
and the JDK class libraries provide a lot of functionality, but
15+
sometimes you need just a little bit more. The io package seeks to
16+
encapsulate some of the most popular i/o base classes into one easy to
17+
use package.</p>
18+
19+
20+
<h3>(1) Scope of the Package</h3>
21+
22+
<p>This proposal is to create a package of Java utility classes for
23+
various types of i/o related activity.</p>
24+
25+
26+
<h3>(1.5) Interaction With Other Packages</h3>
27+
28+
<p><em>IO</em> relies only on standard JDK 1.2 (or later) APIs for
29+
production deployment. It utilizes the JUnit unit testing framework for
30+
developing and executing unit tests, but this is of interest only to
31+
developers of the component. IO will be a dependency for
32+
several existing components in the open source world.</p>
33+
34+
<p>No external configuration files are utilized.</p>
35+
36+
37+
<h3>(2) Initial Source of the Package</h3>
38+
39+
<p>The original Java classes are splashed around various Apache
40+
subprojects. We intend to seek them out and integrate them.</p>
41+
42+
<p>The proposed package name for the new component is
43+
<code>org.apache.commons.io</code>.</p>
44+
45+
46+
<h3>(3) Required Jakarta-Commons Resources</h3>
47+
48+
<ul>
49+
<li>CVS Repository - New directory <code>io</code> in the
50+
<code>jakarta-commons</code> CVS repository.</li>
51+
<li>Mailing List - Discussions will take place on the general
52+
<em>jakarta-commons@jakarta.apache.org</em> mailing list. To help
53+
list subscribers identify messages of interest, it is suggested that
54+
the message subject of messages about this component be prefixed with
55+
[IO].</li>
56+
<li>Bugzilla - New component "IO" under the "Commons" product
57+
category, with appropriate version identifiers as needed.</li>
58+
<li>Jyve FAQ - New category "commons-io" (when available).</li>
59+
</ul>
60+
61+
62+
<h3>(4) Initial Committers</h3>
63+
64+
<p>The initial committers on the BeanUtils component shall be Scott Sanders
65+
and ???(Your name here)</p>
66+
67+
68+
69+
</body>
70+
</html>

RELEASE-NOTES.txt

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,23 @@
1+
$Id: RELEASE-NOTES.txt,v 1.1 2002/01/25 19:06:14 sanders Exp $
2+
3+
Commons I/O Package
4+
Version 1.0-dev
5+
Release Notes
6+
7+
8+
INTRODUCTION:
9+
10+
This document contains the release notes for this version of the Commons
11+
I/O package, and highlights changes since the previous version. The
12+
current release adds new features and bug fixes, and is being done now to
13+
follow the release early/release often mentality.
14+
15+
16+
NEW FEATURES:
17+
18+
*
19+
20+
21+
BUG FIXES:
22+
23+

STATUS.html

Lines changed: 95 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,95 @@
1+
<html>
2+
<head>
3+
<title>Status File for Jakarta Commons "IO" Component</title>
4+
</head>
5+
<body bgcolor="white">
6+
7+
8+
<div align="center">
9+
<h1>The Jakarta Commons <em>IO</em> Component</h1>
10+
$Id: STATUS.html,v 1.1 2002/01/25 19:06:14 sanders Exp $<br />
11+
<a href="#Introduction">[Introduction]</a>
12+
<a href="#Dependencies">[Dependencies]</a>
13+
<a href="#Release Info">[Release Info]</a>
14+
<a href="#Committers">[Committers]</a>
15+
<a href="#Action Items">[Action Items]</a>
16+
<br /><br />
17+
</div>
18+
19+
20+
<a name="Introduction"></a>
21+
<h3>1. INTRODUCTION</h3>
22+
23+
<p>The <em>IO</em> Component contains a set of Java classes that provide
24+
I/O functionality above and beyond what the JDK provides out of the box.
25+
The following classes are included:</p>
26+
<ul>
27+
<li><strong>TBD</strong> - TBD.</li>
28+
</ul>
29+
30+
31+
<a name="Dependencies"></a>
32+
<h3>2. DEPENDENCIES</h3>
33+
34+
<p>The <em>IO</em> component is dependent upon the following external
35+
components for development and use:</p>
36+
<ul>
37+
<li><a href="http://java.sun.com/j2se">Java Development Kit</a>
38+
(Version 1.2 or later)</li>
39+
<li><a href="http://www.junit.org">JUnit Testing Framework</a>
40+
(Version 3.7 or later) - for unit tests only, not required
41+
for deployment</li>
42+
</ul>
43+
44+
45+
<a name="Release Info"></a>
46+
<h3>3. RELEASE INFO</h3>
47+
48+
<p>Current Release: IO is yet to be released. We hope it will be RSN.</p>
49+
50+
<p>Planned Next Release: Real Soon Now :) See the
51+
<a href="#Action Items">Action Items</a> list for tasks that need to be
52+
completed prior to this release.</p>
53+
54+
55+
<a name="Committers"></a>
56+
<h3>4. COMMITTERS</h3>
57+
58+
<p>The following individuals are the primary developers and maintainers of this
59+
component. Developers who plan to use <em>IO</em> in their own
60+
projects are encouraged to collaborate on the future development of this
61+
component to ensure that it continues to meet a variety of needs.</p>
62+
<ul>
63+
<li><a href="mailto:sanders@apache.org">Scott Sanders</a></li>
64+
<li>Fancy volunteering? We need you!</li>
65+
</ul>
66+
67+
68+
<a name="Action Items"></a>
69+
<h3>5. ACTION ITEMS</h3>
70+
71+
<p>The following action items need to be completed prior to a Version 1.3
72+
release of this component:</p>
73+
74+
<table border="1">
75+
76+
<tr>
77+
<th width="80%">Action Item</th>
78+
<th width="20%">Volunteer</th>
79+
</tr>
80+
81+
<tr>
82+
<td><strong>Integration</strong>. Seek and integrate various i/o related classes.</td>
83+
<td align="center">Everyone</td>
84+
</tr>
85+
86+
<tr>
87+
<td><strong>Install / Use Documentation</strong>. Create simple
88+
installation and User's Guide documentation for this component.</td>
89+
<td align="center">everyone</td>
90+
</tr>
91+
92+
</table>
93+
94+
</body>
95+
</html>

build.properties.sample

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
# The directory containing your binary distribution of JUnit,
2+
# version 3.7 or later
3+
junit.home = /usr/local/junit3.7
4+
5+
# The pathname of the "junit.jar" JAR file
6+
junit.jar = ${junit.home}/junit.jar

0 commit comments

Comments
 (0)