DIFFUSE(1) | Příručka programu diffuse | DIFFUSE(1) |
NÁZEV
diffuse - grafický nástroj pro slučování a porovnávání textových souborů
POUŽITÍ
diffuse [-h | -? | --help | -v | --version]
diffuse [--no-rcfile | --rcfile file] [[option...] | [file...]...]
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 a Subversion.
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:
$ diffuse -m
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:
$ diffuse 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:
$ diffuse -r 123 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:
$ diffuse -r 123 -r 321 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:
$ diffuse -r MERGE_HEAD foo.C foo.C -r HEAD 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:
$ diffuse -c 1.2.3 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:
$ diffuse -r HEAD^1 -r HEAD^2 -r HEAD^3 -r HEAD^4 -r HEAD^5 foo.C
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
Pro definici přiřazení klávesových zkratek pro položky nabídky použijte pro parametr kontext hodnotu menu. Platné hodnoty parametru akce jsou:
open_file
Výchozí: Ctrl+o
open_file_in_new_tab
Výchozí: Ctrl+t
open_modified_files
Výchozí: Shift+Ctrl+O
open_commit
Výchozí: Shift+Ctrl+T
reload_file
Výchozí: Shift+Ctrl+R
save_file
Výchozí: Ctrl+s
save_file_as
Výchozí: Shift+Ctrl+A
save_all
Výchozí: Shift+Ctrl+S
new_2_way_file_merge
Výchozí: Ctrl+2
new_3_way_file_merge
Výchozí: Ctrl+3
new_n_way_file_merge
Výchozí: Ctrl+4
close_tab
Výchozí: Ctrl+w
undo_close_tab
Výchozí: Shift+Ctrl+w
quit
Výchozí: Ctrl+q
undo
Výchozí: Ctrl+z
redo
Výchozí: Shift+Ctrl+Z
cut
Výchozí: Ctrl+x
copy
Výchozí: Ctrl+c
paste
Výchozí: Ctrl+v
select_all
Výchozí: Ctrl+a
clear_edits
Výchozí: Ctrl+r
dismiss_all_edits
Výchozí: Ctrl+d
find
Výchozí: Ctrl+f
find_next
Výchozí: Ctrl+g
find_previous
Výchozí: Shift+Ctrl+G
go_to_line
Výchozí: Shift+Ctrl+L
preferences
Výchozí: None
no_syntax_highlighting
Výchozí: None
syntax_highlighting_syntaxe
Výchozí: None
realign_all
Výchozí: Ctrl+l
isolate
Výchozí: Ctrl+i
first_difference
Výchozí: Shift+Ctrl+Up
previous_difference
Výchozí: Ctrl+Up
next_difference
Výchozí: Ctrl+Down
last_difference
Výchozí: Shift+Ctrl+Down
first_tab
Výchozí: Shift+Ctrl+Page_Up
previous_tab
Výchozí: Ctrl+Page_Up
next_tab
Výchozí: Ctrl+Page_Down
last_tab
Výchozí: Shift+Ctrl+Page_Down
shift_pane_right
Výchozí: Shift+Ctrl+parenleft
shift_pane_left
Výchozí: Shift+Ctrl+parenright
convert_to_upper_case
Výchozí: Ctrl+u
convert_to_lower_case
Výchozí: Shift+Ctrl+U
sort_lines_in_ascending_order
Výchozí: Ctrl+y
sort_lines_in_descending_order
Výchozí: Shift+Ctrl+Y
remove_trailing_white_space
Výchozí: Ctrl+k
convert_tabs_to_spaces
Výchozí: Ctrl+b
convert_leading_spaces_to_tabs
Výchozí: Shift+Ctrl+B
increase_indenting
Výchozí: Shift+Ctrl+>
decrease_indenting
Výchozí: Shift+Ctrl+<
convert_to_dos
Výchozí: Shift+Ctrl+E
convert_to_mac
Výchozí: Shift+Ctrl+C
convert_to_unix
Výchozí: Ctrl+e
copy_selection_right
Výchozí: Shift+Ctrl+Right
copy_selection_left
Výchozí: Shift+Ctrl+Left
copy_left_into_selection
Výchozí: Ctrl+Right
copy_right_into_selection
Výchozí: Ctrl+Left
merge_from_left_then_right
Výchozí: Ctrl+m
merge_from_right_then_left
Výchozí: Shift+Ctrl+M
help_contents
Výchozí: F1
about
Výchozí: None
Přiřazení klávesových
zkratek pro řádkový režim úprav
Pro přiřazení klávesových zkratek pro řádkový režim úprav použijte pro parametr kontext hodnotu line_mode. Platné hodnoty parametru akce jsou:
enter_align_mode
Výchozí: space
enter_character_mode
Výchozí: Return, KP_Enter
first_line
Výchozí: Home, g
extend_first_line
Výchozí: Shift+Home
last_line
Výchozí: End, Shift+G
extend_last_line
Výchozí: Shift+End
up
Výchozí: Up, k
extend_up
Výchozí: Shift+Up, Shift+K
down
Výchozí: Down, j
extend_down
Výchozí: Shift+Down, Shift+J
left
Výchozí: Left, h
extend_left
Výchozí: Shift+Left
right
Výchozí: Right, l
extend_right
Výchozí: Shift+Right
page_up
Výchozí: Page_Up, Ctrl+u
extend_page_up
Výchozí: Shift+Page_Up, Shift+Ctrl+u
page_down
Výchozí: Page_Down, Ctrl+d
extend_page_down
Výchozí: Shift+Page_Down, Shift+Ctrl+d
delete_text
Výchozí: BackSpace, Delete, x
first_difference
Výchozí: Ctrl+Home, Shift+P
previous_difference
Výchozí: p
next_difference
Výchozí: n
last_difference
Výchozí: Ctrl+End, Shift+N
clear_edits
Výchozí: r
copy_selection_left
Výchozí: None
copy_selection_right
Výchozí: None
copy_left_into_selection
Výchozí: Shift+L
copy_right_into_selection
Výchozí: Shift+H
merge_from_left_then_right
Výchozí: m
merge_from_right_then_left
Výchozí: Shift+M
isolate
Výchozí: i
Přiřazení klávesových
zkratek pro režim úprav zarovnání
Pro přiřazení klávesových zkratek pro režim úprav zarovnání použijte pro parametr kontext hodnotu align_mode. Platné hodnoty parametru akce jsou:
enter_line_mode
Výchozí: Escape
enter_character_mode
Výchozí: Return, KP_Enter
first_line
Výchozí: g
last_line
Výchozí: Shift+G
up
Výchozí: Up, k
down
Výchozí: Down, j
left
Výchozí: Left, h
right
Výchozí: Right, l
page_up
Výchozí: Page_Up, Ctrl+u
page_down
Výchozí: Page_Down, Ctrl+d
align
Výchozí: space
Přiřazení klávesových
zkratek pro znakový režim úprav
Pro přiřazení klávesových zkratek pro znakový režim úprav použijte pro parametr kontext hodnotu character_mode. Platné hodnoty parametru akce jsou:
enter_line_mode
Výchozí: Escape
Řetězce
string název hodnota
Používané řetězce
Diffuse používá následující řetězce:
difference_colours
Výchozí: difference_1 difference_2 difference_3
Barvy
[ colour | color ] název červená zelená modrá
Používané barvy
Diffuse používá následující barvy:
alignment
Výchozí: 1 1 0
character_selection
Výchozí: 0.7 0.7 1
cursor
Výchozí: 0 0 0
difference_1
Výchozí: 1 0.625 0.625
difference_2
Výchozí: 0.85 0.625 0.775
difference_3
Výchozí: 0.85 0.775 0.625
edited
Výchozí: 0.5 1 0.5
hatch
Výchozí: 0.8 0.8 0.8
line_number
Výchozí: 0 0 0
line_number_background
Výchozí: 0.75 0.75 0.75
line_selection
Výchozí: 0.7 0.7 1
map_background
Výchozí: 0.6 0.6 0.6
margin
Výchozí: 0.8 0.8 0.8
preedit
Výchozí: 0 0 0
text
Výchozí: 0 0 0
text_background
Výchozí: 1 1 1
Hodnoty s plovoucí desetinnou čárkou
float název hodnota
Používané hodnoty s plovoucí
desetinnou čárkou
Diffuse používá následující hodnoty s plovoucí desetinnou čárkou:
alignment_opacity
Výchozí: 1
character_difference_opacity
Výchozí: 0.4
character_selection_opacity
Výchozí: 0.4
edited_opacity
Výchozí: 0.4
line_difference_opacity
Výchozí: 0.3
line_selection_opacity
Výchozí: 0.4
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í.
2014-07-18 | diffuse 0.4.8 |