Mailing-List: contact commons-dev-help@jakarta.apache.org; run by ezmlm
Precedence: bulk
Reply-To: "Jakarta Commons Developers List" <commons-dev@jakarta.apache.org>
Date: 26 May 2003 18:11:30 -0000
Message-ID: <20030526181130.54234.qmail@icarus.apache.org>
From: juanco@apache.org
To: jakarta-commons-sandbox-cvs@apache.org
Subject: cvs commit: jakarta-commons-sandbox/jrcs/doc default.css index.html
 jrcs.gif

juanco      2003/05/26 11:11:30

  Added:       jrcs/doc default.css index.html jrcs.gif
  Log:
  added basic documentation as it appeared on original site
  
  Revision  Changes    Path
  1.1                  jakarta-commons-sandbox/jrcs/doc/default.css
  
  Index: default.css
  ===================================================================
  body {
    background-color: white; 
    color: black; 
    font-family: Arial,Helvetica,sans-serif;
    margin-left: 48; 
    margin-right: 48; 
    margin-top:16; 
    font-size:80%;
  }
  
  a            { font-size: 100%; 
  					letter-spacing: 1;
  				 }
  
  
  acronym { 
    font-weight:bold;
  }      
  
  a:link       { 
    color:darkgreen; 
  }
  
  a:visited    { color : #336633; 
  					}
  a:active   {
   color :green; 
  }
  
  a:hover,
  a:visited:hover {
  }
  
  p            { text-indent: 0; margin-top: 4; margin-bottom: 8 }
  p.indent   {}
  
  p.publication  { text-indent: 0; margin-top: 4; margin-bottom: 8 }
  li.publication { line-spacing: 0; 
                   margin-top: 0; 
                   margin-bottom: 16;
  					  font-size: 90%; }
  pre,
  blockquote {margin-left:16; font-size:90%; text-indent:0; }
  pre.xml {background:gray; color:white; font-weight:bold; padding=8;  }
  pre.copyright { font-size: 80%; text-align: left;text-indent: 0 }
  
  code {font-size:100%; }
  
  td         { font-size: 80%;}
  
  h1,h2,h3,h4 {
    margin-bottom:0;
    letter-spacing:2;
  }
  p,h1,h2,h3,h4 {
    margin-left:8;
  }
  
  p,h2,h3 {
  }
  
  h1 {
    font-size:200%;
    font-weight:normal;
  }
  
  h2 {
    font-size:130%;
    font-weight:bold;
    margin-top:16;
  }
  
  h3 {
    font-size:100%;
    letter-spacing:0;
    margin-top:8;
  }
  
  hr         {color:gray}
  
  img        {border: 0}
  
  ul,li       { line-spacing: 0; list-style-type: square; 
                 margin-top: 0; 
                 margin-bottom: 8; }
  li       { line-spacing: 0; 
                 margin-top: 0; 
                 margin-bottom: 2; }
  
  
  
  1.1                  jakarta-commons-sandbox/jrcs/doc/index.html
  
  Index: index.html
  ===================================================================
  <html>
    <head>
      <meta name="generator" content="Microsoft FrontPage 5.0">
      <meta name="generator" content="Microsoft FrontPage 5.0">
      <title>
        JRCS - A RCS Archive Parser in Java
      </title>
      <link rel="stylesheet" type="text/css" href="default.css">
    </head>
    <body>
      <!--#include file="../software/navbar.html" -->
      <!--#include file="../juanca/navbar.html" -->
      <hr>
      <h1>
        JRCS
      </h1>
      <h2>
        RCS/CVS Archive Manipulation and a Differencing Engine in Java
      </h2>
      <p>
        <a href="../jrcs/">JRCS</a> is a library for parsing and
        manipulation of RCS archive files like the ones produced by RCS
        (Revision Control System) and by CVS (Concurrent Versioning
        System).
      </p>
      <p>
        The  home of JRCS is at <a href=
        "http://www.suigeneris.org/jrcs/">
        http://www.suigeneris.org/jrcs/</a>.
      </p>
      <h2>Copyright</h2>
      <p>
        On April 2002 I donated the JRCS library to the Apache
        Software Foundation under request of Jason van Zyl. JRCS will now
        be part of the <a href="http://jakarta.apache.org/commons">
        Commons</a> project at Jakarta/Apache.
      </p>
      <p>
        JRCS is distributed under the
        <a href="http://www.apache.org/licenses/LICENSE">Apache Software License (ASL)</a>.</p>
      <h2>
        Diff in Java
      </h2>
      <p>
        The library includes a differencing engine that uses a a simple,
        yet fast and effective differencing algorithm that I developed.
        The diff engine can be used by itself to compare the contents of
        any two arrays, whatever their contents (yes, you can compare
        strings, objects, and anything else).
      </p>
      <h2>
        Download
      </h2>
      <p>
        The Jakarta project at Apache has not published JRCS yet, but you
        can get a copy of the new, improved version of JRCS from their
        CVS repository.
      </p>
      <p>
        You can also get copy of the Jakarta distribution of JRCS from
        here:
      </p>
      <ul>
        <li>
          The <a href="dist/jrcs-full-0.1.6.tar.gz">full</a> (~330K)
          distribution includes everything you need to use the library,
          including the third party libraries <a href=
          "http://jakarta.apache.org/oro/">ORO</a>, and <a href=
          "http://www.junit.org">JUnit</a>. Precompiled jar files are
          also included. <a href="dist/jrcs-full-0.1.6.tar.gz">
          [download]</a>
        </li>
        <li>
          The <a href="dist/jrcs-0.1.6.tar.gz">compact</a> (~200K)
          distribution includes everything above except the third party
          libraries, which you can get from their home sites as explained
          below. <a href="dist/jrcs-0.1.6.tar.gz">[download]</a>
        </li>
      </ul>
      <h2>Installation</h2>
      <p>Uncompress the distribution file to the directory of your choice. The 
      precompiled jars can be found under the ./lib directory.</p>
      <h2>
        Documentation
      </h2>
      <p>
        The JRCS documentation consists of the API documentation
        generated by JavaDoc. There's a <a href="doc/api/">local copy</a>
        of the documentation accessible from this site.
      </p>
      <p>
        In the lack of a user manual, I recommend you examine the test
        suite classes as found in the <code>./tests</code>
        directory in the distribution.
      </p>
      <h2>
        Third party stuff used/required by JRCS
      </h2>
      <h3>
        JUnit
      </h3>
      <p>
        The library tests are written for the JUnit Testing Framework.
        For distributions and documentation of JUnit see <a href=
        "http://www.junit.org/">http://www.junit.org/</a>.
      </p>
      <h3>
        ORO Regexp
      </h3>
      <p>
        The Jakarta ORO regexp library is used for RCS keyword
        management. You can get a copy of ORO from <a href=
        "http://jakarta.apache.org/oro/">
        http://jakarta.apache.org/oro/</a>. A copy of ORO regexp is
        included in the full distribution of this library.
      </p>
      <p>
        The <a href="http://jakarta.apache.org/oro">ORO</a> regexp
        package replaced GNU Regexp in the new version of JRCS.
      </p>
      <h3>
        Ant
      </h3>
      <p>
        Jakarta Ant is used for building the JRCS library. Ant is the
        Jakarta project's build tool. You can get a copy of Ant from <a
        href="http://jakarta.apache.org/ant/">
        http://jakarta.apache.org/ant/</a>.
      </p>
      <p>
        You'll need to also download the optional Ant tasks if you'll be
        running JUnit or JavaCC (more info on JavaCC below).
      </p>
      <h3>
        JavaCC
      </h3>
      <p>
        The RCS parser is constructed using the <a href=
        "http://www.webgain.com/products/java_cc/">JavaCC</a> compiler
        compiler. You can get a copy of <a href=
        "http://www.webgain.com/products/java_cc/">JavaCC</a> from <a
        href="http://www.webgain.com/products/java_cc/">
        http://www.webgain.com/products/java_cc/</a>.
      </p>
      <p>
        JavaCC is not distributable, so you must get a copy of it
        yourself if you intend to use it. Keep in mind that, as
        distributed, this library does <b>not</b> require JavaCC to be
        compiled because all the JavaCC generated .java files are already
        included.
      </p>
      <p>
        If you decide to use JavaCC, please adjust the "javacc.lib.dir"
        property in the <a href="ant_build.xml">build.xml</a> script as needed. You'll also need to
        download and install the set of optional tasks for Ant.
      </p>
      <h2>
        Change Log
      </h2>
      <table bordercolor="green" border="1" cellspacing="0" cellpadding=
      "4" summary="change log">
        <tr valign="top">
          <td>
            2002.10.09
          </td>
          <td>
            v0.1.6
          </td>
          <td>
            <p>
              Fixed node ordering in written archive files so it's
              compatible with the one done by CVS and RCS.
            </p>
            <p>
              Thanks to T. (Hari) Hariharan &lt;hari at peribin dot com&gt;
              for providing the feedback, bug reports, and fixes, that
              contributed to this very stable release.
            </p>
          </td>
        </tr>
        <tr valign="top">
          <td>
            2002.09.28
          </td>
          <td>
            v0.1.5
          </td>
          <td>
            <p>
              Fixed incompatibilities with RCS format in generated change
              deltas.
            </p>
            <p>
              Fixes so RCS files always have the correct line endings.
            </p>
            <p>
              Fixed non-operational Archive.save().
            </p>
          </td>
        </tr>
        <tr valign="top">
          <td>
            2002.09.23
          </td>
          <td>
            v0.1.4
          </td>
          <td>
            <p>
              Removed unicode features from parser because RCS files are
              plain ASCII.
            </p>
            <p>
              Fixed LA bug in parsing of version ranges.
            </p>
          </td>
        </tr>
        <tr valign="top">
          <td>
            2002.06.18
          </td>
          <td>
            v0.1.3
          </td>
          <td>
            <p>
              Published Jakarta JRCS project code with contributions and
              bug fixes by various developers.
            </p>
          </td>
        </tr>
        <tr valign="top">
          <td>
            2002.02.18
          </td>
          <td>
            v0.1.2
          </td>
          <td>
            <p>
              I donated the JRCS library to the Apache Software
              Foundation.
            </p>
          </td>
        </tr>
        <tr valign="top">
          <td>
            2002.01.08
          </td>
          <td>
            v0.1.2
          </td>
          <td>
            <p>
              Minor changes to distribution
            </p>
          </td>
        </tr>
        <tr valign="top">
          <td>
            2001.09.17
          </td>
          <td>
            v0.1.1
          </td>
          <td>
            <p>
              Added Archive.getReleaseVersion() methods to retreive tip
              version numbers without having to retreive the the
              release's text.
            </p>
            <p>
              Fixed BranchNode.nextInPathTo() so it went on till finding
              the tip revision when in soft mode.
            </p>
            <p>
              Refactored path getting code in Archive.getRelease() to
              make it common to Archive.getReleaseVersion()
            </p>
          </td>
        </tr>
        <tr valign="top">
          <td>
            2001.03.22
          </td>
          <td>
            v0.1.0
          </td>
          <td>
            <p>
              Fixed spelling and typing mistakes in the site/docs
            </p>
          </td>
        </tr>
      </table>
      <hr>
      <!--#include file="../software/navbar.html" -->
      <!--#include file="../juanca/navbar.html" -->
      <!-- \$Id: index.html,v 1.1 2003/05/26 18:11:30 juanco Exp $ -->
      <!--#include file="../copyright.html" -->
    </body>
  </html>
  
  
  1.1                  jakarta-commons-sandbox/jrcs/doc/jrcs.gif
  
  	<<Binary file>>
  
  

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