# along with this program. If not, see <http://www.gnu.org/licenses/>.
# usages:
-# git-debrebase launder # prints breakwater tip
-# git-debrebase analyse
-# git-debrebase start # like ffrebase start + debrebase launder
-# git-debrebase create-new-upstream [-f] <upstreaminfo>
-# git-debrebase new-upstream [-f] <upstreaminfo>
+# git-debrebase status
+# git-debrebase start # like ffqrebase start + debrebase launder
+# git-debrebase new-upstream [stuff] # see below
# git-debrebase <git-rebase options> # does debrebase start if necessary
#
+# git-debrebase analyse
+# git-debrebase launder # prints breakwater tip
+# git-debrebase create-new-upstream-breakwater [-f] <upstreaminfo>...
+#
# <upstreaminfo> is
# [,][<subdir>:][+]<commitid>[,...]
#
# xxx want auto branch names
# xxx too complicated
# how about for now
-# [+]<commit> [<subdir:> [+]<commit>...]
+# [+]<commit> [<subdir/> [+]<commit>...]
# ? plus options
# --new-upstream-different-subtrees
+#
+# automatic case
+# git-debrebase new-upstream
+# - previous breakwater merge must be gdr-generated
+# - orig set is the same as before
+# - implicitly uses upstream branches according to orig set
+# - not all upstream branches need be updated
+# - insists on fast-forward of each branch, unless
+# --force (or --force=<subdir>[/])
+# branch set adjustments
+# git-debrebase new-upstream --add <subdir>/
+# git-debrebase new-upstream --rm <subdir>/
+# git-debrebase new-upstream / [<subdir>/ ...]
+# - orig set is adjusted
+# - otherwise like auto (--add is not checked for ffness, obv)
+# - multiple --add and --rm may be specified
+# - --add makes new upstream the last contributor
+# explicit
+# git-debrebase / [<rootcommitid>] [<subdir>/ [<commitid>] ...]
+# - orig set is precisely as specified now
+# - previous breakwater merge is irrelevant
+# - no fast forward checks
+# for now only explicit with commitids
+
+ # implicitly uses `upstream'
+# # (or multiple other branches)
+# git-debrebase new-upstream \
+# [<subdir>/]=<commitid>
# UPSTREAM[,[[SUBDIR:]SUBUPSTREAM]
# default for SUBDIR: is from previous upstream merge[xxx terminology]
# when starting must record original start (for ff)
# and new rebase basis
#
-# git-ffrebase start [BASE] # records previous HEAD so it can be overwritten
-# # records base for future git-ffrebase
-# git-ffrebase set-base BASE
-# git-ffrebase <git-rebase options>
-# git-ffrebase finish
-# git-ffrebase status [BRANCH]
+# git-ffqrebase start [BASE]
+# # records previous HEAD so it can be overwritten
+# # records base for future git-ffqrebase
+# git-ffqrebase set-base BASE
+# git-ffqrebase <git-rebase options>
+# git-ffqrebase finish
+# git-ffqrebase status [BRANCH]
#
-# refs/ffrebase-prev/BRANCH BRANCH may be refs/...; if not it means
-# refs/ffrebase-base/BRANCH refs/heads/BRANCH
+# refs/ffqrebase-prev/BRANCH BRANCH may be refs/...; if not it means
+# refs/ffqrebase-base/BRANCH refs/heads/BRANCH
# zero, one, or both of these may exist
use strict;
return ($`,$');
}
-sub D_DEB () { return 0x1; }
-sub D_UPS () { return 0x2; }
-sub D_PAT_ADD () { return 0x4; }
-sub D_PAT_OTH () { return 0x8; }
+sub D_DEB () { return 0x1; } # debian/ (not including debian/patches/)
+sub D_UPS () { return 0x2; } # upstream files
+sub D_PAT_ADD () { return 0x4; } # debian/patches/ extra patches at end
+sub D_PAT_OTH () { return 0x8; } # debian/patches other changes
our $rd = ".git/git-debrebase";
our $ud = "$rd/work";
sub calculate_committer_authline () {
my $c = cmdoutput @git, qw(commit-tree --no-gpg-sign -m),
- 'XXX DUMMY COMMIT (git-debrebase)', "$basis:";
+ 'DUMMY COMMIT (git-debrebase)', "$basis:";
my ($h,$m) = get_commit $c;
$h =~ m/^committer .*$/m or confess "($h) ?";
return $&;
}
+# classify returns an info hash like this
+# CommitId => $objid
+# Hdr => # commit headers, including 1 final newline
+# Msg => # commit message (so one newline is dropped)
+# Tree => $treeobjid
+# Type => (see below)
+# Parents = [ {
+# Ix => $index # ie 0, 1, 2, ...
+# CommitId
+# Differs => return value from get_differs
+# IsOrigin
+# IsDggitImport => 'orig' 'tarball' 'unpatched' 'package' (as from dgit)
+# } ...]
+# NewMsg => # commit message, but with any [dgit import ...] edited
+# # to say "[was: ...]"
+#
+# Types:
+# Packaging
+# Upstream
+# AddPatches
+# Mixed
+# Unknown
+#
+# Pseudomerge
+# has additional entres in classification result
+# Overwritten = [ subset of Parents ]
+# Contributor = $the_remaining_Parent
+#
+# DgitImportUnpatched
+# has additional entry in classification result
+# OrigParents = [ subset of Parents ]
+#
+# BreakwaterUpstreamMerge
+# has additional entry in classification result
+# OrigParents = [ subset of Parents ]
+
sub classify ($) {
my ($objid) = @_;
!($p[0]{Differs} & ~D_DEB) &&
!($p[1]{Differs} & ~D_UPS)) {
return $classify->(qw(BreakwaterUpstreamMerge),
- Upstream => $p[1]);
+ OrigParents => [ $p[1] ]);
}
+ # xxx multi-.orig upstreams
return $unknown->("complex merge");
}
mkdir $rd or $!==EEXIST or die $!;
my $current_method;
foreach my $cl (qw(Debian), (reverse @deb_cl),
+ { SpecialMethod => 'RecordBreakwaterTip' },
qw(Upstream), (reverse @ups_cl)) {
if (!ref $cl) {
$current_method = $cl;
} elsif ($method eq 'StartRewrite') {
$rewriting = 1;
next;
+ } elsif ($method eq 'RecordBreakwaterTip') {
+ last if $wantdebonly;
+ $breakwater = $build;
+ next;
} elsif ($method eq 'DgitImportDebianUpdate') {
$read_tree_debian->($cltree);
$rm_tree_cached(qw(debian/patches));
map { $wantdebonly ? "$_:debian" : $_ },
$input, $build;
- return $build;
+ return ($build, $breakwater);
}
sub get_head () { return git_rev_parse qw(HEAD); }
sub cmd_launder () {
my $old = get_head();
- my $got = launder $old, 0, undef, 0;
- update_head $old, $new, 'launder'; # no tree changes!
+ my ($tip,$breakwater) = launder $old, 0, undef, 0;
+ update_head $old, $tip, 'launder'; # no tree changes! xxx debian/patches
+ printf "# breakwater tip:\n%s\n", $breakwater;
}
my $toplevel = runcmd @git, qw(rev-parse --show-toplevel);