• Home
Name Date Size #Lines LOC

..--

m4/03-May-2024-1716

man/03-May-2024-7964

packages/03-May-2024-702489

src/03-May-2024-35,65621,508

testdata/03-May-2024-11487

vsprojects/03-May-2024-5,8745,722

AUTHORSD03-May-202423 31

COPYINGD03-May-202411.1 KiB203169

ChangeLogD03-May-20246.7 KiB124110

INSTALLD03-May-20249.3 KiB238179

Makefile.amD03-May-20249.2 KiB264190

Makefile.inD03-May-2024102.5 KiB1,6951,500

NEWSD03-May-20240

READMED03-May-20242 KiB4435

THANKSD03-May-2024932 4341

aclocal.m4D03-May-2024264.4 KiB7,5346,773

autogen.shD03-May-20241.4 KiB5228

compileD03-May-20242.7 KiB10048

config.guessD03-May-202443.5 KiB1,5171,305

config.subD03-May-202432 KiB1,6271,483

configureD03-May-2024737.2 KiB23,32918,698

configure.acD03-May-20242.1 KiB7560

depcompD03-May-202417.4 KiB590375

install-shD03-May-202413.3 KiB520344

ltmain.shD03-May-2024195.3 KiB6,9655,506

missingD03-May-202410.9 KiB368275

mkinstalldirsD03-May-20243.4 KiB162112

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