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 sven@marvin:/tmp/foo/tclcurl-7.19.0$ export QUILT_PATCHES=debian/patches
  31
  32 // Check on the different patches available
  33 sven@marvin:/tmp/foo/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 sven@marvin:/tmp/foo/tclcurl-7.19.0$ quilt push correct-linking
  41 [...]
  42
  43 // Take a look at the current diff
  44 sven@marvin:/tmp/foo/tclcurl-7.19.0$ quilt diff
  45 [...]
  46
  47
  48 // Open configure for editing
  49 sven@marvin:/tmp/foo/tclcurl-7.19.0$ quilt edit configure
  50 [...]
  51
  52 // Refresh the patch you're working on
  53 sven@marvin:/tmp/foo/tclcurl-7.19.0$ quilt refresh
  54 Refreshed patch correct-linking
  55
  56 // Remove the patch from your working stack
  57 sven@marvin:/tmp/foo/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 This should be enough to get your modifications in.
  65
  66
  67 Adding patches to quilt without actually using it
  68 =================================================
  69
  70 You can operate without using quilt. You just need
  71 to add a proper patch to debian/patches and add the
  72 name to the series file in the same directory.