← Back to branch summary

~lbrulet-8/compiz-plugins-main/fix-876591

« back to all changes in this revision

Viewing changes to jpeg/.git/hooks/pre-rebase.sample

  • Committer: Bazaar Package Importer
  • Author(s): Didier Roche
  • Date: 2011-02-24 17:34:18 UTC
  • Revision ID: james.westby@ubuntu.com-20110224173418-b81hfllshqpciq6n
Tags: upstream-0.9.4
Import upstream version 0.9.4

Show diffs side-by-side

added added

removed removed

Lines of Context:
jpeg/.git/hooks/pre-rebase.sample
 
1
#!/bin/sh
 
2
#
 
3
# Copyright (c) 2006, 2008 Junio C Hamano
 
4
#
 
5
# The "pre-rebase" hook is run just before "git rebase" starts doing
 
6
# its job, and can prevent the command from running by exiting with
 
7
# non-zero status.
 
8
#
 
9
# The hook is called with the following parameters:
 
10
#
 
11
# $1 -- the upstream the series was forked from.
 
12
# $2 -- the branch being rebased (or empty when rebasing the current branch).
 
13
#
 
14
# This sample shows how to prevent topic branches that are already
 
15
# merged to 'next' branch from getting rebased, because allowing it
 
16
# would result in rebasing already published history.
 
17
 
 
18
publish=next
 
19
basebranch="$1"
 
20
if test "$#" = 2
 
21
then
 
22
        topic="refs/heads/$2"
 
23
else
 
24
        topic=`git symbolic-ref HEAD` ||
 
25
        exit 0 ;# we do not interrupt rebasing detached HEAD
 
26
fi
 
27
 
 
28
case "$topic" in
 
29
refs/heads/??/*)
 
30
        ;;
 
31
*)
 
32
        exit 0 ;# we do not interrupt others.
 
33
        ;;
 
34
esac
 
35
 
 
36
# Now we are dealing with a topic branch being rebased
 
37
# on top of master.  Is it OK to rebase it?
 
38
 
 
39
# Does the topic really exist?
 
40
git show-ref -q "$topic" || {
 
41
        echo >&2 "No such branch $topic"
 
42
        exit 1
 
43
}
 
44
 
 
45
# Is topic fully merged to master?
 
46
not_in_master=`git rev-list --pretty=oneline ^master "$topic"`
 
47
if test -z "$not_in_master"
 
48
then
 
49
        echo >&2 "$topic is fully merged to master; better remove it."
 
50
        exit 1 ;# we could allow it, but there is no point.
 
51
fi
 
52
 
 
53
# Is topic ever merged to next?  If so you should not be rebasing it.
 
54
only_next_1=`git rev-list ^master "^$topic" ${publish} | sort`
 
55
only_next_2=`git rev-list ^master           ${publish} | sort`
 
56
if test "$only_next_1" = "$only_next_2"
 
57
then
 
58
        not_in_topic=`git rev-list "^$topic" master`
 
59
        if test -z "$not_in_topic"
 
60
        then
 
61
                echo >&2 "$topic is already up-to-date with master"
 
62
                exit 1 ;# we could allow it, but there is no point.
 
63
        else
 
64
                exit 0
 
65
        fi
 
66
else
 
67
        not_in_next=`git rev-list --pretty=oneline ^${publish} "$topic"`
 
68
        /usr/bin/perl -e '
 
69
                my $topic = $ARGV[0];
 
70
                my $msg = "* $topic has commits already merged to public branch:\n";
 
71
                my (%not_in_next) = map {
 
72
                        /^([0-9a-f]+) /;
 
73
                        ($1 => 1);
 
74
                } split(/\n/, $ARGV[1]);
 
75
                for my $elem (map {
 
76
                                /^([0-9a-f]+) (.*)$/;
 
77
                                [$1 => $2];
 
78
                        } split(/\n/, $ARGV[2])) {
 
79
                        if (!exists $not_in_next{$elem->[0]}) {
 
80
                                if ($msg) {
 
81
                                        print STDERR $msg;
 
82
                                        undef $msg;
 
83
                                }
 
84
                                print STDERR " $elem->[1]\n";
 
85
                        }
 
86
                }
 
87
        ' "$topic" "$not_in_next" "$not_in_master"
 
88
        exit 1
 
89
fi
 
90
 
 
91
exit 0
 
92
 
 
93
<<\DOC_END
 
94
################################################################
 
95
 
 
96
This sample hook safeguards topic branches that have been
 
97
published from being rewound.
 
98
 
 
99
The workflow assumed here is:
 
100
 
 
101
 * Once a topic branch forks from "master", "master" is never
 
102
   merged into it again (either directly or indirectly).
 
103
 
 
104
 * Once a topic branch is fully cooked and merged into "master",
 
105
   it is deleted.  If you need to build on top of it to correct
 
106
   earlier mistakes, a new topic branch is created by forking at
 
107
   the tip of the "master".  This is not strictly necessary, but
 
108
   it makes it easier to keep your history simple.
 
109
 
 
110
 * Whenever you need to test or publish your changes to topic
 
111
   branches, merge them into "next" branch.
 
112
 
 
113
The script, being an example, hardcodes the publish branch name
 
114
to be "next", but it is trivial to make it configurable via
 
115
$GIT_DIR/config mechanism.
 
116
 
 
117
With this workflow, you would want to know:
 
118
 
 
119
(1) ... if a topic branch has ever been merged to "next".  Young
 
120
    topic branches can have stupid mistakes you would rather
 
121
    clean up before publishing, and things that have not been
 
122
    merged into other branches can be easily rebased without
 
123
    affecting other people.  But once it is published, you would
 
124
    not want to rewind it.
 
125
 
 
126
(2) ... if a topic branch has been fully merged to "master".
 
127
    Then you can delete it.  More importantly, you should not
 
128
    build on top of it -- other people may already want to
 
129
    change things related to the topic as patches against your
 
130
    "master", so if you need further changes, it is better to
 
131
    fork the topic (perhaps with the same name) afresh from the
 
132
    tip of "master".
 
133
 
 
134
Let's look at this example:
 
135
 
 
136
                   o---o---o---o---o---o---o---o---o---o "next"
 
137
                  /       /           /           /
 
138
                 /   a---a---b A     /           /
 
139
                /   /               /           /
 
140
               /   /   c---c---c---c B         /
 
141
              /   /   /             \         /
 
142
             /   /   /   b---b C     \       /
 
143
            /   /   /   /             \     /
 
144
    ---o---o---o---o---o---o---o---o---o---o---o "master"
 
145
 
 
146
 
 
147
A, B and C are topic branches.
 
148
 
 
149
 * A has one fix since it was merged up to "next".
 
150
 
 
151
 * B has finished.  It has been fully merged up to "master" and "next",
 
152
   and is ready to be deleted.
 
153
 
 
154
 * C has not merged to "next" at all.
 
155
 
 
156
We would want to allow C to be rebased, refuse A, and encourage
 
157
B to be deleted.
 
158
 
 
159
To compute (1):
 
160
 
 
161
        git rev-list ^master ^topic next
 
162
        git rev-list ^master        next
 
163
 
 
164
        if these match, topic has not merged in next at all.
 
165
 
 
166
To compute (2):
 
167
 
 
168
        git rev-list master..topic
 
169
 
 
170
        if this is empty, it is fully merged to "master".
 
171
 
 
172
DOC_END