jmacd / xdelta

open-source binary diff, delta/differential compression tools, VCDIFF/RFC 3284 delta compression
http://xdelta.org
1.12k stars 186 forks source link

Documentation of memory tuning options #9

Closed GoogleCodeExporter closed 9 years ago

GoogleCodeExporter commented 9 years ago
What steps will reproduce the problem?
1. xdelta --help

What is the expected output? What do you see instead?

I see this:
   memory options:
      -B blksize   source file block size
      -M memsize   memory budget for hash tables
      -W winsize   input window buffer size

However, the Wiki seems to indicate that the "-B" parameter actually 
controls the window size, not the -W parameter. The wiki also states the 
default is 64 MB, but "xdelta config" seems to indicate it is 8 MB.

I think there needs to be some better documentation in this area. I am 
more that willing to write it; however, I do no think trying to figure out 
what these options do by reading the sourcde is going to work well. 

What version of the product are you using? On what operating system?
3.0j on Windows XP SP2

Please provide any additional information below.

Original issue reported on code.google.com by malay...@gmail.com on 8 Jan 2007 at 4:28

GoogleCodeExporter commented 9 years ago
I'm still working on this document.  I have some changes that will appear in 
3.0k,
which raise the default to 64MB and remove the -M flag.

The help string is also wrong.  The current SVN has my changes, I'm trying to 
do a
little more testing.

Original comment by dotdotis...@gmail.com on 8 Jan 2007 at 9:24

GoogleCodeExporter commented 9 years ago
Please try 3.0k. The default for -B is now 64MB.

The value of -M was previously used to size some internal tables -- these 
tables are
now automatically sized based on the value of -B and -W.

Original comment by josh.mac...@gmail.com on 13 Jan 2007 at 2:04