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