]> Handbok &kompare; SeanWhellersean@inwords.co.za Stefan Asserhäll
stefan.asserhall@comhem.se
Översättare
2007 Sean Wheller &FDLNotice; 2007-01-20 3.4 &kompare; är ett grafiskt gränssnittsprogram som gör det möjligt att visa och sammanfoga skillnader mellan källkodsfiler. &kompare; kan användas för att jämföra skillnader mellan filer och innehållet i kataloger. &kompare; stöder en mängd olika jämförelseformat, och tillhandahåller många alternativ för att anpassa informationsnivån som visas. Detta dokument beskriver &kompare; version &version;. KDE Kompare Diff Sammanfoga Programfix Block
Inledning Om två eller flera personer arbetar med en fil och skickar den fram och tillbaka mellan varandra, blir det svårt att se vilka ändringar som har gjorts i en ny version eller kopia av filen. Att öppna den nya kopian och originalet sida vid sida i programmet som används för att skapa det är en lösning, men det är arbetsamt, tidsödande, och felbenäget. Det är då ett program för att visa skillnader, avkortat till diff på engelska, är användbart. Som man kan vänta sig, är ett lämpligt namn på ett sådant program "diff". Det råkar vara så att programmet diff är installerat på de flesta &Linux;-baserade system, och används för exakt detta syfte. Utvecklare använder ofta diff som ett kommandoradsverktyg för att visa skillnader mellan versioner av en källkodsfil. Dock är inte användningen av diff begränsat till att visa skillnader i källkodsfiler, det kan också användas för många andra textbaserade filtyper. Att använda diff på kommandoraden kan vara förvirrande. Att lära sig diff-kommandots syntax och dechiffrera utmatningen kan förvilla de flesta. Det är då &kompare; rycker in. Det tillhandahåller ett grafiskt gränssnitt för diff-programmet som visar käll- och målfiler sida vid sida med alla skillnader automatiskt färglagda. Från den utgångspunkten kan ändringar i en fil appliceras i den andra filen på ett kontrollerat och styrbart sätt. Alla ändringar behöver inte appliceras, och om du applicerar en ändring kan den alltid 'ångras'. När alla nödvändiga ändringar har applicerats, kan de sparas och visas som vanligt i originalprogrammet som användes för att skapa filen. Förutom att visa skillnader mellan en käll- och målfil, kan &kompare; användas för att skapa och visa en särskild jämförelsefil som kallas 'diff'. Filen samlar skillnaderna mellan de två källorna i en enda fil som kan användas för att visa och applicera ändringar i alla andra kopior av filen. Om två personer till exempel redigerar ett dokument, och den första vill göra ändringar och bara skicka ändringarna till den andra. Normalt skulle den första personen då skicka en fullständig kopia av det ändrade dokumentet till den andra, som då skulle behöva jämföra det ändrade dokumentet sida vid sida med den oförändrade versionen. Processen för detta är i stort sett som vi beskrivit i föregående stycke. Med &kompare; skulle den första personen först göra en lokal kopia av filen som ska ändras, därefter göra ändringarna och jämföra originalet och den ändrade kopian. En jämförelsefil som bara innehåller ändringarna som gjorts kan nu skapas med &kompare;. Den kan skickas till den andra personen istället för hela filen med ändringarna. Genom att använda &kompare; kan den andra personen titta på jämförelsefilen, jämföra den med den lokala kopian av dokumentet och applicera ändringarna som gjorts av den första personen. Så kan processen fortsätta för många dokumentversioner, där varje person gör ändringar, och skapar jämförelsefiler som distribueras och appliceras. Processen kallas ofta "patching" på engelska, ett uttryck som kommer från programmet "patch", som är ett annat kommandoradsverktyg särskilt konstruerat med syftet att applicera jämförelsefiler. Det inträffar ibland att flera personer redigerar en fil samtidigt. I detta fall är det troligt att de gör ändringar i dokumentet på exakt samma rad. Det orsakar ett problem, eftersom det, utan försiktighet, skulle gå att skriva över varandras arbete när jämförelsefiler appliceras. Som tur är tog utvecklarna av programmen diff och patch hänsyn till det, så verktygen tillåter inte att sådana ändringar appliceras utan manuellt ingripande. När detta tillstånd har uppstått, kallas det för en "konflikt". &kompare; visar konflikter, så att du kan lösa upp dem manuellt, och bestämma vilka ändringar som ska appliceras i vilka filer. &kompare; är också ett utmärkt program för jämförelse av filändringar på katalognivå. När det används för att jämföra kataloger, undersöker &kompare; underkataloger och deras filinnehåll rekursivt för att hitta skillnader. I detta användarfall öppnas automatiskt alla filer där skillnader hittas och listas av &kompare;, med möjlighet att enkelt navigera mellan de olika filerna. Använda &kompare; Komma igång Det här avsnittet tillhandahåller instruktioner om hur &kompare; startas, och erbjuder en snabbtur av huvudgränssnittet i &kompare;. Starta &kompare; En genväg för att starta &kompare; finns i K-menyn under programmering: Programmering Kompare. När &kompare; startas, är det första som händer att en dialogruta visas där man kan välja filer som ska jämföras. Särskilda inställningar av jämförelsens egenskaper och dess utseende kan också väljas. Välj en källa och ett mål att jämföra i filformuläret. Det kan vara vilka två filer som helst, kataloger, eller en webbadress och en fil. När källan och målet väl är valda, klicka på knappen Jämför. Så fort &kompare; har hittat skillnaderna, visas huvudgränssnittet. När två filer eller en webbadress och en fil jämförs, tar processen bara några få sekunder. När kataloger med många underkataloger och filer jämförs, kan processen dock ta en stund. För en förklaring av tillgängliga alternativ från diff och utseendefliken, se . Huvudgränssnittet Det här avsnittet erbjuder en snabbtur av huvudgränssnittet, som består av följande områden: Menyer Verktygsrad Käll- och målkataloger Käll- och målfiler Käll- och målradändringar Käll- och måltextvy Statusrad Menyer &kompare; tillhandahåller ett menystyrt gränssnitt. Förklaring av menyerna och deras alternativ tillhandahålls i . Verktygsrad Verktygsraden i &kompare; innehåller genvägar för de oftast använda jämförelse- och sammanfogningsåtgärderna. Verktygsradens orientering, textplacering, ikonstorlek och vilka ikoner som visas kan anpassas från verktygsradens sammanhangsberoende meny, som kan kommas åt genom att högerklicka på verktygsraden med musen. Verktygsradens sammanhangsberoende meny gör det också möjligt att dölja verktygsraden. Om verktygsraden är dold, och du vill visa den, välj Inställningar Visa verktygsrad. Käll- och målkataloger Rutorna med käll- och målkatalog visar katalogerna där de jämförda filerna finns. När många underkataloger ingår i jämförelsen, visas det första dokumentet i en katalog som har en skillnad mellan källa och mål, när katalogen väljes. Käll- och målfiler Rutorna med käll- och målfil visar filerna där en skillnad hittades för käll- och målkatalogerna som för närvarande är valda. När en katalog har flera dokument som innehåller skillnader, listas alla dokument med skillnader. Det valda dokumentet visas. Käll- och målradändringar Rutorna med käll- och målradändringar summerar ändringarna som hittades mellan nuvarande käll- och måldokument. Genom att markera en post i rutan färgas och markeras skillnaden. Det är ett användbart sätt att navigera och inspektera långa dokument med många skillnader. Käll- och målvy Käll- och målvyn är huvudarbetsytan i &kompare;. Innehållet och färglagda skillnader mellan käll- och målfilerna som för närvarande är valda visas här med radnummer. Textvy Textvyn visas normalt inte. Den kan öppnas genom att välja Inställningar Visa textvy. Statusrad Statusraden innehåller en sammanfattning av nuvarande käll- och målfil eller katalog som jämförs. Statusraden rapporterar också antal ändringar som hittats i nuvarande dokument, och räknar skillnader som har applicerats. Dessutom visar statusraden det totala antalet dokument som innehåller skillnader, och nuvarande dokument som är valt av dessa. En jämförelse som görs mellan två kataloger kan exempelvis returnera 1890 filer med skillnader. Dokumentet som för närvarande är valt är nummer 18 av 1890. Visa skillnader Hantera skärmytan &kompare; visar käll- och målfilen med lika stor del av huvudgränssnittets arbetsyta. Vyområdet tillhandahåller några funktioner som hjälper till att optimera användningen av skärmytan när skillnader visas, inklusive: Dubbla rullningslister Den mest uppenbara funktionen är att rullningslister tillhandahålls både till höger och längst ner i vyområdet. Genom att använda rullningslisterna är det möjligt att snabbt flytta sig genom jämförelsen. Delat grepp Det vertikala området mellan käll-och målvyn gör det inte bara möjligt att enkelt se början och slutet av rader i varje ruta, utan är också ett grepp som gör det möjligt att justera den procentuella andelen som används av käll- och målvyn som vyrutan består av. För att öka rutans storlek för en av vyerna, håll musen över greppet, tryck ner musknappen och dra åt vänster eller höger. Naturligtvis minskar tillgänglig yta för den motsatta rutan när ytan för en ruta ökas, inuti vyrutans område. Dockning Huvudarbetsytan kan kopplas ifrån huvudgränssnittet genom att klicka på knappen längst upp till höger i huvudarbetsytans ruta. Det öppnar huvudarbetsytan i ett eget fönster, vilket gör det möjligt att maximera det och ändra dess storlek på bildskärmen. Växla statusraden Statusraden i vyrutan kan stängas av eller sättas på genom att välja Inställningar Visa/Dölj statusrad. Byta käll- och målvy Ibland kan det vara användbart att betrakta filen som skillnader ska appliceras i som källan. Om till exempel två ändrade versioner av en fil jämförs, och det upptäcks att en fil har många fler ändringar än den andra. Filen med flest ändringar vore lämpligare som källa, eftersom färre ändringar då måste appliceras. Om det är fallet, välj Arkiv Byt källa och mål. Det byter filer som visas i alla rutor i &kompare;. Visa jämförelsestatistik Välj Arkiv Visa statistik, för att få en snabb översikt av skillnaderna. Det visar dialogrutan Jämförelsestatistik. Följande information tillhandahålls: Gammal fil: Filnamnet på vad som oftast är målfilen, eller filen som är oförändrad, där skillnader kommer att appliceras. Ny fil: Filnamnet på vad som oftast är källfilen eller filen som är ändrad. Format: Jämförelseformatet som används för att visa skillnaden (se ). Antal block: Antal block hittade i jämförelsen. Ett block är ett antal rader som har markerats som olika i källa och mål, och kan innehålla sammanhangsrader beroende på värdet hos jämförelseformatet Sammanhang (se ). Antal skillnader Det verkliga antal skillnader som hittats, inte antal block. Ett block kan innehålla en eller flera skillnader när de ändrade radernas intervall och sammanhangsrader för två eller flera ändringar överlappar. Navigera i jämförelsevyn &kompare; möjliggör snabb navigation mellan skillnader på filnivå och mellan flera filer med skillnader när katalogträd jämförs. Markera en skillnad En skillnad kan markeras genom att: klicka på en rad i rutan med radändringar för källa och mål (längst upp till höger i huvudfönstret). klicka på den färglagda skillnaden i vyrutan. gå igenom listade skillnader i en jämförelse (se ). När en skillnad är markerad, anses den vara i fokus och visas med en starkare färg än skillnader som inte är markerade. Gå igenom skillnader När en jämförelse hittar många skillnader, är ett av de bästa sätten att granska dem att gå igenom skillnaderna i en logisk ordning, oftast uppifrån och neråt. Normalt markerar &kompare; den första skillnaden som hittats i en jämförelse. Genom att välja Skillnad Nästa skillnad (&Ctrl;Ner) får skillnaden som följer den nuvarande fokus. För att markera skillnaden innan den nuvarande, välj Skillnad Föregående skillnad (&Ctrl;Upp). På så sätt är det möjligt att gå igenom skillnaderna på ett ordnat sätt, och applicera eller ångra skillnader under granskningen. Byta mellan filer När en jämförelse görs på katalognivå, kan många filer hittas med skillnader. En fullständig lista av jämförda filer där skillnader hittades, tillhandahålls i rutorna Käll- och målkataloger och Käll- och målfiler. &kompare; visar dock skillnader mellan källa och mål med en jämförelse åt gången. För att byta mellan dokument i detta scenario, är följande alternativ tillgängliga: Välj rutan Käll- och målkataloger för att visa filskillnaders som hittades i rutan Käll- och målfiler, välj därefter en fil. Välj SkillnadFöregående fil (&Ctrl;Page Up) eller Skillnad Nästa fil (&Ctrl;Page Down) för att visa föregående eller nästa fil med skillnader som hittats i rutan Käll- och målfiler. Sammanfoga skillnader &kompare; gör uppgiften att applicera eller ångra skillnader så enkel som att bara peka och klicka. Flera åtgärder för att applicera eller ångra kan utföras med en skillnad eftersom alla åtgärder utförs i minnet och skrivs inte i filen på disk förrän spara utförs. Applicera en skillnad Klicka på den färglagda skillnaden, välj därefter Skillnad Applicera skillnad (Mellanslag) för att applicera en skillnad. Ångra en skillnad Klicka på den färglagda skillnaden som tidigare applicerades, välj därefter Skillnad Ångra applicerad skillnad (Backsteg) för att ångra en applicerad skillnad. Applicera alla skillnader Efter att ha granskat skillnader mellan filer och sett att alla är acceptabla, är det möjligt att applicera alla med en enda åtgärd genom att välja Skillnad Applicera alla (&Ctrl;A). Ångra alla skillnader Välj Skillnad Ångra applicera alla (&Ctrl;U) för skillnader som har applicerats. Spara ändringar När skillnader väl har applicerats kan de sparas genom att välja Arkiv Spara eller ArkivSpara alla.... Applicerade skillnader sparas i både käll- och målfilen. Arbeta med diff-filer Jämförelsefiler innehåller bara ändringarna som gjorts mellan filer, eller en uppsättning filer i ett katalogsystem, och har möjlighet att innehålla ett antal sammanhangsrader före och efter varje ändrad rad. Summan av en radändring och dess sammanhangsrader kallas ett block. En jämförelsefil kan därför innehålla flera block från en eller flera filer. När sammanhangsraderna för ett eller flera block överlappar, anses de vara ett enda block. Jämförelsefiler kan användas för att: Applicera skillnader från blocken i en originalfil. Applicera skillnader från blocken i en fil eller en uppsättning originalfiler inne i ett katalogsystem. Ändrad innan applicerad i en originalfil eller en uppsättning originalfiler inne i ett katalogsystem. Skapa en jämförelse För att skapa en jämförelsefil måste en jämförelse visas i &kompare;. Med antagandet att det är fallet, välj Arkiv Spara .diff. Det visar dialogrutan Jämförelsealternativ (se för mer information om jämförelseformat och alternativ). När dessa alternativ har ställts in, klicka på knappen Spara och spara jämförelsen i en fil med filändelsen .diff. Visa en jämförelse Det är möjligt att visa innehållet i en jämförelsefil i &kompare; genom att öppna jämförelsefilen med Arkiv Öppna jämförelse... När en jämförelsefil betraktas, visas blocken mellan käll- och målfilen. Kom ihåg att bara blocken visas, inga oförändrade rader visas. I vissa fall skapas en jämförelsefil utan några sammanhangsrader. I dessa fall visas bara de ändrade raderna. När en jämförelsefil innehåller block från flera filer, visar &kompare; block från varje fil åt gången, och du kan byta mellan filer som om de vore riktiga filer, även om denna information bara tillhandahålls av jämförelsefilens innehåll. Applicerar skillnader i en jämförelsefil När skillnader i en jämförelsefil betraktas, är det möjligt att applicera skillnader som du skulle göra när käll- och målfiler jämförs (se ). Foga ihop en webbadress med en jämförelse I fallet när en jämförelsefil tillhandahålls är det möjligt att jämföra blocken i jämförelsefilen med en fil eller katalog. För att göra det, välj Arkiv Foga ihop webbadress med jämförelse.... Mata därefter in sökvägar för Fil eller katalog och Jämförelseutmatning. När skillnader mellan en källfil och en jämförelsefil betraktas, är det möjligt att applicera skillnader som du skulle göra när käll- och målfiler jämförs (se ). Anpassa inställningar &kompare; gör det möjligt för användare att ställa in visningsinställningar för formatering av skillnader i huvudgränssnittet, och ställa in egenskaper för beteendet hos diff-programmet. Dialogrutan Inställningar kan kommas åt genom att välja Inställningar Anpassa &kompare;.... Välj alternativet Visa för att ställa in utseendeinställningar (se ). Välj alternativet Jämför för att ställa in programegenskaper för diff-programmet (se ). Visningsinställningar Sidan Visa i dialogrutan Inställningar visar flikarna Utseende och Teckensnitt. Utseende Fliken Utseende tillhandahåller inställningar för att hantera Färger som används för att ange skillnader i huvudgränssnittet, beteendet hos Mushjulet när det rörs uppåt och neråt, och hur konverteringen Tabulatortecken till mellanslag utförs. Inställningar av utseende i &kompare; Inställningar av utseende i &kompare; Färggrupp Klicka på färgknappen som visar dialogrutan Välj färg för att justera färgalternativ för följande tillstånd: Färg för borttaget Rader som har tagits bort, inte finns, från källa till mål. Färg för ändrat Rader som har ändrats, modifierats, från källa till mål. Färg för tillagt Rader som har lagts till från källa till mål. Färg för applicerat Något av ovanstående tillstånd där skillnader har applicerats mellan källa och mål. Mushjulet Antal rader Antal rader som skillnaderna ska flyttas när mushjulet rullas framåt eller bakåt. Tabulatortecken till mellanslag Antal mellanslag som ett tabulatortecken ska ersättas med Konvertera varje tabulatortecken till n mellanslag. Teckensnitt Teckensnittsinställningar i &kompare; Teckensnittsinställningar i &kompare; Välj teckenfamilj och storlek att använda när skillnader visas. Jämförelseinställningar Sidan Jämför i dialogrutan Inställningar visar flikarna Jämför, Format, Alternativ och Undantag. Flikarna kan användas för att ställa in egenskaper för beteendet hos diff-programmet. Jämför Jämförelseinställningar i &kompare; Jämförelseinställningar i &kompare; Kommandot som används för att köra diff-programmet (normalt diff). Format Formatinställningar i &kompare; Formatinställningar i &kompare; Justera alternativ för Utmatningsformat och Sammanhangsrader. Utmatningsformat Sammanhang Sammanhangsformatet lägger till flera rader sammanhang omkring raderna som skiljer sig åt. Ed Programmet diff kan skapa kommandon som styr texteditorn ed så att den första filen ändras till den andra. Historiskt var detta det enda utmatningsformatet som lämpade sig för att automatiskt redigera en fil till en annan. Efter ankomsten av patch används alternativet nästan aldrig. Normal Det normala formatet visar rader som skiljer sig utan några omgivande sammanhangsrader. RCS Formatet RCS är särskilt framtaget för användning av RCS (Revision Control System). Liksom ed-formatet, används detta format sällan efter programmet patch introducerades. Förenat Det förenade formatet är en variant av sammanhangsformatet. Det anses bättre än sammanhangsformatet på grund av att utdata är kompaktare än sammanhangsformatet, eftersom onödiga sammanhangsrader utelämnas. Sida vid sida Använd formatet Sida vid sida som visar filer listade i två kolumner med ett mellanrum mellan dem. Alternativet är bara tillgängligt i dialogrutan Jämförelsealternativ (se ). Sammanhangsrader Antal sammanhangsrader När en jämförelse med sammanhangsformat eller förenat format utförs, används denna parameter för att styra antal sammanhangsrader som inkluderas. Alternativ Alternativinställningar i &kompare; Alternativinställningar i &kompare; Fliken Alternativ gör det möjligt att anpassa alternativ som stöds av diff-programmet. Allmänt Leta efter mindre ändringar Tvingar jämförelsen att visa ändringar av skiftläge, interpunktion, mellanslag, etc. om markerad. Optimera för stora filer Byter jämförelsen till att behandla filer med hög hastighet om markerad. Ignorera skiftläge Ändringar av små och stora bokstäver undantas när alternativet är markerat. Ignorera reguljärt uttryck Ignorera reguljärt uttryck Ignorera rader som matchar ett reguljärt uttryck. Blanktecken Expandera tabulator-tecken till mellanslag vid utmatning Om markerad, konverterar jämförelseutmatning tabulatortecken till det antal mellanslag som är definierat av alternativet Tabulatortecken till mellanslag på sidan Visa i dialogrutan Inställningar. Ignorera tillagda eller borttagna tomma rader rader med längden noll som skiljer sig mellan källa och mål ignoreras när alternativet är markerat. Ignorera ändringar i blanktecken Blanktecken innan, efter och mellan rader kan ändras beroende på olika editorer. När alternativet är markerat ignoreras sådana ändringar. Ignorera alla blanktecken om markerad ignoreras skillnader i blanktecken helt och hållet. Ignorera ändringar på grund av tabulator-expansion om markerad ignoreras blanktecken orsakade av tabulatortecken. Undantag Formuläret Undantag möjliggör användning av filteralternativen som tillhandahålls av jämförelseprogrammet. Undantagsinställningar i &kompare; Undantagsinställningar i &kompare; Filmönster att undanta Filmönster att undanta Undanta filer baserat på filtrering med jokertecken Fil med filnamn att undanta Fil med filnamn att undanta Definiera filtret baserat på innehållet i en externt hanterad fil. Kommandoreferens Menyn <guimenu >Arkiv</guimenu > &Ctrl;O ArkivÖppna jämförelse... Visar dialogrutan Öppna. &Ctrl;C ArkivJämför filer... Visar dialogrutan Jämför filer eller kataloger. &Ctrl;B ArkivFoga ihop webbadress med jämförelse... Visar dialogrutan Foga ihop webbadress med jämförelse. &Ctrl;S ArkivSpara Skriver applicerade skillnader till nuvarande käll- och/eller målfil. ArkivSpara alla Skriver applicerade skillnader till alla käll- och/eller målfiler. ArkivSpara .diff Visar dialogrutan Jämförelsealternativ för att definiera jämförelseformat och alternativ. ArkivByt källa och mål Byter källa och mål. ArkivVisa statistik Visar dialogrutan Jämförelsestatistik. &Ctrl;Q ArkivAvsluta Avslutar &kompare; Menyn <guimenu >Skillnad</guimenu > &Ctrl;U SkillnadÅngra applicera alla Ångra alla skillnader som tidigare applicerades mellan källa och mål. Backsteg Skillnad Ångra applicerad skillnad Ångra en markerad skillnad som tidigare applicerades. Mellanslag Skillnad Applicera skillnad Applicera en markerad skillnad. &Ctrl;A SkillnadApplicera alla Applicera alla skillnader mellan källa och mål. &Ctrl;Page Up SkillnadFöregående fil Gör föregående skillnad i listan med skillnader till aktuell fil i vyrutan. &Ctrl;Page Down SkillnadNästa fil Gör nästa skillnad i listan med skillnader till aktuell fil i vyrutan. &Ctrl;Upp SkillnadFöregående skillnad Markera skillnaden ovanför skillnaden som för närvarande är markerad. &Ctrl;Ner SkillnadNästa skillnad Markera skillnaden under skillnaden som för närvarande är markerad. Menyn <guimenu >Inställningar</guimenu > Inställningar Visa/Dölj verktygsrad Sätt på eller stäng av visning av verktygsraden. Inställningar Visa/Dölj statusrad Sätt på eller stäng av visning av statusraden. Inställningar Visa textvy Visar rutan Textvy. Inställningar Anpassa genvägar... Visa dialogrutan Anpassa genvägar. InställningarAnpassa verktygsrader... Visa Anpassa verktygsrad. Inställningar Anpassa &kompare;... Visa dialogrutan Inställningar i &kompare;. Menyn <guimenu >Hjälp</guimenu > &help.menu.documentation; Tack till och licens &kompare; Program copyright 2001-2004, &John.Firebaugh; &John.Firebaugh.mail; och Otto Bruggemanotto.bruggeman@home.nl Dokumentation Copyright © 2007 Sean Wheller sean@inwords.co.za Översättning Stefan Asserhäll stefan.asserhall@comhem.se &underFDL; &underGPL; Installation Hur man skaffar &kompare; &install.intro.documentation; Kompilering och installation &install.compile.documentation; &documentation.index;