debian/README.source

   1 This package uses dpatch to manage all modifications to the upstream
   2 source. Changes are stored in the source package as diffs in
   3 debian/patches and applied during the build.
   4
   5 To get the fully patched source after unpacking the source package, cd
   6 to the root level of the source package and run:
   7
   8     debian/rules patch
   9
  10 Removing a patch is as simple as removing its entry from the
  11 debian/patches/00list file, and please also remove the patch file
  12 itself.
  13
  14 Creating a new patch is done with "dpatch-edit-patch patch XX_patchname"
  15 where you should replace XX with a new number and patchname with a
  16 descriptive shortname of the patch. You can then simply edit all the
  17 files your patch wants to edit, and then simply "exit 0" from the shell
  18 to actually create the patch file.
  19
  20 To tweak an already existing patch, call "dpatch-edit-patch XX_patchname"
  21 and replace XX_patchname with the actual filename from debian/patches
  22 you want to use.
  23
  24 To clean up afterwards again, "debian/rules unpatch" will do the
  25 work for you - or you can of course choose to call
  26 "fakeroot debian/rules clean" all together.
  27
  28 ---
  29
  30 original text by Gerfried Fuchs, edited by Junichi Uekawa <dancer@debian.org>
  31 10 Aug 2008.