merge-base --fork-point doc: clarify the example and failure modes
commit6d1700b8af43ea6078c8f17dedc0613431f6b07d
authorJunio C Hamano <gitster@pobox.com>
Thu, 9 Nov 2017 02:49:45 +0000 (9 11:49 +0900)
committerJunio C Hamano <gitster@pobox.com>
Thu, 9 Nov 2017 03:28:30 +0000 (9 12:28 +0900)
tree3735997037cd4842329078e6eb257c366b5b64a2
parent9752ad0bb79f680bca48db7adc45338b298304b0
merge-base --fork-point doc: clarify the example and failure modes

The illustrated history used to explain the `--fork-point` mode
named three keypoint commits B3, B2 and B1 from the oldest to the
newest, which was hard to read.  Relabel them to B0, B1, B2.  Also
illustrate the history after the rebase using the `--fork-point`
facility was made.

The text already mentions use of reflog, but the description is not
clear what benefit we are trying to gain by using reflog.  Clarify
that it is to find the commits that were known to be at the tip of
the remote-tracking branch.  This in turn necessitates users to know
the ramifications of the underlying assumptions, namely, expiry of
reflog entries will make it impossible to determine which commits
were at the tip of the remote-tracking branches and we fail when in
doubt (instead of giving a random and incorrect result without even
warning).  Another limitation is that it won't be useful if you did
not fork from the tip of a remote-tracking branch but from in the
middle.

Describe them.

Signed-off-by: Junio C Hamano <gitster@pobox.com>
Documentation/git-merge-base.txt