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\&.
.PP
\fB\-h\fR, \fB\-?\fR, \fB\-\-help\fR
.RS4
Zobrazí návod k použití\&.
.RE
.PP
\fB\-v\fR, \fB\-\-version\fR
.RS4
Zobrazí verzi programu a licenční údaje\&.
.RE
.SS"Možnosti nastavení"
.PP
Parametr pro specifikaci nastavení musí být zadán jako první parametr příkazové řádky\&.
.PP
\fB\-\-no\-rcfile\fR
.RS4
Zakáže načítání inicializačních souborů\&.
.RE
.PP
\fB\-\-rcfile \fR\fB\fIsoubor\fR\fR
.RS4
Načte inicializační příkazy ze souboru
\fIsoubor\fR\&.
.RE
.SS"Obecné možnosti"
.PP
\fB\-c\fR, \fB\-\-commit\fR\fIrev\fR
.RS4
Otevře samostatné panely pro porovnání všech souborů ze zadaných cest změněných zápisem revize
\fIrev\fR\&.
.RE
.PP
\fB\-D\fR, \fB\-\-close\-if\-same\fR
.RS4
Zavře panely s identickým obsahem\&.
.RE
.PP
\fB\-e\fR, \fB\-\-encoding\fR\fIkodek\fR
.RS4
Pro čtení a zápis souborů použije
\fIkodek\fR\&.
.RE
.PP
\fB\-L\fR, \fB\-\-label\fR\fInázev\fR
.RS4
Místo názvu souboru zobrazí uvedený
\fInázev\fR\&.
.RE
.PP
\fB\-m\fR, \fB\-\-modified\fR
.RS4
Otevře samostatné panely pro porovnání všech změněných souborů ze zadaných cest\&.
.RE
.PP
\fB\-r\fR, \fB\-\-revision\fR\fIrev\fR
.RS4
Otevře revizi
\fIrev\fR
souboru uvedeného jako následující parametr příkazové řádky\&.
.RE
.PP
\fB\-s\fR, \fB\-\-separate\fR
.RS4
Všechny soubory uvedené v příkazové řádce po tomto parametru otevře v samostatných panelech\&.
.RE
.PP
\fB\-t\fR, \fB\-\-tab\fR
.RS4
Otevře nový panel pro všechny soubory uvedené v příkazové řádce po tomto parametru\&.
.RE
.PP
\fB\-\-line \fR\fB\fIřádek\fR\fR
.RS4
Po spuštění zobrazí a vybere zadaný
\fIřádek\fR\&.
.RE
.PP
\fB\-\-null\-file\fR
.RS4
Vytvoří prázdné podokno pro porovnání souborů\&.
.RE
.SS"Možnosti zobrazení"
.PP
Parametry zobrazení zadané v příkazové řádce budou mít přednost před uloženým nastavením\&.
.PP
\fB\-b\fR, \fB\-\-ignore\-space\-change\fR
.RS4
Bude ignorovat změny, pokud jde o znaky mezer\&.
.RE
.PP
\fB\-B\fR, \fB\-\-ignore\-blank\-lines\fR
.RS4
Bude ignorovat změny, pokud jde o prázdné řádky\&.
.RE
.PP
\fB\-E\fR, \fB\-\-ignore\-end\-of\-line\fR
.RS4
Bude ignorovat změny, pokud jde o znaky konců řádek\&.
.RE
.PP
\fB\-i\fR, \fB\-\-ignore\-case\fR
.RS4
Bude ignorovat změny, pokud jde o změnu velikosti písmen\&.
.RE
.PP
\fB\-w\fR, \fB\-\-ignore\-all\-space\fR
.RS4
Bude ignorovat změny, pokud jde o netisknutelné znaky\&.
.RE
.SH"POROVNáVáNí SOUBORů"
.PP
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\&.
.PP
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í\&.
.SS"Přehled porovnání"
.PP
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\&.
.SS"Výběr"
.PP
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\&.
.SS"Zarovnání řádků"
.PP
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\&.
.PP
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\&.
.SS"Editace"
.PP
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\&.
.PP
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\&.
.PP
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\&.
.PP
Režim editace opustíte pomocí klávesy
Escape
nebo kliknutím do podokna jiného souboru\&.
.SS"Slučování"
.PP
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\&.
.PP
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\&.
.SH"SPRáVA VERZí"
.PP
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\&.
.PP
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\&.
.SS"Prohlížení nezapsaných změn"
.PP
Při použití parametru
\fB\-m\fR
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:
.PP
.ifn\{\
.RS4
.\}
.nf
$ \fBdiffuse \-m\fR
.fi
.ifn\{\
.RE
.\}
.PP
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:
.PP
.ifn\{\
.RS4
.\}
.nf
$ \fBdiffuse foo\&.C\fR
.fi
.ifn\{\
.RE
.\}
.sp
.SS"Specifikace revizí"
.PP
Parametr
\fB\-r\fR
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:
.PP
.ifn\{\
.RS4
.\}
.nf
$ \fBdiffuse \-r 123 foo\&.C\fR
.fi
.ifn\{\
.RE
.\}
.PP
Několik revizí souboru může být porovnáno použitím více parametrů
\fB\-r\fR\&. Například tento příkaz zobrazí 2směrné slučování mezi revizí 123 souboru
foo\&.C
a revizí 321 souboru
foo\&.C:
.PP
.ifn\{\
.RS4
.\}
.nf
$ \fBdiffuse \-r 123 \-r 321 foo\&.C\fR
.fi
.ifn\{\
.RE
.\}
.PP
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:
.PP
.ifn\{\
.RS4
.\}
.nf
$ \fBdiffuse \-r MERGE_HEAD foo\&.C foo\&.C \-r HEAD foo\&.C\fR
.fi
.ifn\{\
.RE
.\}
.PP
Parametr
\fB\-c\fR
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:
.PP
.ifn\{\
.RS4
.\}
.nf
$ \fBdiffuse \-c 1\&.2\&.3 foo\&.C\fR
.fi
.ifn\{\
.RE
.\}
.PP
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 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ů\&.
.PP
Diffuse
při spuštění načte příkazy ze systémového inicializačního souboru
/etc/diffuserc
( ve Windows
%INSTALL_DIR%\ediffuserc) a poté z uživatelského inicializačního souboru
~/\&.config/diffuse/diffuserc
(ve Windows
%HOME%\e\&.config\ediffuse\ediffuserc)\&. Toto chování může být změněno pomocí parametrů
\fB\-\-no\-rcfile\fR
a
\fB\-\-rcfile\fR\&. 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\&.
.SS"Obecné"
.PP
\fBimport \fR\fB\fIsoubor\fR\fR
.RS4
Zpracuje inicializační příkazy ze souboru
\fIsoubor\fR\&. Inicializační soubory budou zpracovány pouze jednou\&.
\fInázev\fR\&. Zvýrazňování syntaxe používá jednoduchý stavový stroj u kterého přepínání mezi jednotlivými stavy závisí na nalezení určitých řetězců\&. Výchozím stavem stavového stroje bude
\fIvýchozí_stav\fR\&. Všechny znaky, které neodpovídají nějaké masce budou pro zvýraznění označeny značkou
Přidá masku do dříve definovaného stylu syntaxe\&. Masky jsou postupně testovány v pořadí v jakém byly definovány, dokud není nalezena první shoda\&. Porovnávány jsou vždy jen masky u nichž parametr
\fIvýchozí_stav\fR
odpovídá právě aktivnímu stavu stavového stroje\&. Pokud je nalezen řetězec odpovídající masce parametru
\fImaska\fR, stavový stroj se přepne do stavu definovaného v parametru
\fIcílový_stav\fR\&. Pokud je uveden parametr
\fBignorecase\fR, bude při porovnávání masky ignorována velikost písmen\&. Všechny znaky, které odpovídají určené masce budou pro zvýraznění označeny značkou
\fIznačka\fR\&.
.RE
.SH"SOUBORY"
.PP
Diffuse
používá následující soubory:
.PP
/etc/diffuserc
.RS4
sdílené předvolby (ve Windows
%INSTALL_DIR%\ediffuserc)
.RE
.PP
/usr/share/diffuse/syntax/*\&.syntax
.RS4
soubory s pravidly pro zvýraznění syntaxe různých jazyků (ve Windows
%INSTALL_DIR%\esyntax\e*\&.syntax)
.RE
.PP
~/\&.config/diffuse/diffuserc
.RS4
uživatelské předvolby (ve Windows
%HOME%\e\&.config\ediffuse\ediffuserc)
.RE
.PP
~/\&.config/diffuse/prefs
.RS4
uložená nastavení (ve Windows
%HOME%\e\&.config\ediffuse\eprefs)
.RE
.PP
~/\&.local/share/diffuse/state
.RS4
data přenášená mezi relacemi (ve Windows
%HOME%\e\&.local\eshare\ediffuse\estate)
.RE
.SH"AUTOR"
.PP
Autorem
Diffuse
je Derrick Moser
<derrick_moser@yahoo\&.com>\&.
.PP
\(co 2006\-2014 Derrick Moser\&. Všechna práva vyhrazena\&.
.SH"LICENCE"
.PP
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í\&.