# Handbok &kdiff3;

Joachim
Eibl

     joachim.eibl snabela gmx.de

Stefan
Asserhäll

    stefan.asserhall@comhem.se

Översättare
2002-2005
Joachim Eibl
&FDLNotice;
2005-01-30
0.9.87

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

Det här dokumentet beskriver KDiff3 version 0.9.87.

KDE
kdeextragear
kdiff3
diff
sammanfoga
CVS
trippeljämförelse
jämföra
filer
kataloger
versionskontroll
trevägs sammanfogning
skillnader på plats
synkronisera
kpart
kio
nätverkstransparent
editor
blanktecken
kommentarer

## 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. Det är användbart 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. Editorn för sammanfogning under jämförelsefönstren låter dig lösa konflikter, medan den visar dig vilken utmatning du får. Du kan till och med redigera utmatningen. Den här skärmbilden visar tre indatafiler som 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.

- ...

## Dokumentation av filjämförelse och sammanfogning

### Kommandoradsväljare

#### Jämföra två filer:

    kdiff3 fil1 fil2

#### Sammanfoga två filer:

    kdiff3 fil1 fil2 -m
       kdiff3 fil1 fil2 -o utdatafil

#### Jämföra tre filer:

    kdiff3 fil1 fil2 fil3

#### Sammanfoga tre filer:

    kdiff3 fil1 fil2 fil3 -m
       kdiff3 fil1 fil2 fil3 -o utdatafil

Observera att fil1 behandlas som bas för fil2 och fil3.

#### Specialfall: Filer med samma namn

Om alla filer har samma namn men finns i olika kataloger, kan du reducera hur mycket du måste skriva genom att bara ange filnamnet för den första filen. T.ex:

    kdiff3 kat1/filnamn kat2 kat3

#### Kommandorad för att starta en katalogjämförelse eller sammanfogning:

Det här är mycket likt, men nu handlar det om kataloger.

    kdiff3 kat1 kat2
       kdiff3 kat1 kat2 -o målkat
       kdiff3 kat1 kat2 kat3
       kdiff3 kat1 kat2 kat3 -o målkat

För katalogjämförelse och sammanfogning kan du fortsätta att läsa här.

#### För mer information om kommandoradsväljare, använd:

    kdiff3 --help
    Väljare:
      -m, --merge               Sammanfoga indata.
      -b, --base file           Explicit basfil. För att fungera tillsammans med vissa verktyg.
      -o, --output file         Utdatafil. Betyder underförstått -m. T.ex.: -o ny_fil.txt
      --out file                Utdatafil, igen. (för att fungera med vissa verktyg.)
      --auto                    Inget grafiskt gränssnitt om alla konflikter kan lösas automatiskt (kräver -o fil)
      --qall                    Lös inte konflikter automatiskt. (För att fungeramed andra verktyg...)
      --L1 alias1               Synlig ersättning av namn för indatafil 1 (bas).
      --L2 alias2               Synlig ersättning av namn för indatafil 2.
      --L3 alias3               Synlig ersättning av namn för indatafil 3.
      -L, --fname alias         Alternativ synlig ersättning av namn. Ange detta en gång för all indata.
      -u                        Har ingen effekt. För att fungera med vissa verktyg.

### Dialogrutan Öppna

Eftersom många indatafiler måste kunna väljas, har programmet en särskild öppningsdialogruta:

Öppningsdialogrutan tillåter att filnamnen redigeras för hand, att en fil väljs via filbläddraren ("Fil...") eller att senast använda filer väljs i kombinationsrutan. Om du öppnar dialogrutan igen, finns de nuvarande namnen fortfarande där. Den tredje indatafilen krävs inte. Om fältet för "C" förblir tomt, görs bara en tvåvägs jämförelseanalys.

Du kan också välja en katalog med "Katalog...". Om en katalog anges för A, startar en katalogjämförelse och sammanfogning. Om A anger en fil, men B, C eller utmatningen anger en katalog, använder KDiff3 filnamnet från A i de angivna katalogerna.

Om "Sammanfoga" är valt, blir raden "Utmatning" redigerbar. Det krävs dock inte att utdatafilens namn anges omedelbart. Du kan också vänta med detta till du sparar.

Knappen "Anpassa" visar inställningsdialogrutan, så att du kan ställa in alternativ innan analysen utförs.

### Klistra in eller släpp indata

Ibland vill du jämföra delar av en text som inte är en egen fil. KDiff3 låter dig också klistra in text från klippbordet i det indatafönster för jämförelse som har fokus. Jämförelseanalysen sker då omedelbart. I öppningsdialogrutan behöver du då inte ange filer, utan bara stänga den via "Avbryt".

Du kan också använda drag och släpp: Dra en fil från en filhanterare eller markerad text från en editor och släpp den på ett indatafönster för jämförelse.

Vad är idén? Ibland innehåller en fil två liknande funktioner, men att kontrollera hur lika de verkligen är blir en stor ansträngning om du först måste skapa två filer och sedan ladda dem. Nu kan du helt enkelt kopiera, klistra in och jämföra de relevanta avsnitten.

Observera: För närvarande kan du inte dra någonting från KDiff3. Bara att släppa indata i jämförelsefönstret stöds.

Varning: Vissa editorer tolkar fortfarande drag och släpp till ett annat program som klipp ut (istället för kopiera) och klistra in. Ditt ursprungliga data kan då gå förlorat.

### Tolka informationen i indatafönstren

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. (Om sökvägarna är för långa för att få plats, kan du flytta musen till informationsraden och ett verktygstips visar hela namnet.)

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 de kan ändras via inställningsmenyn.)

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" i inställningarna). Det här färgläggningsschemat är särskilt användbart i fallet med tre indatafiler, som syns i 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.

### Sammanfogning och editorfönstret för sammanfogningsutdata

Editorfönstret för sammanfogningsutdata (under indatafönstren för jämförelse) har också en informationsrad längst upp som visar "Utmatning", filnamnet och "[Ändrad]" om du redigerat något. Oftast innehåller det någon text från de automatiska sammanfogningsfunktionerna, men det innehåller också ofta konflikter.

!!! Spara är inaktiverat till alla konflikter är lösta !!! (Använd knapparna "Gå till föregående/nästa olösta konflikt" för att hitta återstående konflikter.)

Med bara två filer är varje skillnad också en konflikt, som måste lösas manuellt.

Med tre indatafiler behandlas den första som bas, medan den andra och tredje indatafilen innehåller ändringar. Om bara indata B eller C har ändrats för en viss rad, men inte båda väljs den ändrade källan automatiskt. Bara om B och C har ändrats på samma rader, detekterar verktyget en konflikt som måste lösas manuellt. När B och C är likadana, men inte samma som A, väljs C.

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 "Bakgrundsfärgen för aktuellt jämförelseintervall" och en svart rad visas till vänster om texten.

Observera knapparna för indataval som innehåller bokstäverna "A", "B" och "C" i verktygsraden under menyraden. När du klickar på någon av knapparna för indataval, läggs raderna från den indatakällan till sist i markerad grupp, om gruppen inte redan innehöll den källan. Annars tas raderna från den indatakällan bort.

Dessutom kan du redigera vilken rad som helst. Sammanfattningskolumnen visar "m" för varje rad som har ändrats.

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

Observera: När endera källan väljs för olösta konflikter för blanktecken och alternativet "Ignorera siffror" eller "Ignorera C/C++ kommentarer" används, så behandlas ändringar i siffror eller kommentarer också som blanktecken.

### Navigering och redigering

Mycket navigering görs med rullningslisterna och musen, men du kan också navigera med tangentbordet. Om du klickar på något fönster kan du använda markörtangenterna vänsterpil, högerpil, uppåtpil, neråtpil, Page Up, Page Down, Home, End, Ctrl+Home och Ctrl+End som du kan i andra program.

Du kan också använda hjulmusen för att rulla uppåt och neråt.

I editorn för sammanfogningsutdata kan du också använda andra tangenter för redigering. Du kan byta mellan infognings- och ersättningsläge med tangenten Insert. (Normalläget är infoga.)

Ett klick med vänster musknapp i någon sammanfattningskolumn synkroniserar alla fönster för att visa början på samma grupp av rader (som förklaras i avsnittet Sammanfogning).

Verktygsraden innehåller också sju navigeringsknappar som du kan använda för att gå till aktuell/första/sista skillnaden, till nästa/föregående skillnad (Ctrl+Neråtpil eller Ctrl+Uppåtpil), till nästa/föregående konflikt (Ctrl+Page Down eller Ctrl+Page Up) eller till nästa/föregående olösta konflikt. Observera att för KDiff3 förblir en "konflikt" som inte automatiskt löstes vid start av sammanfogningen alltid en "konflikt" även om den är löst. Därav nödvändigheten att särskilja "olöst konflikt".

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äljs. 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: Trött på många klick? Använd en kort fördröjning och snabbtangenterna Ctrl+1, Ctrl+2 eller Ctrl+3 för många konflikter.

### Markera, kopiera och klistra in

Indatafönstren visar inte någon markör, så markeringar måste göras med musen, genom att klicka med vänster musknapp på början, hålla nere musknappen och gå till slutet, där musknappen släpps upp igen. Du kan också markera ett ord genom att dubbelklicka på det. I editorn för sammanfogningsutdata kan du också markera med tangentbordet, genom att hålla nere tangenten "Skift" och navigera med piltangenterna.

För att kopiera till klippbordet måste du trycka på knappen "Kopiera" (Ctrl+C eller Ctrl+Insert). Men det finns ett alternativ som heter "Kopiera automatiskt markering". Om det är markerat, kopieras vad du än väljer omedelbart, och du behöver aldrig explicit kopiera. Men var försiktig när du använder detta, eftersom klippbordets innehåll kan förstöras av misstag.

"Klipp ut" (Ctrl+X eller Skift+Delete) kopierar till klippbordet och tar bort den markerade texten, och "Klistra in" (Ctrl+V eller Skift+Insert) infogar texten från klippbordet på markörens position eller över nuvarande markering.

### Spara

Att spara tillåts bara när alla konflikter är lösta. Om filen redan finns och alternativet "Säkerhetskopiera filer" är markerat, ändras originalversionens namn med tillägg av filändelsen ".orig", och om en sådan fil redan finns tas den bort. När du avslutar eller startar en ny jämförelseanalys och data inte sparats ännu, frågar KDiff3 om du vill spara, avbryta eller fortsätta utan att spara. (KDiff3 fångar inga signaler, så om du "dödar" KDiff3 går data förlorat.)

Radslut sparas enligt den normala metoden i det underliggande operativsystemet. För Unix slutar varje rad med ett nyradstecken "\n", medan för Windows-baserade system slutar varje rad med ett returtecken och ett nyradstecken "\r\n". KDiff3 behåller inte radslut för indatafilerna, vilket också betyder att du inte ska använda KDiff3 med binärfiler.

### Söka efter strängar

Du kan söka efter en sträng i vilket textfönster som helst i KDiff3. Kommandot "Sök..." (Ctrl+F) i menyn Redigera, visar en dialogruta som låter dig ange strängen att söka efter. Du kan också välja de fönster som ska sökas. Sökning startar alltid från början. Använd kommandot "Sök igen" (F3) för att fortsätta till nästa förekomst. Om du väljer att söka i flera fönster, söks det första fönstret från början till slut innan sökningen fortsätter från början i nästa fönster, etc.

### Alternativ

Alternativ och listan med senaste filer sparas när du avslutar programmet, och laddas igen när du startar det. (Menyn Inställningar -> Anpassa KDiff3...)

#### Teckensnitt

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

Kursiv stil för skillnader:

  Om du markerar detta, visas textskillnader med kursiv version av det valda teckensnittet. Om teckensnittet inte stöder kursiv stil, gör det ingenting.

#### Färger

Förgrundsfärg:

  Oftast svart.

Bakgrundsfärg:

  Oftast vit.

Bakgrundsfärg för jämförelse:

  Oftast ljusgrå.

Färg A:

  Oftast mörkblå.

Färg B:

  Oftast mörkgrön.

Färg C:

  Oftast mörk magenta.

Konfliktfärg:

  Oftast röd.

Bakgrundsfärg för aktuellt intervall:

  Oftast ljusgul.

Bakgrundsfärg för aktuellt jämförelseintervall:

  Oftast mörkgul.

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" rena färger.

#### Inställningar för editor

Tabulator infogar mellanslag:

  Om det här inte är markerat, och du trycker på tabulatortangenten, infogas en tabulator, annars infogas lämpligt antal mellanslag.

Tabulatorbredd:

  Kan justeras för dina speciella behov. Normalvärdet är 8.

Automatisk indentering:

  När du trycker på Enter eller returtangenten, används föregående rads indentering för den nya raden.

Kopiera automatiskt markering:

  Varje markering kopieras omedelbart till klippbordet när den aktiveras, och du behöver inte kopiera den explicit.

Radslutstil:

  När du sparar kan du välja vilken radslutsstil du föredrar. Förvald inställning är det vanliga valet för operativsystemet som används.

Använd lokal kodning:

  För att visa främmande tecken. Försök ändra det här om vissa tecken i språket du använder inte visas riktigt.

#### Inställningar av jämför och sammanfoga

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.

Behåll returtecken:

  Vissa editorer (på vissa system) sparar returtecken '\r' och nyradstecken '\n' i slutet på raden, medan andra bara sparar nyradstecknet '\n'. Oftast ignorerar KDiff3 returtecknet, men då ser filer som inte har samma storlek likadana ut vid jämförelse sida vid sida. När det här alternativet är markerat, görs returtecken synliga, men behandlas som blanktecken. Det här alternativet måste vara av under en sammanfogning. Normalvärdet är av.

Ignorera siffror:

  Normalvärdet är av. Siffertecken ('0'-'9','.', '-') ignoreras under första delen av analysen när radmatchningen görs. Skillnaderna för resultatet visas ändå, men de behandlas som blanktecken.

Ignorera C/C++ kommentarer:

  Normalvärdet är av. Ändringar i kommentarer behandlas som ändringar i blanktecken.

Ignorera skiftläge:

  Normalvärdet är av. Skillnader i skiftläge för tecken (som 'A' eller 'a') behandlas som ändringar i blanktecken.

Preprocessorkommando:

  Se nästa avsnitt.

Preprocessorkommando för radmatchning:

  Se nästa avsnitt.

Var noggrann:

  Gör en ansträngning att hitta en ännu mindre skillnad (Normalvärdet är på). Det här är troligen effektivt för komplicerade och stora filer, och långsamt för mycket stora filer.

Fördröjning vid automatisk fortsättning (ms):

  I automatiskt fortsättningsläge anger den här inställningen hur länge resultatet för gruppen ska visas innan hopp till nästa olösta konflikt.

Standardvärde för sammanfogning av blanktecken med två/tre filer:

  Lös automatiskt alla konflikter för blanktecken genom att välja angiven fil. (Normalvärdet är manuellt val.) Användbart om blanktecken verkligen är oviktiga i många filer. Om du bara behöver det ibland, är det bättre att använda "Välj A/B/C för olösta konflikter med blanktecken" i sammanfogningsmenyn. Observera att om du antingen aktiverar "Ignorera siffror" eller "Ignorera C/C++ kommentarer" gäller det automatiska valet också vid konflikter för siffror eller kommentarer.

#### Katalogsammanfogning

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:

Säkerhetskopiera filer:

  När en fil sparas och en äldre version redan finns, ändras originalversionens namn med tillägg av filändelsen ".orig". Om en gammal säkerhetskopia med filändelsen "orig" redan finns tas den bort utan säkerhetskopiering.

#### Inställningar för region och språk

Språk:

  Justera användargränssnittets språk. Att ändra alternativet påverkar inte programmet som kör. Du måste avsluta och starta om Kdiff3 för att ändra språk. (Alternativet är inte tillgängligt i KDE-versionen av Kdiff3, eftersom språket kan justeras i de allmänna KDE-inställningarna.)

Använd samma kodning för allt:

  Följande kodningsalternativ kan justeras separat för varje objekt, eller om alternativet är sant, ställs alla värden in till det första värdet.

Lokal kodning:

  Ovanför kodningsväljarna visas en anmärkning som talar om för dig vad den lokala kodningen är (Den kan inte justeras, utan bara som information om du inte vet vad den lokala kodningen är, men behöver kunna välja den.)

Filkodning för A/B/C:

  Justera filkodningen för indatafiler. Det ger effekt på hur specialtecken tolkas. Eftersom du kan justera varje kodning separat, kan du till och med jämföra och sammanfoga filer som sparades med olika kodningar.

Filkodning för sammanfogad utdata och vid spara:

  När du har redigerat en fil, kan du justera vilken kodning som används när den sparas till disk.

Filkodning för preprocessorfiler:

  När du definierar preprocessorer kanske de inte kan hantera din kodning (exempelvis om dina filer använder 16-bitars Unicode och preprocessorn bara kan hantera 8-bitars ASCII). Med det här alternativet kan du definiera kodningen för preprocessorns utdata.

Språk som läses från höger till vänster

  Vissa språk skrivs från höger till vänster. När alternativet är aktiverat, ritar Kdiff3 text från höger till vänster i jämförelsefönstren och i sammanfogningsfönstret. Observera att om du startar Kdiff3 med kommandoradsväljaren "--reverse" så visas all layout också från höger till vänster. (Det är en funktion som Qt tillhandahåller.) Denna dokumentation är skriven med antagandet att "Språk som läses från höger till vänster" eller omvänd layout inte är aktiverade. Vissa referenser till "vänster" eller "höger" måste ersättas av motsatsen om du använder alternativen.

#### Diverse

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

Visa radnummer:

  Du kan välja om radnummer ska visas för indatafilerna.

Visa mellanslag och tabulatortecken i jämförelse:

  Ibland är synliga mellanslag och tabulatortecken störande. Du kan stänga av detta.

Visa blanktecken:

  Stäng av det här för att inte visa ändringar av bara blanktecken i texten eller översiktskolumnerna. (Observera att detta också gäller ändringar av siffror eller kommentarer om alternativen "Ignorera siffror" eller "Ignorera C/C++ kommentarer" är aktiva.)

Översiktsalternativ:

  Dessa alternativ är bara tillgängliga när du jämför tre filer. I normalläge visas alla skillnader i en färgkodad översiktskolumn, men ibland är du särskilt intresserad av skillnaderna mellan två av de tre filerna. Genom att välja översikten "A mot B", "A mot C" eller "B mot C", visas en andra översiktskolumn med begärd information intill den vanliga översikten.

Radbryt skillnadsfönster:

  Radbryt rader när deras längd skulle överskrida ett fönsters bredd.

Visa fönster A/B/C:

  Ibland vill du använda skärmutrymmet bättre för långa rader. Dölj fönster som inte är viktiga. (I fönstermenyn.)

Byt delningsorientering:

  Byt mellan jämförelsefönster som visas intill varandra (A till vänster om B till vänster om C) eller ovanför varandra (A ovanför B ovanför C). Det bör också hjälpa för långa rader. (I fönstermenyn.)

Starta sammanfogning snabbt:

  Ibland tittar du på skillnader, och bestämmer dig för att sammanfoga. "Sammanfoga markerade filer" i menyn Sammanfoga fungerar också om du bara jämför två filer. Ett enkelklick startar sammanfogningen och använder filnamnet på den sista indatafilen som förvalt utmatningsfilnamn. (När detta används för att starta om en sammanfogning, behålls utmatningsfilnamnet.)

#### Anpassa snabbtangenter

För närvarande stöder bara KDE-versionen anpassningsbara snabbtangenter (Menyn Inställningar -> Anpassa genvägar...)

### Preprocessorkommandon

KDiff3 stöder två preprocessoralternativ.

Preprocessorkommando:

  När en fil läses, skickas den via det här externa kommandot. Utmatningen från kommandot visas istället för den ursprungliga filen. Du kan skriva din egen preprocessor som uppfyller dina speciella behov. Använd det här för att ta bort störande delar av filen, eller för att automatiskt korrigera indenteringen, etc.

Preprocessorkommando för radmatchning:

  När en fil läses, skickas den via det här externa kommandot. Om ett preprocessorkommando (se ovan) också anges är utmatningen från preprocessorn inmatning till kommandot för radmatchning. Utmatningen används bara under radmatchningsfasen av analysen. Du kan skriva din egen preprocessor som uppfyller dina speciella behov. Varje indatarad måste ha en motsvarande utdatarad.

Idén är att ge användaren större flexibilitet när jämförelseresultatet ställs in, men det kräver ett externt program, och många användare vill inte skriva ett själva. De goda nyheterna är att ofta klarar `sed` eller `perl` av jobbet.

Exempel, enkelt testfall: Betrakta filen a.txt (6 rader):

          aa
          ba
          ca
          da
          ea
          fa

och filen b.txt (3 rader):

          cg
          dg
          eg

Utan förbehandling skulle följande rader hamna intill varandra:

          aa - cg
          ba - dg
          ca - eg
          da
          ea
          fa

Det är troligen inte vad som önskas, eftersom första bokstaven innehåller den verkligt intressanta informationen. För att hjälpa matchningsalgoritmen ignorera den andra bokstaven kan vi använda ett radmatchande preprocessorkommando som ersätter 'g' med 'a':

       sed 's/g/a/'

Med detta kommando blir resultatet av jämförelsen:

          aa
          ba
          ca - cg
          da - dg
          ea - eg
          fa

Internt ser matchningsalgoritmen filerna efter att det radmatchande preprocessorkommandot har körts, men på skärmen är filen oförändrad. (Den normala förbehandlingen skulle också ändra data på skärmen.)

#### Grundläggande information om `sed`

Det här avsnittet introducerar bara några mycket grundläggande funktioner i `sed`. För mer information se info:/sed eller http://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. Observera också att följande exempel använder enkla citationstecken ('), vilket inte fungerar i Windows. I Windows ska du istället använda dubbla citationstecken (").

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

       sed 's/reguljärt uttryck/ersättning/flaggor'

Innan du använder ett nytt kommando 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 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

Tecknet "|" är rörkommandot som skickar utdata från föregående kommando till indata för nästa kommando. Om du vill prova med en längre fil kan du använda `cat` i Unix-liknande system eller `type` i Windows-liknande system. `sed` gör ersättningen för varje rad.

    cat filnamn | sed väljare

#### Exempel på användning av `sed` i Kdiff3

##### Ignorera andra typer av kommentarer

För närvarande förstår Kdiff3 bara C/C++ kommentarer. Genom att använda det radmatchande preprocessorkommandot kan du också ignorera andra typer av kommentar, genom att konvertera dem till C/C++ kommentarer. Till exempel för att ignorera kommentarer som börjar med "#", skulle du vilja konvertera dem till "//". Observera att du också måste aktivera alternativet "Ignorera C/C++ kommentarer" för att få någon effekt. Ett lämpligt radmatchande preprocessorkommando skulle vara

       sed 's/#/\/\//'

Eftersom tecknet "/" har en särskild betydelse i `sed`, är det nödvändigt att lägga till tecknet "\" innan varje "/" i ersättningssträngen. Ibland behövs "\" för att lägga till eller ta bort en särskild betydelse för vissa tecken. De enkla citationstecknen (') innan och efter ersättningskommandot är nu viktiga, eftersom skalet annars skulle försöka tolka vissa specialtecken om '#', '$' eller '\' innan de skickas till `sed`. Observera att i Windows behöver du dubbla citationstecken (") här. Windows ersätter andra tecken som '%', så du kan behöva experimentera något.

##### Jämförelse som inte är skiftlägeskänslig

Använd följande radmatchande preprocessorkommando för att konvertera all indata till stora bokstäver:

       sed 's/\(.*\)/\U\1/'

Här är ".*" ett reguljärt uttryck som matchar alla strängar, och i det här sammanhanget matchar alla tecken på raden. Tecknet "\1" i ersättningssträngen motsvarar den matchade texten mellan det första paret "\(" och "\)". "\U" konverterar den infogade texten till stora bokstäver.

##### Ignorera nyckelord för versionskontroll

CVS och andra versionskontrollsystem använder flera nyckelord för att infoga automatiskt skapade strängar (info:/cvs/Keyword substitution). Alla följer mönstret "$NYCKELORD skapad text$". Nu behöver vi ett radmatchande preprocessorkommando som bara tar bort den skapade texten:

       sed 's/\$\(Revision\|Author\|Log\|Header\|Date\).*\$/\$\1\$/'

Tecknet "\|" avdelar möjliga nyckelord. Du kan vilja ändra listan efter dina egna behov. Tecknet "\" innan "$" är nödvändigt eftersom annars matchar "$" slutet på raden.

Medan du experimenterar med `sed` kan du komma att förstå och till och med tycka om de reguljära uttrycken. De är användbara eftersom det finns många andra program som också stöder liknande funktioner.

##### Ignorera siffror

Att ignorera siffror är i själva verket ett inbyggt alternativ, men som ett annat exempel, visas hur det skulle se ut som ett radmatchande preprocessorkommando.

       sed 's/[0123456789.-]//g'

Alla tecken mellan '[' och ']' matchar och ersätts med ingenting.

##### Ignorera vissa kolumner

Ibland är texten mycket strikt formaterad, och innehåller kolumner som du alltid vill ignorera, medan det finns andra kolumner du vill bevara för analys. I följande exempel ignoreras de fem första kolumnerna (tecknen), de följande tio kolumnerna bevaras, därefter ignoreras återigen fem kolumner och resten av raden bevaras.

       sed 's/.....\(..........\).....\(.*\)/\1\2/'

Varje punkt '.' matchar ett enstaka tecken. "\1" och "\2" i ersättningssträngen motsvarar den matchade texten mellan de första och andra paren "\(" och "\)" som anger texten som ska bevaras.

##### Kombinera flera ersättningar

Ibland vill du tillämpa flera ersättningar samtidigt. Då kan du använda semikolon ';' för att skilja dem från varandra. Till exempel:

    echo abrakadabra | sed 's/a/o/g;s/\(.*\)/\U\1/'
       -> OBROKODOBRO

##### Använda `perl` istället för `sed`

Istället för `sed` kanske du vill använda något annat, som `perl`.

       perl -p -e 's/reguljärt uttryck/ersättning/flaggor'

Men vissa detaljer skiljer sig åt i `perl`. Observera att när `sed` behöver "\(" och "\)" kräver `perl` det enklare "(" och ")" utan inledande '\'. Till exempel:

    sed 's/\(.*\)/\U\1/'
       perl -p -e 's/(.*)/\U\1/'

#### Ordning vid körning av preprocessor

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

- Normal preprocessor,

- Preprocessor för radmatchning,

- Ignorera skiftläge (konvertering till stora bokstäver),

- Detektering av C/C++ kommentarer,

- Ignorera siffror,

- Ignorera blanktecken

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.

#### Varning

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 "Visa blanktecken" blir också skillnaderna som togs bort med det radmatchande preprocessorkommandot osynliga. Om knappen Spara förblir inaktiv under en sammanfogning (på grund av kvarvarande konflikter), försäkra dig om att aktivera "Visa blanktecken". Om du inte vill sammanfoga dessa mindre viktiga skillnader för hand kan du välja "Välj [A|B|C] för olösta konflikter med blanktecken" i menyn Sammanfoga.

## Katalogjämförelse och sammanfogning med KDiff3

### Inledning

Ofta måste programmerare ändra många filer i en katalog för att uppnå sina syften. För att åstadkomma detta låter KDiff3 dig också jämföra och sammanfoga hela kataloger rekursivt!

Även om jämförelse och sammanfogning av kataloger verkar vara ganska självklart, finns det flera detaljer som du bör känna till. Det viktigaste är förstås faktum att många filer nu kan påverkas av varje åtgärd. Om du inte har säkerhetskopior av originaldata, kan det vara mycket svårt eller till och med omöjligt att återgå till originalläget. Så innan du påbörjar en sammanfogning, försäkra dig om att data är säkert, och att det är möjligt att återställa. Om du skapar ett arkiv, eller använder ett versionskontrollsystem är ditt eget beslut, men till och med erfarna programmerare och integratörer behöver ibland gammal källkod. Observera också att även om jag (upphovsmannen till KDiff3) försöker att göra mitt bästa, kan jag inte garantera att det inte finns fel. Enligt GNU GPL finns det INGEN GARANTI av något slag för det här programmet. Så var ödmjuk, och kom alltid ihåg:

> Att fela är mänskligt, men för att verkligen ställa till det behövs en dator.

Så det här är vad programmet kan göra åt dig: KDiff3 ...

- ... läser och jämför två eller tre kataloger rekursivt,

- ... hanterar symboliska länkar särskilt,

- ... låter dig bläddra mellan filer med ett dubbelklick på musen,

- ... föreslår ett sammanfogningsalternativ för varje objekt, som du kan ändra innan katalogsammanfogningen startas,

- ... låter dig simulera sammanfogningen och listar åtgärderna som skulle ske, utan att verkligen göra dem,

- ... låter dig utföra sammanfogningen, och låter dig bestämma så fort manuell interaktion behövs,

- ... låter dig utföra vald åtgärd för alla objekt (tangenten F7) eller markerat objekt (tangenten F6),

- ... låter dig fortsätta sammanfogningen efter manuell interaktion med tangenten F7,

- ... skapar valfria säkerhetskopior, med filändelsen ".orig".

- ...

### Starta katalogjämförelse eller sammanfogning

Det här liknar mycket sammanfogning och jämförelse av en enstaka fil. Du måste bara ange kataloger på kommandoraden eller i dialogrutan för filöppning.

#### Jämföra eller sammanfoga två kataloger:

    kdiff3 kat1 kat2
       kdiff3 kat1 kat2 -o målkat

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

#### Jämföra eller sammanfoga tre kataloger:

    kdiff3 kat1 kat2 kat3
       kdiff3 kat1 kat2 kat3 -o målkat

När tre kataloger sammanfogas, används kat1 som basen för sammanfogningen. Om ingen målkatalog anges, använder KDiff3 kat3 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.)

### Synlig information

Medan katalogerna läses visas en meddelanderuta som informerar dig om förloppet. Om du avbryter katalogavsökningen, visas bara filer som hittills har jämförts.

När katalogavsökningen är färdig, visar KDiff3 en listruta med återstående resultat, ...

... och detaljinformation om det markerade objektet till höger:

#### Namnkolumnen

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:

- Normal fil

- Normal katalog (katalogikon)

- Länk till en fil (filikon med en länkpil)

- Länk till en katalog (katalogikon med en länkpil)

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.

#### Kolumnerna A/B/C och färgläggningsschemat

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

- Svart: Det här objektet finns inte i den här katalogen.

- Grön: Nyaste objektet.

- Gul: Äldre än grön, nyare än röd.

- Röd: Äldsta objektet.

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.

#### Åtgärdskolumnen

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:

- Sammanfogning av tre kataloger ("A" behandlas som äldsta bas för båda).

- Sammanfogning av två kataloger.

- Tvåkatalogs synkroniseringsläge (aktiveras med alternativet "Synkronisera kataloger").

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

- ... alla tre katalogerna är likadana: Kopiera från C

- ... A och C är likadana med B är det inte: Kopiera från B (eller om B inte finns, ta bort målet om det finns)

- ... A och B är likadana med C är det inte: Kopiera från C (eller om C inte finns, ta bort målet om det finns)

- ... B och C är likadana med A är det inte: Kopiera från C (eller om C inte finns, ta bort målet om det finns)

- ... bara A finns: Ta bort målet (om det finns)

- ... bara B finns: Kopiera från B

- ... bara C finns: Kopiera från C

- ... A, B och C är inte likadana: Sammanfoga

- ... A, B och C har inte samma filtyp (t.ex. A är en katalog, B är en fil): "Fel: Konflikt i filtyper". Medan sådana objekt finns, kan inte katalogsammanfogningen startas.

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

- ... båda katalogerna är likadana: Kopiera från B

- ... A finns men inte B: Kopiera från A

- ... B finns men inte A: Kopiera från B

- ... A och B finns men är inte likadana: Sammanfoga

- ... A och B har inte samma filtyp (t.ex. A är en katalog, B är en fil): "Fel: Konflikt i filtyper". Medan sådana objekt finns, kan inte katalogsammanfogningen startas.

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

- ... båda katalogerna är lika: Ingenting görs.

- ... A finns, men inte B: Kopiera A till B

- ... B finns, men inte A: Kopiera B till A

- ... A och B finns, men är inte likadana: Sammanfoga och lagra resultatet i båda kataloger. (För användaren är det synliga filnamnet för att spara B, men därefter kopierar KDiff3 också B till A.)

- ... A och B har inte samma filtyp (t.ex. A är en katalog, B är en fil): "Fel: Konflikt i filtyper". Medan sådana objekt finns, kan inte katalogsammanfogningen startas.

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.

#### Statuskolumnen

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.

#### Statistikkolumner

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

### Utföra en sammanfogning

Du kan antingen sammanfoga markerat objekt (fil eller katalog), eller alla objekt. När du har gjort alla val av åtgärder (också i alla underkataloger), kan du utföra sammanfogningen.

Var medveten om att om du inte explicit angav en målkatalog, blir målet "C" i trekatalogsläge, "B" i tvåkatalogsläge, och i synkroniseringsläge är det "A" och/eller "B".

Om du också har angivit en målkatalog, kontrollera att alla objekt som ska finnas i utmatningen finns i trädet. Det finns några alternativ som får vissa objekt att utelämnas från katalogjämförelsen och sammanfogningen. Kontrollera dessa alternativ för att undvika obehagliga överraskningar:

- "Rekursiva kataloger": Om det är av, hittas inte objekt i underkataloger.

- "Mönster" eller "undantagsmönster": Inkludera eller undanta objekt som matchar.

- "Undanta gömda filer"

- "Lista bara skillnader": Filer som matchar i alla kataloger visas inte i trädet, och alltså inte heller i målet.

(I nuvarande version måste du göra en omsökning via menyn "Katalog"->"Avsök igen" själv, efter att ha ändrat alternativ som påverkar katalogavsökningen.)

Om du är nöjd hittills, är resten enkelt.

För att sammanfoga alla objekt: Välj "Starta eller fortsätt katalogsammanfogning" i menyn "Katalog" eller tryck på F7 (som är snabbtangenten). För att bara sammanfoga aktuellt objekt: Välj "Utför åtgärd för aktuellt objekt" eller tryck på F6.

Om vissa objekt med ogiltiga filtyper fortfarande finns, på grund av filtyper med konflikter, visas en meddelanderuta och objekten pekas ut, så att du kan välja en giltig åtgärd för objektet.

Om du sammanfogar alla objekt visas en dialogruta som ger dig alternativen "Gör det", "Simulera det" och "Avbryt".

- Välj "Simulera det" om du vill se vad som skulle göras utan att verkligen göra det. En utförlig lista med alla åtgärder visas.

- Välj annars "Gör det" för att verkligen utföra sammanfogningen.

Därefter utför KDiff3 den angivna åtgärden för alla objekt. Om manuell interaktion krävs (sammanfogning av enstaka fil), visas ett sammanfogningsfönster (se den stora skärmbilden).

När du är klar med en fil, välj återigen "Starta eller fortsätt katalogsammanfogning" eller tryck på F7. Om du inte har sparat ännu, ber en dialogruta dig att göra det. Därefter fortsätter KDiff3 till nästa objekt.

När KDiff3 stöter på ett fel, meddelas det och utförlig statusinformation visas. Längst ner i listan finns det några felmeddelanden som bör hjälpa dig att förstå problemets orsak. När du fortsätter sammanslagningen (tangenten F7), ger KDiff3 dig valet att försöka igen eller hoppa över objektet som orsakade problemet. Det betyder att du kan välja en annan åtgärd, eller lösa problemet på annat sätt, innan du fortsätter.

När sammanfogningen är färdig, informerar KDiff3 dig med en meddelanderuta.

Om vissa objekt sammanfogades individuellt, kommer Kdiff3 ihåg det (medan sammanfogningssessionen pågår), och sammanfogar dem inte igen när sammanfogningen för alla objekt utförs. Även när sammanfogningen hoppas över eller ingenting sparas räknas dessa objekt som färdiga. Bara när sammanfogningsåtgärden ändras, sammanfogas objekten igen.

### Alternativ för att jämföra och sammanfoga kataloger

Inställning av KDiff3 (menyn "Inställningar" -> "Anpassa KDiff3") har nu en sida som heter "Katalogsammanfogning" med följande alternativ:

Rekursiva kataloger:

  Välj om kataloger ska sökas igenom rekursivt.

Mönster för filer:

  Bara filer som matchar något mönster här läggs till i trädet. Mer än ett mönster kan anges genom att använda semikolon ";" som skiljetecken. Giltiga jokertecken: '*' och '?'. (t.ex. "*.cpp;*.h"). Normalvärdet är "*". Kataloger behöver inte matcha mönstret.

Undantagsmönster för filer:

  Filer och kataloger som matchar något mönster undantas från trädet. Mer än ett mönster kan anges genom att använda semikolon ";" som skiljetecken. Giltiga jokertecken: '*' och '?'. (t.ex. "*.cpp;*.h"). Normalvärdet är "*.orig;*.o".

Använd .cvsignore:

  Ignorera filer och kataloger som också skulle ignoreras av CVS. Många automatiskt genererade filer ignoreras av CVS. Den stora fördelen är att detta kan vara katalogspecifikt via en lokal ".cvsignore" fil. (Se info:/cvs/cvsignore.)

Sök efter gömda filer och kataloger:

  För vissa filsystem har filer egenskapen "Gömd". För andra system göms ett filnamn som börjar med en punkt. Alternativet låter dig bestämma om dessa filer ska ingå i trädet eller inte. Normalvärdet är på.

Följ fillänkar:

  För länkar till filer: Om inaktiverad, jämförs de symboliska länkarna. Om aktiverad, jämförs filerna bakom länkarna. Normalvärdet är av.

Följ kataloglänkar:

  För länkar till kataloger: Om inaktiverad, jämförs symboliska länkar. Om aktiverad behandlas länken som en katalog och avsöks rekursivt. (Observera att programmet inte kontrollerar om länken är "rekursiv". En katalog som innehåller en länk till samma katalog skulle orsaka en oändlig snurra, och efter en viss tid när stacken blir full eller minnet tar slut, kraschar programmet.) Normalvärdet är av.

Lista bara skillnader:

  Bara objekt som inte är lika i alla indatakataloger listas, och bara ändrade filer syns. Därför kopieras inte filer som är lika i alla kataloger vid en sammanfogning och om målkatalogen inte innehåller filerna innan sammanfogningen, kan du senare sakna några filer. (Alternativet kommer troligen att ändras i en senare version.) Normalvärdet är av.

Filjämförelseläge:

  Binär jämförelse:

    Det här är förvalt filjämförelseläge.

  Fullständig analys:

    Gör en fullständig analys av varje fil och visa kolumner med statistisk information. (Antal upplösta, oupplösta, inte blanka och blanka konflikter.) Den fullständiga analysen är långsammare än en enkel binäranalys, och är mycket långsammare för filer som inte innehåller text. (Ange lämpliga filmönster för att undvika dem.)

  Lita på ändringsdatum:

    Om du jämför stora kataloger via ett långsamt nätverk, kan det gå snabbare att bara jämföra ändringsdatum och fillängd. Men hastighetsförbättringen sker till priset av en liten osäkerhet. Använd alternativet med försiktighet. Normalvärdet är av.

  Lita på storleken:

    Liknar att lita på ändringsdatum. Ingen verklig jämförelse sker. Två filer anses vara lika om deras filstorlekar är lika. Detta är användbart när filkopieringsåtgärden inte bevarade ändringsdatum. Använd alternativet med försiktighet. Normalvärdet är av.

Synkronisera kataloger:

  Aktiverar "synkroniseringsläge" när två kataloger jämförs och ingen explicit målkatalog anges. I det här läget väljs föreslagna åtgärder så att båda källkatalogerna är likadana efteråt. Sammanfogningsresultatet skrivs också till båda kataloger. Normalvärdet är av.

Kopiera nyare istället för att sammanfoga:

  Istället för att sammanfoga kopierar den föreslagna åtgärden den nyare källan om ändringar har skett. (Anses vara osäkert, eftersom det betyder att man antar att den andra filen inte också har redigerats. Kontrollera för att vara säker i varje enskilt fall.) Normalvärdet är av.

Säkerhetskopiera filer:

  Om en fil eller hel katalog ersätts med en annan eller tas bort, då ändras originalversionens namn med tillägg av filändelsen ".orig". Om en gammal säkerhetskopia med filändelsen "orig" redan finns tas den bort utan säkerhetskopiering. Det här gäller också normal sammanfogning av enstaka filer, inte bara sammanfogningsläge för kataloger. Normalvärdet är på.

### Övriga funktioner

#### Delat eller fullskärmsläge

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 "Delad skärmvy" i menyn "Fönster" för att byta mellan fillistan och fönstren för textjämförelse, som då upptar hela fönstret.

#### Jämföra och sammanfoga en ensam fil

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 markerade filer" i menyn "Sammanfoga". 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: "Avsök igen" i menyn "Katalog".

## Diverse ämnen

### Nätverkstransparens via KIO

#### I/O-slavar

KDE stöder nätverkstransparens via I/O-slavar. KDiff3 använder dem för att läsa indatafiler och avsöka kataloger. Det betyder att du kan ange filer och kataloger på lokal- och fjärr-resurser via webbadresser.

Exempel:

    kdiff3 test.cpp  ftp://ftp.langtbortistan.org/test.cpp
       kdiff3 tar:/home/hackare/arkiv.tar.gz/kat ./kat

Den första raden jämför en lokal fil med en fil på en FTP-server. Den andra raden jämför en katalog i ett komprimerat arkiv med en lokal katalog.

Andra I/O-slavar som är intressanta är:

- Filer från WWW (http:),

- Filer från FTP (ftp:),

- Krypterad filöverföring (fish:, sftp:),

- Resurser från Windows (smb:),

- Lokala filer (file:),

Andra saker som är möjliga, men troligen mindre användbara, är:

- Manualsidor (man:),

- Infosidor (info:),

#### Hur man skriver webbadresser

En webbadress har en annorlunda syntax jämfört med sökvägar till lokala filer och kataloger. Vissa saker måste tas hänsyn till:

- En sökväg kan vara relativ, och kan innehålla "." eller "..". Det är inte möjligt för webbadresser, som alltid är absoluta.

- Specialtecken måste skrivas med särskilda "teckenföljder". ("#" -> "%23", mellanslag -> "%20", etc.) Till exempel skulle en fil med namnet "/#foo#" ha webbadressen "file:/%23foo%23".

- När webbadresser inte fungerar som väntat, försök att öppna dem i Konqueror först.

#### Möjligheter med I/O-slavar

Nätverkstransparens har en nackdel: Inte alla resurser har samma möjligheter.

Ibland beror det på serverns filsystem, ibland på protokollet. Här är en kort lista med begränsningar:

- Ibland finns det inget stöd för länkar.

- Eller finns det inget sätt att särskilja om en länk pekar på en fil eller katalog, då antas alltid en fil (ftp:, sftp:).

- Kan inte alltid avgöra filstorleken.

- Begränsat stöd för rättigheter.

- Ingen möjlighet att ändra rättigheter eller ändringstid, så rättigheter eller tiden för en kopia skiljer sig från originalet. (Se alternativet "Lita på storlek". Ändring av rättigheter eller ändringstid är bara möjligt för lokala filer.)

### Använda &kdiff3; som en Kpart

&kdiff3; är en Kpart. För närvarande implementeras gränssnittet KParts::ReadOnlyPart.

Den huvudsakliga användningen är för skillnadsvisning i KDevelop. KDevelop startar alltid den interna skillnadsvisningen först. För att använda KDiff3, klicka med höger musknapp i skillnadsvisningens fönster och välj "Visa i KDiff3-del" i den sammanhangsberoende menyn.

KDiff3 kräver normalt två fullständiga filer som indata. När det används som en del, antar KDiff3 att indatafilen är en programfixfil med unifierat format. KDiff3 hämtar därefter originalfilernas namn i programfixfilen. Åtminstone en av de två filerna måste vara tillgänglig. KDiff3 startar då kommandot `patch` för att återskapa den andra filen.

Du kan välja en programfixfil i Konqueror och välja "Förhandsgranska i" - "Kdiff3-del" i den sammanhangsberoende menyn. Var medveten om att det inte fungerar om ingen av originalfilerna finns tillgänglig, och är inte tillförlitligt om originalfilen eller filerna har ändrats sedan programfixfilen skapades.

När det kör som en Kpart tillhandahåller KDiff3 bara jämförelse mellan två filer, en mycket liten verktygsrad och meny. Sammanfogning eller katalogjämförelse stöds då inte.

## Vanliga frågor

&reporting.bugs; &updating.documentation;

Varför kallas det "KDiff3"?

Verktyg som heter "KDiff" och "KDiff2" (som nu kallas "Kompare") fanns redan. Dessutom ska "KDiff3" antyda att programmet kan sammanfoga som verktyget "diff3" från samlingen med diff-verktyg.

Varför licensieras det under GPL?

Jag har använt GPL-program under mycket lång tid nu, och lärt mig mycket genom att titta på en hel del av källkoden. Alltså är det här mitt "tack" till alla programmerare som också gjorde eller kommer att göra samma sak.

Vissa knappar och funktioner saknas. Vad är fel?

Du kompilerade från källkod, men angav troligen inte rätt KDE-prefix med configure. Normalt vill configure installera i /usr/local, men då kan inte KDE hitta resursfilerna för användargränssnittet (dvs. kdiff3ui.rc). Filen README innehåller mer information om riktigt prefix.

Ofta visas rader som är liknande men inte identiska intill varandra, men inte alltid. Varför?

Rader där bara antal blanktecken är olika behandlas som "lika", medan bara ett annorlunda blanktecken gör att raderna är "olika". Om liknande rader finns intill varandra, är detta i själva verket en slump men det är som tur är oftast fallet.

Varför måste alla konflikter vara lösta innan sammanfogningsresultatet kan sparas?

För varje likadant eller annorlunda avsnitt kommer editorn i fönstret med sammanfogningsresultatet ihåg var det börjar och slutar. Det behövs eftersom konflikter kan lösas upp manuellt genom att helt enkelt välja källknappen (A, B eller C). Informationen går förlorad när filen sparas som text, och det är för mycket ansträngning att skapa ett speciellt filformat som stöder att spara och återställa all nödvändig information.

Varför har inte editorn i resultatfönstret för sammanfogning en "ångra"-funktion?

Hittills har det varit för stor ansträngning. Du kan alltid återställa en version från en källa (A, B eller C) genom att klicka på motsvarande knapp. För större redigering, rekommenderas användning av en annan editor ändå.

När jag tog bort en del text, visades plötsligt "<Ingen källrad>" och det kan inte tas bort. Vad betyder det och hur kan man ta bort det?

För varje likadant eller annorlunda avsnitt kommer editorn i fönstret med sammanfogningsresultatet ihåg var det börjar och slutar. "<Ingen källrad>" betyder att det inte finns någonting kvar i ett avsnitt, inte ens ett nyradstecken. Detta kan inträffa antingen vid automatisk sammanfogning eller efter redigering. Det är inget problem, eftersom den här informationen inte finns med i den sparade filen. Om du vill ha tillbaka originalkällan, markera bara källan (klicka på sammanfattningskolumnen till vänster) och klicka därefter på källknappen med innehållet som önskas (A, B eller C).

Varför stöder inte KDiff3 syntaxfärgläggning?

KDiff3 använder redan många färger för färgläggning av jämförelser. Ytterligare färgläggning skulle vara förvirrande. Använd en annan editor för detta.

Det finns en stor mängd information här, men din fråga har ändå inte besvarats?

Skicka gärna din fråga till mig. Jag uppskattar alla kommentarer.

## Tack till och licens

&kdiff3;: Verktyg för jämförelser och sammanfogning av filer och kataloger

Program copyright 2002-2005 Joachim Eibl joachim.eibl snabela gmx.de

Flera häftiga idéer och felrapporter kom från kolleger och många personer ute i den Vida Vilda Världen. Tack!

Dokumentation Copyright © 2002-2005 Joachim Eibl joachim. eibl snabela gmx.de

Översättning Stefan Asserhällstefan.asserhall@comhem.se

&underFDL; &underGPL;

## Installation

### Hur man skaffar &kdiff3;

Du kan ladda ner senaste version av KDiff3 från hemsidan http://kdiff3.sourceforge.net.

KDiff3 är också tillgänglig för andra plattformar. Se hemsidan för detaljinformation.

### Krav

För att använda alla funktioner i &kdiff3; med lyckat resultat behöver du &kde; >3.1.

För information om hur KDiff3 kan köras på andra plattformar utan KDE, se hemsidan.

Du hittar en lista med ändringar på http://kdiff3.sourceforge.net/ChangeLog eller i filen "ChangeLog" i källkodspaketet.

### Kompilering och installation

För att kompilera och installera &kdiff3; på ett system med KDE, skriv in följande i baskatalogen för &kdiff3;s distribution:

    % ./configure --prefix=kde-katalog
    % make
    % make install

kde-katalog anger katalogen där KDE finns på systemet. Om du inte är säker, läs filen README för detaljinformation.

Eftersom &kdiff3; använder `autoconf` och `automake` bör du inte ha några problem med att kompilera det. Skulle du stöta på problem, var snäll rapportera dem till &kde;:s e-postlistor.

&documentation.index;