You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@commons.apache.org by br...@apache.org on 2002/09/12 06:10:42 UTC
cvs commit: jakarta-commons-sandbox/net/xdocs proposal.xml navigation.xml tasks.xml
brekke 2002/09/11 21:10:42
Modified: net project.xml
net/xdocs navigation.xml tasks.xml
Added: net/xdocs proposal.xml
Log:
o Added proposal document per commons charter
o Updated task list to be more in order
o Added notes to task about ftp2 issues and multi-line listings
o Moved steve into the contibutor area
Revision Changes Path
1.15 +4 -8 jakarta-commons-sandbox/net/project.xml
Index: project.xml
===================================================================
RCS file: /home/cvs/jakarta-commons-sandbox/net/project.xml,v
retrieving revision 1.14
retrieving revision 1.15
diff -u -r1.14 -r1.15
--- project.xml 6 Aug 2002 15:23:37 -0000 1.14
+++ project.xml 12 Sep 2002 04:10:42 -0000 1.15
@@ -66,12 +66,6 @@
<organization>Quad/Graphics, Inc.</organization>
</developer>
<developer>
- <name>Steve Cohen</name>
- <id/>
- <email>stevecoh1@attbi.com</email>
- <organization/>
- </developer>
- <developer>
<name>Daniel F. Savarese</name>
<id>savarese</id>
<email>savarese@apache.org</email>
@@ -82,13 +76,15 @@
<contributors>
<contributor>
<name>Winston Ojeda</name>
- <id/>
<email>Winston.Ojeda@qg.com</email>
<organization>Quad/Graphics, Inc.</organization>
</contributor>
+ <contributor>
+ <name>Steve Cohen</name>
+ <email>stevecoh1@attbi.com</email>
+ </contributor>
</contributors>
-
<dependencies>
<dependency>
<id>oro</id>
1.2 +1 -0 jakarta-commons-sandbox/net/xdocs/navigation.xml
Index: navigation.xml
===================================================================
RCS file: /home/cvs/jakarta-commons-sandbox/net/xdocs/navigation.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- navigation.xml 6 Aug 2002 15:23:38 -0000 1.1
+++ navigation.xml 12 Sep 2002 04:10:42 -0000 1.2
@@ -5,6 +5,7 @@
<body>
<menu name="Development">
+ <item name="Proposal" href="/proposal.html"/>
<item name="Coding Specifications" href="/code-standards.html"/>
</menu>
</body>
1.3 +6 -7 jakarta-commons-sandbox/net/xdocs/tasks.xml
Index: tasks.xml
===================================================================
RCS file: /home/cvs/jakarta-commons-sandbox/net/xdocs/tasks.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- tasks.xml 29 Apr 2002 03:55:32 -0000 1.2
+++ tasks.xml 12 Sep 2002 04:10:42 -0000 1.3
@@ -14,18 +14,11 @@
Convert code to specified coding standards. Checkstyle report provided.
</li>
<li>
- Evaluate options for integrating FTPClient2/parsing into FTPClient while maintaining (deprecated)
- old interface.
- </li>
- <li>
Clean out any classes that don't belong in this project. Probably classes from
org.apache.commons.util and org.apache.commons.io could be moved to their corresponding
commons projects.
</li>
<li>
- Create proposal documents for the project.
- </li>
- <li>
DefaultFTPFileLister doesn't work with every FTP server.
Some Microsoft and VMS FTP servers foil it. It is also
wasteful of memory in that it parses the listing into a
@@ -39,6 +32,12 @@
regular expression rather than create a completely new
hand-parsed FTPFileLister implementation. ( Partially implemented
by Steve Cohen )
+ This partial implementation has some problems since it assumes
+ that the ftp server is returning one line for each entry.
+ Some ftp servers return two lines for each entry which makes the
+ current implementation unusable with those ftp servers. One
+ possible solution is to use the regular expression to parse the
+ entries instead of assuming each line is one entry.
</li>
<li>
Make buffer size settable for FTP data transfers using
1.1 jakarta-commons-sandbox/net/xdocs/proposal.xml
Index: proposal.xml
===================================================================
<?xml version="1.0"?>
<document>
<properties>
<title>Proposal for Commons/Net</title>
<author email="brekke@apache.org">Jeffrey D. Brekke</author>
</properties>
<body>
<section name="(0) Rationale">
<p>
Java doesn't provide an api for common internet protocols. Many
applications need to communicate via well known internet protocols such as
ftp, smtp, and telnet.
</p>
</section>
<section name="(1) Scope of the Package">
<p>
The purpose of the library is to provide fundamental protocol access,
not higher-level abstractions. Therefore, some of the design violates
object-oriented design principles. Our philosophy is to make the global
functionality of a protocal accesible (e.g., TFTP send file and receive
file) when possible, but also provide access to the fundamental protocols
where applicable so that the programmer may construct his own custom
implementations (e.g, the TFTP packet classes and the TFTP packet send
and receive methods are exposed).
</p>
</section>
<section name="(2) Initial Source of the Package">
<p>The initial classes came from the NetComponents project donated by Daniel Savarese of Oro Inc.</p>
<p>The proposed package name for the new component is org.apache.commons.net</p>
</section>
<section name="(3) Required Jakarta-Commons Resources">
<ul>
<li>CVS Repository - New directory <code>net</code> in the
<code>jakarta-commons</code> CVS repository.</li>
<li>Mailing List - Discussions will take place on the general
<em>commons-dev@jakarta.apache.org</em> mailing list. To help
list subscribers identify messages of interest, it is suggested that
the message subject of messages about this component be prefixed with
[net].</li>
<li>Bugzilla - New component "net" under the "Commons" product
category, with appropriate version identifiers as needed.</li>
<li>Jyve FAQ - New category "commons-net" (when available).</li>
</ul>
</section>
<section name="(4) Initial Committers">
<p>The initial committers on Commons/Net may be found shall be as follows:
<ul>
<li>Jeffrey D. Brekke (brekke)</li>
<li>Daniel Savarese (savarese)</li>
</ul>
</p>
</section>
</body>
</document>
--
To unsubscribe, e-mail: <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>