Handbok KDiff3
KDiff3 är ett verktyg för jämförelser och sammanfogning av filer och kataloger, som
jämför och sammanfogar två eller tre indatafiler med text eller kataloger,
visar skillnaden rad-för-rad och tecken-för-tecken(!),
tillhandahåller en automatisk sammanfogningsfunktion,
har en editor för bekväm upplösning av sammanfogningskonflikter,
erbjuder nätverkstransparens via KIO,
har alternativ för att färglägga eller dölja ändringar av blanktecken och kommentarer,
stöder Unicode, UTF-8 och andra filkodningar,
skriver ut skillnader,
stöder versionshanteringsnyckelord och historiksammanfogning.
Det här dokumentet beskriver Kdiff3 version 0.9.98.

Inledning

Ännu ett jämförelsegränssnitt?
Det finns flera grafiska jämförelseverktyg. Varför ska du välja Kdiff3? Låt mig tala om varför jag skrev det.
Kdiff3 påbörjades därför att jag var tvungen att göra en svår sammanfogning. Att sammanfoga är nödvändigt när flera personer arbetar med samma fil i ett projekt. En sammanfogning kan vara delvis automatiserad, när sammanfogningsverktyget inte bara har tillgång till de nya ändrade filerna (som kallas grenar), utan också originalfilen (som kallas bas). Sammanfogningsverktyget väljer automatiskt en ändring som bara gjorts i en gren. När flera bidragsgivare ändrar samma rader, detekterar sammanfogningsverktyget en konflikt som måste lösas manuellt.
Sammanfogningen var svår eftersom en bidragsgivare hade ändrat mycket och rättat indenteringen på många ställen. Den andra bidragsgivaren hade också ändrat mycket text i samma fil, vilket orsakade flera konflikter vid sammanfogningen.
Verktyget som jag då använde visade bara ändrade rader, men inte vad som hade ändrats inom raden. Det fanns inte heller någon information om var bara indenteringen hade ändrats. Sammanfogningen var en mindre mardröm.
Det var alltså början. Den första versionen kunde visa skillnader på en rad, och visade skillnader i blanktecken. Senare tillkom många funktioner för att öka användbarheten.
Om du till exempel snabbt vill jämföra en text, kan du kopiera den till klippbordet och klistra in i endera jämförelsefönstret.
En funktion som krävde en stor ansträngning var funktionen för katalogjämförelse och sammanfogning, som gjorde programmet till en nästan fullständig filbläddrare.
Jag hoppas att Kdiff3 fungerar för dig, också. Ha det så kul!
Joachim Eibl (2003)

Skärmbilder och funktioner
Den här skärmbilden visar skillnaden mellan två textfiler
(Med en tidig version av Kdiff3):
Trevägs sammanfogning stöds fullständigt. Den är användbar om två personer ändrar kod oberoende av varandra. Originalfilen (basen) används för att hjälpa Kdiff3 att automatiskt välja de riktiga ändringarna. Sammanfogningseditorn under jämförelsefönstren låter dig lösa konflikter, medan utdata du kommer att få visas. Skärmbilden visar tre indatafiler som håller på att' sammanfogas:
Kdiff3 hjälper dig också att jämföra och sammanfoga hela kataloger. Den här skärmbilden visar Kdiff3 under en katalogsammanfogning:

Mer funktioner

Rad-för-rad och tecken-för-tecken jämförelsevisning
Genom att använda möjligheterna hos en grafisk färgskärm, visar Kdiff3 exakt vad skillnaderna är. När du måste göra många kodgranskningar, gillar du det här.

Se skillnader i blanktecken med en blick
Mellanslag och tabulatorer som skiljer sig åt syns. När rader bara skiljer sig i mängden blanktecken syns det med en blick i sammanfattningskolumnen till vänster. (Inga mer problem om någon ändrar indenteringen.)

Trevägsjämförelse
Analysera tre filer och se var de skiljer sig åt.
Vänster/mitten/höger fönster kallas A/B/C och har blå/grön/magenta färg.
Om en fil är likadan och en annan annorlunda för en rad, så visar färgerna vilken fil som är annorlunda. Den röda färgen betyder att båda de andra filerna är olika.

Bekväm sammanfogning av två eller tre indatafiler
Kdiff3 kan användas för att sammanfoga två eller tre indatafiler och sammanfogar automatiskt så mycket som möjligt. Resultatet visas i ett redigerbart fönster där de flesta konflikter kan lösas med ett enda musklick. Välj knapparna A/B/C i verktygsraden för att välja källan som ska användas. Du kan också välja mer än en källa. Eftersom utmatningsfönstret är en editor, kan till och med konflikter som behöver ytterligare korrigering lösas här utan att kräva ett annat verktyg.

Och ...
Snabb navigering via knappar.
Ett musklick i sammanfattningskolumnen synkroniserar alla fönster så att samma position visas.
Markera och kopiera från vilket fönster som helst, och klistra in i resultatfönstret för sammanfogning.
Översiktskolumn som visar var ändringar och konflikter finns.
Färgerna kan justeras enligt dina specifika önskemål.
Justerbar flikstorlek.
Alternativ för att infoga mellanslag istället för tabulatortecken.
Öppna filer bekvämt via dialogrutor, eller ange filnamn på kommandoraden.
Sök efter strängar i alla textfönster. Sök (Ctrl+F) och Sök igen (F3)
Visa radnummer för varje rad.
Klistra in klippbordet eller dra text till ett indatafönster för jämförelse
Nätverkstransparens via KIO.
Kan användas för jämförelsevisning i KDevelop 3.
Radbrytning för långa rader.
Stöd för Unicode, UTF-8 och andra kodningar.
Stöd för språk som läses från höger till vänster.
...