]>
Commit | Line | Data |
---|---|---|
3cf71090 DM |
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. |