X-Git-Url: http://git.maemo.org/git/?a=blobdiff_plain;f=deb-src%2Flibalgorithm-diff-perl%2Flibalgorithm-diff-perl-1.19.02%2FREADME;fp=deb-src%2Flibalgorithm-diff-perl%2Flibalgorithm-diff-perl-1.19.02%2FREADME;h=f12a0f4b6a9721e2292029e891539fa10971fa73;hb=3df72cc8383a92be91804b0f275517da27f60b20;hp=0000000000000000000000000000000000000000;hpb=6f6761b824b9e64ac6775851b55d364442cd7835;p=pkg-perl diff --git a/deb-src/libalgorithm-diff-perl/libalgorithm-diff-perl-1.19.02/README b/deb-src/libalgorithm-diff-perl/libalgorithm-diff-perl-1.19.02/README new file mode 100644 index 0000000..f12a0f4 --- /dev/null +++ b/deb-src/libalgorithm-diff-perl/libalgorithm-diff-perl-1.19.02/README @@ -0,0 +1,81 @@ +This is a module for computing the difference between two files, two +strings, or any other two lists of things. It uses an intelligent +algorithm similar to (or identical to) the one used by the Unix "diff" +program. It is guaranteed to find the *smallest possible* set of +differences. + +This package contains a few parts. + +Algorithm::Diff is the module that contains several interfaces for which +computing the differences betwen two lists. + +The several "diff" programs also included in this package use +Algorithm::Diff to find the differences and then they format the output. + +Algorithm::Diff also includes some other useful functions such as "LCS", +which computes the longest common subsequence of two lists. + +A::D is suitable for many uses. You can use it for finding the smallest +set of differences between two strings, or for computing the most +efficient way to update the screen if you were replacing "curses". + +Algorithm::DiffOld is a previous version of the module which is included +primarilly for those wanting to use a custom comparison function rather +than a key generating function (and who don't mind the significant +performance penalty of perhaps 20-fold). + +diff.pl implements a "diff" in Perl that is as simple as (was +previously) possible so that you can see how it works. The output +format is not compatible with regular "diff". It needs to be +reimplemented using the OO interface to greatly simplify the code. + +diffnew.pl implements a "diff" in Perl with full bells and whistles. By +Mark-Jason, with code from cdiff.pl included. + +cdiff.pl implements "diff" that generates real context diffs in either +traditional format or GNU unified format. Original contextless +"context" diff supplied by Christian Murphy. Modifications to make it +into a real full-featured diff with -c and -u options supplied by Amir +D. Karger. + +Yes, you can use this program to generate patches. + +OTHER RESOURCES + +"Longest Common Subsequences", at +http://www.ics.uci.edu/~eppstein/161/960229.html + +This code was adapted from the Smalltalk code of Mario Wolczko +, which is available at +ftp://st.cs.uiuc.edu/pub/Smalltalk/MANCHESTER/manchester/4.0/diff.st + +THANKS SECTION + +Thanks to Ned Konz's for rewriting the module to greatly improve +performance, for maintaining it over the years, and for readilly handing +it over to me so I could plod along with my improvements. + +(From Ned Konz's earlier versions): + +Thanks to Mark-Jason Dominus for doing the original Perl version and +maintaining it over the last couple of years. Mark-Jason has been a huge +contributor to the Perl community and CPAN; it's because of people like +him that Perl has become a success. + +Thanks to Mario Wolczko for writing and making +publicly available his Smalltalk version of diff, which this Perl +version is heavily based on. + +Thanks to Mike Schilli for writing sdiff and +traverse_balanced and making them available for the Algorithm::Diff +distribution. + +(From Mark-Jason Dominus' earlier versions): + +Huge thanks to Amir Karger for adding full context diff supprt to +"cdiff.pl", and then for waiting patiently for five months while I let +it sit in a closet and didn't release it. Thank you thank you thank +you, Amir! + +Thanks to Christian Murphy for adding the first context diff format +support to "cdiff.pl".