Update lessons on Git

pyvec#638

Author: encukou

lessons/git/basics/index.md

@@ -56,7 +56,7 @@ pomocí příkazu `git init`:
 
 ```ansi
 ␛[36m$␛[0m git init
-Initialized empty Git repository in ./.git/
+Initialized empty Git repository in .../.git/
 ```
 
 Na první pohled to vypadá, že se nic nestalo.
@@ -74,13 +74,13 @@ vypisuje informace o stavu repozitáře:
 ␛[36m$␛[0m git status
 On branch master
 
-Initial commit
+No commits yet
 
 nothing to commit (create/copy files and use "git add" to track)
 ```
 
 *„On branch master”* říká něco o větvích, k tomu se vrátíme později.
-*„Initial commit”* říká, že zatím nemáš uloženou žádnou revizi.
+*„No commits yet”* říká, že zatím nemáš uloženou žádnou revizi.
 A *„nothing to commit”* říká, že je adresář
 prázdný – nejsou tu žádné soubory k verzování.
 
@@ -101,12 +101,11 @@ Pak zkus znovu `git status`: Git oznámí,
 ␛[36m$␛[0m git status
 On branch master
 
-Initial commit
+No commits yet
 
 Untracked files:
   (use "git add <file>..." to include in what will be committed)
-
-        ␛[31mbasnicka.txt␛[m
+	␛[31mbasnicka.txt␛[m
 
 nothing added to commit but untracked files present (use "git add" to track)
 ```
@@ -125,12 +124,11 @@ a znovu zkontroluj stav repozitáře:
 ␛[36m$␛[0m git status
 On branch master
 
-Initial commit
+No commits yet
 
 Changes to be committed:
   (use "git rm --cached <file>..." to unstage)
-
-        ␛[32mnew file:   basnicka.txt␛[m
+	␛[32mnew file:   basnicka.txt␛[m
 
 ```
 
@@ -141,7 +139,7 @@ Pojď tedy vytvořit revizi:
 
 ```ansi
 ␛[36m$␛[0m git commit
-[master (root-commit) 1a009f4] První revize
+[master (root-commit) eb0fcd9] První revize
  1 file changed, 6 insertions(+)
  create mode 100644 basnicka.txt
 ```
@@ -196,9 +194,9 @@ To ti poví příkaz `git show`:
 
 ```ansi
 ␛[36m$␛[0m git show
-␛[33mcommit 1a009f4267d5a6ab7ece87cb7514f5b803692e39␛[m
+␛[33mcommit eb0fcd9317cbba3d9406ffe2918dfaad667f100f␛[m
 Author: Adéla Novotná <[email protected]>
-Date:   Mon Mar 20 14:51:34 2017 +0100
+Date:   Mon May 18 16:18:40 2020 +0200
 
     První revize
 
@@ -252,9 +250,8 @@ Pak se opět zeptej Gitu na stav repozitáře.
 On branch master
 Changes not staged for commit:
   (use "git add <file>..." to update what will be committed)
-  (use "git checkout -- <file>..." to discard changes in working directory)
-
-        ␛[31mmodified:   basnicka.txt␛[m
+  (use "git restore <file>..." to discard changes in working directory)
+	␛[31mmodified:   basnicka.txt␛[m
 
 no changes added to commit (use "git add" and/or "git commit -a")
 ```
@@ -318,12 +315,10 @@ A pro úplnost se znovu koukni, co říká
 revize.
 
 ```ansi
-␛[36m$␛[0m git status
 On branch master
 Changes to be committed:
-  (use "git reset HEAD <file>..." to unstage)
-
-        ␛[32mmodified:   basnicka.txt␛[m
+  (use "git restore --staged <file>..." to unstage)
+	␛[32mmodified:   basnicka.txt␛[m
 
 ```
 
@@ -346,8 +341,8 @@ Můj popisek bude znít takhle:
 Rozdělení dlouhých řádků
 
 Verše básně se většinou píšou na jednotlivé řádky. Myslím, že
-takhle se to líp čte. (Ale co si budeme povídat, hlavní 
-důvod je ukázat, co dělá git diff.)
+takhle se to líp čte. (Ale, co si budeme povídat, hlavní
+důvod je ukázat co dělá git diff.)
 ```
 
 > [note]
@@ -362,15 +357,15 @@ Pak ji zkontroluj:
 
 ```ansi
 ␛[36m$␛[0m git show
-␛[33mcommit 81cbabb3bd3cd2f3896dd41b20012c44dbd69031␛[m
+␛[33mcommit 1fcd654a331f290616c948d9841fd8d2a34aa6b4␛[m
 Author: Adéla Novotná <[email protected]>
-Date:   Mon Mar 20 14:51:34 2017 +0100
+Date:   Mon May 18 16:18:40 2020 +0200
 
     Rozdělení dlouhých řádků
     
     Verše básně se většinou píšou na jednotlivé řádky. Myslím, že
-    takhle se to líp čte. (Ale co si budeme povídat, hlavní
-    důvod je ukázat, co dělá git diff.)
+    takhle se to líp čte. (Ale, co si budeme povídat, hlavní
+    důvod je ukázat co dělá git diff.)
 
 ␛[1mdiff --git a/basnicka.txt b/basnicka.txt␛[m
 ␛[1mindex 558d133..24e2384 100644␛[m
@@ -409,19 +404,19 @@ První z nich je <code>git log</code>.
 
 ```ansi
 ␛[36m$␛[0m git log
-␛[33mcommit 81cbabb3bd3cd2f3896dd41b20012c44dbd69031␛[m
+␛[33mcommit 1fcd654a331f290616c948d9841fd8d2a34aa6b4␛[m
 Author: Adéla Novotná <[email protected]>
-Date:   Mon Mar 20 14:51:34 2017 +0100
+Date:   Mon May 18 16:18:40 2020 +0200
 
     Rozdělení dlouhých řádků
     
     Verše básně se většinou píšou na jednotlivé řádky. Myslím, že
-    takhle se to líp čte. (Ale co si budeme povídat, hlavní
-    důvod je ukázat, co dělá git diff.)
+    takhle se to líp čte. (Ale, co si budeme povídat, hlavní
+    důvod je ukázat co dělá git diff.)
 
-␛[33mcommit 1a009f4267d5a6ab7ece87cb7514f5b803692e39␛[m
+␛[33mcommit eb0fcd9317cbba3d9406ffe2918dfaad667f100f␛[m
 Author: Adéla Novotná <[email protected]>
-Date:   Mon Mar 20 14:51:34 2017 +0100
+Date:   Mon May 18 16:18:40 2020 +0200
 
     První revize
 ```

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ý
@@ -136,10 +138,10 @@ Příkazu musíš dát jméno větve, kterou chceš sloučit.
 ␛[36m$␛[0m git checkout master
 Switched to branch 'master'
 ␛[36m$␛[0m git merge doplneni-jmena
-Updating e929fb0..c982a81
+Updating 1fcd654..5c9bf93
 Fast-forward
- basnicka.txt | 6 ␛[32m+++++␛[m␛[31m-␛[m
- 1 file changed, 5 insertions(+), 1 deletion(-)
+ basnicka.txt | 3 ␛[32m+++␛[m
+ 1 file changed, 3 insertions(+)
 ```
 
 Sloučeno! Ono „`Fast-forward`” znamená, že
@@ -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,10 +240,10 @@ změny jsou v `master` a nemá na nich cenu
 pracovat dál.
 
 ```ansi
-␛[36m$␛[0m git branch -d doplneni-autora
-Deleted branch doplneni-autora (was 0e213cd).
-␛[36m$␛[0m git branch -d doplneni-jmena
-Deleted branch doplneni-jmena (was c982a81).
+␛[36m$␛[0m git branch --delete doplneni-autora
+Deleted branch doplneni-autora (was f1cd9be).
+␛[36m$␛[0m git branch --delete doplneni-jmena
+Deleted branch doplneni-jmena (was 5c9bf93).
 ␛[36m$␛[0m git branch
 * ␛[32mmaster␛[m
 ```