NameDateSize

..04-Jun-20144 KiB

aclocal.m404-Jun-201434.5 KiB

Android.mk04-Jun-20141.2 KiB

AUTHORS04-Jun-201423

autogen.sh04-Jun-20142 KiB

ChangeLog04-Jun-201410.3 KiB

compile04-Jun-20142.7 KiB

config.guess04-Jun-201444.5 KiB

config.sub04-Jun-201433.3 KiB

configure04-Jun-2014540.5 KiB

configure.ac04-Jun-20143.9 KiB

COPYING04-Jun-201411.1 KiB

depcomp04-Jun-201418.2 KiB

gflags/04-Jun-20144 KiB

gtest/04-Jun-20144 KiB

INSTALL04-Jun-201415.2 KiB

install-sh04-Jun-201413.3 KiB

ltmain.sh04-Jun-2014237.8 KiB

m4/04-Jun-20144 KiB

Makefile.am04-Jun-201411.3 KiB

Makefile.in04-Jun-2014117.4 KiB

man/04-Jun-20144 KiB

missing04-Jun-201411.2 KiB

mkinstalldirs04-Jun-20143.5 KiB

MODULE_LICENSE_APACHE204-Jun-20140

NEWS04-Jun-20140

packages/04-Jun-20144 KiB

README04-Jun-20142 KiB

src/04-Jun-20144 KiB

testdata/04-Jun-20144 KiB

THANKS04-Jun-2014987

vsprojects/04-Jun-20144 KiB

README

1open-vcdiff is an encoder and decoder for the VCDIFF format, as described in
2RFC 3284 : The VCDIFF Generic Differencing and Compression Data Format
3(http://www.ietf.org/rfc/rfc3284.txt)
4A library with a simple API is included, as well as a command-line executable
5that can apply the encoder and decoder to source, target, and delta files.
6For further details, please refer to:
7http://code.google.com/p/open-vcdiff/wiki/HowToUseOpenVcdiff
8
9See INSTALL for (generic) installation instructions for C++: basically
10   ./configure && make && make install
11
12This should compile the unit tests as well as "vcdiff", a simple command-line
13utility to run the encoder and decoder.  Typical usage of vcdiff is as follows
14(the "<" and ">" are file redirect operations, not optional arguments):
15   vcdiff encode -dictionary file.dict < target_file > delta_file
16   vcdiff decode -dictionary file.dict < delta_file > target_file
17To see the command-line syntax of vcdiff, use "vcdiff --help" or just "vcdiff".
18
19To call the encoder from C++ code, assuming that dictionary, target, and delta
20are all std::string objects:
21#include <google/vcencoder.h>  // Read this file for interface details
22[...]
23  open_vcdiff::VCDiffEncoder encoder(dictionary.data(), dictionary.size());
24  encoder.SetFormatFlags(open_vcdiff::VCD_FORMAT_INTERLEAVED);
25  encoder.Encode(target.data(), target.size(), &delta);
26
27Calling the decoder is just as simple:
28#include <google/vcdecoder.h>  // Read this file for interface details
29[...]
30  open_vcdiff::VCDiffDecoder decoder;
31  decoder.Decode(dictionary.data(), dictionary.size(), delta, &target);
32
33When using the encoder, the C++ application must be linked with the library
34options -lvcdcom and -lvcdenc; when using the decoder, it must be linked with
35-lvcdcom and -lvcddec.
36
37To verify that the package works on your system, especially after making
38modifications to the source code, please run the unit tests using
39   make check
40
41For further details, please refer to:
42http://code.google.com/p/open-vcdiff/wiki/HowToUseOpenVcdiff
43
44