Pokud vaše pracovní kopie je aktuální a neexistují žádné konflikty, jste připraveni odevzdat změny. Vyberte jakýkoli soubor a/nebo adresáře, které chcete odevzdat, pak TortoiseSVN → Odevzdat....

Obrázek 4.8. Dialogové okno odevzdání

Dialogové okno odevzdání Vám ukáže každý změněný soubor, včetně přidaných, smazaných a bez verze. Pokud si nepřejete, aby změněný soubor byl odevzdán, stačí zrušit zaškrtnutí tohoto souboru. Pokud chcete zařadit soubor bez verze, stačí zaškrtnout tento soubor k přidání do odevzdání.

Pro rychlé zaškrtnutí/odškrtnutí typů souborů, jako všechny soubory s verzí/nezměněné soubory, klikněte na položky odkazů umístěné hned nad seznamem zobrazených položek.

Pro informace o barvení a překryvech položek podle jejich stavu, si prosím prohlédněte „Místní a Vzdálený Stav“.

Položky, které byly překlopeny do jiné cesty úložiště, jsou rovněž uvedeny pomocí značky (s). Mohli jste něco překlopit při práci na větvi a zapomněli jste překlopit zpět do kmene. Toto je Váš varovný signál!

Dvojitým kliknutím na každý modifikovaný soubor v dialogovém oknu odevzdání zahájí externí nástroj rozdílů pro zobrazení změn. Kontextové menu Vám dá více možností, jak je na obrázku znázorněno. Můžete také přetáhnout soubory odtud do jiné aplikace, jako je textový editor nebo IDE.

Můžete označit nebo odznačit výběr položky klepnutím na zaškrtávací políčko vlevo od položky. Pro adresáře můžete využít Shift-vybrat, aby se akce stala rekurzivní.

Sloupce zobrazené v dolní části panelu jsou přizpůsobitelné. Pokud klikněte pravým tlačítkem myši na jakékoli záhlaví sloupce, zobrazí se kontextové menu, umožňující vybrat, které sloupce se mají zobrazit. Můžete také změnit šířku sloupce pomocí tažení rukojeti, která se objeví při pohybu myši nad hranici sloupce. Tyto úpravy jsou zachovány, takže i příště uvidíte stejné položky.

Ve výchozím nastavení, když odevzdáváte změny, všechny zámky, které na souborech držíte, jsou automaticky uvolněny po úspěšném odevzdání. Pokud si chcete tyto zámky ponechat, ujistěte se, že volba Udržet zámky je zaškrtnuta. Výchozí stav tohoto políčka je převzat z možnosti no_unlock v konfiguračním souboru Subversion. Pro více informací jak upravit konfigurační soubor Subversion navštivte „Obecná nastavení“.

Dialogové okno odevzdání podporuje funkce seznamu změn Subversion, které pomáhají seskupit dohromady související soubory. Vice informací o této funkci naleznete v „Seznam Změn“.

Někdy chcete odevzdat pouze části změn, které jste v souboru provedli. Takové situace většinou nastanou, když na něčem pracujete, ale pak je třeba odevzdat důležitou opravu a tato oprava se nachází ve stejném souboru, na kterém pracujete.

Klikněte pravým tlačítkem na soubor a použijte Kontextovou nabídku → Obnovit po odevzdání. Toto vytvoří kopii souboru tak jak je. Pak můžete soubor upravit, např. v textovém editoru a vrátit všechny změny, které nechcete odevzdat. Po uložení těchto změn můžete soubor odevzdat.

Po odevzdání je kopie souboru automaticky obnovena a máte zpět soubor se všemi změnami, které nebyly odevzdány.

Někdy máte soubory v adresářích, které se často mění, ale které nechcete odevzdat. Někdy to znamená chybu v sestavovacím procesu - Proč mají ty soubory verzi? Máte používat šablonové soubory? Ale občas je to nevyhnutelné. Klasický důvodem je, že vaše IDE změní časové razítko v souboru projektu pokaždé, když sestavuje. Soubor projektu musí mít verzí, protože zahrnuje všechny nastavení sestavení, ale nemusí být odevzdán jen proto, že časové razítko se změnilo.

Chcete-li pomoci v nepříjemných případech jako je tento, vyhradili jsme seznam změn s názvem ignore-on-commit. Jakýkoli soubor přidaný do tohoto seznamu bude automaticky odškrtnut v dialogovém oknu odevzdání. Stále můžete pořád odevzdávat změny, ale musíte je v dialogovém oknu odevzdání zvolit ručně.

Ujistěte se, že zadáte zprávu záznamu, která popisuje změny, které odevzdáváte. To vám pomůže zjistit, co se stalo a kdy, pokud později budete procházet zprávy záznamu projektu. Zpráva může být tak dlouhá nebo krátká jak chcete; mnoho projektů má návody, co by mělo být zahrnuto, jaký jazyk používat a někdy dokonce i přísný formát.

Můžete použít jednoduché formátování zprávy záznamu pomocí dohody podobné té používané v rámci e-mailu. Chcete-li použít styl na text, použijte *text* pro tučné, _text_ pro podtržení a ^text^ pro kurzívu.

Obrázek 4.9. Kontrola pravopisu v Dialogovém oknu Odevzdání

TortoiseSVN obsahuje kontrolu pravopisu, které Vám pomůže opravit Vaše zprávy záznamu. Bude upozorňovat na jakékoliv pravopisné chyby. Použijte kontextové menu pro zobrazení navrhovaných oprav. Samozřejmě neví každý technický termín, který Vy znáte, takže pravopisně správná slova se někdy zobrazí jako chyby. Ale nebojte se. Stačí je jen přidat do Vašeho osobního slovníku pomocí kontextového menu.

The log message window also includes a filename and function auto-completion facility. This uses regular expressions to extract class and function names from the (text) files you are committing, as well as the filenames themselves. If a word you are typing matches anything in the list (after you have typed at least 3 characters, or pressed Ctrl+Space), a drop-down appears allowing you to select the full name. The regular expressions supplied with TortoiseSVN are held in the TortoiseSVN installation bin folder. You can also define your own regexes and store them in %APPDATA%\TortoiseSVN\autolist.txt. Of course your private autolist will not be overwritten when you update your installation of TortoiseSVN. If you are unfamiliar with regular expressions, take a look at the introduction at https://en.wikipedia.org/wiki/Regular_expression, and the online documentation and tutorial at http://www.regular-expressions.info/.

Vytvořit správný regulární výraz může být obtížné, proto existuje dialogové okno Test, který Vám může pomoci sestrojit vhodný výraz. Umožňuje totiž zadat výraz a potom zadat názvy souborů k otestování. Spustíte ho z příkazového řádku pomocí příkazu TortoiseProc.exe/command:autotexttest.

Dialogové okno zpráv záznamu má také funkci útržku. Tyto útržky jsou zobrazeny v rozbalovacím seznamu automatického dokončení, jakmile zadáte zkratku útržku, vyberete ho ze seznamu, což pak povede ke vložení celého textu útržku. Útržky dodávané s TortoiseSVN jsou uchovávány ve složce bin v instalaci TortoiseSVN. Můžete si také vytvořit vlastní útržky a uložit je v %APPDATA%\TortoiseSVN\snippet.txt. # je znak komentáře. Nové řádky lze vložit maskováním takto: \n a \r. Pro vložení obráceného lomítka použijte toto maskování: \\.

Můžete znovu použít dříve zadanou zprávu záznamu. Stačí kliknout na Poslední zprávy k zobrazení seznam několika posledních zpráv, které jste zadali pro tuto pracovní kopii. Počet uložených zpráv lze přizpůsobit v dialogovém okně nastavení TortoiseSVN.

Můžete vymazat všechny uložené zprávy odevzdání ze stránky Uložená data v nastavení TortoiseSVN, nebo můžete jednotlivé zprávy vymazat v rámci dialogového okna Poslední zprávy s použitím klávesy Delete.

Pokud chcete zahrnout zkontrolované cesty ve své zprávě záznamu, můžete použít příkaz Kontextové menu → Vložit seznam souborů v kontrole úprav.

Dalším způsobem, jak vložit cesty do zpráv záznamů je jednoduše přetáhnout soubory ze seznamu souborů na kontrolu úprav.

Po stisknutí tlačítka OK se objeví dialogové okno zobrazující průběh odevzdání.

Obrázek 4.10. Dialogové okno průběhu zobrazující probíhající odevzdání

Dialogové okno průběhu používá barevné kódování pro zvýraznění různých činností odevzdání

Toto je výchozí barevné schéma, ale můžete si ho přizpůsobit pomocí dialogového okna nastavení. Přečtěte si „Nastavení Barev TortoiseSVN“ pro více informací.