~ubuntu-branches/debian/sid/bristol/sid

« back to all changes in this revision

Viewing changes to debian/README.source

  • Committer: Bazaar Package Importer
  • Author(s): Alessio Treglia
  • Date: 2011-02-15 02:54:23 UTC
  • mfrom: (13.1.6 experimental)
  • Revision ID: james.westby@ubuntu.com-20110215025423-g8hcla5gyl08mae3
Tags: 0.60.8-2
* Upload to unstable.
* Relax JACK's build-deps to let this build in sid.

Show diffs side-by-side

added added

removed removed

Lines of Context:
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
 
        fi
13
 
    done
14
 
 
15
 
To get the fully patched source after unpacking the source package, cd to
16
 
the root level of the source package and run:
17
 
 
18
 
    quilt push -a
19
 
 
20
 
The last patch listed in debian/patches/series will become the current
21
 
patch.
22
 
 
23
 
To add a new set of changes, first run quilt push -a, and then run:
24
 
 
25
 
    quilt new <patch>
26
 
 
27
 
where <patch> is a descriptive name for the patch, used as the filename in
28
 
debian/patches.  Then, for every file that will be modified by this patch,
29
 
run:
30
 
 
31
 
    quilt add <file>
32
 
 
33
 
before editing those files.  You must tell quilt with quilt add what files
34
 
will be part of the patch before making changes or quilt will not work
35
 
properly.  After editing the files, run:
36
 
 
37
 
    quilt refresh
38
 
 
39
 
to save the results as a patch.
40
 
 
41
 
Alternately, if you already have an external patch and you just want to
42
 
add it to the build system, run quilt push -a and then:
43
 
 
44
 
    quilt import -P <patch> /path/to/patch
45
 
    quilt push -a
46
 
 
47
 
(add -p 0 to quilt import if needed). <patch> as above is the filename to
48
 
use in debian/patches.  The last quilt push -a will apply the patch to
49
 
make sure it works properly.
50
 
 
51
 
To remove an existing patch from the list of patches that will be applied,
52
 
run:
53
 
 
54
 
    quilt delete <patch>
55
 
 
56
 
You may need to run quilt pop -a to unapply patches first before running
57
 
this command.