summaryrefslogtreecommitdiff
path: root/debian/README.dbs
diff options
context:
space:
mode:
Diffstat (limited to 'debian/README.dbs')
-rw-r--r--debian/README.dbs20
1 files changed, 20 insertions, 0 deletions
diff --git a/debian/README.dbs b/debian/README.dbs
new file mode 100644
index 0000000..946bac0
--- /dev/null
+++ b/debian/README.dbs
@@ -0,0 +1,20 @@
+This package uses a form of source build based on DBS. To setup the
+source, run "debian/rules setup". This will extract the pristine source in
+build-dir/, apply patches from debian/patches/ and split the package
+scripts from debian/packages.d/ into their component files.
+
+A few cavaets. Modifying the source in build-tree/ or the package files in
+debian/, will not be preserved after the "clean" target is run. Actual
+files for packages are in debian/packages.d/ and will be regerated after
+being modified.
+
+To create patches for the source, you can remember several steps. There
+are two targes for handling source. The "unpack" target, will simply
+unpack the tarball(s) into build-tree/ and "patch" will apply all patches
+from debian/patches/. If you make any changes you can generate a new patch
+using the "make_patch" target. This will move your current sources under
+build-tree/, unpack the source+patches again, and then generate a diff
+between the two. Note, you should run the "clean" target in the
+build-tree/ source before doing this, to get a clean patch.
+
+Ben