Difference between revisions of "Diff and patch"

From Noah.org
Jump to navigationJump to search
Line 27: Line 27:
 
</pre>
 
</pre>
  
Note the -p0 option. The path to changes.patch will depend on where the maintainer stored it.
+
Note the -p0 option. Also note that the path to changes.patch will depend on where the maintainer stored it (/tmp/ is just an example).
 +
 
 +
Sometimes you and the maintainer will not be working from exactly
 +
the same ORIGINAL source. Patch can search around a fuzzy area of code and find where the context matches. In this case it can help to have more context for patch to work with. Use the "-C NUM" options instead of '-c':
 +
<pre>
 +
diff -r -C 7 -x"*.jpg" -x"*.png" -x"*.gif" -x"*.swp" \
 +
-x"*.a" -x"*.so" -x"*.o" -x"*.pyc" -x"*.exe" -x"*.class" \
 +
-x".svn" -x"CVS" -x"core" -x"a.out"
 +
"/home/user/project-ORIGINAL" "." > /tmp/changes.patch
 +
</pre>

Revision as of 12:33, 29 May 2007

If you don't have svn access to a project and want to submit a manual patch, the following notes should help. You made changes to many files in a project and you want to submit a patch to the maintainer of the project. First, find out if they want Context or Unified diffs. That will set the -c or -u option for diff. I usually go with -c when in doubt. You will use the -r options to recursively compare the ORIGINAL directory with the NEWER directory (the one with your changes). You can add many more -x options to exclude patterns of files that you do not want included in the patch. Usually you don't want to compare binaries or files generated by the build process (make).

cd /home/user/project-NEWER
diff -r -c -x"*.jpg" -x"*.png" -x"*.gif" -x"*.swp" \
-x"*.a" -x"*.so" -x"*.o" -x"*.pyc" -x"*.exe" -x"*.class" \
-x".svn" -x"CVS" -x"core" -x"a.out"
"/home/user/project-ORIGINAL" "." > /tmp/changes.patch

This will generate a patch file that you can mail to the project maintainer. They will then apply the patch as follows:

cd project-ORIGINAL
patch -p0 < /tmp/changes.patch

Note the -p0 option. Also note that the path to changes.patch will depend on where the maintainer stored it (/tmp/ is just an example).

Sometimes you and the maintainer will not be working from exactly the same ORIGINAL source. Patch can search around a fuzzy area of code and find where the context matches. In this case it can help to have more context for patch to work with. Use the "-C NUM" options instead of '-c':

diff -r -C 7 -x"*.jpg" -x"*.png" -x"*.gif" -x"*.swp" \
-x"*.a" -x"*.so" -x"*.o" -x"*.pyc" -x"*.exe" -x"*.class" \
-x".svn" -x"CVS" -x"core" -x"a.out"
"/home/user/project-ORIGINAL" "." > /tmp/changes.patch