Document use of dquilt in debian/README.source
[deb_dpdk.git] / debian / README.source
1 quilt patches format
2
3 Note that we use the dquilt format for patches as outlined on Debian's wiki:
4 https://www.debian.org/doc/manuals/maint-guide/modify.en.html#quiltrc
5
6 Please consider using the same format to avoid excessive churn when adding or
7 refreshing patches.
8
9 Add the following to your ~/.bashrc (or equivalent):
10
11 alias dquilt="quilt --quiltrc=${HOME}/.quiltrc-dpkg"
12 complete -F _quilt_completion $_quilt_complete_opt dquilt
13
14 And then create a new ~/.quiltrc-dpkg file with content:
15
16 d=. ; while [ ! -d $d/debian -a `readlink -e $d` != / ]; do d=$d/..; done
17 if [ -d $d/debian ] && [ -z $QUILT_PATCHES ]; then
18     # if in Debian packaging tree with unset $QUILT_PATCHES
19     QUILT_PATCHES="debian/patches"
20     QUILT_PATCH_OPTS="--reject-format=unified"
21     QUILT_DIFF_ARGS="-p ab --no-timestamps --no-index --color=auto"
22     QUILT_REFRESH_ARGS="-p ab --no-timestamps --no-index"
23     QUILT_COLORS="diff_hdr=1;32:diff_add=1;34:diff_rem=1;31:diff_hunk=1;33:diff_ctx=35:diff_cctx=33"
24     if ! [ -d $d/debian/patches ]; then mkdir $d/debian/patches; fi
25 fi
26
27 Open a new terminal or souce ~/.bashrc, and then you will be able to use
28 dquilt.