summaryrefslogtreecommitdiffstats
path: root/debian/README.source
diff options
context:
space:
mode:
authorLuca Boccassi <luca.boccassi@gmail.com>2016-07-26 13:06:58 +0100
committerLuca Boccassi <luca.boccassi@gmail.com>2016-07-26 20:13:20 +0100
commit5200906dd905c11c7fbd0b905fc82d843ff87a17 (patch)
tree65dddbfcd677917b34cc987ee45a802cba0033c7 /debian/README.source
parente2f183a2ae2710e60a8402863bab5ac7af7a0cc0 (diff)
Document use of dquilt in debian/README.source
Add link to Debian's wiki and short snippets with setup instrunctions Change-Id: I306723034c7f215f5244e9b3eacfaaa5c2aa4388 Signed-off-by: Luca Boccassi <luca.boccassi@gmail.com>
Diffstat (limited to 'debian/README.source')
-rw-r--r--debian/README.source28
1 files changed, 28 insertions, 0 deletions
diff --git a/debian/README.source b/debian/README.source
new file mode 100644
index 00000000..1d9eceab
--- /dev/null
+++ b/debian/README.source
@@ -0,0 +1,28 @@
+quilt patches format
+
+Note that we use the dquilt format for patches as outlined on Debian's wiki:
+https://www.debian.org/doc/manuals/maint-guide/modify.en.html#quiltrc
+
+Please consider using the same format to avoid excessive churn when adding or
+refreshing patches.
+
+Add the following to your ~/.bashrc (or equivalent):
+
+alias dquilt="quilt --quiltrc=${HOME}/.quiltrc-dpkg"
+complete -F _quilt_completion $_quilt_complete_opt dquilt
+
+And then create a new ~/.quiltrc-dpkg file with content:
+
+d=. ; while [ ! -d $d/debian -a `readlink -e $d` != / ]; do d=$d/..; done
+if [ -d $d/debian ] && [ -z $QUILT_PATCHES ]; then
+ # if in Debian packaging tree with unset $QUILT_PATCHES
+ QUILT_PATCHES="debian/patches"
+ QUILT_PATCH_OPTS="--reject-format=unified"
+ QUILT_DIFF_ARGS="-p ab --no-timestamps --no-index --color=auto"
+ QUILT_REFRESH_ARGS="-p ab --no-timestamps --no-index"
+ QUILT_COLORS="diff_hdr=1;32:diff_add=1;34:diff_rem=1;31:diff_hunk=1;33:diff_ctx=35:diff_cctx=33"
+ if ! [ -d $d/debian/patches ]; then mkdir $d/debian/patches; fi
+fi
+
+Open a new terminal or souce ~/.bashrc, and then you will be able to use
+dquilt.