Jonas Fonseca <fonseca@xxxxxxx> writes: > Signed-off-by: Jonas Fonseca <fonseca@xxxxxxx> > --- > Documentation/git-branch.txt | 5 +++++ > 1 files changed, 5 insertions(+), 0 deletions(-) > > I made a patch to discard the overwritten branch's configuration > section, which Spearce felt was too lossy a behaviour. However, since > it confused me, I think it should at least be mentioned in the manpage. > Maybe the warning message from git should also be added to improve its > "googlability". > > diff --git a/Documentation/git-branch.txt b/Documentation/git-branch.txt > index 5e81aa4..def4e85 100644 > --- a/Documentation/git-branch.txt > +++ b/Documentation/git-branch.txt > @@ -165,6 +165,11 @@ If you are creating a branch that you want to immediately checkout, it's > easier to use the git checkout command with its `-b` option to create > a branch and check it out with a single command. > > +When a branch is renamed so that it overwrites an existing branch unintended > +problems can arise. This is because git refuses to discard the configuration > +section of the overwritten branch. As a result git can become confused if, for > +example, the branches involved were used for tracking two different remote > +branches. The only way to fix this is to edit the configuration file manually. I do not understand this bit about "refuse". - To "refuse to discard", somebody has to ask to discard --- who asks so and when? - Is there a reason to "refuse" when such a removal request is made? If so, what is it? If not, why refusal? - To unsubscribe from this list: send the line "unsubscribe git" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html