commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From bre...@apache.org
Subject cvs commit: jakarta-commons-sandbox/net/xdocs proposal.xml navigation.xml tasks.xml
Date Thu, 12 Sep 2002 04:10:42 GMT
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:   <mailto:commons-dev-unsubscribe@jakarta.apache.org>
For additional commands, e-mail: <mailto:commons-dev-help@jakarta.apache.org>


Mime
View raw message