"Fossies" - the Fresh Open Source Software archive 
Member "dpkg-1.16.10/man/sv/dpkg-source.1" of archive dpkg_1.16.10.tar.gz:
Table of Contents
dpkg-source - Verktyg för att manipulera Debiankällkodspaket
(.dsc)
dpkg-source [flagga...] åtgärd
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.
- -x filnamn.dsc [utdatakatalog]
- Extrahera
ett källkodspaket. Ett argument som inte är en flagga måste anges, namnet
på debiankällkodsstyrfilen (.dsc). Ett valfritt andra argument som inte är
en flagga kan anges för att bestämma vilken katalog källkoden skall packas
upp i, det får inte existera. Om du inte anger någon utdatakatalog extraheras
källkodspaketet till en katalog som heter källkod-version i den aktuella
arbetskatalogen.
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 .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ällkoden 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 debian/source/format så att det används som standard
när källkodspaketet byggs på nytt.
- -b katalog [formatspecifika-flaggor]
- Bygg
ett källkodpaket. 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.
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
--format, formatet som anges 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 debian/source/format.
Se avsnittet FORMAT PÅ KÄLLKODSPAKET för en utförlig beskrivning av de
olika källkodspaketformaten.
- --print-format katalog
- Visa formatet som skulle
användas för att bygga källkodspaketet om dpkg-source -b katalog skulle köras
(under samma förhållanden och med samma parametrar).
- --before-build katalog
- Kör motsvarande krok för källkodspaketformatet. Kroken anropas innan något
från paketet byggs (dpkg-buildpakcage anropar det väldigt tidigt, till och
med före 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.
- --after-build
katalog
- Kör motsvarande krok för källkodspaketformatet. Kroken anropas efter
att allt från paketet byggts (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 --before-build har gjort.
- --commit [katalog]
...
- Spara ändringar i källkodsträdet som har packats upp i katalog. Kommandot
kan ta ytterligare parametrar beroende på källkodsformatet. Ett fel kommer
rapporteras för format där operationen inte har någon betydelse.
- -?, --help
- Visar hjälpskärm och avslutar.
- --version
- Visar version och avslutar.
- -ccontrol-fil
- Anger huvudkällkodsstyrfil som information skall
läsas från. Standardvärde är debian/control. Om ett relativt sökvägsnamn
anges tolkas det från källkodsträdets toppnivåkatalog.
- -ländringsloggfil
- Anger ändringsloggsfil som information skall läsas från. Standardvärde är
debian/changelog. Om ett relativt sökvägsnamn anges tolkas det från källkodsträdets
toppnivåkatalog.
- -Fändringsloggformat
- Anger format på ändringsloggen. Se dpkg-parsechangelog(1)
för information om alternativa format.
- --format=värde
- Använd det givna formatet
för att bygga källkodspaketet. Det överstyr inte ett eventuellt format som
anges i debian/source/format.
- -Vnamn=värde
- Ställer in en utdatasubstitueringsvariabel.
Se deb-substvars(5) för en beskrivning av utdatasubstituering.
- -Tsubstvars-fil
- Läs substitueringsvariabler från 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.
- -Dfält=värde
- Ersätt eller lägg till ett fält i den genererade
control-filen.
- -Ufält
- Ta bort ett fält ur den genererade control-filen.
- -Zkomprimering,
--compression=komprimering
- Anger vilken komprimering som skall användas för
de skapade filerna (tar-bollar och diffar). Observera att flaggan inte gör
att befintliga tar-bollar packas om, utan enbart påverkar nya filer. Värden
som stöds är: gzip, bzip2, lzma samt xz. gzip är förvalet. Stöd för xz finns
bara från och med dpkg-dev 1.15.5.
- -znivå, --compression-level=nivå
- Komprimeringsnivå
att använda. Som med -Z påverkas bara filer som nyskapas. Värden som stöds
är: 1 till 9, best (bäst) och fast (snabb). 9 är förval för gzip och bzip2,
6 för xz och lzma.
- -i[reg.uttr], --diff-ignore[=reg.uttr]
- Du kan ange ett reguljärt
uttryck i perlformat för att matcha filer som du vill skall filtreras ut
ur listan över filer för diffen. (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.) -i ensamt aktiverar funktionen, med ett
standardvärde 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 -i-flaggor är det
den sista på kommandoraden 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 ’(^|/)’, ’($|/)’).
- --extend-diff-ignore=reg.uttr
- Det reguljära uttrycket i perlformat som angavs utökar standardvärdet för
--diff-ignore och dess nuvarande värde (om satt). Det gör så genom att lägga
till "|reg.uttry" efter standarduttrycket. Flaggan är nyttig för debian/source/options
för att exkludera en del automatiskt genererade filer från skapandet av
automatiska patchar.
- -I[filmönster], --tar-ignore[=filmönster]
- Om flaggan anges
kommer filnamnet att sändas vidare till tar(1):s --exclude-flagga när det
anropas för att skapa en .orig.tar.gz eller .tar.gz-fil. Till exempel kommer -ICVS
att hoppa över CVS-kataloger när tar.gz-filen skapas. Flaggan kan upprepas
flera gånger för att lista flera filnamn som skall uteslutas.
-i ensamt
aktiverar funktionen, med ett standardvärde som filtrerar ut styrfiler
och kataloger från de flesta vanliga versionshanteringssystem, säkerhetskopior,
växlingsfiler och Libtool-byggutdatakataloger.
Observera: Även om de används
till liknande ändamål, så har -i och -I väldigt olika syntax och semantik.
-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. -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 --exclude-flagga
är något komplicerad, se http://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 --help-kommandot.
- --no-copy
- Kopiera inte original-tarbollar i närheten av det uppackade källkodspaketet.
- --no-check
- Kontrollera inte signaturer och kontrollsummor före uppackning.
- --require-valid-signature
- Vägra packa upp källkodspaketet om det inte innehåller
en OpenPGP-signatur som kan verifieras antingen med användarens trustedkeys.gpg-nyckelring,
en av de säljarspecifka nyckelringarna, eller en av de officiella Debiannyckelringarna
(/usr/share/keyrings/debian-keyring.gpg och /usr/share/keyrings/debian-maintainers.gpg).
Om du inte vet vilket källkodspaketformat du skall
använda, bör du antagligen välja antingen "3.0 (quilt)" eller "3.0 (native)".
Se http://wiki.debian.org/Projects/DebSrc3.0 för information om hur dessa
format sätts i produktion i Debian.
Ett källkodspaket i detta
format består antingen av en .orig.tar.gz, förbunden med en .diff.gz, eller
en ensam .tar.gz (i så fall anses paketet vara eget, "native").
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 .orig.tar.gz-filen och sedan genom att tillämpa patchen som finns i .diff.gz-filen.
Tidsstämplarna för alla 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).
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 .diff.gz-filen på nytt genom att jämföra källkodspaketets
katalog med .orig-katalogen.
- Byggflaggor (med -b):
Om ett andra argument som
inte är en flagga anges skall 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 dpkg-source att leta efter originalkällkodstarfilen paket_uppströmsversion.orig.tar.gz
eller originalkällkodskatalogen paket.orig beroende på -sX-flaggorna.
-sa,
-sp, -sk, -su och -sr skriver inte över befintliga tar-filer och kataloger. Om
det önskas bör -sA, -sP, -sK, -sU och -sR anges i stället.
- -sk
- Anger att den
ursprungliga källkoden är en tar-fil, som standard paket_uppströmsversion.orig.tar.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 katalog.orig för att generera diffen.
- -sp
- Som -sk, men tar
bort katalogen igen efteråt.
- -su
- Anger att originalkällkoden är en katalog,
som standard paket-uppströmsversion.orig och att dpkg-source skall skapa ett
nytt originalkällkodsarkiv från den.
- -sr
- Som -su, men tar bort katalogen när
den har använts.
- -ss
- Anger att originalkällkoden finns både som en katalog
och en tar-fil. Katalogen kommer att användas av dpkg-source för att skapa
diffen, men tarfilen för att skapa .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.
- -sn
- Anger att dpkg-source inte skall leta
efter något källkodsarkiv och att ingen diff skall 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.
- -sa eller -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 -sn).
Om en tarfil hittas kommer programmet att packa upp den för att skapa en
diff och ta bort den efteråt (motsvarar -sp). Om en katalog hittas kommer
den att packas för att skapa originalkällkoden och ta bort den efteråt
(motsvarar -sn). Om båda hittas kommer dpkg-source att ignorera katalogen,
och skriva över den om -sA angavs (detta motsvarar -sP) eller ge ett felmeddelande
om -sa angavs. -sA är standard.
- --abort-on-upstream-changes
- Processen misslyckas
om den genererade diffen innehåller ändringar av filer utanför underkatalogen
debian. Den här flaggan tillåts inte i debian/source/options, men kan användas
i debian/source/local-options.
- Extraheringsflaggor (med -x):
Oavsett kommer
ett befintligt källkodsträd att tas bort.
- -sp
- Används när originalkällkoden
som extraheras (om sådan finns) skall 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. (Detta är standard.)
- -su
- Packar
upp originalkällkodsträdet.
- -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.
Alla -sX-flaggor
är ömsesidigt uteslutande. Om du anger mer än en kommer endast den sista
att användas.
- --skip-debianization
- Hoppas över att tillämpa debian-diffen ovanpå
uppströmskällkoden.
Ä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 debian/patches/
som motsvarar det Perl-reguljära uttrycket [\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 zz_debian-diff-auto.
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
-i i texten för --help).
Ett källkodspaket i detta format
innehåller åtminstone en original-tarboll (.orig.tar.ext, där ext kan vara
gz, bz2, lzma eller xz) och en Debiantarboll (.debian.tar.ext). Den kan även
innehålla ytterligare original-tarbollar (.orig-komponent.tar.ext). komponent
kan endast innehålla alfanumeriska tecken och bindestreck ("-").
Uppackning
Huvud-originaltarbollen packas upp först, därefter packas alla ytterligare
originaltarbollar upp i underkataloger med namn efter komponent-delen i
sitt filnamn (eventuella redan befintliga kataloger ersätts). Debian-tarbollen
packas sedan upp ovanpå källkodskatalogen efter att en redan befintlig
debian-katalog har tagits bort först. Observera att debian-tarbollen måste
bestå av en debian-underkatalog, men att den även kan innehålla binärfiler
utanför den katalogen (se flaggan --include-binaries).
Alla patchar listade
i debian/patches/debian.series eller debian/patches/series tillämpas sedan.
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 quilt till att
hantera patchuppsättningen. Observera att, även om 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 -p1 till patch. Det kommer därför visa en varning sådana flaggor
upptäcks, och bygget kommer troligen att misslyckas.
Till skillnad mot 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 quilt, om
inte kommer dpkg-source rapportera ett felmeddelande när det försöker tillämpa
dem.
Patchar kan även ta bort filer, på ungfär samma sätt som quilt normalt
fungerar.
Filen .pc/applied-patchers skapas om patchar tillämpades vid uppackningen.
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 (debian-changesversion eller debian-changes, beroende på --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 --single-debian-patch eller --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
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 debian/source/include-binaries).
Byggningen kommer även att misslyckas om binärfiler upptäcks i debian-underkatalogen,
såvida de inte har vitlistats i 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 -i i texten för --help). Detta gäller
speciellt katalogen .pc som används av quilt, katalogen kommer att ignoreras
när den automatiska patchen skapas.
Observera: dpkg-source --before-build (och
-b) 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 series men inte i .pc/applied-patches), och om
den första patchen i listan kan tillämpas utan fel kommer samtliga att
tillämpas. Flaggan --no-preparation kan användas för att slå av detta beteende.
Lagra ändringar
- --commit [katalog] [patchnamn] [patch-fil]
- Skapar en patch
som motsvarar de lokala ändringar som inte hanteras av quilt-patch-systemet
och integrerar dem i patch-systemet under namnet patchnamn. Om namnet saknas
kommer programmet be om ett interaktivt. Om patch-fil anges används den som
patch som motsvarar de lokala ändringar som skall 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 patchfil efter att
ett bygge där filen skapats i förväg misslyckas, och att patchfilen därför
skall 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 debian/source/include-binaries så att de dyker upp i debian-tarbollen
(precis som dpkg-source --include-binaries -b skulle gjort).
Byggflaggor
- --allow-version-of-quilt-db=version
- Tillåt dpkg-source att bygga källkodspaketet om versionen av quilt-metadata
är den som angavs, även om dpkg-source inte känner till den. Det betyder
att den givna versionen av quilt-metadata är kompatibel med version 2 som
dpkg-source för närvarande stöder. Versionen av quilt-metadata lagras i .pc/.version.
- --include-removal
- Ignorera inte borttagna filer och ta med dem i den automatiskt
genererade patchen.
- --include-timestamp
- Ta med tidsstämpel i den automatiskt
genererade patchen.
- --include-binaries
- Lägg till alla modifierade binärer i
debian-tarbollen. Lägg även till dem i 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.
- --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.
- --single-debian-patch
- Använd debian/patches/debian-changes istället för debian/patches/debian-changes-version
som namn på den automatiska patch som genereras vid bygget. 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 debian/source/local-options
och följs av filen debian/source/local-patch-header som beskricer hur Debianändringarna
bäst kan ses, till exempel i det versionshanteringssystem som används.
- --create-empty-orig
- Skapa huvud-originaltarbollen som tom automatiskt om den saknas och om det
finns supplement-originaltarbollar. 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.
- --no-unapply-patches, --unapply-patches
- Som standard kommer dpkg-source
att automatiskt ta bort patchar i kroken --after-build om de applicerades
under --before-build. 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 debian/source/local-options så att alla genererade källkodspaket
som standard har samma beteende.
- --abort-on-upstream-changes
- Processen misslyckas
om en automatisk patch har genererats. Flaggan kan användas för att se till
att alla ändringar har lagrats undan korrekt i separata quilt-patchar innan
källkodspaketet byggts. Flaggan tillåts inte i debian/source/options, men
kan användas i debian/source/local-options.
- --auto-commit
- Processen misslyckas
inte om en automatisk patch har skapats, den läggs istället direkt in i
quilt-serien.
Extraheringsflaggor
- --skip-debianization
- Hoppas över att packa
upp debian-tarbollen ovanpå uppströmskällkoden.
- --skip-patches
- Applicera inte
patchar i slutet av uppackningen.
Detta formatet
är speciellt. Det anger inte ett riktigt källkodspaketformat, utan kan användas
för att skapa källkodspaket med godtyckliga filer.
Byggflaggor
Alla argument
som inte är flaggor tas som filer som skall integreras i det skapade källkodspaketet.
De måste finnas, och helst i aktuell katalog. Åtminstone en fil måste anges.
- --target-format=värde
- Krävs. Anger det riktiga formatet på det genererade källkodspaketet.
Den skapade .dsc-filen kommer innehålla detta värde i sitt Format-fält och
inte "3.0 (custom)".
Formatet är experimentellt.
Ett källkodspaket
i detta format består av en ensam "bundle" från ett git-arkiv .git, vilket
innehåller paketets källkod. Filen .gitshallow, som innehåller revisioner
för grunda git-kloner, kan även förekomma.
Uppackning
"Bundle":n klonas som
ett git-arkiv till målkatalogen. Om filen gitshallow finns installeras den
som ".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
"remotes/origin/".
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.
git-bundle(1) används för att generera en "bundle" från git-arkivet.
Som standard tas alla grenar och taggar i arkivet med i "bundle":n.
Byggflaggor
- --git-ref=ref
- Gör det möjligt att ange en git-referens som skall tas med i
"bundle":n. Om den anges överstyr den standardbeteendet som är att ta med
alla grenar och taggar. Kan anges flera gånger. ref kan vara namnet på en
gren eller tagg som skall tas med. Den kan även vara vilken som helst annan
parameter som kan sändas med till git-rev-list(1). För att, till exempel,
endast ta med grenen "master", angänd --git-ref=master. För att ta med alla
taggar och grenar, förutom grenen private, använd --git-ref=--all --git-ref=^private
- --git-depth=antal
- Skapar en grund klon med en historik som är avhuggen vid
det angivna antalet revisioner.
Detta format är experimentellt.
Det genererar en ensam tarboll som innehåller bzr-arkivet.
Uppackning
Tarbollen
packas upp och bzr används sedan för att hämta ut den aktuella grenen.
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.
Filen 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 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 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 debian/source/format.
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
skall 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.
Ä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.
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.
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.
Filen
innehåller på en ensam rad det format som skall användas för att bygga
källkodspaketet (möjliga format beskrivs ovan). Varken ledande eller avslutande
blanksteg tillåts.
Filen innehåller en förteckning
över binärfiler (en per rad) som skall tas med i debian-tarbollen. Inledande
och avslutande blanksteg tas bort. Rader som börjar med "#" är kommentarer
och hoppas över. Tomma rader ignoreras.
Filen innehåller
en lista över långa flaggor som automatiskt sätts in före kommandoradsflaggorna
som anges i ett anrop til dpkg-source -b eller dpkg-source --print-format. Flaggor
som --compression och --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 "#" ignoreras. Inledande "--" skall tas bort och korta flaggor är inte
tillåtna. Blanksteg tillåts runt "="-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)$"
Observera: format-flaggor tillåts inte i den här filen, du bör använda
filen debian/source/format istället.
Precis som
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.
Friformstext
som läggs in på toppen av den automatiskt genererade patchen i formaten
"2.0" eller "3.0 (quilt)". local-patch-header tas inte med i det genererade
källkodspaketet medan patch-header tas med.
Listar alla
patchar som måste tillämpas (i den givna ordningen) ovanpå uppströmskällkodspaketet.
Inledande och avslutande blanksteg tas bort. Rader som börjar med "#" är
kommentarer och ignoreras. Tomma rader ignoreras. De rader som är kvar inleds
med filnamnet på en patchfil (relativt till debian/patches/-katalogen) upp
till det första blankstegstecknet eller slutet på raden. Valfria flaggor
till quilt kan följa fram till slutet av raden eller det första "#" som
följer på ett eller flera blanksteg (vilket anger början på en kommentar
fram till slutet av raden).
Tidpunkten på fältöverstyrning inträffar
jämfört med inställning av vissa standardutdatafält är ganska förvirrad.
dpkg-deb(1), dpkg(1), dselect(1).
Peter Krefting och Daniel
Nylander.
Table of Contents