Mike Gabriel | b1fe2b2 | 2013-06-28 14:31:18 +0200 | [diff] [blame] | 1 | This package uses quilt to manage all modifications to the upstream |
| 2 | source. Changes are stored in the source package as diffs in |
| 3 | debian/patches and applied during the build. |
| 4 | |
| 5 | To configure quilt to use debian/patches instead of patches, you want |
| 6 | either to export QUILT_PATCHES=debian/patches in your environment |
| 7 | or use this snippet in your ~/.quiltrc: |
| 8 | |
| 9 | for where in ./ ../ ../../ ../../../ ../../../../ ../../../../../; do |
| 10 | if [ -e ${where}debian/rules -a -d ${where}debian/patches ]; then |
| 11 | export QUILT_PATCHES=debian/patches |
| 12 | break |
| 13 | fi |
| 14 | done |
| 15 | |
| 16 | To get the fully patched source after unpacking the source package, cd to |
| 17 | the root level of the source package and run: |
| 18 | |
| 19 | quilt push -a |
| 20 | |
| 21 | The last patch listed in debian/patches/series will become the current |
| 22 | patch. |
| 23 | |
| 24 | To add a new set of changes, first run quilt push -a, and then run: |
| 25 | |
| 26 | quilt new <patch> |
| 27 | |
| 28 | where <patch> is a descriptive name for the patch, used as the filename in |
| 29 | debian/patches. Then, for every file that will be modified by this patch, |
| 30 | run: |
| 31 | |
| 32 | quilt add <file> |
| 33 | |
| 34 | before editing those files. You must tell quilt with quilt add what files |
| 35 | will be part of the patch before making changes or quilt will not work |
| 36 | properly. After editing the files, run: |
| 37 | |
| 38 | quilt refresh |
| 39 | |
| 40 | to save the results as a patch. |
| 41 | |
| 42 | Alternately, if you already have an external patch and you just want to |
| 43 | add it to the build system, run quilt push -a and then: |
| 44 | |
| 45 | quilt import -P <patch> /path/to/patch |
| 46 | quilt push -a |
| 47 | |
| 48 | (add -p 0 to quilt import if needed). <patch> as above is the filename to |
| 49 | use in debian/patches. The last quilt push -a will apply the patch to |
| 50 | make sure it works properly. |
| 51 | |
| 52 | To remove an existing patch from the list of patches that will be applied, |
| 53 | run: |
| 54 | |
| 55 | quilt delete <patch> |
| 56 | |
| 57 | You may need to run quilt pop -a to unapply patches first before running |
| 58 | this command. |