You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@commons.apache.org by je...@apache.org on 2003/11/23 14:13:28 UTC

cvs commit: jakarta-commons-sandbox/io project.xml STATUS.html

jeremias    2003/11/23 05:13:28

  Modified:    io/xdocs tasks.xml
               io       project.xml STATUS.html
  Added:       io/xdocs changes.xml
  Log:
  Updated site:
  - Added Alban Peignier as contributor
  - Moved changes to new changes.xml (may be incomplete)
  - Todo list only in tasks.xml now
  - Snipped some duplicate content from STATUS.html
  
  Revision  Changes    Path
  1.2       +46 -71    jakarta-commons-sandbox/io/xdocs/tasks.xml
  
  Index: tasks.xml
  ===================================================================
  RCS file: /home/cvs/jakarta-commons-sandbox/io/xdocs/tasks.xml,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- tasks.xml	21 Sep 2003 17:57:00 -0000	1.1
  +++ tasks.xml	23 Nov 2003 13:13:28 -0000	1.2
  @@ -1,76 +1,51 @@
   <?xml version="1.0"?>
  -
   <document>
  -
  -    <body>
  -        <section name="Action Items">
  -
  -            <p>
  -                The following action items need to be completed prior to a Version 1.0
  -                release of this component:
  -            </p>
  -
  -            <ul>
  -                <li>Compress - Move the compress sub-package out of IO - READY</li>
  -                <li>Rename FileUtilTest to FileUtilsTest - DONE</li>
  -                <li>Rename *Util.java for *Utils.java for consistency - DONE</li>
  -                <li>Extract code from IOUtils to CopyUtils? </li>
  -                <li>Remove StreamUtils as all its methods are in IOUtils - DONE</li>
  -
  -                <li>IOUtils: Remove the toByteArray() variants with the bufferSize
  -                parameter. Reasoning can be found at
  -                http://www.mail-archive.com/commons-dev@jakarta.apache.org/msg19703.html</li>
  -
  -                <li>IOUtils: Change toByteArray() methods to use the new
  -                ByteArrayOutputStream which should improve performance considerably.</li>
  -
  -                <li>IOUtils: Remove the deprecated bufferedCopy method. IO is not released
  -                so we should be able to do that - DONE</li>
  -
  -                <li>FileUtils: This class is a big mess ATM. We need to clean it up.</li>
  -                <li>Split IOUtils into IOUtils and CopyUtils - DONE (Matthew Hawthorne)</li>
  -                <li>More TestCases!!!</li>
  -                <li>More Javadocs!!!</li>
  -            </ul>
  -        </section>
  -
  -        <section name="New Code">
  -            <ul>
  -              <li>ProxyOutput/InputStream. These are predictable Filter-streams. Need to see if FilterWriter/Reader are predictable - DONE</li>
  -              <li>
  -                FileUtils: Add isFileNewer() method from Alban Peignier:
  -                <![CDATA[
  -                http://nagoya.apache.org/eyebrowse/BrowseList?listName=commons-dev@jakarta.apache.org&by=thread&from=348688 - DONE
  -           ]]>
  -              </li>
  -
  -              <li>A CsvReader/Writer set of classes in a csv sub-package</li>
  -              <li>FilePoller for telling when a file changes. Look in Tomcat, or GenJava[bayard]</li>
  -              <li>JoinReader/ConcatReader. One in GenJava, one submitted to Bayard</li>
  -              <li>FormattedWriter, when it writes out values it uses Format objects to output them. </li>
  -              <li>FixedWidthReader. Reads in files with a known width, ie) mainframe like. </li>
  -              <li>Finder system. Generic code to find things in things. So FileFinder, ClassFinder, ZipFinder. Probably too big for IO</li>
  -              <li>Add an additional ByteArrayOutputStream variant that saves content
  -                in memory just as the original but starts to write to a temp file when
  -                a given number of bytes is surpassed. This is to reduce the memory
  -                usage for big "things".</li>
  -            </ul>
  +  <body>
  +    <section name="Action Items">
  +      <p>
  +        The following action items need to be completed prior to a Version 1.0
  +        release of this component:
  +      </p>
  +      <ul>
  +        <li>Compress - Move the compress sub-package out of IO - READY</li>
  +        <li>IOUtils: Remove the toByteArray() variants with the bufferSize
  +            parameter. Reasoning can be found at
  +            http://www.mail-archive.com/commons-dev@jakarta.apache.org/msg19703.html</li>
  +        <li>FileUtils: This class is a big mess ATM. We need to clean it up.</li>
  +        <li>Creation of FilenameUtils: This class will take over the methods with 
  +            String filename parameters. FileUtils is only for methods with 
  +            java.io.File parameters.</li>
  +        <li>Need to see if FilterWriter/Reader are predictable (see also ProxyInput/OutputStream)</li>
  +        <li>More TestCases!!!</li>
  +        <li>More Javadocs!!!</li>
  +        <li>Improve site!!!</li>
  +      </ul>
  +    </section>
  +    <section name="New Code">
  +      <ul>
  +        <li>A CsvReader/Writer set of classes in a csv sub-package</li>
  +        <li>FilePoller for telling when a file changes. Look in Tomcat, or GenJava[bayard]</li>
  +        <li>JoinReader/ConcatReader. One in GenJava, one submitted to Bayard</li>
  +        <li>FormattedWriter, when it writes out values it uses Format objects to output them. </li>
  +        <li>FixedWidthReader. Reads in files with a known width, ie) mainframe like. </li>
  +        <li>Finder system. Generic code to find things in things. So FileFinder, 
  +            ClassFinder, ZipFinder. Probably too big for IO</li>
  +        <li>Add an additional ByteArrayOutputStream variant that saves content
  +            in memory just as the original but starts to write to a temp file when
  +            a given number of bytes is surpassed. This is to reduce the memory
  +            usage for big "things".</li>
  +      </ul>
       </section>
  -
       <section name="Misc.">
  -        <ul>
  -            <li>
  -                <strong>Integration</strong>.  Seek and integrate various i/o related
  -                classes.
  -            </li>
  -
  -            <li>
  -                <strong>Install / Use Documentation</strong>.  Create simple
  -                installation and User's Guide documentation for this component.
  -            </li>
  -       </ul>
  -   </section>
  -
  -    </body>
  -
  +      <ul>
  +        <li>
  +          <strong>Integration</strong>. Seek and integrate various i/o related classes.
  +        </li>
  +        <li>
  +          <strong>Install / Use Documentation</strong>.  Create simple
  +          installation and User's Guide documentation for this component.
  +        </li>
  +      </ul>
  +    </section>
  +  </body>
   </document>
  
  
  
  1.1                  jakarta-commons-sandbox/io/xdocs/changes.xml
  
  Index: changes.xml
  ===================================================================
  <?xml version="1.0" encoding="UTF-8"?>
  <document>
    <properties>
      <title>Changes</title>
    </properties>
    <body>
      <release version="1.0-dev" date="in CVS">
        <action type="update">
          Renamed all *Util.java to *Utils.java for consistency.
        </action>
        <action dev="jeremias" type="update" 
            due-to="Matthew Hawthorne" due-to-email="mhawthorne at alumni.pitt.edu">
          Moved copy methods from IOUtils to CopyUtils.
        </action>
        <action dev="jeremias" type="update" 
            due-to="Matthew Hawthorne" due-to-email="mhawthorne at alumni.pitt.edu">
          Deprecated all methods in FileUtils using String filenames instead of 
          java.io.File.
        </action>
        <action dev="bayard" type="remove">
          Removed StreamUtils as all functionality is is IOUtils (and CopyUtils).
        </action>
        <action dev="rdonkin" type="fix">
          Fixed typos in Apache license.
        </action>
        <action dev="jeremias" type="update">
          All of Commons IO now uses its own ByteArrayOutputStream instead of 
          java.io.ByteArrayOutputStream which should improve speed.
        </action>
        <action dev="jeremias" type="remove">
          Removed deprecated IOUtils.bufferedCopy method.
        </action>
        <action dev="bayard" type="add">
          ProxyInput/OutputStream: Better alternative base class than 
          FilterInput/OutputStream.
        </action>
        <action dev="jeremias" type="add"
            due-to="Alban Peignier" due-to-email="alban.peignier at free.fr">
          New methods for FileUtils: isFileNewer() (3 variants)
        </action>
        <actions dev="bayard" type="add"
            due-to="Jeremias Maerki" due-to-email="jeremias at apache.org">
          Added an alternative ByteArrayOutputStream implementation which is faster than
          the original java.io.ByteArrayOutputStream by reusing buffers instead of 
          reallocating them when the buffer needs to be resized.
        </actions>
      </release>
    </body>
  </document>
  
  
  
  
  1.13      +10 -0     jakarta-commons-sandbox/io/project.xml
  
  Index: project.xml
  ===================================================================
  RCS file: /home/cvs/jakarta-commons-sandbox/io/project.xml,v
  retrieving revision 1.12
  retrieving revision 1.13
  diff -u -r1.12 -r1.13
  --- project.xml	23 Nov 2003 08:04:06 -0000	1.12
  +++ project.xml	23 Nov 2003 13:13:28 -0000	1.13
  @@ -137,6 +137,8 @@
               <roles>
                   <role>Java Developer</role>
               </roles>
  +            <url>http://nagoya.apache.org/wiki/apachewiki.cgi?JeremiasMaerki</url>
  +            <timezone>+1</timezone>
           </developer>
   
           <developer>
  @@ -150,6 +152,13 @@
           </developer>
   
       </developers>
  +    
  +    <contributors>
  +        <contributor>
  +            <name>Alban Peignier</name>
  +            <email>alban.peignier at free.fr</email>
  +        </contributor>
  +    </contributors>
   
       <!-- Need to mark these as compile-time/run-time -->
       <dependencies>
  @@ -206,6 +215,7 @@
           <report>maven-linkcheck-plugin</report>
           <report>maven-pmd-plugin</report>
   
  +        <report>maven-changes-plugin</report>
           <report>maven-changelog-plugin</report>
           <report>maven-developer-activity-plugin</report>
           <report>maven-file-activity-plugin</report>
  
  
  
  1.13      +10 -74    jakarta-commons-sandbox/io/STATUS.html
  
  Index: STATUS.html
  ===================================================================
  RCS file: /home/cvs/jakarta-commons-sandbox/io/STATUS.html,v
  retrieving revision 1.12
  retrieving revision 1.13
  diff -u -r1.12 -r1.13
  --- STATUS.html	21 Oct 2003 04:37:50 -0000	1.12
  +++ STATUS.html	23 Nov 2003 13:13:28 -0000	1.13
  @@ -47,83 +47,19 @@
   
   <a name="Committers"></a>
   <h3>4.  COMMITTERS</h3>
  -
  -<p>The following individuals are the primary developers and maintainers of
  -this component.  Developers who plan to use <em>IO</em> in their own projects
  -are encouraged to collaborate on the future development of this component
  -to ensure that it continues to meet a variety of needs.</p>
  -
  -<ul>
  - <li><a href="mailto:sanders@apache.org">Scott Sanders</a></li>
  - <li><a href="mailto:dion@apache.org">dIon Gillard</a></li>
  - <li><a href="maito:nicolaken@apache.org">Nicola Ken Barozzi</a><br></li>
  - <li><a href="maito:bayard@apache.org">Henri Yandell</a><br></li>
  - <li><a href="maito:scolebourne@apache.org">Stephen Colebourne</a><br></li>
  - <li><a href="maito:jeremias@apache.org">Jeremias Maerki</a><br></li>
  - <li>Matthew Hawthorne</li><br/>
  - <li>Fancy volunteering?  We need you!</li>
  -</ul>
  -
  +<p>
  +  Please see <a href="http://jakarta.apache.org/commons/sandbox/io/team-list.html">Team list</a>.
  +</p>
   
   <a name="Action Items"></a>
   <h3>5.  ACTION ITEMS</h3>
   
  -<p>The following action items need to be completed prior to a Version 1.0
  -release of this component:</p>
  -<ul>
  -  <li>Compress - Move the compress sub-package out of IO - READY</li>
  -  <li>Rename FileUtilTest to FileUtilsTest - DONE</li>
  -  <li>Rename *Util.java for *Utils.java for consistency - DONE</li>
  -  <li>Extract code from IOUtils to CopyUtils? </li>
  -  <li>Remove StreamUtils as all its methods are in IOUtils - DONE</li>
  -  <li>IOUtils: Remove the toByteArray() variants with the bufferSize
  -    parameter. Reasoning can be found at
  -    http://www.mail-archive.com/commons-dev@jakarta.apache.org/msg19703.html</li>
  -  <li>IOUtils: Change toByteArray() methods to use the new
  -    ByteArrayOutputStream which should improve performance considerably.</li>
  -  <li>IOUtils: Remove the deprecated bufferedCopy method. IO is not released
  -    so we should be able to do that - DONE</li>
  -  <li>FileUtils: This class is a big mess ATM. We need to clean it up.</li>
  -  <li>Split IOUtils into IOUtils and CopyUtils - DONE (Matthew Hawthorne)</li>
  -  <li>More TestCases!!!</li>
  -  <li>More Javadocs!!!</li>
  -</ul>
  -<h5>5.1  NEW CODE</h5>
  -<ul>
  -  <li>ProxyOutput/InputStream. These are predictable Filter-streams. Need to see if FilterWriter/Reader are predictable - DONE</li>
  -  <li>FileUtils: Add isFileNewer() method from Alban Peignier:
  -    http://nagoya.apache.org/eyebrowse/BrowseList?listName=commons-dev@jakarta.apache.org&by=thread&from=348688 - DONE</li>
  -  <li>A CsvReader/Writer set of classes in a csv sub-package</li>
  -  <li>FilePoller for telling when a file changes. Look in Tomcat, or GenJava[bayard]</li>
  -  <li>JoinReader/ConcatReader. One in GenJava, one submitted to Bayard</li>
  -  <li>FormattedWriter, when it writes out values it uses Format objects to output them. </li>
  -  <li>FixedWidthReader. Reads in files with a known width, ie) mainframe like. </li>
  -  <li>Finder system. Generic code to find things in things. So FileFinder, ClassFinder, ZipFinder. Probably too big for IO</li>
  -  <li>Add an additional ByteArrayOutputStream variant that saves content
  -    in memory just as the original but starts to write to a temp file when
  -    a given number of bytes is surpassed. This is to reduce the memory
  -    usage for big "things".</li>
  -</ul>
  -
  -<table border="1">
  -    <tbody>
  -    <tr>
  -     <th width="80%">Action Item</th>
  -     <th width="20%">Volunteer</th>
  -   </tr>
  -    <tr>
  -     <td><strong>Integration</strong>.  Seek and integrate various i/o related
  -classes.</td>
  -     <td align="center">Everyone</td>
  -   </tr>
  -    <tr>
  -     <td><strong>Install / Use Documentation</strong>.  Create simple
  -     installation and User's Guide documentation for this component.</td>
  -     <td align="center">everyone</td>
  -   </tr>
  +<p>
  +  Please see 
  +  <a href="http://jakarta.apache.org/commons/sandbox/io/tasks.html">Tasks</a>
  +  and
  +  <a href="http://jakarta.apache.org/commons/sandbox/io/changes-report.html">Changes</a>
  +</p>
   
  -  </tbody>
  -</table>
  -  <br>
   </body>
   </html>
  
  
  

---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org