NAMN
dpkg−source − Verktyg för att manipulera Debiankällkodspaket (.dsc)
SYNOPS
dpkg−source [flaggor] åtgärd
BESKRIVNING
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.
KOMMANDON
−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
Kommandot bör anropas innan paketet byggs (dpkg−buildpakcage anropar det väldigt tidigt, till och med före debian/rules clean). Kommandot bör vara idempotent och kunna 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
Kommandot bör anropas efter paketet har byggts (dpkg−buildpackage anropar det sist). Kommandot bör vara idempotent och kunna 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.
−h, −−help
Visar hjälpskärm och avslutar.
−−version
Visar version och avslutar.
ALLMÄNNA BYGGFLAGGOR
−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. Som standard läses formatet från en speciell rad nära slutet av ändringsloggen, eller så används Debians standardformat om ingen information hittas.
−−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.
−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 standarduttrycket för −i 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.
ALLMÄNNA UPPACKNINGSFLAGGOR
−−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).
FORMAT PÅ KÄLLKODSPAKET
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.
Format:
1.0
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.
Format:
2.0
Ä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.
Format: 3.0
(eget)
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).
Format: 3.0
(quilt)
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.
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 och diffen (om den inte är tom) lagras i denautomatiska 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 förväntar att källkodspaketet har alla patchar som anges i seriefilen tillämpade när källkodspaketet genereras. Detta gäller inte när källkodsträdet har hämtats genom att packa upp ett källkodspaket med till exempel Format: 1.0. För att motverka detta problem kommer dpkg−source självt att tillämpa patchar om det tror att de ännu inte har tillämpats. För att upptäcka om så är fallet används följande heuristik: om en lista över förmodligen ej applicerade patchar (de listas i series−filen 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. Operationen utförs normalt som en del av kommandot −−prepare−build.
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. När den här flaggan används rekommenderar vi att du skapar en debian/source/patch−header−fil som förklarar 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.
−−unapply−patches
Ta bort patchar i kroken −−after−build. Flaggan är huvudsakligen användbar när du bygger direkt från ett versionshanteringssystem som innehåller opatchad uppströmskod och du vill hålla trädet opatchat även efter ett paketbygge. Flaggan läggs normalt i debian/source/local−options (den är inte tillåten i debian/source/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.
Extraheringsflaggor
−−skip−debianization
Hoppas över att packa upp debian−tarbollen ovanpå uppströmskällkoden.
−−skip−patches
Applicera inte patchar i slutet av uppackningen.
Format: 3.0
(skräddarsytt)
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)".
Format: 3.0
(git)
This format is experimental. It uses a bundle of a git
repository to hold the source of a package.
Uppackning
The bundle is cloned to a new git repository.
Note that by default the new repository will have the same branch checked out that was checked out in the original source. (Typically "master", but it could be anything.) Any other branches will be available, under as ’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) is used to generate a bundle of the git repository. By default, all branches and tags in the repository are included in the bundle.
Byggflaggor
−−git−ref=ref
Allows specifying a git ref to include in the git bundle. Use disables the default behavior of including all branches and tags. May be specified multiple times. The ref can be the name of a branch or tag to include. It may also be any parameter that can be passed to git−rev−list(1). For example, to include only the master branch, use −−git−ref=master. To include all tags and branches, except for the private branch, use −−git−ref=−−all −−git−ref=^private
−−git−depth=number
Creates a shallow clone with a history truncated to the specified number of revisions.
Format: 3.0
(bzr)
This format is experimental. It generates a single tarball
containing the bzr repository.
Uppackning
The tarball is unpacked and then bzr is used to checkout the current branch.
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.
VARNINGAR OCH FELMEDDELANDEN
källkodsformat
ej angivet i debian/source/format
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.
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
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.
kan inte
representera ändringen för 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.
den tomma
filen 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.
exekveringsläge
läge på fil kommer inte
representeras i diffen
specialläget läge på
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.
FILFORMAT
debian/source/format
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.
debian/source/include−binaries
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.
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
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
Observera: format−flaggor tillåts inte i den här filen, du bör använda filen debian/source/format istället.
debian/source/local−options
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.
debian/source/patch−header
Friformstext som läggs in på toppen av den
automatiskt genererade patchen i formaten "2.0"
eller "3.0 (quilt)".
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. 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).
PROGRAMFEL
Tidpunkten på fältöverstyrning inträffar jämfört med inställning av vissa standardutdatafält är ganska förvirrad.
SE ÄVEN
dpkg−deb(1), dpkg(1), dselect(1).
FÖRFATTARE
Upphovsrättsskyddat
© 1995−1996 Ian Jackson
Upphovsrättsskyddat © 2000 Wichert Akkerman
Upphovsrättsskyddat © 2008−2010 Raphaël
Hertzog
Detta är fri programvara; se GNU General Public License version 2 eller senare för kopieringsvillkor. Det finns INGEN GARANTI.
ÖVERSÄTTNING
Peter Krefting och Daniel Nylander.