Git branching: Demo a merge conflict

Author: encukou

lessons/git/basics_branching.sh

@@ -55,6 +55,8 @@ git checkout doplneni-autora
 git branch
 
 cat > basnicka.txt << END
+(Lidová)
+
 Holka modrooká
 Nesedávej u potoka
 Holka modrooká
@@ -64,8 +66,6 @@ V potoce je hastrmánek
 Zatahá tě za copánek
 Holka modrooká
 Nesedávej tam
-
-- Lidová
 END
 
 git add basnicka.txt
@@ -79,8 +79,7 @@ git checkout doplneni-jmena
 git branch
 
 cat > basnicka.txt << END
-Holka modrooká
-=========
+Holka Modrooká
 
 Holka modrooká
 Nesedávej u potoka
@@ -101,6 +100,28 @@ take_screenshot $OUTFILE.branches.png gitk --all
 git checkout master
 git merge doplneni-jmena
 git merge doplneni-autora
+git status
+cat basnicka.txt
+git diff
+
+cat > basnicka.txt << END
+Holka modrooká
+(Lidová)
+
+Holka modrooká
+Nesedávej u potoka
+Holka modrooká
+Nesedávej tam
+
+V potoce je hastrmánek
+Zatahá tě za copánek
+Holka modrooká
+Nesedávej tam
+END
+
+git add basnicka.txt
+GIT_EDITOR='true' git commit
+
 git branch
 
 take_screenshot $OUTFILE.merge.png gitk --all

lessons/git/branching/index.md

@@ -63,7 +63,7 @@ Switched to branch 'doplneni-autora'
 ```
 
 Tak. Teď jsi „ve” větvi `doplneni-autora`.
-Doplň nějaké jméno do souboru `basnicka.txt`,
+Doplň nějaké jméno na začátek souboru `basnicka.txt`,
 a pomocí `git add` a `git commit` udělej novou revizi.
 Pak koukni na `gitk --all`, jak to vypadá:
 
@@ -93,7 +93,8 @@ Switched to branch 'doplneni-jmena'
   master␛[m
 ```
 
-Doplň do souboru jméno básně a pomocí
+Doplň jméno básně na začátek souboru (tedy na stejné místo,
+jako je v druhé větvi název) a pomocí
 `git add`, `git commit` ulož revizi.
 Všechno zkontroluj přes `gitk --all`.
 
@@ -125,7 +126,8 @@ zpátky do `master`. Podívejme se jak na to.
 
 Nedávalo by smysl historii projektu rozdvojovat,
 kdyby pak jednotlivé větve nešly zase sloučit dohromady.
-Naštěstí je v Gitu slučování poměrně jednoduché.
+V Gitu je většinou slučování poměrně jednoduché, ale tento příklad schválně
+ukazuje nejsložitější variantu, která může nastat.
 
 Přepni se zpátky na `master`
 a použij příkaz `git merge`, který
@@ -148,25 +150,82 @@ vlastně nebylo co slučovat – jen se do větve
 Zkontroluj v `gitk --all`, jak to vypadá.
 
 A pak zkus sloučit i druhou větev: `git merge doplneni-autora`.
-Tady to bude složitější: Může se stát, že změny nepůjdou
+Tady to bude složitější: pravděpodobně se stane, že změny nepůjdou
 automaticky sloučit a ve výstupu se objeví hláška
-`merge conflict` (slučovací konflikt).
+`merge conflict` (slučovací konflikt):
+
+```ansi
+␛[36m$␛[0m git merge doplneni-autora
+Auto-merging basnicka.txt
+CONFLICT (content): Merge conflict in basnicka.txt
+Automatic merge failed; fix conflicts and then commit the result.
+```
+
+> [note] A když ne?
+> Jestli se konflikt neobjevil, Git změny sloučil sám.
+> Gratuluji! Zbytek téhle sekce bude jen teoretický; vrať se sem, až se ti
+> někdy „podaří“ konflikt udělat.
+
+Když nastane konflikt, `git status` ukáže „both modified“ – tedy že byl soubor
+změněný v obou slučovaných větvích:
+
+```ansi
+␛[36m$␛[0m git status
+On branch master
+You have unmerged paths.
+  (fix conflicts and run "git commit")
+  (use "git merge --abort" to abort the merge)
+
+Unmerged paths:
+  (use "git add <file>..." to mark resolution)
+	␛[31mboth modified:   basnicka.txt␛[m
+
+no changes added to commit (use "git add" and/or "git commit -a")
+```
 V tom případě se na soubor podívej v editoru: objeví
 se v něm obsah z obou konfliktních verzí,
-společně se značkami, které upozorňují na místo
-kde konflikt nastal.
-Soubor uprav ho tak, jak by měl vypadat, ulož a zadej
-`git commit`.
+společně se značkami `<<<<<<<`, `=======` a `>>>>>>>`, které upozorňují na
+místo kde konflikt nastal.
+
+Značky ukáže i příkaz `git diff`, jehož výstup je teď trošku složitější:
+
+```ansi
+␛[36m$␛[0m git diff
+␛[1mdiff --cc basnicka.txt␛[m
+␛[1mindex bc7a2de,88e7ea5..0000000␛[m
+␛[1m--- a/basnicka.txt␛[m
+␛[1m+++ b/basnicka.txt␛[m
+␛[36m@@@ -1,4 -1,4 +1,8 @@@␛[m
+␛[32m++<<<<<<< HEAD␛[m
+␛[32m +Holka Modrooká␛[m
+␛[32m++=======␛[m
+␛[32m+ (Lidová)␛[m
+␛[32m++>>>>>>> doplneni-autora␛[m
+  ␛[m
+  Holka modrooká␛[m
+  Nesedávej u potoka␛[m
+```
+
+Konflikty a značky, které můžou být nepřehledné, ukazuje Git ze stejného důvodu
+jako Python chybové hlášky: tedy aby ti co nejvíce pomohl.
+Git je jen „hloupý“ nástroj a s konfliktem si neporadí sám, ale snaží se
+ti řešení konfliktu co nejvíc usnadnit.
+
+Proto hlavně nepanikař!
+Soubor otevři v editoru a uprav **tak, jak by měl vypadat**.
+Značky jako `<<<<<<<` smaž; řádky poskládej tak, jak by měly jít za sebou.
+(A pracuješ-li na kódu, spusť testy a ověř, jestli všechno stále funguje.)
+
+Pak soubor ulož a zadej `git commit`.
 
 Ať nastal konflikt nebo ne, vytvoří se „slučovací revize“
 (angl. *merge commit*), které – jako každé revizi – můžeš dát popisek.
+Tentokrát je popisek už předvyplněný; chceš-li nějaký jiný, nahraď ho.
 
 ```ansi
-␛[36m$␛[0m git merge doplneni-autora
-Auto-merging basnicka.txt
-Merge made by the 'recursive' strategy.
- basnicka.txt | 2 ␛[32m++␛[m
- 1 file changed, 2 insertions(+)
+␛[36m$␛[0m git add basnicka.txt
+␛[36m$␛[0m git commit
+[master 884b30a] Merge branch 'doplneni-autora'
 ```
 
 Povedlo se?
@@ -181,9 +240,9 @@ změny jsou v `master` a nemá na nich cenu
 pracovat dál.
 
 ```ansi
-␛[36m$␛[0m git branch -d doplneni-autora
+␛[36m$␛[0m git branch --delete doplneni-autora
 Deleted branch doplneni-autora (was f1cd9be).
-␛[36m$␛[0m git branch -d doplneni-jmena
+␛[36m$␛[0m git branch --delete doplneni-jmena
 Deleted branch doplneni-jmena (was 5c9bf93).
 ␛[36m$␛[0m git branch
 * ␛[32mmaster␛[m