From: Eric S. Raymond Date: Mon, 15 Sep 2003 23:46:31 +0000 (+0000) Subject: Document limitations. X-Git-Tag: 2.0~64 X-Git-Url: http://thyrsus.com/gitweb/?a=commitdiff_plain;h=c9cf9067c3ebe5853dcdefae0c2715705641dbc7;p=comparator.git Document limitations. --- diff --git a/comparator.xml b/comparator.xml index d32258e..fc26f68 100644 --- a/comparator.xml +++ b/comparator.xml @@ -194,14 +194,18 @@ collections of Linux and Unix source trees running into the tens of millions of lines, you are very unlikely to ever see this. There is no possibility of false negatives. -This program handles a maximum of 65536 lines per file. A full -integer line-number range would increase working-set size by -20%. +The design of this program accepts some size limits to get high +performance in the typical case. The RXOR hash function's performance +will degrade, possibly leading to comparison errors, on shreds of 512 +or more characters. Also, comparison will handle maximum of 65536 +lines per file (you will be warned if if this limit is exceeded). A +full integer line-number range would increase working-set size by +33%. You will get spurious results if you mix -.scf files with different shred sizes or -normalizations, or with settings for these that conflict with the -command-line options you have in effect for shredding source-code +.scf files with different hash methods, shred +sizes or normalizations, or with settings for these that conflict with +the command-line options you have in effect for shredding source-code trees. The program does some sanity checking but will not prevent you from shooting yourself in the foot.