You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@commons.apache.org by ju...@apache.org on 2003/05/30 03:45:17 UTC
cvs commit: jakarta-commons-sandbox/jrcs/doc .cvsignore index.html
juanco 2003/05/29 18:45:17
Modified: jrcs build.xml
jrcs/doc index.html
Added: jrcs/doc .cvsignore
Log:
updated web page to reflect recent enhancements
Revision Changes Path
1.10 +8 -3 jakarta-commons-sandbox/jrcs/build.xml
Index: build.xml
===================================================================
RCS file: /home/cvs/jakarta-commons-sandbox/jrcs/build.xml,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -r1.9 -r1.10
--- build.xml 5 May 2003 21:49:28 -0000 1.9
+++ build.xml 30 May 2003 01:45:17 -0000 1.10
@@ -122,9 +122,10 @@
<property name="java.dir" value="${src.dir}/java" />
<property name="tests.dir" value="${src.dir}/test" />
<property name="lib.dir" value="${basedir}/lib" />
- <property name="dist.dir" value="${basedir}/dist" />
+ <property name="doc.dir" value="${basedir}/doc" />
+ <property name="javadoc" value="${doc.dir}/api" />
+ <property name="dist.dir" value="${doc.dir}/dist" />
<property name="classes" value="${basedir}/classes" />
- <property name="javadoc" value="${basedir}/doc/api" />
<property name="test.classes" value="${basedir}/test-classes" />
<property name="javacc.lib.dir" value="${javacc.home}/bin/lib" />
@@ -338,5 +339,9 @@
</target>
<target name="dist" depends="compact.dist,full.dist" />
+
+ <target name="changelog" >
+ <cvschangelog destfile="changelog.xml" />
+ </target>
</project>
1.2 +169 -301 jakarta-commons-sandbox/jrcs/doc/index.html
Index: index.html
===================================================================
RCS file: /home/cvs/jakarta-commons-sandbox/jrcs/doc/index.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- index.html 26 May 2003 18:11:30 -0000 1.1
+++ index.html 30 May 2003 01:45:17 -0000 1.2
@@ -1,302 +1,170 @@
<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 <hari at peribin dot com>
- 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$ -->
- <!--#include file="../copyright.html" -->
- </body>
-</html>
\ No newline at end of file
+
+<head>
+<meta http-equiv="Content-Language" content="en-us">
+<meta name="generator" content="Microsoft FrontPage 5.0">
+<meta name="ProgId" content="FrontPage.Editor.Document">
+<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 framework for pluggable differencing engines.
+Currently, two algorithms are implemented:</p>
+<ul>
+ <li>A simple, fast, memory conscious, but suboptimal algorithm by me.</li>
+ <li>The <a href="http://www.cs.arizona.edu/people/gene/PAPERS/diff.ps">Eugene
+ Myers</a> algorithm that produces optimal results.</li>
+</ul>
+<p>The diff engine can be used by itself to compare the contents of any two
+arrays, whatever the underlying type.</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>2003.05.29</td>
+ <td>v0.1.7</td>
+ <td> <p>Brian McBride <bwm at hplb dot hpl dot hp dot com> added the
+ Visitor pattern to Revisions and Deltas, and made differencing algorithms
+ pluggable using the Algorithm pattern.</p>
+ <p>Juanco implemented the Eugene Myers algorithm, and made it the default.</td>
+ </tr>
+ <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 <hari at peribin dot com> for providing the
+ feedback, bug reports, and fixes, that contributed to this very stable
+ release. </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(). </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. </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. </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.
+ </td>
+ </tr>
+ <tr valign="top">
+ <td>2002.01.08 </td>
+ <td>v0.1.2 </td>
+ <td> <p>Minor changes to distribution </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() </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 </td>
+ </tr>
+</table>
+<hr>
+<!--#include file="../software/navbar.html" -->
+<!--#include file="../juanca/navbar.html" -->
+<!-- \$Id$ -->
+<!--#include file="../copyright.html" -->
+
+</body>
+
+</html>
1.1 jakarta-commons-sandbox/jrcs/doc/.cvsignore
Index: .cvsignore
===================================================================
dist
---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org