Document -i flag to git-read-tree
[git/jnareb-git/bp-gitweb.git] / git-format-patch.sh
blob525a2f22126cfead751c30310ffe2b2fd971fdae
1 #!/bin/sh
3 # Copyright (c) 2005 Junio C Hamano
6 . git-sh-setup || die "Not a git archive."
8 usage () {
9 echo >&2 "usage: $0"' [-n] [-o dir] [--keep-subject] [--mbox] [--check] [--signoff] [-<diff options>...] upstream [ our-head ]
11 Prepare each commit with its patch since our-head forked from upstream,
12 one file per patch, for e-mail submission. Each output file is
13 numbered sequentially from 1, and uses the first line of the commit
14 message (massaged for pathname safety) as the filename.
16 When -o is specified, output files are created in that directory; otherwise in
17 the current working directory.
19 When -n is specified, instead of "[PATCH] Subject", the first line is formatted
20 as "[PATCH N/M] Subject", unless you have only one patch.
22 When --mbox is specified, the output is formatted to resemble
23 UNIX mailbox format, and can be concatenated together for processing
24 with applymbox.
26 exit 1
29 diff_opts=
30 LF='
33 outdir=./
34 while case "$#" in 0) break;; esac
36 case "$1" in
37 -a|--a|--au|--aut|--auth|--autho|--author)
38 author=t ;;
39 -c|--c|--ch|--che|--chec|--check)
40 check=t ;;
41 -d|--d|--da|--dat|--date)
42 date=t ;;
43 -m|--m|--mb|--mbo|--mbox)
44 date=t author=t mbox=t ;;
45 -k|--k|--ke|--kee|--keep|--keep-|--keep-s|--keep-su|--keep-sub|\
46 --keep-subj|--keep-subje|--keep-subjec|--keep-subject)
47 keep_subject=t ;;
48 -n|--n|--nu|--num|--numb|--numbe|--number|--numbere|--numbered)
49 numbered=t ;;
50 -s|--s|--si|--sig|--sign|--signo|--signof|--signoff)
51 signoff=t ;;
52 -o=*|--o=*|--ou=*|--out=*|--outp=*|--outpu=*|--output=*|--output-=*|\
53 --output-d=*|--output-di=*|--output-dir=*|--output-dire=*|\
54 --output-direc=*|--output-direct=*|--output-directo=*|\
55 --output-director=*|--output-directory=*)
56 outdir=`expr "$1" : '-[^=]*=\(.*\)'` ;;
57 -o|--o|--ou|--out|--outp|--outpu|--output|--output-|--output-d|\
58 --output-di|--output-dir|--output-dire|--output-direc|--output-direct|\
59 --output-directo|--output-director|--output-directory)
60 case "$#" in 1) usage ;; esac; shift
61 outdir="$1" ;;
62 -*' '* | -*"$LF"* | -*' '*)
63 # Ignore diff option that has whitespace for now.
65 -*) diff_opts="$diff_opts$1 " ;;
66 *) break ;;
67 esac
68 shift
69 done
71 case "$keep_subject$numbered" in
72 tt)
73 die '--keep-subject and --numbered are incompatible.' ;;
74 esac
76 rev1= rev2=
77 case "$#" in
79 rev1="$1" rev2="$2" ;;
81 case "$1" in
82 *..*)
83 rev1=`expr "$1" : '\(.*\)\.\.'`
84 rev2=`expr "$1" : '.*\.\.\(.*\)'`
87 rev1="$1"
88 rev2="HEAD"
90 esac ;;
92 usage ;;
93 esac
95 me=`git-var GIT_AUTHOR_IDENT | sed -e 's/>.*/>/'`
97 case "$outdir" in
98 */) ;;
99 *) outdir="$outdir/" ;;
100 esac
101 test -d "$outdir" || mkdir -p "$outdir" || exit
103 tmp=.tmp-series$$
104 trap 'rm -f $tmp-*' 0 1 2 3 15
106 series=$tmp-series
107 commsg=$tmp-commsg
108 filelist=$tmp-files
110 titleScript='
111 /./d
112 /^$/n
113 s/^\[PATCH[^]]*\] *//
114 s/[^-a-z.A-Z_0-9]/-/g
115 s/\.\.\.*/\./g
116 s/\.*$//
117 s/--*/-/g
118 s/^-//
119 s/-$//
120 s/$/./
125 whosepatchScript='
126 /^author /{
127 s/author \(.*>\) \(.*\)$/au='\''\1'\'' ad='\''\2'\''/p
131 _x40='[0-9a-f][0-9a-f][0-9a-f][0-9a-f][0-9a-f]'
132 _x40="$_x40$_x40$_x40$_x40$_x40$_x40$_x40$_x40"
133 stripCommitHead='/^'"$_x40"' (from '"$_x40"')$/d'
135 git-cherry -v "$rev1" "$rev2" |
136 while read sign rev comment
138 case "$sign" in
139 '-')
140 echo >&2 "Merged already: $comment"
143 echo $rev
145 esac
146 done >$series
148 total=`wc -l <$series | tr -dc "[0-9]"`
150 while read commit
152 git-cat-file commit "$commit" | git-stripspace >$commsg
153 title=`sed -ne "$titleScript" <$commsg`
154 case "$numbered" in
155 '') num= ;;
157 case $total in
158 1) num= ;;
159 *) num=' '`printf "%d/%d" $i $total` ;;
160 esac
161 esac
163 file=`printf '%04d-%stxt' $i "$title"`
164 i=`expr "$i" + 1`
165 echo "* $file"
167 mailScript='
168 /./d
169 /^$/n'
170 case "$keep_subject" in
171 t) ;;
173 mailScript="$mailScript"'
174 s|^\[PATCH[^]]*\] *||
175 s|^|[PATCH'"$num"'] |'
177 esac
178 mailScript="$mailScript"'
179 s|^|Subject: |'
180 case "$mbox" in
182 echo 'From nobody Mon Sep 17 00:00:00 2001' ;# UNIX "From" line
184 esac
185 eval "$(sed -ne "$whosepatchScript" $commsg)"
186 test "$author,$au" = ",$me" || {
187 mailScript="$mailScript"'
189 From: '"$au"
191 test "$date,$au" = ",$me" || {
192 mailScript="$mailScript"'
194 Date: '"$ad"
197 mailScript="$mailScript"'
198 : body
201 b body'
203 sed -ne "$mailScript" <$commsg
205 test "$signoff" = "t" && {
206 offsigner=`git-var GIT_COMMITTER_IDENT | sed -e 's/>.*/>/'`
207 line="Signed-off-by: $offsigner"
208 grep -q "^$line\$" $commsg || {
209 echo
210 echo "$line"
211 echo
214 echo
215 echo '---'
216 echo
217 git-diff-tree -p $diff_opts "$commit" | git-apply --stat --summary
218 echo
219 git-diff-tree -p $diff_opts "$commit" | sed -e "$stripCommitHead"
221 case "$mbox" in
223 echo
225 esac
226 } >"$outdir$file"
227 case "$check" in
229 # This is slightly modified from Andrew Morton's Perfect Patch.
230 # Lines you introduce should not have trailing whitespace.
231 # Also check for an indentation that has SP before a TAB.
232 grep -n '^+\([ ]* .*\|.*[ ]\)$' "$outdir$file"
234 : do not exit with non-zero because we saw no problem in the last one.
235 esac
236 done <$series