From b86570f63e533abcbcb97c2572e0e5732a96307b Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Sat, 27 Apr 2024 11:40:31 +0200 Subject: Adding upstream version 1.20.13. Signed-off-by: Daniel Baumann --- man/sv/dpkg-source.pod | 929 +++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 929 insertions(+) create mode 100644 man/sv/dpkg-source.pod (limited to 'man/sv/dpkg-source.pod') diff --git a/man/sv/dpkg-source.pod b/man/sv/dpkg-source.pod new file mode 100644 index 0000000..f898223 --- /dev/null +++ b/man/sv/dpkg-source.pod @@ -0,0 +1,929 @@ + + ***************************************************** + * GENERATED FILE, DO NOT EDIT * + * THIS IS NO SOURCE FILE, BUT RESULT OF COMPILATION * + ***************************************************** + +This file was generated by po4a(7). Do not store it (in VCS, for example), +but store the PO file used as source file by po4a-translate. + +In fact, consider this as a binary, and the PO file as a regular .c file: +If the PO get lost, keeping this translation up-to-date will be harder. + +=encoding UTF-8 + +=head1 NAMN + +dpkg-source - Verktyg för att manipulera Debiankällkodspaket (.dsc) + +=head1 SYNOPS + +B [I...] I<åtgärd> + +=head1 BESKRIVNING + +B packar och packar upp Debiankällkodsarkiv. + +Inga av dessa kommandon tillåter att flera flaggor kombineras till ett, och +de tillåter inte att värdet på en flagga anges som ett separat argument. + +=head1 KOMMANDON + +=over + +=item B<-x>, B<--extract> I.dsc [I] + +Extrahera ett källkodspaket (B<--extract> sedan dpkg 1.17.14). Ett argument +som inte är en flagga måste anges, namnet på debiankällkodsstyrfilen +(B<.dsc>). Ett valfritt andra argument som inte är en flagga kan anges för +att bestämma vilken katalog källkoden ska packas upp i, det får inte +existera. Om du inte anger någon utdatakatalog extraheras källkodspaketet +till en katalog som heter I-I i den aktuella +arbetskatalogen. + +B läser namnen på de övriga filer som ingår i källkodspaketet +från styrfilen; de antas vara i samma katalog som B<.dsc>-filen. + +Filerna i det extraherade paketet kommer att ha behörighet och ägare satta +till det som kunde förväntas om filerna och katalogerna bara hade skapats - +kataloger och körbara filer kommer ha 0777 och enkla filer 0666, båda +modifierade av uppackarens umask; om föräldrakatalogen är setgid kommer de +extraherade katalogerna också att vara det, och samtliga filer och kataloger +kommer ärva dess gruppägarskap. + +Om källkodspaketet använder ett annat format än standardformatet (gäller för +närvarande alla format förutom ”1.0”), kommer dess namn att lagras som +B så att det används som standard när källkodspaketet +byggs på nytt. + +=item B<-b>, B<--build> I [I] + +Bygg ett källkodpaket (B<--build> sedan dpkg 1.17.14). Det första argumentet +som inte är en flagga tas som namn på katalogen som innehåller det +debianiserade källkodsträdet (dvs. med underkatalogen ”debian” och kanske +ändringar på originalfilerna). Beroende på vilket källkodspaketformat som +används för att bygga formatet kan ytterligare parametrar kanske godtas. + +B kommer bygga källkodspaketet med det första format som +fungerar från denna lista i denna ordning: formatet som anges med +kommandoradsflaggan I<--format>, formatet som anges i +I, ”1.0”. Standardvärdet ”1.0” rekommenderas ej och +kommer att tas bort en gång i framtiden, du bör alltid dokumentera det +önskade källkodsformatet i B. Se avsnittet B för en utförlig beskrivning av de olika +källkodspaketformaten. + +=item B<--print-format> I + +Visa formatet som skulle användas för att bygga källkodspaketet om +B I skulle köras (under samma förhållanden och +med samma parametrar; sedan dpkg 1.15.5). + +=item B<--before-build> I + +Kör motsvarande krok för källkodspaketformatet (sedan dpkg 1.15.8). Kroken +anropas innan något från paketet byggs (B anropar det +väldigt tidigt, till och med före B). Kommandot är +idempotent och kan anropas flera gånger. Det är inte alla källkodsformat som +implementerar något i den här kroken, och de som gör det förbereder oftast +källkodsträdet för att byggas, till exempel genom att se till att +Debianpatchar har applicerats. + +=item B<--after-build> I + +Kör motsvarande krok för källkodspaketformatet (sedan dpkg 1.15.8). Kroken +anropas efter att allt från paketet byggts (B anropar det +sist). Kommandot är idempotent och kan anropas flera gånger. Det är inte +alla källkodsformat som implementerar något i den här kroken, och de som gör +det använder den normalt för att återställa det som B<--before-build> har +gjort. + +=item B<--commit> [I] ... + +Spara ändringar i källkodsträdet som har packats upp i I (sedan +dpkg 1.16.1). Kommandot kan ta ytterligare parametrar beroende på +källkodsformatet. Ett fel kommer rapporteras för format där operationen inte +har någon betydelse. + +=item B<-?>, B<--help> + +Visar hjälpskärm och avslutar. De formatspecifika bygg- och +extraheringsflaggorna kan visas genom att använda flaggan B<--format>. + +=item B<--version> + +Visar version och avslutar. + +=back + +=head1 FLAGGOR + +=head2 Generiska byggflaggor + +=over + +=item B<-c>I + +Anger huvudkällkodsstyrfil som information ska läsas från. Standardvärde är +B. Om ett relativt sökvägsnamn anges tolkas det från +källkodsträdets toppnivåkatalog. + +=item B<-l>I<ändringsloggfil> + +Anger ändringsloggsfil som information ska läsas från. Standardvärde är +B. Om ett relativt sökvägsnamn anges tolkas det från +källkodsträdets toppnivåkatalog. + +=item B<-F>I<ändringsloggformat> + +Anger format på ändringsloggen. Se B(1) för information +om alternativa format. + +=item B<--format=>I + +Använd det givna formatet för att bygga källkodspaketet (sedan dpkg +1.14.17). Det överstyr ett eventuellt format som anges i +B. + +=item B<-V>IB<=>I + +Ställer in en utdatasubstitueringsvariabel. Se B(5) för en +beskrivning av utdatasubstituering. + +=item B<-T>I + +Läs substitueringsvariabler från I; standardvärde är att inte +läsa någon fil. Flaggan kan användas flera gånger för att läsa +substitueringsvariabler från flera filer (sedan dpkg 1.15.6). + +=item B<-D>IB<=>I + +Ersätt eller lägg till ett fält i den genererade control-filen. + +=item B<-U>I + +Ta bort ett fält ur den genererade control-filen. + +=item B<-Z>I, B<--compression>=I + +Anger vilken komprimering som ska användas för de skapade tar-bollarna och +diff-filerna (B<--compression> sedan dpkg 1.15.5). Observera att flaggan +inte gör att befintliga tar-bollar packas om, utan enbart påverkar nya +filer. Värden som stöds är: I, I, I samt I. Förvalet +är I för format 2.0 och senare, och I för format 1.0. Stöd för +I finns bara från och med dpkg 1.15.5. + +=item B<-z>I, B<--compression-level>=I + +Komprimeringsnivå att använda (B<--compression-level> sedan dpkg +1.15.5). Som med B<-Z> påverkas bara filer som nyskapas. Värden som stöds +är: I<1> till I<9>, I (bäst) och I (snabb). I<9> är förval för +gzip och bzip2, I<6> för xz och lzma. + +=item B<-i>[I], B<--diff-ignore>[=I] + +Du kan ange ett reguljärt uttryck i perlformat för att matcha filer som du +vill ska filtreras ut ur listan över filer för diffen (B<--diff-ignore> +sedan dpkg 1.15.6). (Listan skapas av ett find-kommando.) (Om +källkodspaketet byggs som ett version 3-paket med ett VCS kan detta användas +för att ignorera ändringar som inte har checkats in på de angivna +filerna. -i.* kommer att ignorera samtliga.) + +B<-i> ensamt aktiverar inställningen, med ett standardvärde (bibehåller +modifieringar till standarduttrycket som gjorts med tidigare användning av +B<--extend-diff-ignore>) som filtrerar ut styrfiler och kataloger från de +flesta vanliga versionshanteringssystem, säkerhetskopior, växlingsfiler och +Libtool-byggutdatakataloger. Endast ett reguljärt kan vara aktivt, om du +anger flera B<-i>-flaggor är det den sista som gäller. + +Flaggan är mycket användbar för att utesluta extrafiler som kommer med i +diffen, t.ex om du underhåller din källkod i ett versionshanteringssystem +och vill använda en utcheckning för att bygga ett källkodspaket utan att ta +med de ytterligare filer och det normalt innehåller (t.ex CVS/, .cvsignore, +.svn/). Det förvalda reguljära uttrycket täcker redan in många av dessa, men +om du ändrar det, kom ihåg att det som standard kan träffa alla delar av +filnamnet. Så, om du träffa bara början av ett filnamn eller hela filnamn +måste du själv lägga till de förankringar som är nödvändiga (t.ex ”(^|/)”, +”($|/)”). + +=item B<--extend-diff-ignore>=I + +Det reguljära uttrycket i perlformat som angavs utökar standardvärdet som +används av B<--diff-ignore> och dess nuvarande värde, om satt (sedan dpkg +1.15.6). Det gör så genom att lägga till ”B<|>I” efter +standarduttrycket. Flaggan är nyttig för B för att +exkludera en del automatiskt genererade filer från skapandet av automatiska +patchar. + +=item B<-I>[I], B<--tar-ignore>[=I] + +Om flaggan anges kommer filnamnet att sändas vidare till B(1):s +B<--exclude>-flagga när det anropas för att skapa en .orig.tar.gz eller +.tar.gz-fil (B<--tar-ignore> sedan dpkg 1.15.6). Till exempel kommer +B<-I>CVS att hoppa över CVS-kataloger när tar.gz-filen skapas. Flaggan kan +upprepas flera gånger för att lista flera filnamn som ska uteslutas. + +B<-I> ensamt lägger till satandard B<--exclude>-flaggor som filtrerar ut +styrfiler och kataloger från de flesta vanliga versionshanteringssystem, +säkerhetskopior, växlingsfiler och Libtool-byggutdatakataloger. + +=back + +B Även om de används till liknande ändamål, så har B<-i> och +B<-I> väldigt olika syntax och semantik. B<-i> kan endast anges en gång och +tar ett perl-kompatibelt reguljärt uttryck, vilket matchas mot den kompletta +relativa sökvägen för varje fil. B<-I> kan anges flera gånger och tar ett +filnamnssökmänster med skaljokertecken. Mönstret matchas mot den kompletta +relativa sökvägen, men även individuellt mot varje komponent i sökvägen. Den +exakta semantiken för tar:s B<--exclude>-flagga är något komplicerad, se +L för +fullständig dokumentation. + +Förvalt reguljärt uttryck och sökmönster för de bägge flaggorna kan ses i +utdata för B<--help>-kommandot. + +=head2 Generiska extraheringsflaggor + +=over + +=item B<--no-copy> + +Kopiera inte original-tarbollar i närheten av det uppackade källkodspaketet +(sedan dpkg 1.14.17). + +=item B<--no-check> + +Kontrollera inte signaturer och kontrollsummor före uppackning (sedan dpkg +1.14.17). + +=item B<--no-overwrite-dir> + +Skriv inte över uppackningskatalogen om den redan finns (sedan dpkg 1.18.8). + +=item B<--require-valid-signature> + +Vägra packa upp källkodspaketet om det inte innehåller en OpenPGP-signatur +som kan verifieras (sedan dpkg 1.15.0) antingen med användarens +I-nyckelring, en av de säljarspecifka nyckelringarna, eller +en av de officiella Debiannyckelringarna +(I, +I och +I). + +=item B<--require-strong-checksums> + +Vägra packa upp källkodspaketet om det inte innehåller några starka +kontrollsummor (sedan dpkg 1.18.7). Den enda kända kontrollsumma som anses +stark är för närvarande B. + +=item B<--ignore-bad-version> + +Ändrar testet för felaktig källkodspaketversion till en icke-ödesdiger +varning (sedan dpkg 1.17.7). Flaggan är endast nödvändig vid uppackning av +väldigt gamla källkodspaket med trasiga versioner, bara för +bakåtkompatibilitet. + +=back + +=head1 FORMAT PÅ KÄLLKODSPAKET + +Om du inte vet vilket källkodspaketformat du ska använda, bör du antagligen +välja antingen ”3.0 (quilt)” eller ”3.0 (native)”. L för information om hur dessa +format sätts i produktion i Debian. + +=head2 Format: 1.0 + +Ett källkodspaket i detta format består antingen av en B<.orig.tar.gz>, +förbunden med en B<.diff.gz>, eller en ensam B<.tar.gz> (i så fall anses +paketet vara I, ”I”). Original-tarbollen kan också valfritt +åtföljas av en friliggande uppströmssignatur B<.orig.tar.gz.asc>, uppackning +stöds sedan dpkg 1.18.5. + +B + +Att packa upp ett Debianeget paket innebär att packa upp den ensamma +tarbollen i målkatalogen. Att packa upp ett icke-eget paket innebär att +först packa upp I<.orig.tar.gz>-filen och sedan genom att tillämpa patchen +som finns i B<.diff.gz>-filen. Tidsstämplarna för alla patchade filer +nollställs till den tidpunkt då källkodspaketet extraherades (vilket +undviker tidsstämpelförskjutningar som kunde leda till problem när +autogenererade filer patchas). Diffen kan skapa nya filer (hela +debian-katalogen skapas på det sättet), men kan inte ta bort filer (tomma +filer kommer lämnas kvar) och kan inte skapa eller ändra symboliska länkar. + +B + +Att bygga ett Debianeget paket innebär bara att skapa en ensam tarboll med +källkodskatalogen. Att bygga ett icke-eget paket innefattar att extrahera +original-tarbollen i en separat ”.orig”-katalog och skapa B<.diff.gz>-filen +på nytt genom att jämföra källkodspaketets I med .orig-katalogen. + +B + +Om ett andra argument som inte är en flagga anges ska det vara namnet på +originalkällkodskatalogen eller -tarfilen eller den tomma strängen om +paketet är Debianspecifikt och därför inte har några +debianiserings-diffar. Om inget andra argument anges kommer B +att leta efter originalkällkodstarfilen +IB<_>IB<.orig.tar.gz> eller +originalkällkodskatalogen IB<.orig> beroende på B<-sX>-flaggorna. + +B<-sa>, B<-sp>, B<-sk>, B<-su> och B<-sr> skriver inte över befintliga +tar-filer och kataloger. Om det önskas bör B<-sA>, B<-sP>, B<-sK>, B<-sU> +och B<-sR> anges i stället. + +=over + +=item B<-sk> + +Anger att den ursprungliga källkoden är en tar-fil, som standard +IB<_>IB<.orig.tar.>I. Den kommer låta +originalkällkodsfilen ligga kvar som en tarfil, eller kopiera den till den +aktuella katalogen om den inte redan är där. Tarbollen kommer att packas upp +i IB<.orig> för att generera diffen. + +=item B<-sp> + +Som B<-sk>, men tar bort katalogen igen efteråt. + +=item B<-su> + +Anger att originalkällkoden är en katalog, som standard +IB<->IB<.orig> och att B ska skapa ett +nytt originalkällkodsarkiv från den. + +=item B<-sr> + +Som B<-su>, men tar bort katalogen när den har använts. + +=item B<-ss> + +Anger att originalkällkoden finns både som en katalog och en +tar-fil. Katalogen kommer att användas av B för att skapa +diffen, men tarfilen för att skapa B<.dsc>-filen. Flaggan måste användas med +tillförsikt - om katalogen och tarfilen inte stämmer överens kommer ett +trasigt källkodsarkiv att skapas. + +=item B<-sn> + +Anger att dpkg-source inte ska leta efter något källkodsarkiv och att ingen +diff ska skapas. Det andra argumentet, om det anges, måste vara den tomma +strängen. Flaggan används för Debianspecifika paket som inte har en separat +uppströmskällkod och därför inte har någon debianiseringsdiff. + +=item B<-sa> eller B<-sA> + +Anger att originalkällkoden finns som en katalog eller en tarfil - det andra +argumentet, om det anges, kan vara det ena eller det andra, eller den tomma +strängen (motsvarar att använda B<-sn>). Om en tarfil hittas kommer +programmet att packa upp den för att skapa en diff och ta bort den efteråt +(motsvarar B<-sp>). Om en katalog hittas kommer den att packas för att skapa +originalkällkoden och ta bort den efteråt (motsvarar B<-sn>). Om båda hittas +kommer B att ignorera katalogen, och skriva över den om B<-sA> +angavs (detta motsvarar B<-sP>) eller ge ett felmeddelande om B<-sa> +angavs. B<-sa> är standard. + +=item B<--abort-on-upstream-changes> + +Processen misslyckas om den genererade diffen innehåller ändringar av filer +utanför underkatalogen debian (sedan dpkg 1.15.8). Den här flaggan tillåts +inte i B, men kan användas i +B. + +=back + +B + +Oavsett kommer ett befintligt källkodsträd att tas bort. + +=over + +=item B<-sp> + +Används när originalkällkoden som extraheras (om sådan finns) ska lämnas +kvar som en tarfil. Om den inte redan finns i den aktuella katalogen, eller +om en befintlig men annan fil finns där, kommer den att kopieras +dit. (B) + +=item B<-su> + +Packar upp originalkällkodsträdet. + +=item B<-sn> + +Försäkrar att originalkällkoden varken kopieras till en aktuella katalogen +eller packas upp. Eventuella originalkällkodsträd som finns i den aktuella +katalogen tas fortfarande bort. + +=back + +Alla B<-s>I-flaggor är ömsesidigt uteslutande. Om du anger mer än en +kommer endast den sista att användas. + +=over + +=item B<--skip-debianization> + +Hoppas över att tillämpa debian-diffen ovanpå uppströmskällkoden (sedan dpkg +1.15.1). + +=back + +=head2 Format: 2.0 + +Uppackning stöds sedan dpkg 1.13.9, byggning stöds sedan dpkg 1.14.8. Även +känt som wig&pen. Detta format rekommenderas inte för allmän användning, +formatet ”3.0 (quilt)” ersätter det. Wig&pen var den första specifikationen +av en ny generation av källkodspaketformat. + +Beteendet för detta format är detsamma som för ”3.0 (quilt)”-formatet, +förutom att det inte använder en explicit förteckning patchar. Alla filer i +B som motsvarar det Perl-reguljära uttrycket B<[\w-]+> +måste vara giltiga patchar: de appliceras när paketet packas upp. + +När du bygger ett nytt källkodspaket kommer eventuella ändringar på +uppströmskällkoden att lagras i en patch som kallas B. + +=head2 Format: 3.0 (eget) + +Stöds sedan dpkg 1.14.17. Detta format är en utökning av det egna +paketformatet som anges av 1.0-formatet. Det stöder alla +komprimeringsmetoder och kommer att som standard ignorera alla VCS-specifika +filer och kataloger, samt många temporärfiler (se standardvärdet som är +knutet till flaggan B<-i> i texten för B<--help>). + +=head2 Format: 3.0 (quilt) + +Stöds sedan dpkg 1.14.17. Ett källkodspaket i detta format innehåller +åtminstone en original-tarboll (B<.orig.tar.>I, där I kan vara +B, B, B eller B) och en Debiantarboll +(B<.debian.tar.>I). Den kan även innehålla ytterligare +original-tarbollar (B<.orig->IB<.tar.>I). I kan +endast innehålla alfanumeriska (”a-zA-Z0-9”) tecken och bindestreck +(”-”). Varje original-tarboll kan också valfritt åtföljas av en friliggande +uppströmssignatur (B<.orig.tar.>IB<.asc> och +B<.orig->IB<.tar.>IB<.asc>), uppackning stöds sedan dpkg +1.17.20, byggning stöds sedan dpkg 1.18.5. + +B + +Huvud-originaltarbollen packas upp först, därefter packas alla ytterligare +originaltarbollar upp i underkataloger med namn efter I-delen i +sitt filnamn (eventuella redan befintliga kataloger +ersätts). Debian-tarbollen packas sedan upp ovanpå källkodskatalogen efter +att en redan befintlig B-katalog har tagits bort först. Observera +att debian-tarbollen måste bestå av en B-underkatalog, men att den +även kan innehålla binärfiler utanför den katalogen (se flaggan +B<--include-binaries>). + +Alla patchar listade i BI<återförsäljare>B<.series> eller +B tillämpas sedan, där I<återförsäljare> är namnet på +den aktuella återförsäljaren skrivet med små bokstäver, eller B om +ingen har angivits. Om den förstnämnda filen används och den sistnämnda inte +existerar (eller är en symbolisk länk), kommer den senare att ersättas av en +symbolisk länk till den första. Tanken är att göra det enklare att använda +B till att hantera patchuppsättningen. Återförsäljarspecifika +series-filer är tänkta att göra det möjligt att serialisera flera +utvecklingsgrenar baserade på återförsäljaren, på ett deklarativt sätt, +istället för att öppet koda den här hanteringen i B. Detta är +speciellt användbart när källkoden behöver patchas olika eftersom de rörda +filerna inte stöder inbyggd villkorlig tillämpning. Observera att, även om +B korrekt tolkar series-filer som använder explicita flaggor +till patch-programmet (lagrade på kommandoraden efter patch-filnamnet och +ett eller flera blanksteg), så ignoreras dessa flaggor och det förväntar sig +att patchar kan tillämpas med flaggan B<-p1> till B. Det kommer +därför visa en varning sådana flaggor upptäcks, och bygget kommer troligen +att misslyckas. + +Oberbera att B(1) kommer skapa ovillkorliga varningar när +återförsäljarserier används på grund av en kontroversiell Debian-specifik +dom, vilket inte bör påverka extern användning; för att tysta dessa kan +dpkg:s lintianprofil användas genom att ge parametern ”B<--profile dpkg>” +till B(1). + +Tidsstämplarna för alla patchade filer nollställs till den tidpunkt då +källkodspaketet extraherades (vilket undviker tidsstämpelförskjutningar som +kunde leda till problem när autogenererade filer patchas). + +Till skillnad mot B:s originalbeteende förväntas det att patchar kan +appliceras utan någon ”fuzz”. När så inte är fallet bör du uppdatera +patcharna med hjälp av B, om inte kommer B rapportera +ett felmeddelande när det försöker tillämpa dem. + +Patchar kan även ta bort filer, på samma sätt som B normalt fungerar. + +Filen B<.pc/applied-patchers> skapas om patchar tillämpades vid +uppackningen. + +B + +Alla original-tarbollar som finns i den aktuella katalogen packas upp i en +temporär katalog med samma logik som i uppackningen, debian-katalogen +kopieras över i den temporära katalogen och alla patchar, förutom den +automatiska patchen (BI eller B, +beroende på B<--single-debian-patch>) tillämpas. Temporärkatalogen jämförs +därefter mot källkodskatalogen. Om diffen inte är tom misslyckas bygget, +såvida inte B<--single-debian-patch> eller B<--auto-commit> använts, i +vilket fall diffen lagras i den automatiska patchen. Om den automatiska +patchen skapas/tas bort, läggs den till/tas bort från series-filen och från +B-metadata. + +Eventuella ändringar på binärfiler kan inte representeras i en diff och +kommer därmed att leda till ett felmeddelande, såvida inte paketansvariga +medvetet väljer att inkludera den modifierade binärfilen i debian-tarbollen +(genom att lista den i B). Byggningen kommer +även att misslyckas om binärfiler upptäcks i debian-underkatalogen, såvida +de inte har tillåtits i B. + +Den uppdaterade debiankatalogen, och listan över modifierade binärer, +används sedan för att skapa debian-tarbollen. + +Den automatiskt genererade diff-filen innehåller inte ändringar för +VCS-specifika filer eller för många temporära filer (se standardvärdet som +är knutet till flaggan B<-i> i texten för B<--help>). Detta gäller speciellt +katalogen B<.pc> som används av B, katalogen kommer att ignoreras när +den automatiska patchen skapas. + +B B B<--before-build> (och B<--build>) ser till att +alla patchar som anges i seriefilen tillämpas så att paketbygget alltid har +alla patchar tillämpade. Detta görs genom att hitta alla icke-tillämpade +patchar (som anges i filen B men inte i B<.pc/applied-patches>), och +om den första patchen i listan kan tillämpas utan fel kommer samtliga att +tillämpas. Flaggan B<--no-preparation> kan användas för att slå av detta +beteende. + +B + +=over + +=item B<--commit> [I] [I] [I] + +Skapar en patch som motsvarar de lokala ändringar som inte hanteras av +B-patch-systemet och integrerar dem i patch-systemet under namnet +I. Om namnet saknas kommer programmet be om ett interaktivt. Om +I anges används den som patch som motsvarar de lokala ändringar +som ska integreras. När patchen är integrerad startas ett redigeringsprogram +så att du kan ange metainformationen i patchhuvudet. + +Det är oftast nyttigt att sända med I efter att ett bygge där +filen skapats i förväg misslyckas, och att patchfilen därför ska tas bort +efter integrering. Observera även att ändringarna som finns i patchfilen +redan måste ha applicerats på trädet och att filerna som modifieras av +patchen inte får innehålla ytterligare ej beskrivna ändringar. + +Om genereringen av patchar upptäcker ändringar i binärfiler kommer de +automatiskt att läggas in i B så att de +dyker upp i debian-tarbollen (precis som B skulle gjort). + +=back + +B + +=over + +=item B<--allow-version-of-quilt-db=>I + +Tillåt B att bygga källkodspaketet om versionen av +B-metadata är den som angavs, även om B inte känner till +den (sedan dpkg 1.15.5.4). Det betyder att den givna versionen av +B-metadata är kompatibel med version 2 som B för +närvarande stöder. Versionen av B-metadata lagras i B<.pc/.version>. + +=item B<--include-removal> + +Ignorera inte borttagna filer och ta med dem i den automatiskt genererade +patchen. + +=item B<--include-timestamp> + +Ta med tidsstämpel i den automatiskt genererade patchen. + +=item B<--include-binaries> + +Lägg till alla modifierade binärer i debian-tarbollen. Lägg även till dem i +B: de kommer att läggas till som standard i +följande byggen och du behöver inte längre ange den här flaggan. + +=item B<--no-preparation> + +Försök inte att förbereda byggträdet genom att tillämpa patchar som inte +verkar ha tillämpas för närvarande (sedan dpkg 1.14.18). + +=item B<--single-debian-patch> + +Använd B istället för +BI som namn på den automatiska +patch som genereras vid bygget (sedan dpkg 1.15.5.4). Denna flagga är +speciellt nyttig när paketet hanteras i ett versionshanteringssystem och en +patch inte kan skapas på ett pålitligt sätt. Den aktuella diffen mot +uppströms lagras istället i en ensam patch. Flaggan bör anges i +B och följs av filen +B som beskricer hur Debianändringarna bäst +kan ses, till exempel i det versionshanteringssystem som används. + +=item B<--create-empty-orig> + +Skapa huvud-originaltarbollen som tom automatiskt om den saknas och om det +finns tilläggs-originaltarbollar (sedan dpkg 1.15.6). Flaggan är tänkt att +användas när källkodspaketet bara är en samling av flera uppströmsprogram +och där det inte finns något ”huvud”-program. + +=item B<--no-unapply-patches, --unapply-patches> + +Som standard kommer B att automatiskt ta bort patchar i kroken +B<--after-build> om de applicerades under B<--before-build> +(B<--unapply-patches> sedan dpkg 1.15.8, B<--no-unapply-patches> sedan dpkg +1.16.5). De här flaggorna låter dig överstyra om du vill inaktivera eller +aktivera proceduren för borttagning av patchar. Flaggorna tillåts endast i +B så att alla genererade källkodspaket som +standard har samma beteende. + +=item B<--abort-on-upstream-changes> + +Processen misslyckas om en automatisk patch har genererats (sedan dpkg +1.15.8). Flaggan kan användas för att se till att alla ändringar har lagrats +undan korrekt i separata B-patchar innan källkodspaketet +byggts. Flaggan tillåts inte i B, men kan användas i +B. + +=item B<--auto-commit> + +Processen misslyckas inte om en automatisk patch har skapats, den läggs +istället direkt in i B-serien. + +=back + +B + +=over + +=item B<--skip-debianization> + +Hoppar över att packa upp debian-tarbollen ovanpå uppströmskällkoden (sedan +dpkg 1.15.1). + +=item B<--skip-patches> + +Applicera inte patchar i slutet av uppackningen (sedan dpkg 1.14.18). + +=back + +=head2 Format: 3.0 (skräddarsytt) + +Stöds sedan dpkg 1.14.17. Detta formatet är speciellt. Det anger inte ett +riktigt källkodspaketformat, utan kan användas för att skapa källkodspaket +med godtyckliga filer. + +B + +Alla argument som inte är flaggor tas som filer som ska integreras i det +skapade källkodspaketet. De måste finnas, och helst i aktuell +katalog. Åtminstone en fil måste anges. + +=over + +=item B<--target-format=>I + +B. Anger det riktiga formatet på det genererade källkodspaketet. Den +skapade .dsc-filen kommer innehålla detta värde i sitt B-fält och +inte ”3.0 (custom)”. + +=back + +=head2 Format: 3.0 (git) + +Stöds sedan dpkg 1.14.17. Formatet är experimentellt. + +Ett källkodspaket i detta format består av en ensam bunt (”bundle”) från ett +git-arkiv B<.git>, vilket innehåller paketets källkod. Filen B<.gitshallow>, +som innehåller revisioner för grunda git-kloner, kan även förekomma. + +B + +Bunten klonas som ett git-arkiv till målkatalogen. Om filen gitshallow finns +installeras den som I<.git/shallow> i det klonade git-arkivet. + +Observera att det nya arkivet som standard kommer att ha samma gren +utcheckad som den som var utcheckad i det ursprungliga +källkodsträdet. (Typiskt ”master”, men kan vara vad som helst.) Eventuella +andra grenar kommer också att vara tillgängliga, under I. + +B + +Innan uppackningen fortsätter kommer en del tester att utföras för att se +till att vi inte har några ej ignorerade ej incheckade ändringar. + +B(1) används för att generera en bunt från git-arkivet. Som +standard tas alla grenar och taggar i arkivet med i bunten. + +B + +=over + +=item B<--git-ref=>I + +Gör det möjligt att ange en git-referens som ska tas med i bunten. Om den +anges överstyr den standardbeteendet som är att ta med alla grenar och +taggar. Kan anges flera gånger. I kan vara namnet på en gren eller tagg +som ska tas med. Den kan även vara vilken som helst annan parameter som kan +sändas med till B(1). För att, till exempel, endast ta med +grenen ”master”, använd B<--git-ref=>master. För att ta med alla taggar och +grenar, förutom grenen private, använd B<--git-ref=>--all +B<--git-ref=>^private + +=item B<--git-depth=>I + +Skapar en grund klon med en historik som är avhuggen vid det angivna antalet +revisioner. + +=back + +=head2 Format: 3.0 (bzr) + +Stöds sedan dpkg 1.14.17. Detta format är experimentellt. Det genererar en +ensam tarboll som innehåller bzr-arkivet. + +B + +Tarbollen packas upp och bzr används sedan för att hämta ut den aktuella +grenen. + +B + +Innan uppackningen fortsätter kommer en del tester att utföras för att se +till att vi inte har några ej ignorerade ej incheckade ändringar. + +De VCS-specifika delarna av källkodskatalogen kommer därefter att kopieras +över till en temporär katalog. Innan den temporära katalogen packas i en +tarboll utförs viss städning för att spara plats. + +=head1 DIAGNOSTIK + +=head2 källkodsformat ej angivet i debian/source/format + +Filen B bör alltid finnas och ange det önskade +källkodsformatet. För bakåtkompatibilitet antar formatet ”1.0” om filen inte +finns, men du bör inte förlita dig på detta: vid någon punkt i framtiden +kommer B att justeras så att det misslyckas om filen inte +finns. + +Resonemanget bakom detta är att formatet ”1.0” inte längre är det +rekommenderade formatet, du bör normalt välja ett av de nyare formaten (”3.0 +(quilt)”, ”3.0 (native)”), men B gör inte detta automatiskt åt +dig. Om du vill fortsätta använda det gamla formatet bör du ange det +explicit genom att skriva ”1.0” i B. + +=head2 diffen modifierar följande uppströmsfiler + +När du använder källkodsformatet ”1.0” är det oftast inte någon bra idé att +modifiera uppströmsfiler direkt eftersom ändringarna döljs och i huvudsak är +odokumenterade i diff.gz-filen. Du bör istället spara dina ändringar som +patchar i debian-katalogen och applicera dem när paketet ska byggas. För att +undvika den här komplexiteten kan du även använda formatet ”3.0 (quilt)” som +låter dig göra det här automatiskt. + +=head2 kan inte representera ändringen för I + +Ändringar på uppströmsfiler sparas normalt som patchfiler, men inte alla +ändringar kan representeras med patchar: de kan endast ändra innehållet i +vanliga textfiler. Om du försöker ersätta en fil med något som har en annan +typ (till exempel ersätta en vanlig fil med en symbolisk länk eller en +katalog) får du det här felmeddelandet. + +=head2 den tomma filen I som just skapats kommer inte representeras i diffen + +Tomma filer kan inte skapas med patchfiler. Ändringen kommer därmed inte att +sparas i källkodspaketet och du får en varning om det. + +=head2 exekveringsläge I på I kommer inte representeras i diffen + +Patchfiler beskriver inte läget på filer och exekveringsbehörigheter sparas +därmed inte i källkodspaketet. Den här varningen påminner dig om detta. + +=head2 specialläget I på I kommer inte representeras i diffen + +Patchfiler beskriver inte läget på filer och ändrade lägen sparas inte i +källkodspaketet. Den här varningen påminner dig om detta. + +=head1 MILJÖVARIABLER + +=over + +=item B + +Väljer färgläge (sedan dpkg 1.18.5). För närvarande godtas följande värden: +B (förval), B och B. + +=item B + +Om satt, används för att bestämma om lokalt språkstöd ska aktiveras, även +känt som internationaliseringsstöd (eller i18n) (sedan dpkg +1.19.0). Tillåtna värden är: B<0> och B<1> (förval). + +=item B + +Om satt kommer det användas som tidsstämpel (som sekunder sedan epoken) för +att tvinga mtime i B(5)-filposterna. + +=item B + +=item B + +Används av källkodsformatmodulerna ”2.0” och ”3.0 (quilt)”. + +=item B + +=item B + +=item B + +=item B + +=item B + +Används av källkodsformatmodulen ”3.0 (git)”. + +=back + +=head1 FILER + +=head2 debian/source/format + +Filen innehåller på en ensam rad det format som ska användas för att bygga +källkodspaketet (möjliga format beskrivs ovan). Varken ledande eller +avslutande blanksteg tillåts. + +=head2 debian/source/include-binaries + +Filen innehåller en förteckning med sökvägsnamn för binärfiler (en per rad) +relativt till källkods-rotkatalogen som ska tas med i +debian-tarbollen. Inledande och avslutande blanksteg tas bort. Rader som +börjar med ”B<#>” är kommentarer och hoppas över. Tomma rader ignoreras. + +=head2 debian/source/options + +Filen innehåller en lista över långa flaggor som automatiskt sätts in före +kommandoradsflaggorna som anges i ett anrop til B eller +B. Flaggor som B<--compression> och +B<--compression-level> är passande att lägga in i den här filen. + +Ange varje flagga på en egen rad. Tomma rader och rader som börjar med +”B<#>” ignoreras. Inledande ”B<-->” ska tas bort och korta flaggor är inte +tillåtna. Blanksteg tillåts runt ”B<=>”-tecknet och citattecken tillåts runt +värdet. Här är ett exempel på en sådan fil: + + # låt dpkg-source skapa en debian.tar.bz2 med maximal komprimering + compression = "bzip2" + compression-level = 9 + # använd debian/patches/debian-changes som en automatisk patch + single-debian-patch + # ignorera ändringar i config.{sub,guess} + extend-diff-ignore = "(^|/)(config.sub|config.guess)$" +B B-flaggor tillåts inte i den här filen, du bör använda +filen B istället. + +=head2 debian/source/local-options + +Precis som B förutom att filen inte inkluderas i det +genererade källkodspaketet. Det kan vara användbart för att spara ett val +som gäller för paketansvariga eller VCS-systemet källkodspaketet hanteras i. + +=head2 debian/source/local-patch-header + +=head2 debian/source/patch-header + +Friformstext som läggs in på toppen av den automatiskt genererade patchen i +formaten ”2.0” eller ”3.0 (quilt)”. B tas inte med i det +genererade källkodspaketet medan B tas med. + +=head2 debian/patches/I<återförsäljare>.series + +=head2 debian/patches/series + +Listar alla patchar som måste tillämpas (i den givna ordningen) ovanpå +uppströmskällkodspaketet. Inledande och avslutande blanksteg tas +bort. I<återförsäljare> är namnet på aktuell återförsäljare skrivet med små +bokstäver. Om den återförsäljarspecifika series-filen inte existerar, kommer +den återförsäljarlösa series-filen att användas istället. Rader som börjar +med ”B<#>” är kommentarer och ignoreras. Tomma rader ignoreras. De rader som +är kvar inleds med filnamnet på en patchfil (relativt till +B-katalogen) upp till det första blankstegstecknet eller +slutet på raden. Valfria flaggor till B kan följa fram till slutet av +raden eller det första ”B<#>” som följer på ett eller flera blanksteg +(vilket anger början på en kommentar fram till slutet av raden). + +=head1 PROGRAMFEL + +Tidpunkten på fältöverstyrning inträffar jämfört med inställning av vissa +standardutdatafält är ganska förvirrad. + +=head1 SE ÄVEN + +B(5), B(5), B(5). + + +=head1 ÖVERSÄTTNING + +Peter Krefting och Daniel Nylander. -- cgit v1.2.3