= 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, the developers of that software package will typically prefer it to be created from the top-most directory. However, BePorter currently requires the patch to be created in the parent of that top-most directory.

As example, image we wish to create a patch of Haiku's OptionalPackage file.
Yes, I realize this is a horrible example. 
{{{
cd /path/haiku/
cd ../
svn diff haiku/build/jam/OptionalPackages > ~/OptionalPackage-<new-pkg>.patch
}}}