#pragma section-numbers 2 <> == Větev neboli branch == Termín ''branch'' odpovídá intuitivní představě větve jenom zcela náhodou. Dle definice je branch "''sada všech changesetů, které mají jako atribut stejný název větve''". Atribut názve větve mají všechny changesety. Implicitní hodnotou tohoto atributu je slovo "default". Technicky by šlo zařídit, aby každý changeset nesl jiný název větve. Orientovaný acyklický graf (DAG) takového repozitáře by spíše připomínal šňůru korálků než větvenou strukturu. Vytvoříme-li z orientovaného acyklického grafu strukturu, připomínající "košatý strom", může se přesto z hlediska definice jednat o jedinou větev, budou-li mít všechny jeho changesety stejný atribut názvu větve, například ''default''. Na druhou stranu lze zařídit (jak vyplývá z "korálků") aby se v přímém úseku grafu střídaly různé názvy větve - například def a bis: {{{ 0def -- 1def -- 2bis -- 3bis -- 4def -- wc (working copy) }}} Z definice tedy vyplývá, že všechny "větve" v repozitáři jsou pojmenované. Setkáme-li se s termíny "anonymní" a "pojmenovaná" větev, budeme tomu rozumět tak, že ''anonymní'' je větev, která nese implicitní označení "default" a ''pojmenovaná'' větev je ta, která se jmenuje jinak. == Čelo větve == '''Čelo''' neboli "head" je changeset, který v repozitáři nemá potomka (potomek budiž dítě nebo dítě dítěte). Takovému čelu se také říká ''topologické čelo''. Kromě tohoto čela (větve) je rovněž definováno '''čelo větve''', které se vyznačuje tím, že ve větvi nemá potomka, je to tedy poslední changeset větve. Ve výše uvedeném schematu je "čelem větve" revize č. 3, čelem (topologickým) je revize č. 4. Revize č. 1 není "čelem větve", protože větev "def" končí revizí č. 4. '''Příklady souběžných větví:''' V následujícím schematu vidíme dvě větve (def, bis) a tři čela (3bis, 4def, 7def). Čelo 3bis je čelo větve, čela 4def a 7def jsou čela větví topologická. Revize 1def byla čelem větve do té doby, než se vytvořil changeset 4def. 1) {{{ 0def -- 1def -- 2bis -- 3bis -- 4def -- wc (working copy) \ 5def -- 6def -- 7def }}} V dalším schematu vidíme dvě větve a dvě čela (4bis-větve, 8def-topolog). 2) {{{ 0def -- 1def -- 2bis -- 3bis -- ''4bis'' \ \ 5def -- 6def -- 7def -- 8def -- wc }}} Z pilnosti vyrobím ještě jedno schema se dvěmi větvemi a jedním čelem. Revize 4bis již není čelem větve, protože má ve větvi potomka - 9bis. Je to obdoba revize 1def v první ukázce. 3) {{{ 0def -- 1def -- 2bis -- 3bis -- 4bis \ \ 5def -- 6def -- 7def -- 8def -- 9bis -- wc }}} Záležitost s čely, potažmo větvemi vypadá dost složitě ale nic se nejí tak horké, jak se uvaří. Většinou budeme čela větví spíš likvidovat (sloučením) než iniciativně vytvářet. Nebudou tedy vznikat složité konstelace. Potíž s překladem "branch head" vyplývá z toho, že v češtině je "čelo větve" a. souslovím, označujícím jistý typ čela (branch head) a. podstatné jméno + přívlastek neshodný (head of branch), připomínající, že se nejedná o čelo na naší hlavě. Nepříliš šťastná volba názvů to je i v originále. Mechanizmus zvaný "větev" byl do Mercuriálu vložen dodatečně a postupně se vyvíjí. Tvůrci se přitom snaží dodržet zpětnou kontinuitu nejen v jeho chování ale i v jeho popisech. Apropos '''hlava''' - převod ''head'' na ''čelo'' je možný a v tomto případě mi přijde přiléhavější (čelo průvodu). == Vytvoření nové větve == Nová větev může vzniknout přenesením ze vzdáleného repozitáře příkazem `hg pull`, nebo příkazem `hg branch `, což se může realizovat ve dvou různých situacích, v obou případech uzavřených akcí ''hg commit'': * rodičem pracovní kopie je čelo topologické -- v tom případě dojde ke změně názvu a tudíž k vytvoření nové větve bez odbočování - viz 9bis ad-3. * rodičem pracovní kopie je neposlední changeset -- v tom případě dojde k vytvoření nového čela s novým názvem větve - viz 4bis v následném schematu. {{{ 0def -- 1def -- 2def -- 3def \ 4bis -- 5bis -- wc }}} Odbočující čelo nové větve s ponecháním původního názvu lze také vytvořit komitem změn pracovní kopie, napojené na neposlední changeset. Pracovní kopie předává novému changesetu odbočky název větve svého rodiče - viz 5def ad-3. == Použití příkazů hg == Pro vytvoření schemat ad 1 až 3 v odstavci ''Příklady souběžných větví'' použijeme následnou posloupnost příkazů: {{{ -- 1def -- wc hg head branch bis brrm, brrm -- 1def -- 2bis -- wc hg ci -m "head bis + brrm" }}} {{{ -- 3bis -- wc hg branch def -f # Opětovné použití názvu nutno vynutit opcí -f/--force vrrm, vrrm -- 3bis -- 4def --wc hg ci -m "head def + vrrm" }}} {{{ -- 1def -- 2bis -- hg update -r1 # 1def -- wc \ drrm, drrm 5def -- wc hg ci -m "fork + drrm" Případně by šlo vytvořit odbočku s odlišným názvem větve: \ drrm, drrm 5cis --wc hg branch cis hg ci -m "head cis + drrm" }}} Za změnu pracovní kopie je považována i samotná změna jejích metadat, zde konkretně změna názvu větve a vložení markeru o uzavření čela - viz "Zavřené čelo". '''Další příkazy, související s větvemi:''' {{{ hg head (heads) zobrazí revize, které jsou čely }}} {{{ hg branch zobrazí název větve aktuální revize }}} {{{ hg branches zobrazí názvy větví a jejich ID }}} {{{ hg update přenese pracovní kopii k čelu aktální větve }}} == Zavřené čelo, potažmo větev == Oba typy čel lze takzvaně "zavřít", což se interně realizuje tím, že se do metadat changesetu přidá marker o uzavření čela. Tato událost se zapisuje do repozitáře jako changeset (případně lze do něho uložit i změny pracovní kopie): {{{ hg ci --close-branch -m "zavíráme!" }}} Větev, která má (všechna) čela zavřená, se rovněž považuje za zavřenou. Význam zavřeného čela či větve je ten, že příkazy `hg heads` případně `hg branches` jej neuvedou ve výpisu čel respektive větví. Komu tento výsledek stojí za námahu, používá institut zavřené větve při připojování "vedlejší" větve k větvi "default": {{{ hg up prospekt # aktualizace wc k čelu větve "prospekt" hg ci -m "Zavíráme prospekt" --close-branch hg up default # aktualizace wc k čelu větve "default" hg merge prospekt # připojení zavřeného čela prospektu k čelu default hg ci -m "uzavření prospektu" }}} Zavřenou větev (čelo) lze jednoduše otevřít tak, že k uzavřenému čelu aktualizujeme pracovní kopii (wc) a tam komitujeme nějakou změnu. Úplný výpis čel či větví vrací příkazy {{{ hg heads -c hg branches -c }}} == Transfer větví - pull, push == Název větve (implicitně její čelo) lze použít jako identifikátor u různých příkazů Mercuriálu. Příkaz {{{ hg trans # trans = pull nebo push }}} přenese všechny větve v repozitáři. Chceme-li přenést jenom určitou {větev, bookmark, revizi} použijeme tvar {{{ hg trans -r{větev, bookmark, revize} }}} Při prvním přenosu nové větve do vzdáleného repozitáře nutno použít {{{ hg push -b . --new-branch }}} Při dalším přenosu už stačí jenom (tečka zastupuje aktuální wc) {{{ hg push -b . }}} == Viz také == [[CzechBookmarks|Záložky neboli bookmarks]]