Add support for a pdf version of the user manual
[git/mingw.git] / git-stash.sh
blobb9ace9970492aaf48472904d978d809d90ca33db
1 #!/bin/sh
2 # Copyright (c) 2007, Nanako Shiraishi
4 dashless=$(basename "$0" | sed -e 's/-/ /')
5 USAGE="list [<options>]
6 or: $dashless (show | drop | pop ) [<stash>]
7 or: $dashless apply [--index] [<stash>]
8 or: $dashless branch <branchname> [<stash>]
9 or: $dashless [save [--keep-index] [<message>]]
10 or: $dashless clear"
12 SUBDIRECTORY_OK=Yes
13 OPTIONS_SPEC=
14 . git-sh-setup
15 require_work_tree
16 cd_to_toplevel
18 TMP="$GIT_DIR/.git-stash.$$"
19 trap 'rm -f "$TMP-*"' 0
21 ref_stash=refs/stash
23 no_changes () {
24 git diff-index --quiet --cached HEAD --ignore-submodules -- &&
25 git diff-files --quiet --ignore-submodules
28 clear_stash () {
29 if test $# != 0
30 then
31 die "git stash clear with parameters is unimplemented"
33 if current=$(git rev-parse --verify $ref_stash 2>/dev/null)
34 then
35 git update-ref -d $ref_stash $current
39 create_stash () {
40 stash_msg="$1"
42 git update-index -q --refresh
43 if no_changes
44 then
45 exit 0
48 # state of the base commit
49 if b_commit=$(git rev-parse --verify HEAD)
50 then
51 head=$(git log --no-color --abbrev-commit --pretty=oneline -n 1 HEAD --)
52 else
53 die "You do not have the initial commit yet"
56 if branch=$(git symbolic-ref -q HEAD)
57 then
58 branch=${branch#refs/heads/}
59 else
60 branch='(no branch)'
62 msg=$(printf '%s: %s' "$branch" "$head")
64 # state of the index
65 i_tree=$(git write-tree) &&
66 i_commit=$(printf 'index on %s\n' "$msg" |
67 git commit-tree $i_tree -p $b_commit) ||
68 die "Cannot save the current index state"
70 # state of the working tree
71 w_tree=$( (
72 rm -f "$TMP-index" &&
73 cp -p ${GIT_INDEX_FILE-"$GIT_DIR/index"} "$TMP-index" &&
74 GIT_INDEX_FILE="$TMP-index" &&
75 export GIT_INDEX_FILE &&
76 git read-tree -m $i_tree &&
77 git add -u &&
78 git write-tree &&
79 rm -f "$TMP-index"
80 ) ) ||
81 die "Cannot save the current worktree state"
83 # create the stash
84 if test -z "$stash_msg"
85 then
86 stash_msg=$(printf 'WIP on %s' "$msg")
87 else
88 stash_msg=$(printf 'On %s: %s' "$branch" "$stash_msg")
90 w_commit=$(printf '%s\n' "$stash_msg" |
91 git commit-tree $w_tree -p $b_commit -p $i_commit) ||
92 die "Cannot record working tree state"
95 save_stash () {
96 keep_index=
97 case "$1" in
98 --keep-index)
99 keep_index=t
100 shift
101 esac
103 stash_msg="$*"
105 git update-index -q --refresh
106 if no_changes
107 then
108 echo 'No local changes to save'
109 exit 0
111 test -f "$GIT_DIR/logs/$ref_stash" ||
112 clear_stash || die "Cannot initialize stash"
114 create_stash "$stash_msg"
116 # Make sure the reflog for stash is kept.
117 : >>"$GIT_DIR/logs/$ref_stash"
119 git update-ref -m "$stash_msg" $ref_stash $w_commit ||
120 die "Cannot save the current status"
121 printf 'Saved working directory and index state "%s"\n' "$stash_msg"
123 git reset --hard
125 if test -n "$keep_index" && test -n $i_tree
126 then
127 git read-tree --reset -u $i_tree
131 have_stash () {
132 git rev-parse --verify $ref_stash >/dev/null 2>&1
135 list_stash () {
136 have_stash || return 0
137 git log --no-color --pretty=oneline -g "$@" $ref_stash -- |
138 sed -n -e 's/^[.0-9a-f]* refs\///p'
141 show_stash () {
142 flags=$(git rev-parse --no-revs --flags "$@")
143 if test -z "$flags"
144 then
145 flags=--stat
148 w_commit=$(git rev-parse --verify --default $ref_stash "$@") &&
149 b_commit=$(git rev-parse --verify "$w_commit^") &&
150 git diff $flags $b_commit $w_commit
153 apply_stash () {
154 git update-index -q --refresh &&
155 git diff-files --quiet --ignore-submodules ||
156 die 'Cannot apply to a dirty working tree, please stage your changes'
158 unstash_index=
159 case "$1" in
160 --index)
161 unstash_index=t
162 shift
163 esac
165 # current index state
166 c_tree=$(git write-tree) ||
167 die 'Cannot apply a stash in the middle of a merge'
169 # stash records the work tree, and is a merge between the
170 # base commit (first parent) and the index tree (second parent).
171 s=$(git rev-parse --verify --default $ref_stash "$@") &&
172 w_tree=$(git rev-parse --verify "$s:") &&
173 b_tree=$(git rev-parse --verify "$s^1:") &&
174 i_tree=$(git rev-parse --verify "$s^2:") ||
175 die "$*: no valid stashed state found"
177 unstashed_index_tree=
178 if test -n "$unstash_index" && test "$b_tree" != "$i_tree" &&
179 test "$c_tree" != "$i_tree"
180 then
181 git diff-tree --binary $s^2^..$s^2 | git apply --cached
182 test $? -ne 0 &&
183 die 'Conflicts in index. Try without --index.'
184 unstashed_index_tree=$(git-write-tree) ||
185 die 'Could not save index tree'
186 git reset
189 eval "
190 GITHEAD_$w_tree='Stashed changes' &&
191 GITHEAD_$c_tree='Updated upstream' &&
192 GITHEAD_$b_tree='Version stash was based on' &&
193 export GITHEAD_$w_tree GITHEAD_$c_tree GITHEAD_$b_tree
196 if git-merge-recursive $b_tree -- $c_tree $w_tree
197 then
198 # No conflict
199 if test -n "$unstashed_index_tree"
200 then
201 git read-tree "$unstashed_index_tree"
202 else
203 a="$TMP-added" &&
204 git diff-index --cached --name-only --diff-filter=A $c_tree >"$a" &&
205 git read-tree --reset $c_tree &&
206 git update-index --add --stdin <"$a" ||
207 die "Cannot unstage modified files"
208 rm -f "$a"
210 git status || :
211 else
212 # Merge conflict; keep the exit status from merge-recursive
213 status=$?
214 if test -n "$unstash_index"
215 then
216 echo >&2 'Index was not unstashed.'
218 exit $status
222 drop_stash () {
223 have_stash || die 'No stash entries to drop'
225 if test $# = 0
226 then
227 set x "$ref_stash@{0}"
228 shift
230 # Verify supplied argument looks like a stash entry
231 s=$(git rev-parse --verify "$@") &&
232 git rev-parse --verify "$s:" > /dev/null 2>&1 &&
233 git rev-parse --verify "$s^1:" > /dev/null 2>&1 &&
234 git rev-parse --verify "$s^2:" > /dev/null 2>&1 ||
235 die "$*: not a valid stashed state"
237 git reflog delete --updateref --rewrite "$@" &&
238 echo "Dropped $* ($s)" || die "$*: Could not drop stash entry"
240 # clear_stash if we just dropped the last stash entry
241 git rev-parse --verify "$ref_stash@{0}" > /dev/null 2>&1 || clear_stash
244 apply_to_branch () {
245 have_stash || die 'Nothing to apply'
247 test -n "$1" || die 'No branch name specified'
248 branch=$1
250 if test -z "$2"
251 then
252 set x "$ref_stash@{0}"
254 stash=$2
256 git-checkout -b $branch $stash^ &&
257 apply_stash --index $stash &&
258 drop_stash $stash
261 # Main command set
262 case "$1" in
263 list)
264 shift
265 if test $# = 0
266 then
267 set x -n 10
268 shift
270 list_stash "$@"
272 show)
273 shift
274 show_stash "$@"
276 save)
277 shift
278 save_stash "$@"
280 apply)
281 shift
282 apply_stash "$@"
284 clear)
285 shift
286 clear_stash "$@"
288 create)
289 if test $# -gt 0 && test "$1" = create
290 then
291 shift
293 create_stash "$*" && echo "$w_commit"
295 drop)
296 shift
297 drop_stash "$@"
299 pop)
300 shift
301 if apply_stash "$@"
302 then
303 test -z "$unstash_index" || shift
304 drop_stash "$@"
307 branch)
308 shift
309 apply_to_branch "$@"
312 if test $# -eq 0
313 then
314 save_stash &&
315 echo '(To restore them type "git stash apply")'
316 else
317 usage
320 esac