]> SeanWhellersean@inwords.co.za &erik.kjaer.pedersen.role; 2007 Sean Wheller &FDLNotice; 2007-01-20 3.4 &kompare; er et grafisk grænsefladeprogram som gør det muligt at vise og sammenflette forskelle mellem kildekodefiler. &kompare; kan bruges til at sammenligne forskelle mellem filer og indholdet i mapper. &kompare; understøtter en mængde forskellige sammenligningsformater, og sørger for mange tilvalg for at indstille informationsniveauet som vises. Dette dokument beskriver &kompare; version &version;. KDE Kompare Diff Sammenflet Programrettelse Blok Når to eller flere personer arbejder med en fil og sender den frem og tilbage mellem hinanden, bliver det svært at se hvilke ændringer der er gjort i en ny version eller kopi af filen. At åbne den nye kopi og originalen side om side i programmet som bruges til at oprette den er en løsning, men det er arbejdsomt, tidsforbrugende og fejlbehæftet. Det er der et program til at vis forskelle, afkortet til diff på engelsk, er nyttigt. Som man kan forvente sig, er et passende navn på et sådant program "diff". Det er sådan at programmet diff er installeret på de fleste &Linux;-baserede systemer, og bruges til nøjagtigt dette formål. Udviklere bruger ofte diff som et kommandolinjeværktøj for at vise forskelle mellem versioner af en kildekodefil. Imidlertid er brugen af diff ikke begrænset til at vise forskelle i kildekodefiler, det kan også bruges for mange andre tekstbaserede filtyper. At bruge diff på kommandolinjen kan være forvirrende. At lære sig diff-kommandoens syntaks og tolke uddata kan forvilde de fleste. Det er her &kompare; rykker ind. Det sørger for en grafisk grænseflade for diff-programmet som viser kilde- og målfiler side ved side med alle forskelle automatisk farvelagte. Fra dette udgangspunkt kan ændringer i en fil anvendes på den andre filen på en kontrolleret og styrbar måde. Alle ændringer behøver ikke at blive anvendt, og hvis du anvender en ændring kan den altid 'fortrydes'. Når alle nødvendige ændringer er anvendt, kan de gemmes og vises som sædvanligt i originalprogrammet som blev brugt til at oprette filen. Udover at vise forskelle mellem en kilde- og målfil, kan &kompare; bruges til at oprette og vise en særlig sammenligningfil som kaldes 'diff'. Denne fil samler forskellene mellem de to kilder i en enkelt fil som kan bruges til at vise og anvende ændringer i alle andre kopier af filen. Hvis to personer for eksempel redigerer et dokument, og den første vil udføre ændringer og kun sende ændringerne til den anden. Normalt skulle den første person så sende en fuldstændig kopi af det ændrede dokument til den anden, som så skulle sammenligne det ændrede dokument side om side med den uforandrede version. Processen for dette er stort set som vi beskrev i foregående paragraf. Med &kompare; ville den første person først lave en lokal kopi af filen som skal ændres, derefter udføre ændringerne og sammenligne originalen og den ændrede kopi. En sammenligningfil som kun indholder de ændringer som er gjort kan nu laves med &kompare;. Den kan sendes til den anden person i stedet for hele filen med ændringerne. Ved at bruge &kompare; kan den anden person kigge på sammenligningsfilen, sammenligne den med den lokale kopi af dokumentet og anvende ændringerne som er gjort af den første personen. Så kan processen fortsætte for mange dokumentversioner, hvor hver person laver ændringer, og laver sammenligningfiler som distribueres og anvendes. Denne proces kaldes ofte "patching" på engelsk, et udtryk som kommer fra programmet "patch", som er et andet kommandolinjeværktøj særligt konstrueret med det formål at anvende sammenligningfiler. Det sker sommetider at flere personer redigerer en fil samtidig. I dette tilfælde er det sandsynligt at de laver ændringer i dokumentet på nøjagtig samme linje. Dette forårsager et problem, eftersom de, uden forsigtighed, kunne ske at de overskriver hinandens arbejde når sammenligningfiler anvendes. Heldigvis tog udviklerne af programmerne diff og patch hensyn til dette, så værktøjerne tillader ikke at sådanne ændringer anvendes uden manuelt indgreb. Når denne tilstand er opstået, kaldes det for en "konflikt". &kompare; viser konflikter, så du kan løse dem manuelt, og bestemme hvilke ændringer som skal anvendes på hvilke filer. &kompare; er også et udmærket program til sammenligning af filændringer på mappeniveau. Når det bruges til at sammenligne mapper, undersøger &kompare; undermapper og deres filindhold rekursivt for at finde forskelle. I dette brugertilfælde åbnes automatisk alle filer hvor forskelle findes og listes af &kompare;, med mulighed for nemt navigere mellem de forskellige filer. Dette afsnit sørger for instruktioner om hvordan &kompare; startes, og tilbyder en hurtigtur af hovedgrænsefladen i &kompare;. En genvej for at starte &kompare; findes i K-menuen under programmering: Programmering Kompare. Når &kompare; startes, er det første som sker at en dialog vises hvor man kan vælge filer som skal sammenlignes. Særskilte indstillinger af sammenligningsegenskaber og dets udseende kan også vælges. Vælg en kilde og et mål at sammenligne i filformularen. Det kan være hvilke som helst to filer, mapper, eller en URL og en fil. Når kilden og målet er valgt, klik så på knappen Sammenlign. Så snart &kompare; har fundet forskellene, vises hovedgrænsefladen. Når to filer eller en URL og en fil sammenlignes, tager processen kun nogle få sekunder. Når mapper med mange undermapper og filer sammenlignes, kan processen dog tage en stund. For en forklaring af tilgængelige tilvalg fra diff og udseendefanebladet, se . Dette afsnit tilbyder en hurtigtur af hovedgrænsefladen, som består af følgende områder: Menuer Værktøjslinje Kilde- og målmapper Kilde- og målfiler Kilde- og mål-linjeændringer Kilde- og måltekstvisning Statuslinje &kompare; sørger for en menustyret grænseflade. Forklaring af menuerne og deres tilvalg findes i . Værktøjslinjen i &kompare; indholder genveje for de oftest brugte sammenlignings- og sammenfletningshandlinger. Værktøjslinjens orientering, tekstplacering, ikonstørrelse og hvilke ikoner som vises kan indstilles fra værktøjslinjens sammenhængsafhængige menu, som der er adgang til ved at højreklikke på værktøjslinjen med musen. Værktøjslinjens sammenhængsafhængige menu gør det også muligt at skjule værktøjslinjen. Hvis værktøjslinjen er skjult, og du vil vise den, vælges Opsætning Vis værktøjslinje. Ruderne med kilde- og målmappe viser mapperne hvor de sammenlignede filer findes. Når mange undermapper indgår i sammenligningen, vises det første dokument i en mappe som har en forskel mellem kilde og mål, når mappen vælges. Ruderne med kilde- og målfil viser filerne hvor en forskel er fundet for kilde- og målmapperne som for øjeblikket er valgte. Når en mappe har flere dokumenter som indeholder forskelle, listes alle dokumenter med forskelle. Det valgte dokument vises. Ruderne med kilde- og mållinjeændringer opsummerer ændringerne som blev fundet mellem nuværende kilde- og måldokument. Ved at markere en indgang i feltet farvelægges den og forskellen markeres. Dette er en nyttig måde at navigere og undersøge lange dokumenter med mange forskelle. Kilde- og målvisningen er hovedarbejdsfladen i &kompare;. Indholdet og farvelagte forskelle mellem kilde- og målfilerne som for øjeblikket er valgte vises her med linjenummer. Tekstvisningen vises normalt ikke. Den kan åbnes ved at vælge Opsætning Vis tekstvisning. Statuslinjen indholder en sammenfatning af nuværende kilde- og målfil eller mappe som sammenlignes. Statuslinjen rapporterer også antal ændringer som er fundet i nuværende dokument, og tæller de forskelle som er anvendt. Desuden viser statuslinjen det totale antal dokumenter som indeholder forskelle, og nuværende dokument som er valgt af disse. En sammenligning som gøres mellem to mapper kan eksempelvis returnere 1890 filer med forskelle. Dokumentet som for øjeblikket er valgt er nummer 18 af 1890. &kompare; viser kilde- og målfilen med lige store dele af hovedgrænsefladens arbejdsflade. Visningsområdet sørger for nogle funktioner som hjælper til med at optimere brugen af skærmfladen når forskelle vises, inklusive: Dobbelte rullebjælker Den mest åbenbare funktion er at der sørges for rullebjælker både til højre og længst nede i visningsområdet. Ved at bruge rullebjælkerne er det muligt hurtigt at flytte sig ved sammenligningen. Delt greb Det lodrette område mellem kilde-og målvisningen gør det ikke kun muligt nemt at se begyndelsen og slutningen af linjer i hver rude, men er desuden også et greb som gør det muligt at justere den procentuelle andel som bruges af kilde- og målvisningen som visningsfeltet består af. For at øge feltets størrelse for en af visningerne, holdes musen over grebet, tryk så museknappen ned og træk til venstre eller højre. Naturligvis mindskes tilgængelig flade for den modsatte felt når fladen for en rude øges, indenfor visningsfeltets område. Dokning Hovedarbejdsfladen kan frigøres fra hovedgrænsefladen ved at klikke på knappen længst oppe til højre i hovedarbejdsfladens rude. Dette åbner hovedarbejdsfladen i et eget vindue, hvilket gør det muligt at maksimere det og ændre dets størrelse på billedskærmen. Slå statuslinjen til og fra Statuslinjen i visningsfeltet kan slås fra eller til ved at vælge Opsætning Vis/Skjul statuslinje. Sommetider kan det være nyttigt at betragte filen som forskelle skal anvendes på som kilden. Hvis for eksempel to ændrede versioner af en fil sammenlignes, og det opdages at en fil har mange flere ændringer end den anden. Filen med flest ændringer ville være mere passende som kilde, eftersom færre ændringer så skal anvendes. Hvis dette er tilfældet, vælges Fil Skift kilde og mål. Det skifter filer som vises i alle ruder i &kompare;. Vælg Fil Vis statistik, for at få en hurtig oversigt af forskellene. Dette viser dialogen Sammenligningstatistik. Følgende information tilvejebringes: Gammel fil: Filnavnet på hvad som oftest er målfilen, eller filen som er uforandret, hvor forskelle vil blive anvendt. Ny fil: Filnavnet på hvad som oftest er kildefilen eller filen som er ændret. Format: Sammenligningformatet som bruges til at vis forskellen (se ). Antal blokke: Antal blokke fundet i sammenligningen. En blok er et antal linjer som er markeret som forskellige i kilde og mål, og kan indholde sammenhængslinjer afhængig af værdien af sammenligningformatet Sammenhæng (se ). Antal forskelle Det egentlige antal forskelle som er fundet, ikke antal blokke. En blok kan indeholde en eller flere forskelle når de ændrede linjers område og sammenhængslinjer for to eller flere ændringer overlapper. &kompare; muliggør hurtig navigation mellem forskelle på filniveau og mellem flere filer med forskelle når mappetræer sammenlignes. En forskel kan markeres ved at: klikke på en linje i feltet med linjeændringer for kilde og mål (længst oppe til højre i hovedvinduet). klikke på den farvelagte forskellen i visningsfeltet. gå gennem listede forskelle i en sammenligning (se ). Når en forskel er markeret, anses den for at være i fokus og vises med en stærkere farve end forskelle som ikke er markerede. Når en sammenligning finder mange forskelle, er en af de bedste måder at granske dem at gå gennem forskellene i en logisk rækkefølge, oftest oppefra og nedad. Normalt markerer &kompare; den første forskel som er fundet i en sammenligning. Ved at vælge Forskel Næste forskel (&Ctrl;Nedad) får forskellen som følger den nuværende fokus. For at markere forskellen inden den nuværende, vælges Forskel Foregående forskel (&Ctrl;Op). På denne måde er det muligt at gå gennem forskellene på en ordnet måde, og anvende eller fortryde forskelle under granskningen. Når en sammenligning gøres på mappeniveau, kan mange filer findes med forskelle. En fuldstændig liste af sammenlignede filer hvor forskelle er fundet, findes i felterne Kilde- og målmapper og Kilde- og målfiler. &kompare; viser imidlertid forskelle mellem kilde og mål med en sammenligning af gangen. For at skifte mellem dokumenter i dette scenario, er følgende tilvalg tilgængelige: Vælg feltet Kilde- og målmapper for at vise filforskelle som er fundet i feltet Kilde- og målfiler, vælg derefter en fil. Vælg ForskelForegående fil (&Ctrl;Page Up) eller Forskel Næste fil (&Ctrl;Page Down) for at vise foregående eller næste fil med forskelle som er fundet i feltet Kilde- og målfiler. &kompare; gør opgaven at anvende eller fortryde forskelle så enkel som blot at kun pege og klikke. Flere handlinger for at anvende eller fortryde kan udføres med en forskel eftersom alle handlinger udføres i hukommelsen og skrives ikke i filen på disken førend der gemmes. Klik på den farvelagte forskel, vælg derefter Forskel Anvend forskel (Mellemrum) for at anvende en forskel. Klik på den farvelagte forskel som tidligere blev anvendt, vælg derefter Forskel Fortryd anvendt forskel (Backspace) for at fortryde en anvendt forskel. Efter at have gransket forskelle mellem filer og set at alle er acceptable, er det muligt at anvende alle med en enkelt handling ved at vælge Forskel Anvend alle (&Ctrl;A). Vælg Forskel Fortryd anvend alle (&Ctrl;U) for forskelle som er anvendt. Når forskelle er anvendt kan de gemmes ved at vælge Fil Gem eller FilGem alle.... Anvendte forskelle gemmes i både kilde- og målfilen. Sammenligningsfiler indholder kun ændringerne som er gjort mellem filer, eller et sæt filer i et mappesystem, og har mulighed for at indeholde et antal sammenhængslinjer før og efter hver ændret linje. Summen af en linjeændring og dets sammenhængslinjer kaldes en blok. En sammenligningfil kan derfor indeholde flere blokke fra en eller flere filer. Når sammenhængslinjerne for en eller flere blokke overlapper, anses de for at være en enkelt blok. Sammenligningfiler kan bruges til at: Anvende forskelle fra blokken på en originalfil. Anvende forskelle fra blokken på en fil eller et sæt originalfiler inde i et mappesystem. Ændret inden anvendelse på en originalfil eller et sæt originalfiler inde i et mappesystem. For at oprette en sammenligningfil skal en sammenligning vises i &kompare;. Under antagelse af at dette er tilfældet, vælges Fil Gem .diff. Det viser dialogen Sammenligningstilvalg (se for mere information om sammenligningformater og tilvalg). Når disse tilvalg er indstillet, klik på knappen Gem og gem sammenligningen i en fil med filendelsen .diff. Det er muligt at vise indholdet i en sammenligningsfil i &kompare; ved at åbne sammenligningfilen med Fil Åbn sammenligning... Når en sammenligningsfil betragtes, vises blokken mellem kilde- og målfilen. Husk at kun blokken vises, ingen uforandrede linjer vises. I visse tilfælde skabes en sammenligningsfil uden nogen sammenhængslinjer. I disse tilfælde vises kun de ændrede linjer. Når en sammenligningfil indholder blokke fra flere filer, viser &kompare; en blok fra hver fil af gangen, og du kan skifte mellem filer som om de var rigtige filer, også selvom denne information kun sørges for af sammenligningfilens indhold. Når forskelle i en sammenligningfil betragtes, er det muligt at anvende forskelle som du ville gøre det når kilde- og målfiler sammenlignes (se ). I tilfældet hvor en sammenligningfil sørges for er det muligt at sammenligne blokken i sammenligningsfilen med en fil eller mappe. For at gøre dette, vælges Fil Bland URL med sammenligning.... Indtast derefter søgestier for Fil eller mappe og Sammenligningsuddata. Når forskelle mellem en kildefil og en sammenligningfil betragtes, er det muligt at anvende forskelle som du ville gøre det når kilde- og målfiler sammenlignes (se ). &kompare; gør det muligt for brugere at indstille visningsindstillinger for formatering af forskelle i hovedgrænsefladen, og indstille egenskaber for opførslen af diff-programmet. Dialogen Opsætning kan man komme til ved at vælge Opsætning Indstil &kompare;.... Vælg punktet Vis for at indstille udseendeindstillinger (se ). Vælg punktet Sammenlign for at indstille programegenskaber for diff-programmet (se ). Siden Vis i dialogen Opsætning viser fanebladene Udseende og Skrifttype. Fanebladet Udseende sørger for indstillinger for at håndtere Farver som bruges til at angive forskelle i hovedgrænsefladen, opførslen af Mushjulet når det bevæges opad og nedad, og hvordan konverteringen Tabulatortegn til mellemrum udføres. Opsætning af udseende i &kompare; Opsætning af udseende i &kompare; Klik på farveknappen som viser dialogen Vælg farve for at justere farvetilvalg for følgende tilstande: Farve for fjernet Linjer som er fjernet, ikke findes, fra kilde til mål. Farve for ændret Linjer som er ændret, fra kilde til mål. Farve for tilføjet Linjer som er tilføjet fra kilde til mål. Farve for anvendt Noget af ovenstående tilstand hvor forskelle er anvendt mellem kilde og mål. Antal linjer Antal linjer som forskellene skal flyttes når musehjulet rulles fremad eller tilbage. Antal mellemrum som et tabulatortegn skal erstattes med Konvertér hvert tabulatortegn til n mellemrum. Skrifttypeindstillinger i &kompare; Skrifttypeindstillinger i &kompare; Vælg tegnfamilie og størrelse at bruge når forskelle vises. Menuen Sammenlign i dialogen Opsætning viser fanebladene Sammenlign, Format, Tilvalg og Undtag. Disse formularer kan bruges til at indstille egenskaber for opførslen af diff-programmet. Sammenligningsindstillinger i &kompare; Sammenligningsindstillinger i &kompare; Kommandoen som bruges til at køre diff-programmet (normalt diff). Formatindstillinger i &kompare; Formatindstillinger i &kompare; Justér tilvalg for Uddataformat og Sammenhængslinjer. Sammenhæng Sammenhængsformatet tilføjer flere linjer sammenhæng omkring linjer som er forskellige. Ed Programmet diff kan oprette kommandoer som styrer teksteditoren ed sådan at den første fil ændres til den anden. Historisk var dette det eneste uddataformatet som duede til automatisk at redigere en fil til en anden. Efter ankomsten af patch bruges dette næsten aldrig. Normal Det normale format viser linjer som adskiller sig uden nogen omgivende sammenhængslinjer. RCS Formatet RCS er særligt designet til brug af RCS (Revision Control System). Ligesom ed-formatet, bruges dette format sjældent efter programmet patch blev introduceret. Forenet Det forenede format er en variant af sammenhængsformatet. Det anses for at være bedre end sammenhængsformatet på grund af at uddata er mere kompakt end sammenhængsformatet, eftersom unødige sammenhængslinjer udelades. Side om side Brug formatet Side om side som viser filer listede i to søjler med et mellemrum mellem dem. Dette er kun tilgængeligt i dialogen Sammenligningstilvalg (se ). Antal sammenhængslinjer Når en sammenligning med sammenhængsformat eller forenet format udføres, bruges denne parameter til at styre antal sammenhængslinjer som inkluderes. Tilvalgsindstillinger i &kompare; Tilvalgsindstillinger i &kompare; Fanebladet Tilvalg gør det muligt at indstille tilvalg som understøttes af diff-programmet. Led efter mindre ændringer Tvinger sammenligningen til at vise ændringer af skifttilstand, tegnsætning, mellemrum, etc. om markeret. Optimér for store filer Skifter sammenligningen til at behandle filer med høj hastighed om markeret. Ignorér versalændringer Ændringer af små og store bogstaver undtages når dette er markeret. Ignorér regulært udtryk Ignorér linjer som matcher et regulært udtryk. Ekspandér tabulator-tegn til mellemrum ved uddata Hvis markeret, konverterer sammenligninguddata tabulatortegn til det antal mellemrum som er defineret af tilvalget Tabulatortegn til mellemrum på siden Vis i dialogen Opsætning. Ignorér tilføjede eller fjernede tomme linjer linjer med længden nul som adskiller sig mellem kilde og mål ignoreres når dette er markeret. Ignorér ændringer i blanke tegn Blanke tegn før, efter og mellem linjer kan ændres afhængig af forskellige editorer. Når dette er markeret ignoreres sådanne ændringer. Ignorér alle blanke tegn om markeret ignoreres forskelle i blanke tegn helt og holdent. Ignorér ændringer på grund af tabulator-ekspansion om markeret ignoreres blanke tegn forårsagede af tabulatortegn. Formularen Undtag muliggør brug af filtervalgmulighederne som der sørges for af sammenligningprogrammet. Undtagelsesindstillinger i &kompare; Undtagelsesindstillinger i &kompare; Filmønster at undtage Undtag filer baseret på filtrering med jokertegn Fil med filnavne at undtage Definér filtret baseret på indholdet i en eksternt håndteret fil. &Ctrl;O FilÅbn sammenligning... Viser dialogen Åbn. &Ctrl;C FilSammenlign filer... Viser dialogen Sammenlign filer eller mapper. &Ctrl;B FilBland URL med sammenligning... Viser dialogen Bland URL med sammenligning. &Ctrl;S FilGem Skriver de anvendte forskelle til nuværende kilde- og/eller målfil. FilGem alle Skriver anvendte forskelle til alle kilde- og/eller målfiler. FilGem .diff Viser dialogen Sammenligningstilvalg for at definere sammenligningsformater og tilvalg. FilSkift kilde og mål Skifter kilde og mål. FilVis statistik Viser dialogen Sammenligningstatistik. &Ctrl;Q FilAfslut Afslutter &kompare; &Ctrl;U ForskelFortryd anvend alle Fortryd alle forskelle som tidligere blev anvendt mellem kilde og mål. Backspace Forskel Fortryd anvendt forskel Fortryd en markeret forskel som tidligere er anvendt. Mellemrum Forskel Anvend forskel Anvend en markeret forskel. &Ctrl;A ForskelAnvende alle Anvend alle forskelle mellem kilde og mål. &Ctrl;Page Up ForskelForegående fil Gør foregående forskel i listen med forskelle til nuværende fil i visningsfeltet. &Ctrl;Page Down ForskelNæste fil Gør næste forskel i listen med forskelle til nuværende fil i visningsfeltet. &Ctrl;Op ForskelForegående forskel Markér forskellen ovenfor forskellen som for øjeblikket er markeret. &Ctrl;Ned ForskelNæste forskel Markér forskellen under forskellen som for øjeblikket er markeret. Opsætning Vis/Skjul værktøjslinje Slå til eller fra for visning af værktøjslinjen. Opsætning Vis/Skjul statuslinje Slå til eller fra for visning af statuslinjen. Opsætning Vis tekstvisning Viser feltet Tekstvisning. Opsætning Indstil genveje... Vis dialogen Indstil genveje. OpsætningIndstil værktøjslinjer... Vis Indstil værktøjslinje. Opsætning Indstil &kompare;... Vis dialogen Opsætning i &kompare;. &help.menu.documentation; &kompare; Program ophavsret 2001-2004, &John.Firebaugh; &John.Firebaugh.mail; og Otto Bruggemanotto.bruggeman@home.nl Dokumentation ophavsret © 2007 Sean Wheller sean@inwords.co.za &erik.kjaer.pedersen.credit; &underFDL; &underGPL; &install.intro.documentation; &install.compile.documentation; &documentation.index;