Debiff Deb Diff Format
======================
tim@tjansen.de, 12.03.2000


The Deb Diff format with the extension .debiff is a simple ar archive.
The name scheme of a debiff archive is 
<package>_old-version_new-version_architecture.debiff

The first member is a file called debiff-control in a format similar
to the deb control file. Each line consist of a name tag, followed by
a color and the value. Whitespace between the name tag and the colon,
between the colon and the beginning of the value and at the end of
the line will be ignored. If the line begins with whitespace followed
by non-whitespace, the whitespace at the beginning and end of this line
is discarded and the text is appendend to the value of the last tag.
Empty lines (containing only whitespace) will be ignored.

The following tags are required:
Debiff-Version: 1
         The version of this debiff archive, currently always 1
Package: <package name>
	 The name of the debian package

Old-Version: <version>
	 The version of the old deb file that will be patched

New-Version: <version>
	 The version of the new deb file after the patch

The following tags are optional:
Architecture: <arch|all>
	 The architecture of the deb files. Default is 'all'.

XDelta-Files: <filelist>
         A list of files, separated by whitespace, of the files that have
         changed in the new version

New-Files: <filelist>
         A list of files, separated by whitespace, of the files that have
         added or should be replaced in the new version

Unmodified-Files: <filelist>
         A list of files, separated by whitespace, of the files that have
         not changed and should be copied from the original deb to the
         new deb.

It is an error if a file is contained more than one of the 
'XDelta-Files', 'New-Files' and 'Unmodified-Files' tags. It is not allowed
for a tag be used more than once in the debiff-control file.

The next files in the ar archive are diffs for each of the files specified 
in the debiff-control 'XDelta-Files' tag. The diffs are created by the 
xdelta(1) tool. Those that have an .gz extension are decompressed using 
gzip(1) before xdelta is used, those with a '.bz2' extension are decompressed
using bzip2(1). The name of the xdelta-diffs is the original filename with
a '.xdelta' ending.

After the xdelta-files those files specified in the 'New-Files' tag 
follow. They are unmodified and saved in their original version.


Example debiff-control
----------------------

Package: bash
Old-Version: 2.04-7
New-Version: 2.04-8

Architecture: i386

Unmodified-Files: debian-binary
XDelta-Files: control.tar.gz data.tar.gz