TO

   1 #!/bin/sh
   2
   3 clean= next=next
   4 branch=`git symbolic-ref HEAD`
   5 while case $# in 0) break ;; esac
   6 do
   7         case "$1" in
   8         --clean)
   9                 test refs/heads/master = "$branch" || {
  10                         echo >&2 Not on master
  11                         exit 1
  12                 }
  13                 clean=t
  14                 ;;
  15         --next)
  16                 test 2 -le $# || {
  17                         echo >&2 "Need argument"
  18                         exit 1
  19                 }
  20                 next="$2"
  21                 git rev-parse --verify "$next" >/dev/null || exit
  22                 shift
  23                 ;;
  24         *)
  25                 echo >&2 "$0 [--clean | --next test-next ]"
  26                 exit 1
  27                 ;;
  28         esac
  29         shift
  30 done
  31
  32 master_sha1=`git rev-parse --verify refs/heads/master`
  33 LF='
  34 '
  35 (cd .git/refs/heads && find -type f) |
  36 sed -n \
  37     -e 's/^\.\///' \
  38     -e '/^[^\/][^\/]\//p' |
  39 sort |
  40 while read topic
  41 do
  42         rebase= done= not_done= trouble= date=
  43         topic_sha1=`git rev-parse --verify "refs/heads/$topic"`
  44         is_current=
  45         if test "refs/heads/$topic" = "$branch"
  46         then
  47                 is_current=" *"
  48         fi
  49
  50         date=`
  51                 git-rev-list -1 --pretty "$topic" |
  52                 sed -ne 's/^Date: *\(.*\)/ (\1)/p'
  53         `
  54         # (1)
  55         only_next_1=`git-rev-list ^master "^$topic" ${next} | sort`
  56         only_next_2=`git-rev-list ^master           ${next} | sort`
  57         if test "$only_next_1" = "$only_next_2"
  58         then
  59                 not_in_topic=`git-rev-list "^$topic" master`
  60                 if test -z "$not_in_topic"
  61                 then
  62                         rebase=" (vanilla)"
  63                 else
  64                         rebase=" (can be rebased)"
  65                 fi
  66         fi
  67
  68         # (2)
  69         not_in_master=`
  70                 git-rev-list ^master "$topic"
  71         `
  72         test -z "$not_in_master" &&
  73         done="${LF}Fully merged -- delete."
  74
  75         # (3)
  76         not_in_next=`
  77                 git-rev-list --pretty=oneline ^${next} "$topic" |
  78                 sed -e 's/^[0-9a-f]* / - /'
  79         `
  80         if test -n "$not_in_next"
  81         then
  82                 if test -n "$done"
  83                 then
  84                         # If $topic and master are the same,
  85                         # it is fine.
  86                         test "$master_sha1" = "$topic_sha1" ||
  87                         trouble="${LF}### MODIFIED AFTER COOKED ###"
  88                 fi
  89                 not_done="${LF}Still not merged in ${next}$rebase.$LF$not_in_next"
  90         elif test -n "$done"
  91         then
  92                 not_done=
  93         else
  94                 not_done="${LF}Up to date."
  95         fi
  96
  97         echo "*** $topic ***$date$is_current$trouble$done$not_done"
  98
  99         if test -z "$trouble$not_done" &&
 100             test -n "$done" &&
 101             test t = "$clean"
 102         then
 103                 git branch -d "$topic"
 104         fi
 105 done
 106
 107 exit
 108
 109 ################################################################
 110 Using Topic Branches
 111
 112 Some important disciplines first.
 113
 114  * Once a topic branch forks from "master", never merge "master"
 115    updates into the topic branch.
 116
 117  * Once a topic branch is fully cooked and merged into "master",
 118    delete it.  If you need to build on top of it to correct
 119    earlier mistakes, create a new topic branch by forking at the
 120    tip of the "master".  This is not strictly necessary, but it
 121    makes it easier to keep your history simple.
 122
 123  * Whenever you need to test or publish your changes to topic
 124    branches, merge them into "next" branch.
 125
 126 So, you would want to know:
 127
 128 (1) ... if a topic branch has ever been merged to "next".  Young
 129     topic branches can have stupid mistakes you would rather
 130     clean up, and things that have not been merged into other
 131     branches can be easily rebased without affecting others.
 132
 133 (2) ... if a topic branch has been fully merged to "master".
 134     Then you can delete it.  More importantly, you can tell you
 135     should not build on top of it.
 136
 137 (3) ... if a topic branch has commits unmerged to "next".  You
 138     need to merge them to test and/or publish.
 139
 140 Let's look at this example:
 141
 142                    o---o---o---o---o---o---o---o---o---o "next"
 143                   /       /           /           /
 144                  /   a---a---b A     /           /
 145                 /   /               /           /
 146                /   /   c---c---c---c B         /
 147               /   /   /             \         /
 148              /   /   /   b---b C     \       /
 149             /   /   /   /             \     /
 150     ---o---o---o---o---o---o---o---o---o---o---o "master"
 151
 152
 153 A, B and C are topic branches.
 154
 155  * A has one fix since it was merged up to "next".
 156
 157  * B has finished.  It has been fully merged up to "master" and "next",
 158    and is ready to be deleted.
 159
 160  * C has not merged to "next" at all.
 161
 162 To compute (1):
 163
 164         git-rev-list ^master ^topic next
 165         git-rev-list ^master        next
 166
 167         if these match, topic has not merged in next at all.
 168
 169 To compute (2):
 170
 171         git-rev-list master..topic
 172
 173         if this is empty, it is fully merged to "master".
 174
 175 To compute (3):
 176
 177         git-rev-list next..topic
 178
 179         if this is empty, there is nothing to merge to "next".
 180