.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.40)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "dpkg-source 1"
.TH dpkg-source 1 "2022-09-01" "1.20.12" "dpkg suite"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAMN"
.IX Header "NAMN"
dpkg-source \- Verktyg f\(:or att manipulera Debiank\(:allkodspaket (.dsc)
.SH "SYNOPS"
.IX Header "SYNOPS"
\&\fBdpkg-source\fR [\fIflagga\fR...] \fI\(oatg\(:ard\fR
.SH "BESKRIVNING"
.IX Header "BESKRIVNING"
\&\fBdpkg-source\fR packar och packar upp Debiank\(:allkodsarkiv.
.PP
Inga av dessa kommandon till\(oater att flera flaggor kombineras till ett, och
de till\(oater inte att v\(:ardet p\(oa en flagga anges som ett separat argument.
.SH "KOMMANDON"
.IX Header "KOMMANDON"
.IP "\fB\-x\fR, \fB\-\-extract\fR \fIfilename\fR.dsc [\fIutdatakatalog\fR]" 4
.IX Item "-x, --extract filename.dsc [utdatakatalog]"
Extrahera ett k\(:allkodspaket (\fB\-\-extract\fR sedan dpkg 1.17.14). Ett argument
som inte \(:ar en flagga m\(oaste anges, namnet p\(oa debiank\(:allkodsstyrfilen
(\fB.dsc\fR). Ett valfritt andra argument som inte \(:ar en flagga kan anges f\(:or
att best\(:amma vilken katalog k\(:allkoden ska packas upp i, det f\(oar inte
existera. Om du inte anger n\(oagon utdatakatalog extraheras k\(:allkodspaketet
till en katalog som heter \fIk\(:allkod\fR\-\fIversion\fR i den aktuella
arbetskatalogen.
.Sp
\&\fBdpkg-source\fR l\(:aser namnen p\(oa de \(:ovriga filer som ing\(oar i k\(:allkodspaketet
fr\(oan styrfilen; de antas vara i samma katalog som \fB.dsc\fR\-filen.
.Sp
Filerna i det extraherade paketet kommer att ha beh\(:orighet och \(:agare satta
till det som kunde f\(:orv\(:antas om filerna och katalogerna bara hade skapats \-
kataloger och k\(:orbara filer kommer ha 0777 och enkla filer 0666, b\(oada
modifierade av uppackarens umask; om f\(:or\(:aldrakatalogen \(:ar setgid kommer de
extraherade katalogerna ocks\(oa att vara det, och samtliga filer och kataloger
kommer \(:arva dess grupp\(:agarskap.
.Sp
Om k\(:allkodspaketet anv\(:ander ett annat format \(:an standardformatet (g\(:aller f\(:or
n\(:arvarande alla format f\(:orutom \(rq1.0\(rq), kommer dess namn att lagras som
\&\fBdebian/source/format\fR s\(oa att det anv\(:ands som standard n\(:ar k\(:allkodspaketet
byggs p\(oa nytt.
.IP "\fB\-b\fR, \fB\-\-build\fR \fIdirectory\fR [\fIformatspecifika-flaggor\fR]" 4
.IX Item "-b, --build directory [formatspecifika-flaggor]"
Bygg ett k\(:allkodpaket (\fB\-\-build\fR sedan dpkg 1.17.14). Det f\(:orsta argumentet
som inte \(:ar en flagga tas som namn p\(oa katalogen som inneh\(oaller det
debianiserade k\(:allkodstr\(:adet (dvs. med underkatalogen \(rqdebian\(rq och kanske
\(:andringar p\(oa originalfilerna). Beroende p\(oa vilket k\(:allkodspaketformat som
anv\(:ands f\(:or att bygga formatet kan ytterligare parametrar kanske godtas.
.Sp
\&\fBdpkg-source\fR kommer bygga k\(:allkodspaketet med det f\(:orsta format som
fungerar fr\(oan denna lista i denna ordning: formatet som anges med
kommandoradsflaggan \fI\-\-format\fR, formatet som anges i
\&\fIdebian/source/format\fR, \(rq1.0\(rq. Standardv\(:ardet \(rq1.0\(rq rekommenderas ej och
kommer att tas bort en g\(oang i framtiden, du b\(:or alltid dokumentera det
\(:onskade k\(:allkodsformatet i \fBdebian/source/format\fR. Se avsnittet \fB\s-1FORMAT\s0 P\(oA
K\(:ALLKODSPAKET\fR f\(:or en utf\(:orlig beskrivning av de olika
k\(:allkodspaketformaten.
.IP "\fB\-\-print\-format\fR \fIkatalog\fR" 4
.IX Item "--print-format katalog"
Visa formatet som skulle anv\(:andas f\(:or att bygga k\(:allkodspaketet om
\&\fBdpkg-source \-\-build\fR \fIkatalog\fR skulle k\(:oras (under samma f\(:orh\(oallanden och
med samma parametrar; sedan dpkg 1.15.5).
.IP "\fB\-\-before\-build\fR \fIkatalog\fR" 4
.IX Item "--before-build katalog"
K\(:or motsvarande krok f\(:or k\(:allkodspaketformatet (sedan dpkg 1.15.8). Kroken
anropas innan n\(oagot fr\(oan paketet byggs (\fBdpkg-buildpakcage\fR anropar det
v\(:aldigt tidigt, till och med f\(:ore \fBdebian/rules clean\fR). Kommandot \(:ar
idempotent och kan anropas flera g\(oanger. Det \(:ar inte alla k\(:allkodsformat som
implementerar n\(oagot i den h\(:ar kroken, och de som g\(:or det f\(:orbereder oftast
k\(:allkodstr\(:adet f\(:or att byggas, till exempel genom att se till att
Debianpatchar har applicerats.
.IP "\fB\-\-after\-build\fR \fIkatalog\fR" 4
.IX Item "--after-build katalog"
K\(:or motsvarande krok f\(:or k\(:allkodspaketformatet (sedan dpkg 1.15.8). Kroken
anropas efter att allt fr\(oan paketet byggts (\fBdpkg-buildpakcage\fR anropar det
sist). Kommandot \(:ar idempotent och kan anropas flera g\(oanger. Det \(:ar inte
alla k\(:allkodsformat som implementerar n\(oagot i den h\(:ar kroken, och de som g\(:or
det anv\(:ander den normalt f\(:or att \(oaterst\(:alla det som \fB\-\-before\-build\fR har
gjort.
.IP "\fB\-\-commit\fR [\fIkatalog\fR] ..." 4
.IX Item "--commit [katalog] ..."
Spara \(:andringar i k\(:allkodstr\(:adet som har packats upp i \fIkatalog\fR (sedan
dpkg 1.16.1). Kommandot kan ta ytterligare parametrar beroende p\(oa
k\(:allkodsformatet. Ett fel kommer rapporteras f\(:or format d\(:ar operationen inte
har n\(oagon betydelse.
.IP "\fB\-?\fR, \fB\-\-help\fR" 4
.IX Item "-?, --help"
Visar hj\(:alpsk\(:arm och avslutar. De formatspecifika bygg\- och
extraheringsflaggorna kan visas genom att anv\(:anda flaggan \fB\-\-format\fR.
.IP "\fB\-\-version\fR" 4
.IX Item "--version"
Visar version och avslutar.
.SH "FLAGGOR"
.IX Header "FLAGGOR"
.SS "Generiska byggflaggor"
.IX Subsection "Generiska byggflaggor"
.IP "\fB\-c\fR\fIcontrol-fil\fR" 4
.IX Item "-ccontrol-fil"
Anger huvudk\(:allkodsstyrfil som information ska l\(:asas fr\(oan. Standardv\(:arde \(:ar
\&\fBdebian/control\fR. Om ett relativt s\(:okv\(:agsnamn anges tolkas det fr\(oan
k\(:allkodstr\(:adets toppniv\(oakatalog.
.IP "\fB\-l\fR\fI\(:andringsloggfil\fR" 4
.IX Item "-l\(:andringsloggfil"
Anger \(:andringsloggsfil som information ska l\(:asas fr\(oan. Standardv\(:arde \(:ar
\&\fBdebian/changelog\fR. Om ett relativt s\(:okv\(:agsnamn anges tolkas det fr\(oan
k\(:allkodstr\(:adets toppniv\(oakatalog.
.IP "\fB\-F\fR\fI\(:andringsloggformat\fR" 4
.IX Item "-F\(:andringsloggformat"
Anger format p\(oa \(:andringsloggen. Se \fBdpkg-parsechangelog\fR(1) f\(:or information
om alternativa format.
.IP "\fB\-\-format=\fR\fIv\(:arde\fR" 4
.IX Item "--format=v\(:arde"
Anv\(:and det givna formatet f\(:or att bygga k\(:allkodspaketet (sedan dpkg
1.14.17). Det \(:overstyr ett eventuellt format som anges i
\&\fBdebian/source/format\fR.
.IP "\fB\-V\fR\fInamn\fR\fB=\fR\fIv\(:arde\fR" 4
.IX Item "-Vnamn=v\(:arde"
St\(:aller in en utdatasubstitueringsvariabel. Se \fBdeb-substvars\fR(5) f\(:or en
beskrivning av utdatasubstituering.
.IP "\fB\-T\fR\fIsubstvars-fil\fR" 4
.IX Item "-Tsubstvars-fil"
L\(:as substitueringsvariabler fr\(oan \fIsubstvarfil\fR; standardv\(:arde \(:ar att inte
l\(:asa n\(oagon fil. Flaggan kan anv\(:andas flera g\(oanger f\(:or att l\(:asa
substitueringsvariabler fr\(oan flera filer (sedan dpkg 1.15.6).
.IP "\fB\-D\fR\fIf\(:alt\fR\fB=\fR\fIv\(:arde\fR" 4
.IX Item "-Df\(:alt=v\(:arde"
Ers\(:att eller l\(:agg till ett f\(:alt i den genererade control-filen.
.IP "\fB\-U\fR\fIf\(:alt\fR" 4
.IX Item "-Uf\(:alt"
Ta bort ett f\(:alt ur den genererade control-filen.
.IP "\fB\-Z\fR\fIkomprimering\fR, \fB\-\-compression\fR=\fIkomprimering\fR" 4
.IX Item "-Zkomprimering, --compression=komprimering"
Anger vilken komprimering som ska anv\(:andas f\(:or de skapade tar-bollarna och
diff-filerna (\fB\-\-compression\fR sedan dpkg 1.15.5). Observera att flaggan
inte g\(:or att befintliga tar-bollar packas om, utan enbart p\(oaverkar nya
filer. V\(:arden som st\(:ods \(:ar: \fIgzip\fR, \fIbzip2\fR, \fIlzma\fR samt \fIxz\fR. F\(:orvalet
\(:ar \fIxz\fR f\(:or format 2.0 och senare, och \fIgzip\fR f\(:or format 1.0. St\(:od f\(:or
\&\fIxz\fR finns bara fr\(oan och med dpkg 1.15.5.
.IP "\fB\-z\fR\fIniv\(oa\fR, \fB\-\-compression\-level\fR=\fIniv\(oa\fR" 4
.IX Item "-zniv\(oa, --compression-level=niv\(oa"
Komprimeringsniv\(oa att anv\(:anda (\fB\-\-compression\-level\fR sedan dpkg
1.15.5). Som med \fB\-Z\fR p\(oaverkas bara filer som nyskapas. V\(:arden som st\(:ods
\(:ar: \fI1\fR till \fI9\fR, \fIbest\fR (b\(:ast) och \fIfast\fR (snabb). \fI9\fR \(:ar f\(:orval f\(:or
gzip och bzip2, \fI6\fR f\(:or xz och lzma.
.IP "\fB\-i\fR[\fIreg.uttr\fR], \fB\-\-diff\-ignore\fR[=\fIreg.uttr\fR]" 4
.IX Item "-i[reg.uttr], --diff-ignore[=reg.uttr]"
Du kan ange ett regulj\(:art uttryck i perlformat f\(:or att matcha filer som du
vill ska filtreras ut ur listan \(:over filer f\(:or diffen (\fB\-\-diff\-ignore\fR
sedan dpkg 1.15.6). (Listan skapas av ett find-kommando.) (Om
k\(:allkodspaketet byggs som ett version 3\-paket med ett \s-1VCS\s0 kan detta anv\(:andas
f\(:or att ignorera \(:andringar som inte har checkats in p\(oa de angivna
filerna. \-i.* kommer att ignorera samtliga.)
.Sp
\&\fB\-i\fR ensamt aktiverar inst\(:allningen, med ett standardv\(:arde (bibeh\(oaller
modifieringar till standarduttrycket som gjorts med tidigare anv\(:andning av
\&\fB\-\-extend\-diff\-ignore\fR) som filtrerar ut styrfiler och kataloger fr\(oan de
flesta vanliga versionshanteringssystem, s\(:akerhetskopior, v\(:axlingsfiler och
Libtool-byggutdatakataloger. Endast ett regulj\(:art kan vara aktivt, om du
anger flera \fB\-i\fR\-flaggor \(:ar det den sista som g\(:aller.
.Sp
Flaggan \(:ar mycket anv\(:andbar f\(:or att utesluta extrafiler som kommer med i
diffen, t.ex om du underh\(oaller din k\(:allkod i ett versionshanteringssystem
och vill anv\(:anda en utcheckning f\(:or att bygga ett k\(:allkodspaket utan att ta
med de ytterligare filer och det normalt inneh\(oaller (t.ex \s-1CVS/,\s0 .cvsignore,
\&.svn/). Det f\(:orvalda regulj\(:ara uttrycket t\(:acker redan in m\(oanga av dessa, men
om du \(:andrar det, kom ih\(oag att det som standard kan tr\(:affa alla delar av
filnamnet. S\(oa, om du tr\(:affa bara b\(:orjan av ett filnamn eller hela filnamn
m\(oaste du sj\(:alv l\(:agga till de f\(:orankringar som \(:ar n\(:odv\(:andiga (t.ex \(rq(^|/)\(rq,
\(rq($|/)\(rq).
.IP "\fB\-\-extend\-diff\-ignore\fR=\fIreg.uttr\fR" 4
.IX Item "--extend-diff-ignore=reg.uttr"
Det regulj\(:ara uttrycket i perlformat som angavs ut\(:okar standardv\(:ardet som
anv\(:ands av \fB\-\-diff\-ignore\fR och dess nuvarande v\(:arde, om satt (sedan dpkg
1.15.6). Det g\(:or s\(oa genom att l\(:agga till \(rq\fB|\fR\fIreg.uttr\fR\(rq efter
standarduttrycket. Flaggan \(:ar nyttig f\(:or \fBdebian/source/options\fR f\(:or att
exkludera en del automatiskt genererade filer fr\(oan skapandet av automatiska
patchar.
.IP "\fB\-I\fR[\fIfilm\(:onster\fR], \fB\-\-tar\-ignore\fR[=\fIfilm\(:onster\fR]" 4
.IX Item "-I[film\(:onster], --tar-ignore[=film\(:onster]"
Om flaggan anges kommer filnamnet att s\(:andas vidare till \fBtar\fR(1):s
\&\fB\-\-exclude\fR\-flagga n\(:ar det anropas f\(:or att skapa en .orig.tar.gz eller
\&.tar.gz\-fil (\fB\-\-tar\-ignore\fR sedan dpkg 1.15.6). Till exempel kommer
\&\fB\-I\fR\s-1CVS\s0 att hoppa \(:over CVS-kataloger n\(:ar tar.gz\-filen skapas. Flaggan kan
upprepas flera g\(oanger f\(:or att lista flera filnamn som ska uteslutas.
.Sp
\&\fB\-I\fR ensamt l\(:agger till satandard \fB\-\-exclude\fR\-flaggor som filtrerar ut
styrfiler och kataloger fr\(oan de flesta vanliga versionshanteringssystem,
s\(:akerhetskopior, v\(:axlingsfiler och Libtool-byggutdatakataloger.
.PP
\&\fBObservera:\fR \(:Aven om de anv\(:ands till liknande \(:andam\(oal, s\(oa har \fB\-i\fR och
\&\fB\-I\fR v\(:aldigt olika syntax och semantik. \fB\-i\fR kan endast anges en g\(oang och
tar ett perl-kompatibelt regulj\(:art uttryck, vilket matchas mot den kompletta
relativa s\(:okv\(:agen f\(:or varje fil. \fB\-I\fR kan anges flera g\(oanger och tar ett
filnamnss\(:okm\(:anster med skaljokertecken. M\(:onstret matchas mot den kompletta
relativa s\(:okv\(:agen, men \(:aven individuellt mot varje komponent i s\(:okv\(:agen. Den
exakta semantiken f\(:or tar:s \fB\-\-exclude\fR\-flagga \(:ar n\(oagot komplicerad, se
<https://www.gnu.org/software/tar/manual/tar.html#wildcards> f\(:or
fullst\(:andig dokumentation.
.PP
F\(:orvalt regulj\(:art uttryck och s\(:okm\(:onster f\(:or de b\(:agge flaggorna kan ses i
utdata f\(:or \fB\-\-help\fR\-kommandot.
.SS "Generiska extraheringsflaggor"
.IX Subsection "Generiska extraheringsflaggor"
.IP "\fB\-\-no\-copy\fR" 4
.IX Item "--no-copy"
Kopiera inte original-tarbollar i n\(:arheten av det uppackade k\(:allkodspaketet
(sedan dpkg 1.14.17).
.IP "\fB\-\-no\-check\fR" 4
.IX Item "--no-check"
Kontrollera inte signaturer och kontrollsummor f\(:ore uppackning (sedan dpkg
1.14.17).
.IP "\fB\-\-no\-overwrite\-dir\fR" 4
.IX Item "--no-overwrite-dir"
Skriv inte \(:over uppackningskatalogen om den redan finns (sedan dpkg 1.18.8).
.IP "\fB\-\-require\-valid\-signature\fR" 4
.IX Item "--require-valid-signature"
V\(:agra packa upp k\(:allkodspaketet om det inte inneh\(oaller en OpenPGP-signatur
som kan verifieras (sedan dpkg 1.15.0) antingen med anv\(:andarens
\&\fItrustedkeys.gpg\fR\-nyckelring, en av de s\(:aljarspecifka nyckelringarna, eller
en av de officiella Debiannyckelringarna
(\fI/usr/share/keyrings/debian\-keyring.gpg\fR,
\&\fI/usr/share/keyrings/debian\-nonupload.gpg\fR och
\&\fI/usr/share/keyrings/debian\-maintainers.gpg\fR).
.IP "\fB\-\-require\-strong\-checksums\fR" 4
.IX Item "--require-strong-checksums"
V\(:agra packa upp k\(:allkodspaketet om det inte inneh\(oaller n\(oagra starka
kontrollsummor (sedan dpkg 1.18.7). Den enda k\(:anda kontrollsumma som anses
stark \(:ar f\(:or n\(:arvarande \fB\s-1SHA\-256\s0\fR.
.IP "\fB\-\-ignore\-bad\-version\fR" 4
.IX Item "--ignore-bad-version"
\(:Andrar testet f\(:or felaktig k\(:allkodspaketversion till en icke\-\(:odesdiger
varning (sedan dpkg 1.17.7). Flaggan \(:ar endast n\(:odv\(:andig vid uppackning av
v\(:aldigt gamla k\(:allkodspaket med trasiga versioner, bara f\(:or
bak\(oatkompatibilitet.
.SH "FORMAT P\(oA K\(:ALLKODSPAKET"
.IX Header "FORMAT P\(oA K\(:ALLKODSPAKET"
Om du inte vet vilket k\(:allkodspaketformat du ska anv\(:anda, b\(:or du antagligen
v\(:alja antingen \(rq3.0 (quilt)\(rq eller \(rq3.0 (native)\(rq. \*(L"/wiki.debian.org/Projects/DebSrc3.0\*(R" in Se
https: f\(:or information om hur dessa
format s\(:atts i produktion i Debian.
.SS "Format: 1.0"
.IX Subsection "Format: 1.0"
Ett k\(:allkodspaket i detta format best\(oar antingen av en \fB.orig.tar.gz\fR,
f\(:orbunden med en \fB.diff.gz\fR, eller en ensam \fB.tar.gz\fR (i s\(oa fall anses
paketet vara \fIeget\fR, \(rq\fInative\fR\(rq). Original-tarbollen kan ocks\(oa valfritt
\(oatf\(:oljas av en friliggande uppstr\(:omssignatur \fB.orig.tar.gz.asc\fR, uppackning
st\(:ods sedan dpkg 1.18.5.
.PP
\&\fBUppackning\fR
.PP
Att packa upp ett Debianeget paket inneb\(:ar att packa upp den ensamma
tarbollen i m\(oalkatalogen. Att packa upp ett icke-eget paket inneb\(:ar att
f\(:orst packa upp \fI.orig.tar.gz\fR\-filen och sedan genom att till\(:ampa patchen
som finns i \fB.diff.gz\fR\-filen. Tidsst\(:amplarna f\(:or alla patchade filer
nollst\(:alls till den tidpunkt d\(oa k\(:allkodspaketet extraherades (vilket
undviker tidsst\(:ampelf\(:orskjutningar som kunde leda till problem n\(:ar
autogenererade filer patchas). Diffen kan skapa nya filer (hela
debian-katalogen skapas p\(oa det s\(:attet), men kan inte ta bort filer (tomma
filer kommer l\(:amnas kvar) och kan inte skapa eller \(:andra symboliska l\(:ankar.
.PP
\&\fBBygga\fR
.PP
Att bygga ett Debianeget paket inneb\(:ar bara att skapa en ensam tarboll med
k\(:allkodskatalogen. Att bygga ett icke-eget paket innefattar att extrahera
original-tarbollen i en separat \(rq.orig\(rq\-katalog och skapa \fB.diff.gz\fR\-filen
p\(oa nytt genom att j\(:amf\(:ora k\(:allkodspaketets \fIkatalog\fR med .orig\-katalogen.
.PP
\&\fBByggflaggor (med \-\-build):\fR
.PP
Om ett andra argument som inte \(:ar en flagga anges ska det vara namnet p\(oa
originalk\(:allkodskatalogen eller \-tarfilen eller den tomma str\(:angen om
paketet \(:ar Debianspecifikt och d\(:arf\(:or inte har n\(oagra
debianiserings-diffar. Om inget andra argument anges kommer \fBdpkg-source\fR
att leta efter originalk\(:allkodstarfilen
\&\fIpaket\fR\fB_\fR\fIuppstr\(:omsversion\fR\fB.orig.tar.gz\fR eller
originalk\(:allkodskatalogen \fIpaket\fR\fB.orig\fR beroende p\(oa \fB\-sX\fR\-flaggorna.
.PP
\&\fB\-sa\fR, \fB\-sp\fR, \fB\-sk\fR, \fB\-su\fR och \fB\-sr\fR skriver inte \(:over befintliga
tar-filer och kataloger. Om det \(:onskas b\(:or  \fB\-sA\fR, \fB\-sP\fR, \fB\-sK\fR, \fB\-sU\fR
och \fB\-sR\fR anges i st\(:allet.
.IP "\fB\-sk\fR" 4
.IX Item "-sk"
Anger att den ursprungliga k\(:allkoden \(:ar en tar-fil, som standard
\&\fIpaket\fR\fB_\fR\fIuppstr\(:omsversion\fR\fB.orig.tar.\fR\fIfil\(:andelse\fR. Den kommer l\(oata
originalk\(:allkodsfilen ligga kvar som en tarfil, eller kopiera den till den
aktuella katalogen om den inte redan \(:ar d\(:ar. Tarbollen kommer att packas upp
i \fIkatalog\fR\fB.orig\fR f\(:or att generera diffen.
.IP "\fB\-sp\fR" 4
.IX Item "-sp"
Som \fB\-sk\fR, men tar bort katalogen igen efter\(oat.
.IP "\fB\-su\fR" 4
.IX Item "-su"
Anger att originalk\(:allkoden \(:ar en katalog, som standard
\&\fIpaket\fR\fB\-\fR\fIuppstr\(:omsversion\fR\fB.orig\fR och att \fBdpkg-source\fR ska skapa ett
nytt originalk\(:allkodsarkiv fr\(oan den.
.IP "\fB\-sr\fR" 4
.IX Item "-sr"
Som \fB\-su\fR, men tar bort katalogen n\(:ar den har anv\(:ants.
.IP "\fB\-ss\fR" 4
.IX Item "-ss"
Anger att originalk\(:allkoden finns b\(oade som en katalog och en
tar-fil. Katalogen kommer att anv\(:andas av \fBdpkg-source\fR f\(:or att skapa
diffen, men tarfilen f\(:or att skapa \fB.dsc\fR\-filen. Flaggan m\(oaste anv\(:andas med
tillf\(:orsikt \- om katalogen och tarfilen inte st\(:ammer \(:overens kommer ett
trasigt k\(:allkodsarkiv att skapas.
.IP "\fB\-sn\fR" 4
.IX Item "-sn"
Anger att dpkg-source inte ska leta efter n\(oagot k\(:allkodsarkiv och att ingen
diff ska skapas. Det andra argumentet, om det anges, m\(oaste vara den tomma
str\(:angen. Flaggan anv\(:ands f\(:or Debianspecifika paket som inte har en separat
uppstr\(:omsk\(:allkod och d\(:arf\(:or inte har n\(oagon debianiseringsdiff.
.IP "\fB\-sa\fR eller \fB\-sA\fR" 4
.IX Item "-sa eller -sA"
Anger att originalk\(:allkoden finns som en katalog eller en tarfil \- det andra
argumentet, om det anges, kan vara det ena eller det andra, eller den tomma
str\(:angen (motsvarar att anv\(:anda \fB\-sn\fR). Om en tarfil hittas kommer
programmet att packa upp den f\(:or att skapa en diff och ta bort den efter\(oat
(motsvarar \fB\-sp\fR). Om en katalog hittas kommer den att packas f\(:or att skapa
originalk\(:allkoden och ta bort den efter\(oat (motsvarar \fB\-sn\fR). Om b\(oada hittas
kommer \fBdpkg-source\fR att ignorera katalogen, och skriva \(:over den om \fB\-sA\fR
angavs (detta motsvarar \fB\-sP\fR) eller ge ett felmeddelande om \fB\-sa\fR
angavs. \fB\-sa\fR \(:ar standard.
.IP "\fB\-\-abort\-on\-upstream\-changes\fR" 4
.IX Item "--abort-on-upstream-changes"
Processen misslyckas om den genererade diffen inneh\(oaller \(:andringar av filer
utanf\(:or underkatalogen debian (sedan dpkg 1.15.8). Den h\(:ar flaggan till\(oats
inte i \fBdebian/source/options\fR, men kan anv\(:andas i
\&\fBdebian/source/local\-options\fR.
.PP
\&\fBExtraheringsflaggor (med \-\-extract):\fR
.PP
Oavsett kommer ett befintligt k\(:allkodstr\(:ad att tas bort.
.IP "\fB\-sp\fR" 4
.IX Item "-sp"
Anv\(:ands n\(:ar originalk\(:allkoden som extraheras (om s\(oadan finns) ska l\(:amnas
kvar som en tarfil. Om den inte redan finns i den aktuella katalogen, eller
om en befintlig men annan fil finns d\(:ar, kommer den att kopieras
dit. (\fBDetta \(:ar standard.\fR)
.IP "\fB\-su\fR" 4
.IX Item "-su"
Packar upp originalk\(:allkodstr\(:adet.
.IP "\fB\-sn\fR" 4
.IX Item "-sn"
F\(:ors\(:akrar att originalk\(:allkoden varken kopieras till en aktuella katalogen
eller packas upp. Eventuella originalk\(:allkodstr\(:ad som finns i den aktuella
katalogen tas fortfarande bort.
.PP
Alla \fB\-s\fR\fIX\fR\-flaggor \(:ar \(:omsesidigt uteslutande. Om du anger mer \(:an en
kommer endast den sista att anv\(:andas.
.IP "\fB\-\-skip\-debianization\fR" 4
.IX Item "--skip-debianization"
Hoppas \(:over att till\(:ampa debian-diffen ovanp\(oa uppstr\(:omsk\(:allkoden (sedan dpkg
1.15.1).
.SS "Format: 2.0"
.IX Subsection "Format: 2.0"
Uppackning st\(:ods sedan dpkg 1.13.9, byggning st\(:ods sedan dpkg 1.14.8. \(:Aven
k\(:ant som wig&pen. Detta format rekommenderas inte f\(:or allm\(:an anv\(:andning,
formatet \(rq3.0 (quilt)\(rq ers\(:atter det. Wig&pen var den f\(:orsta specifikationen
av en ny generation av k\(:allkodspaketformat.
.PP
Beteendet f\(:or detta format \(:ar detsamma som f\(:or \(rq3.0 (quilt)\(rq\-formatet,
f\(:orutom att det inte anv\(:ander en explicit f\(:orteckning patchar. Alla filer i
\&\fBdebian/patches/\fR som motsvarar det Perl\-regulj\(:ara uttrycket \fB[\ew\-]+\fR
m\(oaste vara giltiga patchar: de appliceras n\(:ar paketet packas upp.
.PP
N\(:ar du bygger ett nytt k\(:allkodspaket kommer eventuella \(:andringar p\(oa
uppstr\(:omsk\(:allkoden att lagras i en patch som kallas \fBzz_debian\-diff\-auto\fR.
.SS "Format: 3.0 (eget)"
.IX Subsection "Format: 3.0 (eget)"
St\(:ods sedan dpkg 1.14.17. Detta format \(:ar en ut\(:okning av det egna
paketformatet som anges av 1.0\-formatet. Det st\(:oder alla
komprimeringsmetoder och kommer att som standard ignorera alla VCS-specifika
filer och kataloger, samt m\(oanga tempor\(:arfiler (se standardv\(:ardet som \(:ar
knutet till flaggan \fB\-i\fR i texten f\(:or \fB\-\-help\fR).
.SS "Format: 3.0 (quilt)"
.IX Subsection "Format: 3.0 (quilt)"
St\(:ods sedan dpkg 1.14.17. Ett k\(:allkodspaket i detta format inneh\(oaller
\(oatminstone en original-tarboll (\fB.orig.tar.\fR\fIext\fR, d\(:ar \fIext\fR kan vara
\&\fBgz\fR, \fBbz2\fR, \fBlzma\fR eller \fBxz\fR) och en Debiantarboll
(\fB.debian.tar.\fR\fIext\fR). Den kan \(:aven inneh\(oalla ytterligare
original-tarbollar (\fB.orig\-\fR\fIkomponent\fR\fB.tar.\fR\fIext\fR). \fIkomponent\fR kan
endast inneh\(oalla alfanumeriska (\(rqa\-zA\-Z0\-9\(rq) tecken och bindestreck
(\(rq\-\(rq). Varje original-tarboll kan ocks\(oa valfritt \(oatf\(:oljas av en friliggande
uppstr\(:omssignatur (\fB.orig.tar.\fR\fIext\fR\fB.asc\fR och
\&\fB.orig\-\fR\fIkomponent\fR\fB.tar.\fR\fIext\fR\fB.asc\fR), uppackning st\(:ods sedan dpkg
1.17.20, byggning st\(:ods sedan dpkg 1.18.5.
.PP
\&\fBUppackning\fR
.PP
Huvud-originaltarbollen packas upp f\(:orst, d\(:arefter packas alla ytterligare
originaltarbollar upp i underkataloger med namn efter \fIkomponent\fR\-delen i
sitt filnamn (eventuella redan befintliga kataloger
ers\(:atts). Debian-tarbollen packas sedan upp ovanp\(oa k\(:allkodskatalogen efter
att en redan befintlig \fBdebian\fR\-katalog har tagits bort f\(:orst. Observera
att debian-tarbollen m\(oaste best\(oa av en \fBdebian\fR\-underkatalog, men att den
\(:aven kan inneh\(oalla bin\(:arfiler utanf\(:or den katalogen (se flaggan
\&\fB\-\-include\-binaries\fR).
.PP
Alla patchar listade i \fBdebian/patches/\fR\fI\(oaterf\(:ors\(:aljare\fR\fB.series\fR eller
\&\fBdebian/patches/series\fR till\(:ampas sedan, d\(:ar \fI\(oaterf\(:ors\(:aljare\fR \(:ar namnet p\(oa
den aktuella \(oaterf\(:ors\(:aljaren skrivet med sm\(oa bokst\(:aver, eller \fBdebian\fR om
ingen har angivits. Om den f\(:orstn\(:amnda filen anv\(:ands och den sistn\(:amnda inte
existerar (eller \(:ar en symbolisk l\(:ank), kommer den senare att ers\(:attas av en
symbolisk l\(:ank till den f\(:orsta. Tanken \(:ar att g\(:ora det enklare att anv\(:anda
\&\fBquilt\fR till att hantera patchupps\(:attningen. \(oAterf\(:ors\(:aljarspecifika
series-filer \(:ar t\(:ankta att g\(:ora det m\(:ojligt att serialisera flera
utvecklingsgrenar baserade p\(oa \(oaterf\(:ors\(:aljaren, p\(oa ett deklarativt s\(:att,
ist\(:allet f\(:or att \(:oppet koda den h\(:ar hanteringen i \fBdebian/rules\fR. Detta \(:ar
speciellt anv\(:andbart n\(:ar k\(:allkoden beh\(:over patchas olika eftersom de r\(:orda
filerna inte st\(:oder inbyggd villkorlig till\(:ampning. Observera att, \(:aven om
\&\fBdpkg-source\fR korrekt tolkar series-filer som anv\(:ander explicita flaggor
till patch-programmet (lagrade p\(oa kommandoraden efter patch-filnamnet och
ett eller flera blanksteg), s\(oa ignoreras dessa flaggor och det f\(:orv\(:antar sig
att patchar kan till\(:ampas med flaggan \fB\-p1\fR till \fBpatch\fR. Det kommer
d\(:arf\(:or visa en varning s\(oadana flaggor uppt\(:acks, och bygget kommer troligen
att misslyckas.
.PP
Oberbera att \fBlintian\fR(1) kommer skapa ovillkorliga varningar n\(:ar
\(oaterf\(:ors\(:aljarserier anv\(:ands p\(oa grund av en kontroversiell Debian-specifik
dom, vilket inte b\(:or p\(oaverka extern anv\(:andning; f\(:or att tysta dessa kan
dpkg:s lintianprofil anv\(:andas genom att ge parametern \(rq\fB\-\-profile dpkg\fR\(rq
till \fBlintian\fR(1).
.PP
Tidsst\(:amplarna f\(:or alla patchade filer nollst\(:alls till den tidpunkt d\(oa
k\(:allkodspaketet extraherades (vilket undviker tidsst\(:ampelf\(:orskjutningar som
kunde leda till problem n\(:ar autogenererade filer patchas).
.PP
Till skillnad mot \fBquilt\fR:s originalbeteende f\(:orv\(:antas det att patchar kan
appliceras utan n\(oagon \(rqfuzz\(rq. N\(:ar s\(oa inte \(:ar fallet b\(:or du uppdatera
patcharna med hj\(:alp av \fBquilt\fR, om inte kommer \fBdpkg-source\fR rapportera
ett felmeddelande n\(:ar det f\(:ors\(:oker till\(:ampa dem.
.PP
Patchar kan \(:aven ta bort filer, p\(oa samma s\(:att som \fBquilt\fR normalt fungerar.
.PP
Filen \fB.pc/applied\-patchers\fR skapas om patchar till\(:ampades vid
uppackningen.
.PP
\&\fBBygga\fR
.PP
Alla original-tarbollar som finns i den aktuella katalogen packas upp i en
tempor\(:ar katalog med samma logik som i uppackningen, debian-katalogen
kopieras \(:over i den tempor\(:ara katalogen och alla patchar, f\(:orutom den
automatiska patchen (\fBdebian-changes\fR\fIversion\fR eller \fBdebian-changes\fR,
beroende p\(oa \fB\-\-single\-debian\-patch\fR) till\(:ampas. Tempor\(:arkatalogen j\(:amf\(:ors
d\(:arefter mot k\(:allkodskatalogen. Om diffen inte \(:ar tom misslyckas bygget,
s\(oavida inte \fB\-\-single\-debian\-patch\fR eller \fB\-\-auto\-commit\fR anv\(:ants, i
vilket fall diffen lagras i den automatiska patchen. Om den automatiska
patchen skapas/tas bort, l\(:aggs den till/tas bort fr\(oan series-filen och fr\(oan
\&\fBquilt\fR\-metadata.
.PP
Eventuella \(:andringar p\(oa bin\(:arfiler kan inte representeras i en diff och
kommer d\(:armed att leda till ett felmeddelande, s\(oavida inte paketansvariga
medvetet v\(:aljer att inkludera den modifierade bin\(:arfilen i debian-tarbollen
(genom att lista den i \fBdebian/source/include\-binaries\fR). Byggningen kommer
\(:aven att misslyckas om bin\(:arfiler uppt\(:acks i debian-underkatalogen, s\(oavida
de inte har till\(oatits i \fBdebian/source/include\-binaries\fR.
.PP
Den uppdaterade debiankatalogen, och listan \(:over modifierade bin\(:arer,
anv\(:ands sedan f\(:or att skapa debian-tarbollen.
.PP
Den automatiskt genererade diff-filen inneh\(oaller inte \(:andringar f\(:or
VCS-specifika filer eller f\(:or m\(oanga tempor\(:ara filer (se standardv\(:ardet som
\(:ar knutet till flaggan \fB\-i\fR i texten f\(:or \fB\-\-help\fR). Detta g\(:aller speciellt
katalogen \fB.pc\fR som anv\(:ands av \fBquilt\fR, katalogen kommer att ignoreras n\(:ar
den automatiska patchen skapas.
.PP
\&\fBObservera:\fR \fBdpkg-source\fR \fB\-\-before\-build\fR (och \fB\-\-build\fR) ser till att
alla  patchar som anges i seriefilen till\(:ampas s\(oa att paketbygget alltid har
alla patchar till\(:ampade. Detta g\(:ors genom att hitta alla icke\-till\(:ampade
patchar (som anges i filen \fBseries\fR men inte i \fB.pc/applied\-patches\fR), och
om den f\(:orsta patchen i listan kan till\(:ampas utan fel kommer samtliga att
till\(:ampas. Flaggan \fB\-\-no\-preparation\fR kan anv\(:andas f\(:or att sl\(oa av detta
beteende.
.PP
\&\fBLagra \(:andringar\fR
.IP "\fB\-\-commit\fR [\fIkatalog\fR] [\fIpatchnamn\fR] [\fIpatch-fil\fR]" 4
.IX Item "--commit [katalog] [patchnamn] [patch-fil]"
Skapar en patch som motsvarar de lokala \(:andringar som inte hanteras av
\&\fBquilt\fR\-patch\-systemet och integrerar dem i patch-systemet under namnet
\&\fIpatchnamn\fR. Om namnet saknas kommer programmet be om ett interaktivt. Om
\&\fIpatch-fil\fR anges anv\(:ands den som patch som motsvarar de lokala \(:andringar
som ska integreras. N\(:ar patchen \(:ar integrerad startas ett redigeringsprogram
s\(oa att du kan ange metainformationen i patchhuvudet.
.Sp
Det \(:ar oftast nyttigt att s\(:anda med \fIpatchfil\fR efter att ett bygge d\(:ar
filen skapats i f\(:orv\(:ag misslyckas, och att patchfilen d\(:arf\(:or ska tas bort
efter integrering. Observera \(:aven att \(:andringarna som finns i patchfilen
redan m\(oaste ha applicerats p\(oa tr\(:adet och att filerna som modifieras av
patchen inte f\(oar inneh\(oalla ytterligare ej beskrivna \(:andringar.
.Sp
Om genereringen av patchar uppt\(:acker \(:andringar i bin\(:arfiler kommer de
automatiskt att l\(:aggas in i \fBdebian/source/include\-binaries\fR s\(oa att de
dyker upp i debian-tarbollen (precis som \fBdpkg-source \-\-include\-binaries
\&\-\-build\fR skulle gjort).
.PP
\&\fBByggflaggor\fR
.IP "\fB\-\-allow\-version\-of\-quilt\-db=\fR\fIversion\fR" 4
.IX Item "--allow-version-of-quilt-db=version"
Till\(oat \fBdpkg-source\fR att bygga k\(:allkodspaketet om versionen av
\&\fBquilt\fR\-metadata \(:ar den som angavs, \(:aven om \fBdpkg-source\fR inte k\(:anner till
den (sedan dpkg 1.15.5.4). Det betyder att den givna versionen av
\&\fBquilt\fR\-metadata \(:ar kompatibel med version 2 som \fBdpkg-source\fR f\(:or
n\(:arvarande st\(:oder. Versionen av \fBquilt\fR\-metadata lagras i \fB.pc/.version\fR.
.IP "\fB\-\-include\-removal\fR" 4
.IX Item "--include-removal"
Ignorera inte borttagna filer och ta med dem i den automatiskt genererade
patchen.
.IP "\fB\-\-include\-timestamp\fR" 4
.IX Item "--include-timestamp"
Ta med tidsst\(:ampel i den automatiskt genererade patchen.
.IP "\fB\-\-include\-binaries\fR" 4
.IX Item "--include-binaries"
L\(:agg till alla modifierade bin\(:arer i debian-tarbollen. L\(:agg \(:aven till dem i
\&\fBdebian/source/include\-binaries\fR: de kommer att l\(:aggas till som standard i
f\(:oljande byggen och du beh\(:over inte l\(:angre ange den h\(:ar flaggan.
.IP "\fB\-\-no\-preparation\fR" 4
.IX Item "--no-preparation"
F\(:ors\(:ok inte att f\(:orbereda byggtr\(:adet genom att till\(:ampa patchar som inte
verkar ha till\(:ampas f\(:or n\(:arvarande (sedan dpkg 1.14.18).
.IP "\fB\-\-single\-debian\-patch\fR" 4
.IX Item "--single-debian-patch"
Anv\(:and \fBdebian/patches/debian\-changes\fR ist\(:allet f\(:or
\&\fBdebian/patches/debian\-changes\-\fR\fIversion\fR som namn p\(oa den automatiska
patch som genereras vid bygget (sedan dpkg 1.15.5.4). Denna flagga \(:ar
speciellt nyttig n\(:ar paketet hanteras i ett versionshanteringssystem och en
patch inte kan skapas p\(oa ett p\(oalitligt s\(:att. Den aktuella diffen mot
uppstr\(:oms lagras ist\(:allet i en ensam patch. Flaggan b\(:or anges i
\&\fBdebian/source/local\-options\fR och f\(:oljs av filen
\&\fBdebian/source/local\-patch\-header\fR som beskricer hur Debian\(:andringarna b\(:ast
kan ses, till exempel i det versionshanteringssystem som anv\(:ands.
.IP "\fB\-\-create\-empty\-orig\fR" 4
.IX Item "--create-empty-orig"
Skapa huvud-originaltarbollen som tom automatiskt om den saknas och om det
finns till\(:aggs\-originaltarbollar (sedan dpkg 1.15.6). Flaggan \(:ar t\(:ankt att
anv\(:andas n\(:ar k\(:allkodspaketet bara \(:ar en samling av flera uppstr\(:omsprogram
och d\(:ar det inte finns n\(oagot \(rqhuvud\(rq\-program.
.IP "\fB\-\-no\-unapply\-patches, \-\-unapply\-patches\fR" 4
.IX Item "--no-unapply-patches, --unapply-patches"
Som standard kommer \fBdpkg-source\fR att automatiskt ta bort patchar i kroken
\&\fB\-\-after\-build\fR om de applicerades under \fB\-\-before\-build\fR
(\fB\-\-unapply\-patches\fR sedan dpkg 1.15.8, \fB\-\-no\-unapply\-patches\fR sedan dpkg
1.16.5). De h\(:ar flaggorna l\(oater dig \(:overstyra om du vill inaktivera eller
aktivera proceduren f\(:or borttagning av patchar. Flaggorna till\(oats endast i
\&\fBdebian/source/local\-options\fR s\(oa att alla genererade k\(:allkodspaket som
standard har samma beteende.
.IP "\fB\-\-abort\-on\-upstream\-changes\fR" 4
.IX Item "--abort-on-upstream-changes"
Processen misslyckas om en automatisk patch har genererats (sedan dpkg
1.15.8). Flaggan kan anv\(:andas f\(:or att se till att alla \(:andringar har lagrats
undan korrekt i separata \fBquilt\fR\-patchar innan k\(:allkodspaketet
byggts. Flaggan till\(oats inte i \fBdebian/source/options\fR, men kan anv\(:andas i
\&\fBdebian/source/local\-options\fR.
.IP "\fB\-\-auto\-commit\fR" 4
.IX Item "--auto-commit"
Processen misslyckas inte om en automatisk patch har skapats, den l\(:aggs
ist\(:allet direkt in i \fBquilt\fR\-serien.
.PP
\&\fBExtraheringsflaggor\fR
.IP "\fB\-\-skip\-debianization\fR" 4
.IX Item "--skip-debianization"
Hoppar \(:over att packa upp debian-tarbollen ovanp\(oa uppstr\(:omsk\(:allkoden (sedan
dpkg 1.15.1).
.IP "\fB\-\-skip\-patches\fR" 4
.IX Item "--skip-patches"
Applicera inte patchar i slutet av uppackningen (sedan dpkg 1.14.18).
.SS "Format: 3.0 (skr\(:addarsytt)"
.IX Subsection "Format: 3.0 (skr\(:addarsytt)"
St\(:ods sedan dpkg 1.14.17. Detta formatet \(:ar speciellt. Det anger inte ett
riktigt k\(:allkodspaketformat, utan kan anv\(:andas f\(:or att skapa k\(:allkodspaket
med godtyckliga filer.
.PP
\&\fBByggflaggor\fR
.PP
Alla argument som inte \(:ar flaggor tas som filer som ska integreras i det
skapade k\(:allkodspaketet. De m\(oaste finnas, och helst i aktuell
katalog. \(oAtminstone en fil m\(oaste anges.
.IP "\fB\-\-target\-format=\fR\fIv\(:arde\fR" 4
.IX Item "--target-format=v\(:arde"
\&\fBKr\(:avs\fR. Anger det riktiga formatet p\(oa det genererade k\(:allkodspaketet. Den
skapade .dsc\-filen kommer inneh\(oalla detta v\(:arde i sitt \fBFormat\fR\-f\(:alt och
inte \(rq3.0 (custom)\(rq.
.SS "Format: 3.0 (git)"
.IX Subsection "Format: 3.0 (git)"
St\(:ods sedan dpkg 1.14.17. Formatet \(:ar experimentellt.
.PP
Ett k\(:allkodspaket i detta format best\(oar av en ensam bunt (\(rqbundle\(rq) fr\(oan ett
git-arkiv \fB.git\fR, vilket inneh\(oaller paketets k\(:allkod. Filen \fB.gitshallow\fR,
som inneh\(oaller revisioner f\(:or grunda git-kloner, kan \(:aven f\(:orekomma.
.PP
\&\fBUppackning\fR
.PP
Bunten klonas som ett git-arkiv till m\(oalkatalogen. Om filen gitshallow finns
installeras den som \fI.git/shallow\fR i det klonade git-arkivet.
.PP
Observera att det nya arkivet som standard kommer att ha samma gren
utcheckad som den som var utcheckad i det ursprungliga
k\(:allkodstr\(:adet. (Typiskt \(rqmaster\(rq, men kan vara vad som helst.) Eventuella
andra grenar kommer ocks\(oa att vara tillg\(:angliga, under \fIremotes/origin/\fR.
.PP
\&\fBBygga\fR
.PP
Innan uppackningen forts\(:atter kommer en del tester att utf\(:oras f\(:or att se
till att vi inte har n\(oagra ej ignorerade ej incheckade \(:andringar.
.PP
\&\fBgit-bundle\fR(1) anv\(:ands f\(:or att generera en bunt fr\(oan git-arkivet. Som
standard tas alla grenar och taggar i arkivet med i bunten.
.PP
\&\fBByggflaggor\fR
.IP "\fB\-\-git\-ref=\fR\fIref\fR" 4
.IX Item "--git-ref=ref"
G\(:or det m\(:ojligt att ange en git-referens som ska tas med i bunten. Om den
anges \(:overstyr den standardbeteendet som \(:ar att ta med alla grenar och
taggar. Kan anges flera g\(oanger. \fIref\fR kan vara namnet p\(oa en gren eller tagg
som ska tas med. Den kan \(:aven vara vilken som helst annan parameter som kan
s\(:andas med till \fBgit-rev-list\fR(1). F\(:or att, till exempel, endast ta med
grenen \(rqmaster\(rq, anv\(:and \fB\-\-git\-ref=\fRmaster. F\(:or att ta med alla taggar och
grenar, f\(:orutom grenen private, anv\(:and \fB\-\-git\-ref=\fR\-\-all
\&\fB\-\-git\-ref=\fR^private
.IP "\fB\-\-git\-depth=\fR\fIantal\fR" 4
.IX Item "--git-depth=antal"
Skapar en grund klon med en historik som \(:ar avhuggen vid det angivna antalet
revisioner.
.SS "Format: 3.0 (bzr)"
.IX Subsection "Format: 3.0 (bzr)"
St\(:ods sedan dpkg 1.14.17. Detta format \(:ar experimentellt. Det genererar en
ensam tarboll som inneh\(oaller bzr-arkivet.
.PP
\&\fBUppackning\fR
.PP
Tarbollen packas upp och bzr anv\(:ands sedan f\(:or att h\(:amta ut den aktuella
grenen.
.PP
\&\fBBygga\fR
.PP
Innan uppackningen forts\(:atter kommer en del tester att utf\(:oras f\(:or att se
till att vi inte har n\(oagra ej ignorerade ej incheckade \(:andringar.
.PP
De VCS-specifika delarna av k\(:allkodskatalogen kommer d\(:arefter att kopieras
\(:over till en tempor\(:ar katalog. Innan den tempor\(:ara katalogen packas i en
tarboll utf\(:ors viss st\(:adning f\(:or att spara plats.
.SH "DIAGNOSTIK"
.IX Header "DIAGNOSTIK"
.SS "k\(:allkodsformat ej angivet i debian/source/format"
.IX Subsection "k\(:allkodsformat ej angivet i debian/source/format"
Filen \fBdebian/source/format\fR b\(:or alltid finnas och ange det \(:onskade
k\(:allkodsformatet. F\(:or bak\(oatkompatibilitet antar formatet \(rq1.0\(rq om filen inte
finns, men du b\(:or inte f\(:orlita dig p\(oa detta: vid n\(oagon punkt i framtiden
kommer \fBdpkg-source\fR att justeras s\(oa att det misslyckas om filen inte
finns.
.PP
Resonemanget bakom detta \(:ar att formatet \(rq1.0\(rq inte l\(:angre \(:ar det
rekommenderade formatet, du b\(:or normalt v\(:alja ett av de nyare formaten (\(rq3.0
(quilt)\(rq, \(rq3.0 (native)\(rq), men \fBdpkg-source\fR g\(:or inte detta automatiskt \(oat
dig. Om du vill forts\(:atta anv\(:anda det gamla formatet b\(:or du ange det
explicit genom att skriva \(rq1.0\(rq i \fBdebian/source/format\fR.
.SS "diffen modifierar f\(:oljande uppstr\(:omsfiler"
.IX Subsection "diffen modifierar f\(:oljande uppstr\(:omsfiler"
N\(:ar du anv\(:ander k\(:allkodsformatet \(rq1.0\(rq \(:ar det oftast inte n\(oagon bra id\('e att
modifiera uppstr\(:omsfiler direkt eftersom \(:andringarna d\(:oljs och i huvudsak \(:ar
odokumenterade i diff.gz\-filen. Du b\(:or ist\(:allet spara dina \(:andringar som
patchar i debian-katalogen och applicera dem n\(:ar paketet ska byggas. F\(:or att
undvika den h\(:ar komplexiteten kan du \(:aven anv\(:anda formatet \(rq3.0 (quilt)\(rq som
l\(oater dig g\(:ora det h\(:ar automatiskt.
.SS "kan inte representera \(:andringen f\(:or \fIfil\fP"
.IX Subsection "kan inte representera \(:andringen f\(:or fil"
\(:Andringar p\(oa uppstr\(:omsfiler sparas normalt som patchfiler, men inte alla
\(:andringar kan representeras med patchar: de kan endast \(:andra inneh\(oallet i
vanliga textfiler. Om du f\(:ors\(:oker ers\(:atta en fil med n\(oagot som har en annan
typ (till exempel ers\(:atta en vanlig fil med en symbolisk l\(:ank eller en
katalog) f\(oar du det h\(:ar felmeddelandet.
.SS "den tomma filen \fIfil\fP som just skapats kommer inte representeras i diffen"
.IX Subsection "den tomma filen fil som just skapats kommer inte representeras i diffen"
Tomma filer kan inte skapas med patchfiler. \(:Andringen kommer d\(:armed inte att
sparas i k\(:allkodspaketet och du f\(oar en varning om det.
.SS "exekveringsl\(:age \fIl\(:age\fP p\(oa \fIfil\fP kommer inte representeras i diffen"
.IX Subsection "exekveringsl\(:age l\(:age p\(oa fil kommer inte representeras i diffen"
Patchfiler beskriver inte l\(:aget p\(oa filer och exekveringsbeh\(:origheter sparas
d\(:armed inte i k\(:allkodspaketet. Den h\(:ar varningen p\(oaminner dig om detta.
.SS "speciall\(:aget \fIl\(:age\fP p\(oa \fIfil\fP kommer inte representeras i diffen"
.IX Subsection "speciall\(:aget l\(:age p\(oa fil kommer inte representeras i diffen"
Patchfiler beskriver inte l\(:aget p\(oa filer och \(:andrade l\(:agen sparas inte i
k\(:allkodspaketet. Den h\(:ar varningen p\(oaminner dig om detta.
.SH "MILJ\(:OVARIABLER"
.IX Header "MILJ\(:OVARIABLER"
.IP "\fB\s-1DPKG_COLORS\s0\fR" 4
.IX Item "DPKG_COLORS"
V\(:aljer f\(:argl\(:age (sedan dpkg 1.18.5). F\(:or n\(:arvarande godtas f\(:oljande v\(:arden:
\&\fBauto\fR (f\(:orval), \fBalways\fR och \fBnever\fR.
.IP "\fB\s-1DPKG_NLS\s0\fR" 4
.IX Item "DPKG_NLS"
Om satt, anv\(:ands f\(:or att best\(:amma om lokalt spr\(oakst\(:od ska aktiveras, \(:aven
k\(:ant som internationaliseringsst\(:od (eller i18n) (sedan dpkg
1.19.0). Till\(oatna v\(:arden \(:ar: \fB0\fR och \fB1\fR (f\(:orval).
.IP "\fB\s-1SOURCE_DATE_EPOCH\s0\fR" 4
.IX Item "SOURCE_DATE_EPOCH"
Om satt kommer det anv\(:andas som tidsst\(:ampel (som sekunder sedan epoken) f\(:or
att tvinga mtime i \fBtar\fR(5)\-filposterna.
.IP "\fB\s-1VISUAL\s0\fR" 4
.IX Item "VISUAL"
.PD 0
.IP "\fB\s-1EDITOR\s0\fR" 4
.IX Item "EDITOR"
.PD
Anv\(:ands av k\(:allkodsformatmodulerna \(rq2.0\(rq och \(rq3.0 (quilt)\(rq.
.IP "\fB\s-1GIT_DIR\s0\fR" 4
.IX Item "GIT_DIR"
.PD 0
.IP "\fB\s-1GIT_INDEX_FILE\s0\fR" 4
.IX Item "GIT_INDEX_FILE"
.IP "\fB\s-1GIT_OBJECT_DIRECTORY\s0\fR" 4
.IX Item "GIT_OBJECT_DIRECTORY"
.IP "\fB\s-1GIT_ALTERNATE_OBJECT_DIRECTORIES\s0\fR" 4
.IX Item "GIT_ALTERNATE_OBJECT_DIRECTORIES"
.IP "\fB\s-1GIT_WORK_TREE\s0\fR" 4
.IX Item "GIT_WORK_TREE"
.PD
Anv\(:ands av k\(:allkodsformatmodulen \(rq3.0 (git)\(rq.
.SH "FILER"
.IX Header "FILER"
.SS "debian/source/format"
.IX Subsection "debian/source/format"
Filen inneh\(oaller p\(oa en ensam rad det format som ska anv\(:andas f\(:or att bygga
k\(:allkodspaketet (m\(:ojliga format beskrivs ovan). Varken ledande eller
avslutande blanksteg till\(oats.
.SS "debian/source/include\-binaries"
.IX Subsection "debian/source/include-binaries"
Filen inneh\(oaller en f\(:orteckning med s\(:okv\(:agsnamn f\(:or bin\(:arfiler (en per rad)
relativt till k\(:allkods\-rotkatalogen som ska tas med i
debian-tarbollen. Inledande och avslutande blanksteg tas bort. Rader som
b\(:orjar med \(rq\fB#\fR\(rq \(:ar kommentarer och hoppas \(:over. Tomma rader ignoreras.
.SS "debian/source/options"
.IX Subsection "debian/source/options"
Filen inneh\(oaller en lista \(:over l\(oanga flaggor som automatiskt s\(:atts in f\(:ore
kommandoradsflaggorna som anges i ett anrop til \fBdpkg-source \-\-build\fR eller
\&\fBdpkg-source \-\-print\-format\fR. Flaggor som \fB\-\-compression\fR och
\&\fB\-\-compression\-level\fR \(:ar passande att l\(:agga in i den  h\(:ar filen.
.PP
Ange varje flagga p\(oa en egen rad. Tomma rader och rader som b\(:orjar med
\(rq\fB#\fR\(rq ignoreras. Inledande \(rq\fB\-\-\fR\(rq ska tas bort och korta flaggor \(:ar inte
till\(oatna. Blanksteg till\(oats runt \(rq\fB=\fR\(rq\-tecknet och citattecken till\(oats runt
v\(:ardet. H\(:ar \(:ar ett exempel p\(oa en s\(oadan fil:
.PP
.Vb 9
\& # l\(oat dpkg\-source skapa en debian.tar.bz2 med maximal komprimering
\& compression = "bzip2"
\& compression\-level = 9
\& # anv\(:and debian/patches/debian\-changes som en automatisk patch
\& single\-debian\-patch
\& # ignorera \(:andringar i config.{sub,guess}
\& extend\-diff\-ignore = "(^|/)(config.sub|config.guess)$"
\&B<Observera:> B<format>\-flaggor till\(oats inte i den h\(:ar filen, du b\(:or anv\(:anda
\&filen B<debian/source/format> ist\(:allet.
.Ve
.SS "debian/source/local\-options"
.IX Subsection "debian/source/local-options"
Precis som \fBdebian/source/options\fR f\(:orutom att filen inte inkluderas i det
genererade k\(:allkodspaketet. Det kan vara anv\(:andbart f\(:or att spara ett val
som g\(:aller f\(:or paketansvariga eller VCS-systemet k\(:allkodspaketet hanteras i.
.SS "debian/source/local\-patch\-header"
.IX Subsection "debian/source/local-patch-header"
.SS "debian/source/patch\-header"
.IX Subsection "debian/source/patch-header"
Friformstext som l\(:aggs in p\(oa toppen av den automatiskt genererade patchen i
formaten \(rq2.0\(rq eller \(rq3.0 (quilt)\(rq. \fBlocal-patch-header\fR tas inte med i det
genererade k\(:allkodspaketet medan \fBpatch-header\fR tas med.
.SS "debian/patches/\fI\(oaterf\(:ors\(:aljare\fP.series"
.IX Subsection "debian/patches/\(oaterf\(:ors\(:aljare.series"
.SS "debian/patches/series"
.IX Subsection "debian/patches/series"
Listar alla patchar som m\(oaste till\(:ampas (i den givna ordningen) ovanp\(oa
uppstr\(:omsk\(:allkodspaketet. Inledande och avslutande blanksteg tas
bort. \fI\(oaterf\(:ors\(:aljare\fR \(:ar namnet p\(oa aktuell \(oaterf\(:ors\(:aljare skrivet med sm\(oa
bokst\(:aver. Om den \(oaterf\(:ors\(:aljarspecifika series-filen inte existerar, kommer
den \(oaterf\(:ors\(:aljarl\(:osa series-filen att anv\(:andas ist\(:allet. Rader som b\(:orjar
med \(rq\fB#\fR\(rq \(:ar kommentarer och ignoreras. Tomma rader ignoreras. De rader som
\(:ar kvar inleds med filnamnet p\(oa en patchfil (relativt till
\&\fBdebian/patches/\fR\-katalogen) upp till det f\(:orsta blankstegstecknet eller
slutet p\(oa raden. Valfria flaggor till \fBquilt\fR kan f\(:olja fram till slutet av
raden eller det f\(:orsta \(rq\fB#\fR\(rq som f\(:oljer p\(oa ett eller flera blanksteg
(vilket anger b\(:orjan p\(oa en kommentar fram till slutet av raden).
.SH "PROGRAMFEL"
.IX Header "PROGRAMFEL"
Tidpunkten p\(oa f\(:alt\(:overstyrning intr\(:affar j\(:amf\(:ort med inst\(:allning av vissa
standardutdataf\(:alt \(:ar ganska f\(:orvirrad.
.SH "SE \(:AVEN"
.IX Header "SE \(:AVEN"
\&\fBdeb-src-control\fR(5), \fBdeb-changelog\fR(5), \fBdsc\fR(5).
.SH "\(:OVERS\(:ATTNING"
.IX Header "\(:OVERS\(:ATTNING"
Peter Krefting och Daniel Nylander.