debian/README.source

   1 ==================================
   2 Quilt using package in your hands
   3 ==================================
   4
   5 This package makes use of a debian/patches/ directory maintained
   6 with quilt. The integration of the actual patches in the build process
   7 is done with the inclusion of /usr/share/quilt/quilt.make in debian/rules.
   8 Thus you've the patch and unpatch target available to take a look at what
   9 the patched source will look like.
  10
  11 Modify this package
  12 ===================
  13
  14 You can still modify this package (e.g. for NMUs) through editing
  15 the source but be aware that this might collide with patches integrated
  16 in the patch system.
  17
  18
  19 Modify this package with quilt
  20 ==============================
  21
  22 This is a small example to get you started with quilt on a similar package
  23 and is far from beeing complete.
  24
  25 dpkg-source -x the package and change into that directory
  26
  27 // Set the path to the patches correctly so that quilt can find them
  28 tclcurl-7.19.0$ export QUILT_PATCHES=debian/patches
  29
  30 // Check on the different patches available
  31 tclcurl-7.19.0$ quilt series
  32 man-section
  33 reformat-tclcurl3
  34 correct-linking
  35
  36 // Apply the correct-linking patch, this will cause quilt to apply all patches
  37 // stacked on the selected one first.
  38 tclcurl-7.19.0$ quilt push correct-linking
  39 [...]
  40
  41 // Take a look at the current diff
  42 tclcurl-7.19.0$ quilt diff
  43 [...]
  44
  45
  46 // Open configure for editing
  47 tclcurl-7.19.0$ quilt edit configure
  48 [...]
  49
  50 // Refresh the patch you're working on
  51 tclcurl-7.19.0$ quilt refresh
  52 Refreshed patch correct-linking
  53
  54 // Remove the patch from your working stack
  55 tclcurl-7.19.0$ quilt pop
  56 Removing patch correct-linking
  57 Restoring configure
  58 Restoring configure.in
  59
  60 Now at patch reformat-tclcurl3
  61
  62 // Add a new patch
  63 tclcurl-7.19.0$ quilt new my-patch
  64 Patch my-patch is now on top
  65
  66 You can now edit, refresh and pop this patch of the stack
  67 when you're done.
  68
  69 // Importing an external patch is also possible
  70 tclcurl-7.19.0$ quilt import -P <patch> /path/to/ext-patch
  71
  72
  73
  74 Adding patches to quilt without actually using it
  75 =================================================
  76
  77 You can operate without using quilt. You just need
  78 to add a proper patch to debian/patches and add the
  79 name to the series file in the same directory.