summaryrefslogtreecommitdiffstats
path: root/man/sv/dpkg-source.pod
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-27 09:40:31 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-27 09:40:31 +0000
commitb86570f63e533abcbcb97c2572e0e5732a96307b (patch)
treecabc83be691530ae685c45a8bc7620ccc0e1ebdf /man/sv/dpkg-source.pod
parentInitial commit. (diff)
downloaddpkg-b86570f63e533abcbcb97c2572e0e5732a96307b.tar.xz
dpkg-b86570f63e533abcbcb97c2572e0e5732a96307b.zip
Adding upstream version 1.20.13.upstream/1.20.13upstream
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'man/sv/dpkg-source.pod')
-rw-r--r--man/sv/dpkg-source.pod929
1 files changed, 929 insertions, 0 deletions
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<dpkg-source> [I<flagga>...] I<åtgärd>
+
+=head1 BESKRIVNING
+
+B<dpkg-source> 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<filename>.dsc [I<utdatakatalog>]
+
+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<källkod>-I<version> i den aktuella
+arbetskatalogen.
+
+B<dpkg-source> 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<debian/source/format> så att det används som standard när källkodspaketet
+byggs på nytt.
+
+=item B<-b>, B<--build> I<directory> [I<formatspecifika-flaggor>]
+
+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<dpkg-source> 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<debian/source/format>, ”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<debian/source/format>. Se avsnittet B<FORMAT PÅ
+KÄLLKODSPAKET> för en utförlig beskrivning av de olika
+källkodspaketformaten.
+
+=item B<--print-format> I<katalog>
+
+Visa formatet som skulle användas för att bygga källkodspaketet om
+B<dpkg-source --build> I<katalog> skulle köras (under samma förhållanden och
+med samma parametrar; sedan dpkg 1.15.5).
+
+=item B<--before-build> I<katalog>
+
+Kör motsvarande krok för källkodspaketformatet (sedan dpkg 1.15.8). Kroken
+anropas innan något från paketet byggs (B<dpkg-buildpakcage> anropar det
+väldigt tidigt, till och med före B<debian/rules clean>). 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<katalog>
+
+Kör motsvarande krok för källkodspaketformatet (sedan dpkg 1.15.8). Kroken
+anropas efter att allt från paketet byggts (B<dpkg-buildpakcage> 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<katalog>] ...
+
+Spara ändringar i källkodsträdet som har packats upp i I<katalog> (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<control-fil>
+
+Anger huvudkällkodsstyrfil som information ska läsas från. Standardvärde är
+B<debian/control>. 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<debian/changelog>. 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<dpkg-parsechangelog>(1) för information
+om alternativa format.
+
+=item B<--format=>I<värde>
+
+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<debian/source/format>.
+
+=item B<-V>I<namn>B<=>I<värde>
+
+Ställer in en utdatasubstitueringsvariabel. Se B<deb-substvars>(5) för en
+beskrivning av utdatasubstituering.
+
+=item B<-T>I<substvars-fil>
+
+Läs substitueringsvariabler från I<substvarfil>; 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>I<fält>B<=>I<värde>
+
+Ersätt eller lägg till ett fält i den genererade control-filen.
+
+=item B<-U>I<fält>
+
+Ta bort ett fält ur den genererade control-filen.
+
+=item B<-Z>I<komprimering>, B<--compression>=I<komprimering>
+
+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<gzip>, I<bzip2>, I<lzma> samt I<xz>. Förvalet
+är I<xz> för format 2.0 och senare, och I<gzip> för format 1.0. Stöd för
+I<xz> finns bara från och med dpkg 1.15.5.
+
+=item B<-z>I<nivå>, B<--compression-level>=I<nivå>
+
+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<best> (bäst) och I<fast> (snabb). I<9> är förval för
+gzip och bzip2, I<6> för xz och lzma.
+
+=item B<-i>[I<reg.uttr>], B<--diff-ignore>[=I<reg.uttr>]
+
+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<reg.uttr>
+
+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<reg.uttr>” efter
+standarduttrycket. Flaggan är nyttig för B<debian/source/options> för att
+exkludera en del automatiskt genererade filer från skapandet av automatiska
+patchar.
+
+=item B<-I>[I<filmönster>], B<--tar-ignore>[=I<filmönster>]
+
+Om flaggan anges kommer filnamnet att sändas vidare till B<tar>(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<Observera:> Ä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<https://www.gnu.org/software/tar/manual/tar.html#wildcards> 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<trustedkeys.gpg>-nyckelring, en av de säljarspecifka nyckelringarna, eller
+en av de officiella Debiannyckelringarna
+(I</usr/share/keyrings/debian-keyring.gpg>,
+I</usr/share/keyrings/debian-nonupload.gpg> och
+I</usr/share/keyrings/debian-maintainers.gpg>).
+
+=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<SHA-256>.
+
+=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<Se
+https://wiki.debian.org/Projects/DebSrc3.0> 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<eget>, ”I<native>”). 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<Uppackning>
+
+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<Bygga>
+
+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<katalog> med .orig-katalogen.
+
+B<Byggflaggor (med --build):>
+
+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<dpkg-source>
+att leta efter originalkällkodstarfilen
+I<paket>B<_>I<uppströmsversion>B<.orig.tar.gz> eller
+originalkällkodskatalogen I<paket>B<.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
+I<paket>B<_>I<uppströmsversion>B<.orig.tar.>I<filändelse>. 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 I<katalog>B<.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
+I<paket>B<->I<uppströmsversion>B<.orig> och att B<dpkg-source> 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<dpkg-source> 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<dpkg-source> 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<debian/source/options>, men kan användas i
+B<debian/source/local-options>.
+
+=back
+
+B<Extraheringsflaggor (med --extract):>
+
+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<Detta är standard.>)
+
+=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<X>-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<debian/patches/> 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<zz_debian-diff-auto>.
+
+=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<ext>, där I<ext> kan vara
+B<gz>, B<bz2>, B<lzma> eller B<xz>) och en Debiantarboll
+(B<.debian.tar.>I<ext>). Den kan även innehålla ytterligare
+original-tarbollar (B<.orig->I<komponent>B<.tar.>I<ext>). I<komponent> 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.>I<ext>B<.asc> och
+B<.orig->I<komponent>B<.tar.>I<ext>B<.asc>), uppackning stöds sedan dpkg
+1.17.20, byggning stöds sedan dpkg 1.18.5.
+
+B<Uppackning>
+
+Huvud-originaltarbollen packas upp först, därefter packas alla ytterligare
+originaltarbollar upp i underkataloger med namn efter I<komponent>-delen i
+sitt filnamn (eventuella redan befintliga kataloger
+ersätts). Debian-tarbollen packas sedan upp ovanpå källkodskatalogen efter
+att en redan befintlig B<debian>-katalog har tagits bort först. Observera
+att debian-tarbollen måste bestå av en B<debian>-underkatalog, men att den
+även kan innehålla binärfiler utanför den katalogen (se flaggan
+B<--include-binaries>).
+
+Alla patchar listade i B<debian/patches/>I<återförsäljare>B<.series> eller
+B<debian/patches/series> tillämpas sedan, där I<återförsäljare> är namnet på
+den aktuella återförsäljaren skrivet med små bokstäver, eller B<debian> 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<quilt> 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<debian/rules>. 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<dpkg-source> 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<patch>. Det kommer
+därför visa en varning sådana flaggor upptäcks, och bygget kommer troligen
+att misslyckas.
+
+Oberbera att B<lintian>(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<lintian>(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<quilt>: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<quilt>, om inte kommer B<dpkg-source> rapportera
+ett felmeddelande när det försöker tillämpa dem.
+
+Patchar kan även ta bort filer, på samma sätt som B<quilt> normalt fungerar.
+
+Filen B<.pc/applied-patchers> skapas om patchar tillämpades vid
+uppackningen.
+
+B<Bygga>
+
+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 (B<debian-changes>I<version> eller B<debian-changes>,
+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<quilt>-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<debian/source/include-binaries>). Byggningen kommer
+även att misslyckas om binärfiler upptäcks i debian-underkatalogen, såvida
+de inte har tillåtits i B<debian/source/include-binaries>.
+
+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<quilt>, katalogen kommer att ignoreras när
+den automatiska patchen skapas.
+
+B<Observera:> B<dpkg-source> 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<series> 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<Lagra ändringar>
+
+=over
+
+=item B<--commit> [I<katalog>] [I<patchnamn>] [I<patch-fil>]
+
+Skapar en patch som motsvarar de lokala ändringar som inte hanteras av
+B<quilt>-patch-systemet och integrerar dem i patch-systemet under namnet
+I<patchnamn>. Om namnet saknas kommer programmet be om ett interaktivt. Om
+I<patch-fil> 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<patchfil> 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<debian/source/include-binaries> så att de
+dyker upp i debian-tarbollen (precis som B<dpkg-source --include-binaries
+--build> skulle gjort).
+
+=back
+
+B<Byggflaggor>
+
+=over
+
+=item B<--allow-version-of-quilt-db=>I<version>
+
+Tillåt B<dpkg-source> att bygga källkodspaketet om versionen av
+B<quilt>-metadata är den som angavs, även om B<dpkg-source> inte känner till
+den (sedan dpkg 1.15.5.4). Det betyder att den givna versionen av
+B<quilt>-metadata är kompatibel med version 2 som B<dpkg-source> för
+närvarande stöder. Versionen av B<quilt>-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<debian/source/include-binaries>: 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<debian/patches/debian-changes> istället för
+B<debian/patches/debian-changes->I<version> 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<debian/source/local-options> och följs av filen
+B<debian/source/local-patch-header> 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<dpkg-source> 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<debian/source/local-options> 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<quilt>-patchar innan källkodspaketet
+byggts. Flaggan tillåts inte i B<debian/source/options>, men kan användas i
+B<debian/source/local-options>.
+
+=item B<--auto-commit>
+
+Processen misslyckas inte om en automatisk patch har skapats, den läggs
+istället direkt in i B<quilt>-serien.
+
+=back
+
+B<Extraheringsflaggor>
+
+=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<Byggflaggor>
+
+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<värde>
+
+B<Krävs>. Anger det riktiga formatet på det genererade källkodspaketet. Den
+skapade .dsc-filen kommer innehålla detta värde i sitt B<Format>-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<Uppackning>
+
+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<remotes/origin/>.
+
+B<Bygga>
+
+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<git-bundle>(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<Byggflaggor>
+
+=over
+
+=item B<--git-ref=>I<ref>
+
+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<ref> 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<git-rev-list>(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<antal>
+
+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<Uppackning>
+
+Tarbollen packas upp och bzr används sedan för att hämta ut den aktuella
+grenen.
+
+B<Bygga>
+
+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<debian/source/format> 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<dpkg-source> 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<dpkg-source> 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<debian/source/format>.
+
+=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<fil>
+
+Ä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<fil> 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<läge> på I<fil> 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<läge> på I<fil> 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<DPKG_COLORS>
+
+Väljer färgläge (sedan dpkg 1.18.5). För närvarande godtas följande värden:
+B<auto> (förval), B<always> och B<never>.
+
+=item B<DPKG_NLS>
+
+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<SOURCE_DATE_EPOCH>
+
+Om satt kommer det användas som tidsstämpel (som sekunder sedan epoken) för
+att tvinga mtime i B<tar>(5)-filposterna.
+
+=item B<VISUAL>
+
+=item B<EDITOR>
+
+Används av källkodsformatmodulerna ”2.0” och ”3.0 (quilt)”.
+
+=item B<GIT_DIR>
+
+=item B<GIT_INDEX_FILE>
+
+=item B<GIT_OBJECT_DIRECTORY>
+
+=item B<GIT_ALTERNATE_OBJECT_DIRECTORIES>
+
+=item B<GIT_WORK_TREE>
+
+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<dpkg-source --build> eller
+B<dpkg-source --print-format>. 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<Observera:> B<format>-flaggor tillåts inte i den här filen, du bör använda
+filen B<debian/source/format> istället.
+
+=head2 debian/source/local-options
+
+Precis som B<debian/source/options> 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<local-patch-header> tas inte med i det
+genererade källkodspaketet medan B<patch-header> 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<debian/patches/>-katalogen) upp till det första blankstegstecknet eller
+slutet på raden. Valfria flaggor till B<quilt> 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<deb-src-control>(5), B<deb-changelog>(5), B<dsc>(5).
+
+
+=head1 ÖVERSÄTTNING
+
+Peter Krefting och Daniel Nylander.