= Create the Patch =

BePorter will apply the patch in the directory where the source package was extracted. For this to work, you need to create the patch like this:

 1. Place the directory (for example, named {{{xyz-1.0.0}}}) containing the original sources in a directory of your liking
 1. Place the directory containing the patched sources in the same directory. You'll need to rename it first, of course (say {{{xyz-1.0.0-haiku}}}
 1. Now create the patch with
{{{
diff -Naur xyz-1.0.0/ xyz-1.0.0-haiku/ > xyz-1.0.0.patch
}}}

Don't forget to clean your sources directories first ({{{make distclean}}}, for example).

Congratulations! The generated patch is BePorter compatible.

Note: when creating a patch from a svn or a similar repository, it is preferred to create the patch from the top-most directory.
As example, image we wish to create a patch of Haiku's OptionalPackage file.
{{{
cd /path/haiku/
svn diff build/jam/OptionalPackages > ~/OptionalPackage-<new-pkg>.patch
}}}
A patch created in this manner is the preferred method, as it allows the developers to apply it from their top-most directory.