diff options
Diffstat (limited to 'git-debrebase.1.pod')
-rw-r--r-- | git-debrebase.1.pod | 22 |
1 files changed, 13 insertions, 9 deletions
diff --git a/git-debrebase.1.pod b/git-debrebase.1.pod index 9140702..7e12624 100644 --- a/git-debrebase.1.pod +++ b/git-debrebase.1.pod @@ -17,8 +17,11 @@ This is the command line reference. Please read the tutorial L<dgit-maint-debrebase(5)>. For background, theory of operation, -and definitions of the terms used here, -see L<git-debrebase(5)>. +and definitions see L<git-debrebase(5)>. + +You should read this manpage in conjunction with +L<git-debrebase(5)/TERMINOLOGY>, +which defines many important terms used here. =head1 PRINCIPAL OPERATIONS @@ -299,14 +302,15 @@ in the text for the relvant operation. =item --anchor=<commit-ish> -Treats <commit-ish> as an anchor, -regardless of what it's actually like. +Treats <commit-ish> as an anchor. +This overrides the usual automatic commit classification logic. -(It is a problem for -git-debrebase new-upstream operations -if <commit-ish> is the previous anchor to be used, -because treating an arbitrary commit as an anchor -means forgoing upstream coherency checks.) +It also disables some coherency checks +which depend on metadata extracted from its commit message, +so +it is a problem if <commit-ish> is the anchor +for the previous upstream version in +git-debrebase new-upstream operations. =item -D |