summaryrefslogtreecommitdiff
path: root/debian/README.source
diff options
context:
space:
mode:
authorCyril Brulebois <kibi@debian.org>2011-01-22 03:02:44 +0000
committerCyril Brulebois <kibi@debian.org>2011-01-22 03:02:44 +0000
commitaed8e54a3be07013d0aab768448420c82d1a8a4f (patch)
tree6a8386b48ed98a929514d80526f5d7e8529f70b3 /debian/README.source
parentc057ebe20dab81b37887db08d65e5b3d792f5257 (diff)
downloadmesa-aed8e54a3be07013d0aab768448420c82d1a8a4f.tar.gz
Add Debian packaging from debian-experimental.
Now that debian-experimental-new is both: - unmodified mesa-7.10 upstream sources - a child of debian-experimental the Debian packaging (debian/*) can be added back, and we get: - a diff from mesa-7.10 which is exactly those files - a debian-experimental branch which can be fast-forwarded
Diffstat (limited to 'debian/README.source')
-rw-r--r--debian/README.source35
1 files changed, 35 insertions, 0 deletions
diff --git a/debian/README.source b/debian/README.source
new file mode 100644
index 0000000000..8ff408c91f
--- /dev/null
+++ b/debian/README.source
@@ -0,0 +1,35 @@
+------------------------------------------------------
+Quick Guide To Patching This Package For The Impatient
+------------------------------------------------------
+
+1. Make sure you have quilt installed
+2. Unpack the package as usual with "dpkg-source -x"
+3. Run the "patch" target in debian/rules
+4. Create a new patch with "quilt new" (see quilt(1))
+5. Edit all the files you want to include in the patch with "quilt edit"
+ (see quilt(1)).
+6. Write the patch with "quilt refresh" (see quilt(1))
+7. Run the "clean" target in debian/rules
+
+Alternatively, instead of using quilt directly, you can drop the patch in to
+debian/patches and add the name of the patch to debian/patches/series.
+
+
+The X Strike Force team maintains X packages in git repositories on
+git.debian.org in the pkg-xorg subdirectory. Most upstream packages
+are actually maintained in git repositories as well, so they often
+just need to be pulled into git.debian.org in a "upstream-*" branch.
+
+The .orig.tar.gz is upstream's MesaLib tarball.
+
+The Debian packaging is added by creating the "debian-*" git branch
+which contains the aforementioned "upstream-*" branch plus the debian/
+repository files.
+When a patch has to be applied to the Debian package, two solutions
+are involved:
+* If the patch is available in one of the upstream branches, it
+ may be git'cherry-picked into the Debian repository. In this
+ case, it appears directly in the .diff.gz.
+* Otherwise, the patch is added to debian/patches/ which is managed
+ with quilt as documented in /usr/share/doc/quilt/README.source.
+ Thus, the patching system requires a build dependency on quilt.