From c9cf9067c3ebe5853dcdefae0c2715705641dbc7 Mon Sep 17 00:00:00 2001 From: "Eric S. Raymond" Date: Mon, 15 Sep 2003 23:46:31 +0000 Subject: [PATCH] Document limitations. --- comparator.xml | 16 ++++++++++------ 1 file changed, 10 insertions(+), 6 deletions(-) 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. -- 2.43.0