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