debian/README.source

   1 This package uses dpatch in order to apply patches to the upstream
   2 source.
   3 Patches are stored in debian/patches and their filenames usually end in
   4 .dpatch .
   5 For further details, see the man pages for dpatch and dpatch-edit-patch.
   6
   7 All commands described below should be run from the top directory of the
   8 package source tree, unless otherwise stated.
   9
  10  * To generate the fully patched source, in a form ready for
  11    editing, that would be built to create Debian packages, run:
  12
  13      dpatch apply-all
  14
  15    Note: This should happen automatically when you run
  16    dpkg-source -x on a dpatch source package.
  17
  18  * To modify the source and save those modifications so that
  19    they will be applied when building the package, pick a
  20    suitably informative patch file name, for example
  21    01_add_README.source_file.dpatch, and then run:
  22
  23      dpatch-edit-patch 01_add_README.source_file.dpatch
  24
  25    This will place you in a new shell in a temporary copy of the
  26    source tree.  Make your desired modifications to it, and then
  27    exit the shell to create the patch file containing them (this
  28    file will appear in debian/patches).
  29
  30  * To remove source modifications that are currently being
  31    applied when building the package, run:
  32
  33      dpatch unapply-all
  34