=head1 NAME

dpatch - applys a debdiff.

=head1 SYNOPSIS

  dpatch [options] <debdiff> <from> [to]

=head1 DESCRIPTION

Dpatch executes the list of commands in the debdiff given on the
command line. It creates an output debian package based on the
commands in the debdiff and the data in the package file from. The
output file's name is given in to if that parameter is
specified. Otherwise, the name is taken from version information given
provided in the debdiff. 

If debdiff is '-', dpatch reads from standard input. The from
and to arguments must be normal files, and not devices or pipes or
something else.

Dpatch is the flip side of the ddiff program.

=head1 OPTIONS

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

=over 4

=item --formats, -F

This cause dpatch to print out a machine-readable range of formats
that it accepts. The first line is the earliest format that this
version of dpatch understands, the second is the latest.

=item --help, -h

Displays a brief help message.

=item --keep-incomplete, -k

Normally, in the case of an error, dpatch deletes the file it's
creating. This option supresses that behavior.

=item --output-prefix <prefix>, -O <prefix>

If the to parameter is omitted on the command line, the new debian
package file is created in the directory given by prefix.

=item --verbose, -v

This causes debpatch to emit output explaining what it's doing.

=item --version, -V

This causes debpatch to display human-readable version and copyright
information.

=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

ddiff(1)