clone git-svn / branches parasites

Tl; dr:

git svn crée ces " @ " - branches si une branche (ou une balise) a été créée pour un sous-répertoire (ou pour un autre répertoire qui n'est pas suivi par git-svn). Il y aura toujours aussi une branche "régulière" avec le même nom, mais sans le suffixe"@". La branche "@ " n'existe que comme point de branchement pour la branche régulière.

Remarque: j'ai soumis un patch pour cela; une version modifiée de cette explication fait maintenant partie de la page de manuel officielle git svn, en tant que nouvelle section "Gestion des BRANCHES SVN" (depuis git 1.8.1).

Dans Subversion, les branches et les balises ne sont que des copies d'une arborescence de répertoires, il est donc possible (bien que généralement déconseillé) de créer une branche à partir d'un répertoire qui n'est pas lui-même une branche (ou un tronc). Par exemple, en copiant /trunk / foo dans / branches / bar, au lieu de copier /trunk (une "branche de sous-répertoire", pour ainsi dire), ou en copiant un répertoire qui se trouve en dehors de la structure trunk / tags / branches (ce qui est possible dans SVN).

Dans git, cependant, une branche est toujours pour l'ensemble du repo, les branches de sous-répertoire n'existent pas. git svn utilise donc une solution de contournement. S'il détecte une branche qui a été copiée à partir d'un répertoire qui n'est pas lui-même suivi en tant que branche par git-svn, il créera un nouvel historique. Par exemple, pour une branche de sous-répertoire où /trunk / foo est copié dans / branches / bar dans r1234, il va créer:

• un nouveau commit git pour chaque révision SVN de r1233 en arrière (notez que le nombre est le dernière révision avant la création de la branche). Les arbres de ces commits ne contiendront que le sous-répertoire qui a été ramifié. Donc, pour chaque révision de r1233 en arrière, il y aura généralement deux commits git, un avec l'arbre entier (créé lorsque git-svn a traité l'historique de trunk), et les nouveaux.
• une branche factice appelée "bar@1233" (branch name@revision), qui pointe vers le commit créé à partir de r1233 ci-dessus.
• un commit de r1234, le commit qui a créé la branche. Ce commit aura la branche ci-dessus comme ancêtre (seulement).
• une branche appelée "bar", qui pointe vers le deuxième commit.

De cette façon, pour la barre de branche du sous-répertoire, vous obtenez deux branches dans git

• bar@1233, qui représente l'état du référentiel à partir duquel la branche a été créée
• bar, qui représente la branche

Je ne suis pas tout à fait sûr pourquoi cette branche factice est créée. Je pense que c'est fait pour représenter l'information A propos de quelle révision la branche a été ramifiée, et d'avoir un historique complet pour la branche.

Notez que tout ce mécanisme peut être désactivé en utilisant le drapeau --no-follow-parent. Dans ce cas, chaque branche SVN aboutira à une branche git avec seulement les commits du répertoire SVN branch. Chaque branche ne sera pas connectée au reste de l'historique et aura son propre commit racine, correspondant au premier commit de la branche.