=head1 NAME

ddiff - creates a debdiff from two .debs.

=head1 SYNOPSIS

  ddiff [options] <from> <to>

=head1 DESCRIPTION

Ddiff creates a debdiff containing the differences between the debian
packages named in the from and to arguments. The debdiff generated is
a script that can be executed by the dpatch program to create a debian 
package equivalent to the to package given only the patch and the 
information given in the from package.

One of the goals of ddiff is to store enough information in the
debdiff to reconstruct an equivalent ddiff. Indeed, in this version,
the uncompressed members of reconstructed package should be identical
to those in the source package.

The debdiff is sent to standard output, unless it's redirected by the
-o command line option.

=head1 OPTIONS

Ddiff allows you to use command line options to control it's
behavior. Here's a list.

=over 4

=item --compress, -z

This causes ddiff to compress its output. 

=item --help, -h

This causes ddiff to display a brief help message. (But since you've
found this man page, you're much better off.)

=item --output <file>, -o <file>

This causes the output debdiff to be sent to <file>, rather than to
stdout as is the default.

=item --output-comments, -c

This tells ddiff to put comments in the generated output telling which
files are being processed. It's only really useful for debugging
purposes.

=item --verbose, -v

This tells ddiff to be rather verbose in explaning what it's
doing. Useful for debugging, or just for being convinced that
something is going on.

=item --version, -V

This displays the current version and output version of ddiff.

=item --blocks <num>, -b <num>

This sets the number of 256-byte blocks used by the bdiff
algorithm. Roughly, the number of bytes is the maximum amount of
differences bdiff can handle while still being able to eventually
resynchronize with the output stream.

=back

=head1 AUTHOR AND WEB PAGE

The author of ddiff is Tom Rothamel <tom-ddiff@onegeek.org>. There's
a web site for ddiff at http://onegeek.org/~tom/software/ddiff/.

=head1 SEE ALSO

dpatch(1)