## Patch

### Description

Applies a diff file to originals. Requires `patch` to be on the execution path.

### Parameters

Attribute | Description | Required
--- | --- | ---
patchfile | the file that includes the diff output | Yes
originalfile | the file to patch | No; tries to guess it from the diff file
destfile | the file to send the output to instead of patching the file(s) in place. since Apache Ant 1.6 | No
backups | Keep backups of the unpatched files | No
quiet | Work silently unless an error occurs | No
reverse | Assume patch was created with old and new files swapped. | No
ignorewhitespace | Ignore whitespace differences. | No
strip | Strip the smallest prefix containing num leading slashes from filenames. | No
dir | The directory in which to run the `patch` command. | No; default is the project's basedir
failonerror | Stop the build process if the command exits with a return code signaling failure. since Ant 1.8.0 | No; defaults to false

### Examples

Apply the diff included in `module.1.0-1.1.patch` to the files in base directory guessing the filename(s) from the diff output.

    <patch patchfile="module.1.0-1.1.patch"/>

Here, one leading directory part will be removed:

    <patch patchfile="module.1.0-1.1.patch" strip="1"/>

i.e. if the diff output looked like

    --- a/mod1.0/A  Mon Jun  5 17:28:41 2000
    +++ a/mod1.1/A  Mon Jun  5 17:28:49 2000

the leading `a/` will be stripped.