KDiff3-håndbogen
KDiff3 er et værktøj til sammenligning og sammenfletning af filer og mapper, som
sammenligner og fletter to eller tre tekst-inddatafiler eller mapper sammen,
viser forskellen linje-for-linje og tegn-for-tegn(!),
sørger for en automatisk sammenfletningsfunktion,
har en editor til behagelig løsning af sammenfletningskonflikter,
tilbyder netværksgennemsigtighed via KIO,
har valgmuligheder til at fremhæve eller skjule ændringer i blanke tegn eller kommentarer,
understøtter Unicode, UTF-8 og andre tegnsæt,
udskriver forskelle,
understøtter versionshåndteringsnøgleord og historiksammenfletning.
Dette dokument beskriver Kdiff3 version 0.9.98.

Indledning

Endnu en sammenligningsgrænseflade?
Der eksisterer flere grafiske sammenligningsværktøjer. Hvorfor skal du vælge KDiff3? Lad mig fortælle dig hvorfor jeg skrev det.
KDiff3 blev påbegyndt fordi jeg var tvunget til at lave en svær sammenfletning. At sammensætte er nødvendigt når flere personer arbejder med samme fil i et projekt. En sammenfletning kan være delvis automatiseret, når sammenfletningsværktøjet ikke kun har adgang til de nye ændrede filer (som kaldes "grene"), men også originalfilen (som kaldes "basis"). Sammenfletningsværktøjet vælger automatisk en ændring som kun er udført i en gren. Når flere bidragydere ændrer samme linjer, detekterer sammenfletningsværktøjet en konflikt som skal løses manuelt.
Sammenfletningen var svær eftersom en bidragyder havde ændret meget og rettet indrykningen mange steder. Den anden bidragydere havde også ændret meget tekst i samme fil, hvilket forårsagede flere konflikter ved sammenfletningen.
Værktøjet som jeg dengang brugte viste kun ændrede linjer, men ikke hvad der var ændret indenfor linjen. Der fandtes heller ikke nogen information om hvor kun indrykningen var ændret. Sammenfletningen var et mindre mareridt.
Det var altså begyndelsen. Den første version kunne vise forskelle på en linje, og viste forskelle i blanke tegn. Senere kom mange andre funktioner til for at øge brugbarheden.
Hvis du for eksempel hurtigt vil sammenligne en tekst, kan du kopiere den til klippebordet og indsætte den i et af sammenligningsvinduerne.
En funktion som krævede en stor anstrengelse var funktionen for mappesammenligning og sammenfletning, som gjorde programmet til en næsten fuldstændig filsøger.
Jeg håber at KDiff3 også virker for dig. Hav det sjovt!
Joachim Eibl (2003)

Skærmaftryk og funktioner
Dette skærmaftryk viser forskellen mellem to tekstfiler
(Med en tidlig version af KDiff3):
Trevejs sammenfletning understøttes fuldstændigt. Dette er nyttigt hvis to personer ændrer kode uafhængig af hinanden. Originalfilen (basen) bruges til at hjælpe Kdiff3 med automatisk at vælge de rigtige ændringer. Sammenfletningseditoren under diff-vinduerne lader dig løse konflikter, mens uddata du vil få vises. Skærmbilledet viser tre inddatafiler som er ved at blive flettet sammen:
KDiff3 hjælper dig også med at sammenligne og sammenflette hele mapper. Dette skærmaftryk viser KDiff3 under en mappesammenfletning:

Flere funktioner

Linje-for-linje og tegn-for-tegn sammenligningsvisning
Ved at bruge mulighederne en grafisk farveskærm har, viser KDiff3 nøjagtigt hvad forskellene er. Når du skal lave mange kodegennemgange, vil du kunne lide dette.

Se forskelle i blanke tegn med et blik
Mellemrum og tabulatorer som er forskellige ses. Når linjer kun er forskellige i mængden af blanke tegn ses det med et blik i sammendragssøjlen til venstre. (Ikke flere problemer hvis nogen ændrer indrykningen.)

Trevejssammenligninger
Analysér tre filer og se hvor de adskiller sig.
Venstre/midt/højre vindue kaldes A/B/C og har blå/grøn/magenta farve.
Hvis en fil er den samme og en anden anderledes for en linje, så viser farverne hvilken fil der er anderledes. Den røde farve betyder at begge de andre filer er forskellige.

Bekvem sammenfletning af to eller tre inddatafiler
KDiff3 kan bruges til at sammenflette to eller tre inddatafiler og sammenfletter automatisk så meget som muligt. Resultatet vises i et redigerbart vindue hvor de fleste konflikter kan løses med et enkelt museklik. Vælg knapperne A/B/C i værktøjslinjen for at vælge kilden som skal bruges. Du kan også vælge mere end en kilde. Eftersom udskriftsvinduet er en editor, kan til og med konflikter som behøver yderligere korrigering løses her uden at kræve et andet værktøj.

Og ...
Hurtig navigering via knapper.
Et museklik i sammendragssøjlen synkroniserer alle vinduer så samme position vises.
Markér og kopiér fra hvilket som helst vindue, og indsæt i resultatvinduet for sammenfletning.
Oversigtssøjle som viser hvor ændringer og konflikter er.
Farverne kan justeres efter dine specifikke ønsker.
Justerbar fanebladsstørrelse.
Valgmulighed for at indsætte mellemrum i stedet for tabulatortegn.
Åbn filer bekvemt via dialoger, eller angiv filnavn på kommandolinjen.
Søg efter strenge i alle tekstvinduer. Find (Ctrl-F) og Find næste (F3).
Vis linjenummer for hver linje.
Indsæt klippebordet eller træk tekst til et inddatavindue for sammenligning
Netværksgennemsigtighed via KIO.
Kan bruges som en forskelsviser i KDevelop 3.
Tekstombrydning af lange linjer.
Støtte for Unicode, UTF-8 og andre kodninger.
Støtte for sprog som læses fra højre til venstre.
...