NÁZEV¶

diffuse - grafický nástroj pro slučování a porovnávání textových souborů

POUŽITͶ

POPIS¶

Diffuse je grafický nástroj pro slučování a porovnávání textových souborů. Diffuse dokáže porovnat libovolný počet souborů a nabízí uživatelům možnost ručně upravit zarovnání řádků a přímo upravovat porovnávané soubory. Diffuse také umí načíst k porovnání a slučování revize souborů přímo z repozitářů Bazaar, CVS, Darcs, Git, Mercurial, Monotone, RCS, Subversion a SVK.

MOŽNOSTI¶

Možnosti nápovědy¶

Parametr pro zobrazení nápovědy musí být zadán jako jediný parametr příkazové řádky. Diffuse bude po zobrazení nápovědy okamžitě ukončeno. -h, -?, --help -v, --version

Možnosti nastavení¶

Parametr pro specifikaci nastavení musí být zadán jako první parametr příkazové řádky. --no-rcfile --rcfile soubor

Obecné možnosti¶

-c, --commit rev -D, --close-if-same -e, --encoding kodek -L, --label název -m, --modified -r, --revision rev -s, --separate -t, --tab --line řádek --null-file

Možnosti zobrazení¶

Parametry zobrazení zadané v příkazové řádce budou mít přednost před uloženým nastavením. -b, --ignore-space-change -B, --ignore-blank-lines -E, --ignore-end-of-line -i, --ignore-case -w, --ignore-all-space

POROVNáVáNí SOUBORů¶

Pro vytvoření dalších panelů pro porovnání souborů použijte položky nabídky Soubor → Nové 2směrné slučování, Soubor → Nové 3směrné slučování nebo Soubor → Nové Nsměrné slučování. Názvy souborů a čísla revizí mohou být zadány pomocí příkazové řádky pro spuštění Diffuse, nebo pomocí polí v dialogu Otevřít soubor. Diffuse zobrazí soubory vedle sebe a vložením mezer zarovná podobné řádky v jednotlivých souborech. Rozdíly jsou zvýrazněny pomocí odlišné barvy pozadí.

Přehled porovnání¶

Přehled rozdílů v porovnaných souborech je umístěn na pravém okraji. V přehledu jsou vyznačena místa, kde byly vloženy mezery pro zarovnání shodných řádků a rozdíly jsou zvýrazněny pomocí barevných pruhů. Ruční úpravy jsou zvýrazněny zelenou barvou. Aktuálně zobrazený úsek je pak označen modrým kurzorem. Kliknutím do podokna přehledu můžete vybrat úsek, který má být zobrazen.

Výběr¶

Pro výběr textových řádků můžete použít jak myš, tak klávesnici. Samostatný řádek vyberete myší jednoduše tak, že na něj kliknete. Více řádků můžete vybrat kliknutím a tažením kurzoru. Aktuální výběr pak také můžete rozšířit tak, že při kliknutí podržíte klávesu Shift. Pomocí klávesnice vyberete jednotlivé řádky pomocí kláves Page Up/Down nebo pomocí šipek. Aktuální výběr pak rozšíříte podržením klávesy Shift a stisknutím kláves Page Up/Down nebo šipek. Pro přesun výběru mezi jednotlivými soubory můžete použít šipku doleva nebo doprava.

Zarovnání řádků¶

K zarovnání řádků porovnávaných souborů může být použita myš nebo klávesnice. Pro zarovnání řádků pomocí myši vyberte požadovaný řádek v prvním ze souborů pomocí levého tlačítka a v druhém souboru klikněte pravým tlačítkem myši na řádek, který chcete zarovnat s vybraným a z místní nabídky vyberte položku Zarovnat s výběrem. Pro zarovnání řádků pomocí klávesnice nastavte pomocí šipek výběr na požadovaný řádek v prvním ze souborů a aktivujte ho stisknutím mezerníku, poté pomocí šipek vyberte požadovaný řádek ve druhém souboru a stisknutím mezerníku potvrďte zarovnání. Tuto operaci můžete přerušit stisknutím klávesy Escape. Pokud nechcete aby některé řádky byly porovnávány s řádky v ostatních souborech, můžete je z porovnání vyloučit použitím položky Izolovat.

Editace¶

Pro přepnutí do režimu editace stiskněte klávesu Enter nebo dvakrát klikněte myší. Režim editace je indikován změnou kurzoru a zobrazením pozice kurzoru ve stavovém řádku. V režimu editace je možné vybírat text pomocí myši. Pro rozšíření aktuálního výběru je možné použít klávesu Shift, kterou je třeba přidržet a poté určit nový rozsah výběru buď pomocí myši, nebo pomocí klávesnice za použití šipek, nebo některé z kláves Home, End, Page Up nebo Page Down. Jednotlivá slova mohou být vybrána dvojitým kliknutím myší. Celé řádky pak trojitým kliknutím. V režimu editace je také možné text upravovat. Upravené řádky budou zvýrazněny použitím zeleného pozadí. Provedené úpravy můžete vrátit zpět nebo zopakovat použitím položek nabídky Zpět a Znovu. Režim editace opustíte pomocí klávesy Escape nebo kliknutím do podokna jiného souboru.

Slučování¶

Pro přesun mezi nalezenými rozdíly použijte příslušná tlačítka nebo položky nabídky. Diffuse při procházení přesune výběr na následující souvislý blok rozdílů nebo úprav. Pro zkopírování bloků textu do vybraného rozsahu použijte příslušná tlačítka nebo položky nabídky. Provedené úpravy můžete vrátit zpět nebo zopakovat použitím položek nabídky Zpět a Znovu. Pro vrácení všech provedených úprav daného bloku řádků bez ohledu na pořadí jejich provedení je možné použít položku nabídky Smazat úpravy.

SPRáVA VERZí¶

Diffuse podporuje načítání revizí souborů z několika systémů pro správu verzí prostřednictvím jejich rozhraní pro příkazový řádek. Verze Diffuse pro Microsoft Windows umí používat jak Cygwin verze, tak nativní verze podporovaných systémů pro správu verzí. Pokud Diffuse používáte s Cygwin, zajistěte, aby nastavení Diffuse pro Cygwin odpovídala konfiguraci vašeho systému. Pokud je pro daný systém správy verzí k dispozici volba Upravit cesty pro Cygwin, musí být při použití verze pro Cygwin povolena. Chování systémů pro správu verzí závisí na nastavení systémových cest a dalších proměnných. Volba Spustit z příkazové řádky terminálu Bash může být použita pro zjednodušení nastavení prostředí pro systémy kontroly verzí pro Cygwin.

Prohlížení nezapsaných změn¶

Při použití parametru -m budou v Diffuse otevřeny panely s porovnáním pro všechny soubory u kterých systém pro správu verzí nahlásí nezapsané změny. To se hodí pro kontrolu změn před zapsáním, nebo pro řešení konfliktů slučování. Pokud není specifikována žádná cesta, bude použit aktuální pracovní adresář. Například pokud chcete zobrazit všechny nezapsané úpravy, použijte tento příkaz: Pokud je specifikován jen jeden soubor, bude pro porovnání použita výchozí revize tohoto souboru. Například tento příkaz zobrazí 2směrné slučování mezi výchozí revizí souboru foo.C a místní kopií souboru foo.C:

Specifikace revizí¶

Parametr -r může být použit pro explicitní specifikaci určité revize souboru. Může být použit libovolný identifikátor podporovaný daným systémem pro správu verzí. Pokud je uvedena jen jedna revize, bude při porovnání použita místní kopie souboru. Například tento příkaz zobrazí 2směrné slučování mezi revizí 123 souboru foo.C a místní kopií souboru foo.C: Několik revizí souboru může být porovnáno použitím více parametrů -r. Například tento příkaz zobrazí 2směrné slučování mezi revizí 123 souboru foo.C a revizí 321 souboru foo.C: Při porovnání mohou být uvedeny jak místní soubory, tak soubory ze systému správy verzí. Například tento příkaz zobrazí 3směrné slučování mezi revizí MERGE_HEAD souboru foo.C, lokální kopií souboru foo.C a revizí HEAD souboru foo.C: Parametr -c může být použit k jednoduchému určení po sobě jdoucích revizí. Například tento příkaz zobrazí 2směrné slučování mezi revizí 1.2.2 souboru foo.C a revizí 1.2.3 souboru foo.C: Počet podoken která mohou být použita k porovnání souborů není programem Diffuse nijak omezen. Například vstupní soubory pro chobotnicovité sloučení v Git mohou být zobrazeny pomocí následujícího příkazu:

ZDROJE¶

Zdroje mohou být použity k úpravě vzhledu a chování Diffuse, například ke změně barev použitých v uživatelském rozhraní, přizpůsobení klávesových zkratek, přidání nebo změně pravidel zvýraznění syntaxe, nebo změně přiřazení pravidel zvýraznění syntaxe k určitým příponám souborů. Diffuse při spuštění načte příkazy ze systémového inicializačního souboru /etc/diffuserc ( ve Windows %INSTALL_DIR%\diffuserc) a poté z uživatelského inicializačního souboru ~/.config/diffuse/diffuserc (ve Windows %HOME%\.config\diffuse\diffuserc). Toto chování může být změněno pomocí parametrů --no-rcfile a --rcfile. Pro zpracování inicializačních příkazů je použit lexikální analyzátor podobný tomu v Bourne shell . Pro zadávání komentářů a speciálních znaků je možné použít stejné escapování jako v Bourne shell skriptech.

Obecné¶

import soubor

Přiřazení klávesových zkratek¶

keybinding kontext akce kombinace_kláves Přiřazení klávesových zkratek položkám nabídky Přiřazení klávesových zkratek pro řádkový režim úprav Přiřazení klávesových zkratek pro režim úprav zarovnání Přiřazení klávesových zkratek pro znakový režim úprav

Řetězce¶

string název hodnota Používané řetězce

Barvy¶

[ colour | color ] název červená zelená modrá Používané barvy

Hodnoty s plovoucí desetinnou čárkou¶

float název hodnota Používané hodnoty s plovoucí desetinnou čárkou

Zvýraznění syntaxe¶

syntax název [výchozí_stav výchozí_značka] syntax_files název [maska] syntax_magic název [maska [ignorecase]] syntax_pattern název výchozí_stav cílový_stav značka maska [ignorecase]

SOUBORY¶

Diffuse používá následující soubory: /etc/diffuserc /usr/share/diffuse/syntax/*.syntax ~/.config/diffuse/diffuserc ~/.config/diffuse/prefs ~/.local/share/diffuse/state

AUTOR¶

Autorem Diffuse je Derrick Moser <derrick_moser@yahoo.com>. © 2006-2014 Derrick Moser. Všechna práva vyhrazena.

LICENCE¶

Diffuse je svobodný software. Lze ho upravovat a distribuovat za podmínky dodržení pravidel licence GNU General Public License (dále jen GPL), vydané Free Software Foundation. Použít lze verzi 2, nebo (pokud chcete) některou z jejích novějších verzí.