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.

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.)

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.

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 ... i respektive fönster A/B/C 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.

Längst upp i varje textfönster finns dess "informationsrad". Informationsraderna i indatafönstret innehåller bokstaven A, B eller C, filnamnet och radnumret för den första synliga raden i fönstret. (Observera att fönstret "C" är valfritt.) Varje informationsrad visas i en egen färg.

När du väljer en annan fil genom att bläddra eller avslutar redigera filnamnet här genom att trycka på returtangenten, laddas den nya filen och jämförs med filen eller filerna som redan är laddade.

De tre indatafönstren tilldelas bokstäverna A, B och C. A har blå färg, B har grön färg och C har magenta. (Det är förvalda färger, men kan ändras med alternativet Färg i inställningsdialogrutan.)

När en skillnad upptäcks visar färgen vilken indatafil som skiljer sig åt. När båda övriga indatafiler skiljer sig åt, är färgen som används för att uttrycka det normalt röd (Konfliktfärg med alternativet Färg i inställningsdialogrutan). Färgschemat är särskilt användbart i fallet med tre indatafiler, som framgår av nästa avsnitt (Sammanfogning).

Till vänster om varje text är "sammanfattningskolumnen". Om skillnader uppstod på en rad, visar sammanfattningskolumnen motsvarande färg. För en skillnad som bara består av blanktecken är sammanfattningen kryssad. För programspråk, där blanktecken inte är så viktiga är det användbart för att se med en blick om något av vikt ändrades. (För C/C++ är blanktecken bara intressanta inne i strängar, i kommentarer, för preprocessorn och i några mycket esoteriska situationer.)

Den vertikala linjen som skiljer sammanfattningskolumnen och texten är avbruten om indatafilen inte har några rader där. När radbrytning är aktiverad visas den vertikala linjen med punkter för brutna rader.

På höger sida är en "översiktskolumn" synlig till vänster om den vertikala rullningslisten. Den visar en komprimerad sammanfattning av indata A. Alla skillnader och konflikter är synliga med en blick. När bara två indatafönster används, syns alla skillnader i rött här, eftersom alla skillnader också är konflikter. En svart rektangel ramar in den synliga delen av indata. För mycket långa indatafiler, där antalet indatarader är större än höjden på översikten i bildpunkter, delar flera indatarader en översiktsrad. En konflikt har prioritet över enkla skillnader, som har prioritet över inga ändringar, så att inga skillnader eller konflikter går förlorade här. Genom att klicka på översiktskolumnen visas motsvarande text.

Ibland placerar algoritmen fel rader intill varandra, eller så vill du jämföra ett textstycke med text på en helt annan position i den andra filen. I dessa fall kan du manuellt tala om för KDiff3 att vissa rader ska arrangeras i rak linje. Markera texten som du vill arrangera med musen, som du skulle göra vid kopiera och klistra in i det första jämförelsefönstret och välj därefter Jämförelsevy → Lägg till manuell justering av jämförelse (Ctrl+Y). En orange rad visas i sammanfattningskolumnen intill den markerade texten. Upprepa det för den andra och (om tillgänglig) tredje jämförelsevyn. KDiff3 beräknar omedelbart om jämförelsen varje gång du gör det, och radar upp de markerade raderna. Naturligtvis kanske några av raderna som tidigare matchade inte längre matchar.

För närvarande stöder inte sammanfogning användning av manuell hjälp vid jämförelse.

I vissa fall ser KDiff3 för många eller för få avsnitt att sammanfoga. I ett sådant fall kan du foga ihop eller dela befintliga avsnitt.

Lägg till nya avsnitt genom att först markera texten på raderna som hör ihop i något av indatafönstren (som vid kopiering till klippbordet). Välj därefter menyalternativet Sammanfoga → Dela jämförelse vid markering. Delningen görs ovanför den första raden och under den sista raden i den markerade texten. Om du bara vill lägga till ett avsnitt, markera text som börjar på ett annat avsnitts delning.

För att foga ihop avsnitt i något indatafönster, markera någonting på raderna i avsnitten som ska fogas ihop. (Du kan också foga ihop flera avsnitt i ett steg.) Välj därefter menyalternativet Sammanfoga → Foga ihop markerade jämförelser.

Editorfönstret för sammanfogningsutdata har också en sammanfattningskolumn till vänster. Den visar bokstaven för indata som raden valdes, eller ingenting om alla tre källorna var likadana för raden. Vid konflikter visar den ett frågetecken "?" och raden visar "< Konflikter vid sammanfogning >", allt med rött. Eftersom det skulle ta mycket lång tid att lösa konflikter rad för rad, grupperas rader i grupper som har samma skillnader och konfliktkaraktär. Konflikter med bara blanktecken skiljs dock från andra konflikter för att förbättra sammanfogningen av filer där indenteringen ändrats på många rader.

När du klickar på sammanfattningskolumnen med vänster musknapp i endera fönstret, så markeras gruppen som hör till den raden i alla fönster och gruppens början visas. (Det här kan innebära ett automatiskt byte av position i fönstren om gruppens början inte syns.) Gruppen blir då den "aktuella gruppen". Den markeras med alternativetBakgrundsfärgen för aktuellt jämförelseintervall i objektet Integrering och en svart rad visas till vänster om texten.

Knappraden under menyraden innehåller tre knappar för indataval som innehåller bokstäverna A, B och C. Klicka på knappen för indataval för att infoga rader (eller ta bort dem om de redan infogats) från respektive källfil. För att välja rader från flera indatafiler klicka på respektive knappar i nödvändig ordning. Om du till exempel vill att rader från B ska hamna före rader från A i utdata, klicka först på B och därefter på A.

Om du använder knappen Gå automatiskt till nästa olösta konflikt efter val av källa (see Avancera automatiskt), måste du inaktivera det innan du väljer rader från flera indatafiler eller om du vill redigera raderna efter du valt dem. Annars går KDiff3 till nästa konflikt efter den första indatafilen valts.

Det är ofta användbart att direkt redigera sammanfogad utdata. Sammanfattningskolumnen visar "m" för varje rad som ändrades manuellt. När skillnaderna till exempel justeras på ett sätt så att ett enkelt val av indata inte är tillfredsställande, kan du markera texten som behövs och använda normal kopiera och klistra in för att placera den i sammanfogad utdata.

Ibland, när en rad tas bort antingen på grund av automatisk sammanfogning eller genom redigering och inga andra rader finns kvar i gruppen, visas texten <Ingen källrad> på raden. Det är bara en platsmarkör för gruppen om du ändrar dig och väljer en källa igen. Texten syns inte i sparade filer eller i några markeringar som du vill kopiera och klistra in.

Texten "< Konflikter vid sammanfogning >" visas på klippbordet om du kopierar och klistrar in någon text som innehåller en sådan rad. Men var ändå försiktig med att göra det.

Den normala sammanfogningen börjar med att automatiskt lösa enkla konflikter. Menyn Sammanfoga tillhandahåller också några alternativ för andra vanliga behov. Om du måste välja samma källfil för de flesta konflikter, kan du välja A, B eller C överallt, eller bara för återstående olösta konflikter, eller för olösta konflikter med blanktecken. Om du vill bestämma själv för varje enskild skillnad, kan du Ändra skillnader till konflikter, eller om du vill återgå till de automatiska valen i KDiff3 kan du välja Lös automatiskt enkla konflikter. Då startar KDiff3 om sammanfogningen. För åtgärder som påverkar dina tidigare ändringar frågar KDiff3 om bekräftelse innan åtgärden utförs.

Många versionshanteringssystem stöder särskilda nyckelord i filen (t.ex. "$Date$", "$Header$", "$Author$", "$Log$" etc.) Vid arkivering ändrar versionshanteringssystemet (VCN) dessa rader. Till exempel ändras "$Date$" till "$Date: 2005/03/22 18:45:01 $". Eftersom raden är olika i varje version av filen, skulle den kräva manuell interaktion under sammanfogningen.

KDiff3 erbjuder automatisk sammanfogning av dessa poster med alternativet Sammanfoga i inställningsdialogrutan. För enkla rader som matchar alternativet Reguljärt uttryck för automatisk sammanfogning i alla indatafiler väljer KDiff3 raden från B, eller om tillgänglig, den från C. (Dessutom är det nödvändigt att raderna i fråga radas upp i jämförelsen och att föregående rad inte innehåller en konflikt.) Den automatiska sammanfogningen kan antingen utföras omedelbart när sammanfogningen startas (aktivera alternativet Kör automatisk sammanfogning med reguljärt uttryck när sammanfogning startar) eller senare via menyalternativet Sammanfoga → Kör automatisk sammanfogning med reguljärt uttryck.

Automatisk sammanfogning för versionshanteringshistorik (också kallat "logg") stöds också. Automatisk sammanfogning av historik kan antingen utföras omedelbart när sammanfogningen startas genom att aktivera alternativet Sammanfogning enligt versionshanteringshistorik när sammanfogning startar under alternativet Sammanfoga i inställningsdialogrutan eller senare via menyalternativet Sammanfoga → Lös automatiskt historikkonflikter.

Oftast börjar versionshanteringshistoriken med en rad som innehåller nyckelordet "$Log$". Den måste matchas av alternativet Reguljärt uttryck för historikens början:. KDiff3 detekterar vilka efterföljande rader som ingår i historiken genom att analysera de inledande tecknen som fanns före nyckelordet "$Log$". Om samma "inledande kommentar" också finns på följande rader inkluderas de också i historiken.

Vid varje arkivering skriver VCS en unik rad som anger version, datum- och tidsinformation följd av rader med användarens kommentarer. Raderna utgör en historikpost. Historikavsnittet växer vid varje arkivering och de senaste posterna visas längst upp (efter historikens startrad).

När två utvecklare arkiverar grenar av en fil under parallell utveckling, kommer historiken för sammanfogning att innehålla flera poster som visas som konflikter under sammafogning av grenarna. Eftersom sammafogning av dem kan bli mycket tröttsam, erbjuder KDiff3 stöd för den med två möjliga strategier: Bara infoga historikinformationen från båda bidragsgivarna längst upp, eller sortera historikinformationen enligt en användardefinierad nyckel.

Metoden att bara infoga alla poster är enklast att ställa in. KDiff3 behöver bara en metod att detektera vilka rader som hör till en historikpost. De flesta VCS infogar en tom rad efter varje historikpost. Om det inte finns några andra tomma rader, är det ett tillräckligt villkor för KDiff3. Ange bara ett tomt Reguljärt uttryck för historikens början under alternativet Sammanfoga i inställningsdialogrutan. Om kriteriet med en tom rad inte är tillräckligt kan du ange ett reguljärt uttryck för att detektera historikpostens början.

Observera att KDiff3 tar bort duplicerade historikposter.Om en historikpost fanns flera gånger i en indatafils historik, förblir bara en post i utmatningen.

Om du vill sortera historiken måste du ange hur sorteringsnyckeln ska byggas. Använd parenteser som i Reguljärt uttryck för historikpostens början under alternativet Sammanfoga i inställningsdialogrutan för att gruppera delar av det reguljära uttrycket som senare ska användas i sorteringsnyckeln. Ange därefter Sorteringsnycklarnas ordning från historikpostens början med en lista av nummer som refererar till gruppens position i det reguljära uttrycket åtskilda av kommatecken ",".

Eftersom det inte är så enkelt att få det rätt omedelbart, kan du prova och förbättra det reguljära uttrycket och nyckelgenereringen i en särskild dialogruta genom att klicka på knappen Prova dina reguljära uttryck.

Exempel: antag en historik som ser ut så här:

/**************************************************************************
** HISTORIK:    $Log: \toms_sammanfogning_huvudvy\Mitt_program\kod\komplexalgoritm.cpp $
**
**     \head\integreringsgren_12   2 Apr 2001 10:45:41   tom
**  Sammanfogade grenen simongren_15.
**
**     \main\henry_felrättningsgren_7\1   30 Mar 2001 19:22:05   henry
**  Förbättrade hastigheten för delrutinen omvandlaTill().
**  Fixade krasch.
**************************************************************************/

Historikens inledande rad matchar det reguljära uttrycket ".*\$Log.*\$.*". Därefter följer historikposterna.

Raden med nyckelordet "$Log$" börjar med två "*" och därefter följer ett mellanslag. KDiff3 använder den första strängen utan blanktecken som "inledande kommentar" och antar att historiken slutar med den första raden utan denna inledande kommentar. I exemplet slutar den sista raden med en sträng som också börjar med två "*", men istället för ett mellanslag följer fler "*". Därför avslutar denna rad historiken.

Om sortering av historiken inte krävs kan det reguljära uttrycket för historikpostens början se ut så här. (Raden är delad i två eftersom den inte skulle få plats annars.)

\s*\\main\\\S+\s+[0-9]+ (Jan|Feb|Mar|Apr|Maj|Jun|Jul|Aug|Sep|Okt|Nov|Dec)
 [0-9][0-9][0-9][0-9] [0-9][0-9]:[0-9][0-9]:[0-9][0-9]\s+.*

Om sortering av historiken inte krävs kan det reguljära uttrycket för historikpostens början se ut så här. (Raden är delad i två eftersom den inte skulle få plats annars.)

\s*\\main\\\S+\s+[0-9]+ (Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec)
 [0-9][0-9][0-9][0-9] [0-9][0-9]:[0-9][0-9]:[0-9][0-9]\s+.*

För detaljinformation om reguljära uttryck se Trolltechs dokumentation av reguljära uttryck. Observera att "\s" (med ett litet "s") matchar alla blanktecken och "\S" (med ett stort "S") matchar alla tecken som inte är blanktecken. I vårt exempel innehåller historikpostens början först versionsinformation med det reguljära uttrycket "\\main\\\S+", datumet som består av dagen "[0-9]+", månaden "(Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec)" och året "[0-9][0-9][0-9][0-9]", tiden "[0-9][0-9]:[0-9][0-9]:[0-9][0-9]" och till sist utvecklarens inloggningsnamn ".*".

Observera att de "inledande kommentartecknen" (i exemplet "**") redan har tagits bort av KDiff3 innan försöket att matcha, alltså börjar det reguljära uttrycket med att matcha ett eller flera blanktecken "\s*". Eftersom kommentartecken kan skilja sig åt i varje fil (C/C++ använder t.ex. andra kommentartecken än ett Perl-skript), tar KDiff3 hand om de inledande kommentartecknen och du ska inte ange dem i det reguljära uttrycket.

Om du kräver sorterad historik måste sorteringsnyckeln beräknas. För att göra det måste relevanta delar i det reguljära uttrycket grupperas med parenteser. (De extra parenteserna kan också vara kvar även om historiksortering inaktiveras.)

\s*\\main\\(\S+)\s+([0-9]+) (Jan|Feb|Mar|Apr|Maj|Jun|Jul|Aug|Sep|Okt|Nov|Dec)
 ([0-9][0-9][0-9][0-9]) ([0-9][0-9]:[0-9][0-9]:[0-9][0-9])\s+(.*)

Om du kräver sorterad historik måste sorteringsnyckeln beräknas. För att göra det måste relevanta delar i det reguljära uttrycket grupperas med parenteser. (De extra parenteserna kan också vara kvar även om historiksortering inaktiveras.)

\s*\\main\\(\S+)\s+([0-9]+) (Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec)
 ([0-9][0-9][0-9][0-9]) ([0-9][0-9]:[0-9][0-9]:[0-9][0-9])\s+(.*)

Parenteserna innehåller nu 1. versionsinformation, 2. dag, 3. månad, 4. år, 5. tid, 6. namn. Men om vi vill sortera enligt datum och tid måste vi skapa en nyckel med elementen synliga i en annan ordning: Först året, följt av månad, dag, tid, versionsinformation och namn. Därför ska sorteringsnyckelns ordning som anges vara "4,3,2,5,1,6".

Eftersom månadsnamn inte är bra att sortera enligt ("Apr" skulle vara först) detekterar KDiff3 vilken ordning månadsnamnen anges och använder det numret istället ("Apr" -> "04"). Och om ett rent nummer hittas omvandlas det till ett fyrasiffrors värde med inledande nollor för sortering. Till sist blir den resulterande sorteringsnyckeln för den första historikpostens inledande rad:

2001 04 0002 10:45:41 integreringsgren_12   tom

För mer information, se också avsnittet Inställningar av sammanfoga.

Det finns också en knapp som heter Gå automatiskt till nästa olösta konflikt efter val av källa (automatisk fortsättning). Om du aktiverar det här, så går KDiff3 automatiskt till nästa olösta konflikt när en källa väljes. Det kan hjälpa till när du bara vill välja en källa. När du behöver båda källor, eller du vill redigera efter valet, bör du troligen stänga av det här. Innan KDiff3 fortsätter till nästa olösta konflikt, visas effekten av valet en kort tid. Den här fördröjningen kan justeras i inställningarna under Jämför och sammanfoga. Du kan ange "Fördröjning vid automatisk fortsättning" i millisekunder mellan 0 och 2000. Tips: Är du trött på många klick? Använd en kort fördröjning vid automatisk fortsättning och snabbtangenterna Ctrl+1/2/3 för att välja A/B/C för många konflikter.

Välj ett teckensnitt med fast breddsteg. (På vissa system visar dialogrutan också teckensnitt med variabel bredd, men du bör inte använda dem.)

Att ändra färgerna för katalogjämförelser får inte någon effekt förrän nästa katalogjämförelse startas.

För system med bara 16 eller 256 färger är vissa rena färger inte tillgängliga. För sådana system väljer knappen Förval en ren färg.

När filer jämförs försöker KDiff3 först att matcha rader som är lika i alla indatafiler. Det är bara under detta steg som blanktecken kan ignoreras. Det andra steget jämför varje rad. Under detta steg ignoreras inte blanktecken. Under sammanfogning ignoreras inte heller blanktecken.

De här alternativen har att göra med avsökning av katalogen och hantering av sammanfogningen: Se Katalogjämförelse och sammanfogning för detaljinformation.

Ändå finns det ett alternativ här som också är relevant för att spara enstaka filer:

(Dessa alternativ och åtgärder är tillgängliga i menyerna eller verktygsraden.)

För närvarande stöder bara ramverksversionen anpassningsbara snabbtangenter (Menyn Inställningar → Anpassa genvägar...).

Det här avsnittet introducerar bara några mycket grundläggande funktioner i sed. För mer information se info:/sed eller https://www.gnu.org/software/sed/manual/html_mono/sed.html. En förkompilerad version för Windows® finns på http://unxutils.sourceforge.net. Observera att följande exempel antar att sed finns i någon katalog i miljövariabeln PATH. Om det inte är fallet, måste du ange fullständig absolut sökväg till kommandot.

I det här sammanhanget används bara ersättningskommandot sed:

sed 's/REGUTTRYCK/ERSÄTTNING/FLAGGOR'

Innan du använder ett nytt kommando inne i KDiff3, bör du först prova det i en terminal. Då är kommandot echo användbart. Till exempel:

echo abrakadabra | sed 's/a/o/'
   -> obrakadabra

Exemplet visar ett mycket enkelt sed-kommando som ersätter den första förekomsten av "a" med "o". Om du vill ersätta alla förekomster behöver du flaggan "g":

echo abrakadabra | sed 's/a/o/g'
   -> obrokodobro

Symbolen "|" är rörledningskommandot som överför utdata från föregående kommando till indata i efterföljande kommando. Om du vill prova med en längre fil kan du använda cat på UNIX®-liknande system eller type på Windows®-liknande system. sed utför ersättningen för varje rad.

cat filnamn |sed väljare

Data skickas igenom all intern och extern förbehandling i följande ordning:

Data efter den normala förbehandlingen bevaras för att visas och sammanfogas. De andra åtgärderna ändrar bara data som algoritmen för radmatchande jämförelse ser.

I de sällsynta fall då du använder normal förbehandling, observera att den radmatchande förbehandlingen ser utdata från den normala förbehandlingen som indata.

Förbehandlingskommandon är ofta mycket användbara, men som med alla alternativ som ändrar texten eller döljer vissa skillnader automatiskt, kan du av misstag hoppa över vissa skillnader och i värsta fall förstöra viktig data.

Av denna orsak, om ett normalt preprocessorkommando används under en sammanfogning, talar KDiff3 om det för dig och frågar om det ska inaktiveras eller inte. Men du får ingen varning om ett Radmatchande preprocessorkommando är aktivt. Sammanfogningen sker inte förrän alla konflikter är lösta. Om du inaktiverade Jämförelsevy → Visa blanktecken blir också skillnaderna som togs bort med Radmatchande preprocessorkommando osynliga. Om knappen Spara förblir inaktiv under en sammanfogning (på grund av kvarvarande konflikter), försäkra dig om att aktivera Jämförelsevy → Visa blanktecken. Om du inte vill sammanfoga dessa mindre viktiga skillnader för hand kan du välja Sammanfoga → Välj [A|B|C] för olösta konflikter med blanktecken.

kdiff3 katalog1 katalog2
   kdiff3 katalog1 katalog2 -o målkatalog

Om ingen målkatalog anges, använder KDiff3 katalog2.

kdiff3 katalog1 katalog2 katalog3
   kdiff3 katalog1 katalog2 katalog3 -o målkatalog

När tre kataloger sammanfogas, används katalog1 som basen för sammanfogningen. Om ingen målkatalog anges, använder KDiff3 katalog3 som målkatalog för sammanfogningen.

Observera att bara jämförelsen startas automatiskt, inte sammanfogningen. För det måste du först välja ett menyalternativ eller tangenten F7. (Mer information kommer senare.)

Varje fil och katalog som hittades under avsökningen visas här i ett träd. Du kan välja ett objekt genom att klicka en gång på det med musen.

Katalogerna är normalt ihopdragna. Du kan expandera och dra ihop dem genom att klicka på "+"/"-", genom att dubbelklicka på objektet eller genom att använda tangenterna vänsterpil och högerpil. Menyn Katalog innehåller också två alternativ Dra ihop alla underkataloger och Expandera alla underkataloger som du kan använda för att dra ihop eller expandera alla kataloger på en gång.

Om du dubbelklickar på ett filobjekt, utförs filjämförelsen och jämförelsefönstret för filer visas.

Ikonen i namnkolumnen motsvarar filtypen i den första katalogen (A). Den kan vara någon av dessa:

Om filtypen är annorlunda i övriga kataloger, syns det i kolumnerna A/B/C och i fönstret som visar detaljinformation om det markerade objektet. Observera att i dessa fall kan inte någon sammanfogningsåtgärd väljas automatiskt. När sammanfogningen startas, informeras användaren om den här sortens problem.

Som syns i bilden ovan, används färgerna röd, grön, gul och svart i kolumnerna A/B/C.

Utom för objekt som var identiska i jämförelsen, där är färgen också identisk även om åldern inte är det.

Kataloger anses vara likadana om alla objekt de innehåller är likadana. Då har de också samma färg. Åldern på en katalog spelar dock ingen roll för dess färg.

Idén för färgläggningsschemat hittade jag i dirdiff. Färgerna motsvarar färgerna hos ett löv som är grönt från början, sedan blir gult och till sist rött när det är gammalt.

Efter att ha jämfört katalogerna utvärderar KDiff3 också ett förslag på sammanfogningsåtgärd. Det visas i kolumnen Åtgärd. Du kan ändra den genom att klicka på åtgärden du vill ändra. En liten meny dyker upp och låter dig välja en åtgärd för objektet. (Du kan också välja den oftast använda åtgärden via tangentbordet. Ctrl+1/2/3/4/Delete väljer A/B/C/Sammanfoga/Ta bort om de är tillgängliga.) Åtgärden utförs under sammanfogningen. Vilka åtgärder som är tillgängliga beror på objektet och sammanfogningsläget som används. Sammanfogningsläget är ett av

Vid trekatalogers sammanfogning är den förslagna åtgärden: Om för ett objekt...

Vid tvåkatalogers sammanfogning är den förslagna åtgärden: Om för ett objekt...

Synkroniseringsläge är bara aktivt om två kataloger och ingen explicit målkatalog anges, och om alternativet Synkronisera kataloger är aktivt. KDiff3 väljer då en standardåtgärd så att båda katalogerna är likadana efteråt. Om för ett objekt ...

När två kataloger sammanfogas och alternativet Kopiera nyare istället för att sammanfoga är markerat, tittar KDiff3 på datum och föreslår att välja den nyare filen. Om filerna inte är lika men har samma datum, innehåller åtgärden "Fel: Datum är lika men filerna är det inte." Medan sådana objekt finns, kan inte katalogsammanfogningen startas.

Under sammanfogningen behandlas en fil i taget. Statuskolumnen visar Klar för objekt där sammanfogningsåtgärden har lyckats, och någon annan text om något oväntat inträffade. När en sammanfogning är färdig, bör du göra en sista kontroll för att se att status för alla objekt är acceptabel.

När filjämförelseläget Fullständig analys är aktiverat i alternativen, visar KDiff3 extra kolumner som innehåller antal oupplösta, upplösta, inte blanka och blanka konflikter. (Kolumnen Lösta visas bara när kataloger jämförs eller sammanfogas.)

Flera alternativ påverkar vilka filer som listas här. Vissa är tillgängliga i inställningsdialogrutan. Menyn Katalog innehåller alternativen:

Aktivera bara alternativen Visa för objekten du vill lista. Om du till exempel bara vill lista alla objekt som antingen finns i A eller i B men inte i båda, måste du aktivera Visa bara filer i A och Visa bara filer i B och inaktivera alla andra (Visa identiska filer, Visa olika filer, Visa bara filer i C). Listan uppdateras omedelbart för att motsvara ändringen.

Alternativen gäller också för kataloger med ett undantag: Att inaktivera Visa olika filer döljer inte hela kataloger. Det fungerar bara för filer inne i dem.

Observera att av dessa är bara alternativet Visa identiska filer som är bestående Övriga aktiveras när KDiff3 startas.

Oftast förblir listfönstret för katalogsammanfogning synligt medan en enstaka fil jämförs eller sammanfogas. Du kan flytta raden som delar fillistan från fönstren för textjämförelse med musen. Om du inte vill göra det, kan du inaktivera Katalog → Delad skärmvy för kataloger och text. Därefter kan du använda Katalog → Byt vy för att byta mellan fillistan och fönstren för textjämförelse, som då upptar hela fönstret.

Du föredrar troligen ett vanligt dubbelklick på musen för att jämföra en fil. Hur som helst finns det också ett alternativ i menyn Katalog. Du kan också direkt sammanfoga en enstaka fil, utan att starta katalogsammanfogning via Sammanfoga → Sammanfoga markerade filer. När resultatet sparas, sätts status till klar, och filen sammanfogas inte igen om en katalogsammanfogning startas.

Men observera att statusinformationen går förlorad när du kör om en katalogavsökning: Katalog → Avsök igen

Ibland behöver du jämföra eller sammanfoga filer med olika namn (t.ex. nuvarande fil och säkerhetskopian i samma katalog).

Markera den exakta filen genom att klicka på ikonen i kolumnen A, B eller C. Filen som först markeras på det sättet markeras med A, den andra och tredje med B och C oberoende av vilken kolumn de finns i. Bara upp till tre filer kan markeras på detta sätt.

Fortsätt genom att välja menyalternativet Katalog → Jämför explicit markerade filer eller Katalog → Sammanfoga explicit markerade filer. Av bekvämlighetsskäl finns också menyalternativen som en sammanhangsberoende meny som visas när du klickar på den senast markerade filen.

Jämförelsen eller sammanfogningen av en fil sker i samma fönster. Om metoden används för kataloger öppnas ett nytt fönster.