Provided by: dpkg-dev_1.16.1.2ubuntu7_all bug

NAMN

       dpkg-source - Verktyg for att manipulera Debiankallkodspaket (.dsc)

SYNOPS

       dpkg-source [flagga...] oatg"ard

BESKRIVNING

       dpkg-source packar och packar upp Debiankallkodsarkiv.

       Inga av dessa kommandon tillater att flera flaggor kombineras till ett,
       och de tillater inte att vardet pa en  flagga  anges  som  ett  separat
       argument.

KOMMANDON

       -x filnamn.dsc [utdatakatalog]
              Extrahera  ett kallkodspaket. Ett argument som inte ar en flagga
              maste  anges,  namnet  pa  debiankallkodsstyrfilen  (.dsc).  Ett
              valfritt  andra argument som inte ar en flagga kan anges for att
              bestamma vilken katalog kallkoden skall packas upp  i,  det  far
              inte  existera.  Om du inte anger nagon utdatakatalog extraheras
              kallkodspaketet till en katalog som heter k"allkod-version i  den
              aktuella arbetskatalogen.

              dpkg-source  laser  namnen  pa  de  ovriga  filer  som  ingar  i
              kallkodspaketet fran styrfilen; de antas vara  i  samma  katalog
              som .dsc-filen.

              Filerna  i  det extraherade paketet kommer att ha behorighet och
              agare  satta  till  det  som  kunde  forvantas  om  filerna  och
              katalogerna  bara  hade  skapats  -  kataloger och korbara filer
              kommer ha  0777  och  enkla  filer  0666,  bada  modifierade  av
              uppackarens  umask;  om  foraldrakatalogen  ar  setgid kommer de
              extraherade katalogerna ocksa att vara det, och  samtliga  filer
              och kataloger kommer arva dess gruppagarskap.

              Om  kallkoden  anvander  ett  annat  format  an standardformatet
              (galler for narvarande alla format forutom "1.0"),  kommer  dess
              namn  att lagras som debian/source/format sa att det anvands som
              standard nar kallkodspaketet byggs pa nytt.

       -b katalog [formatspecifika-flaggor]
              Bygg ett kallkodpaket. Det forsta  argumentet  som  inte  ar  en
              flagga   tas   som   namn   pa   katalogen  som  innehaller  det
              debianiserade kallkodstradet (dvs. med  underkatalogen  "debian"
              och  kanske  andringar  pa  originalfilerna). Beroende pa vilket
              kallkodspaketformat som  anvands  for  att  bygga  formatet  kan
              ytterligare parametrar kanske godtas.

              dpkg-source  kommer  bygga kallkodspaketet med det forsta format
              som fungerar fran denna lista  i  denna  ordning:  formatet  som
              anges  med  kommandoradsflaggan  --format,  formatet som anges i
              debian/source/format, "1.0". Standardvardet "1.0"  rekommenderas
              ej  och  kommer  att tas bort en gang i framtiden, du bor alltid
              dokumentera det onskade kallkodsformatet i debian/source/format.
              Se avsnittet FORMAT PoA K"ALLKODSPAKET for en utforlig beskrivning
              av de olika kallkodspaketformaten.

       --print-format katalog
              Visa formatet som skulle anvandas for att bygga  kallkodspaketet
              om dpkg-source -b katalog skulle koras (under samma forhallanden
              och med samma parametrar).

       --before-build katalog
              Kor motsvarande krok for kallkodspaketformatet.  Kroken  anropas
              innan  nagot  fran  paketet byggs (dpkg-buildpakcage anropar det
              valdigt tidigt, till och med fore debian/rules clean). Kommandot
              ar  idempotent  och  kan  anropas flera ganger. Det ar inte alla
              kallkodsformat som implementerar nagot i den har kroken, och  de
              som  gor  det  forbereder  oftast kallkodstradet for att byggas,
              till  exempel  genom  att  se   till   att   Debianpatchar   har
              applicerats.

       --after-build katalog
              Kor  motsvarande  krok for kallkodspaketformatet. Kroken anropas
              efter att allt fran paketet  byggts  (dpkg-buildpakcage  anropar
              det sist). Kommandot ar idempotent och kan anropas flera ganger.
              Det ar inte alla kallkodsformat som implementerar  nagot  i  den
              har  kroken,  och  de  som  gor det anvander den normalt for att
              aterstalla det som --before-build har gjort.

       --commit [katalog] ...
              Spara andringar i kallkodstradet som har packats upp i  katalog.
              Kommandot    kan   ta   ytterligare   parametrar   beroende   pa
              kallkodsformatet. Ett fel  kommer  rapporteras  for  format  dar
              operationen inte har nagon betydelse.

       -h, --help
              Visar hjalpskarm och avslutar.

       --version
              Visar version och avslutar.

ALLM"ANNA BYGGFLAGGOR

       -ccontrol-fil
              Anger  huvudkallkodsstyrfil  som  information  skall lasas fran.
              Standardvarde ar debian/control.  Om  ett  relativt  sokvagsnamn
              anges tolkas det fran kallkodstradets toppnivakatalog.

       -l"andringsloggfil
              Anger   andringsloggsfil   som  information  skall  lasas  fran.
              Standardvarde ar debian/changelog. Om ett  relativt  sokvagsnamn
              anges tolkas det fran kallkodstradets toppnivakatalog.

       -F"andringsloggformat
              Anger format pa andringsloggen. Som standard lases formatet fran
              en speciell rad nara slutet av andringsloggen, eller sa  anvands
              Debians standardformat om ingen information hittas.

       --format=v"arde
              Anvand  det  givna  formatet  for att bygga kallkodspaketet. Det
              overstyr   inte   ett   eventuellt   format    som    anges    i
              debian/source/format.

       -Vnamn=v"arde
              Staller  in en utdatasubstitueringsvariabel. Se deb-substvars(5)
              for en beskrivning av utdatasubstituering.

       -Tsubstvars-fil
              Las substitueringsvariabler fran substvarfil;  standardvarde  ar
              att  inte  lasa  nagon fil.Flaggan kan anvandas flera ganger for
              att lasa substitueringsvariabler fran flera filer.

       -Df"alt=v"arde
              Ersatt eller lagg till ett falt i den genererade control-filen.

       -Uf"alt Ta bort ett falt ur den genererade control-filen.

       -Zkomprimering, --compression=komprimering
              Anger vilken komprimering som  skall  anvandas  for  de  skapade
              filerna  (tar-bollar och diffar). Observera att flaggan inte gor
              att befintliga tar-bollar packas om, utan  enbart  paverkar  nya
              filer.  Varden  som stods ar: gzip, bzip2, lzma samt xz. gzip ar
              forvalet. Stod for xz finns bara fran och med dpkg-dev 1.15.5.

       -znivoa, --compression-level=nivoa
              Komprimeringsniva att anvanda. Som med -Z  paverkas  bara  filer
              som  nyskapas.  Varden  som  stods ar: 1 till 9, best (bast) och
              fast (snabb). 9 ar forval for gzip och bzip2, 6 for xz och lzma.

       -i[reg.uttr], --diff-ignore[=reg.uttr]
              Du kan ange ett reguljart uttryck i perlformat  for  att  matcha
              filer  som  du  vill skall filtreras ut ur listan over filer for
              diffen.   (Listan   skapas   av    ett    find-kommando.)    (Om
              kallkodspaketet  byggs  som  ett version 3-paket med ett VCS kan
              detta anvandas for att ignorera andringar som inte har  checkats
              in pa de angivna filerna. -i.* kommer att ignorera samtliga.) -i
              ensamt aktiverar funktionen, med ett standardvarde som filtrerar
              ut    styrfiler   och   kataloger   fran   de   flesta   vanliga
              versionshanteringssystem,  sakerhetskopior,  vaxlingsfiler   och
              Libtool-byggutdatakataloger.   Endast  ett  reguljart  kan  vara
              aktivt, om du  anger  flera  -i-flaggor  ar  det  den  sista  pa
              kommandoraden som galler.

              Flaggan  ar  mycket  anvandbar  for  att utesluta extrafiler som
              kommer med i diffen, t.ex om du underhaller din  kallkod  i  ett
              versionshanteringssystem och vill anvanda en utcheckning for att
              bygga ett kallkodspaket utan att ta med de ytterligare filer och
              det  normalt  innehaller  (t.ex  CVS/,  .cvsignore,  .svn/). Det
              forvalda reguljara uttrycket tacker redan in manga av dessa, men
              om  du andrar det, kom ihag att det som standard kan traffa alla
              delar av filnamnet. Sa, om du traffa bara borjan av ett  filnamn
              eller hela filnamn maste du sjalv lagga till de forankringar som
              ar nodvandiga (t.ex '(^|/)', '($|/)').

       --extend-diff-ignore=reg.uttr
              Det  reguljara  uttrycket  i  perlformat   som   angavs   utokar
              standardvardet  for  --diff-ignore  och dess nuvarande varde (om
              satt). Det gor  sa  genom  att  lagga  till  "|reg.uttry"  efter
              standarduttrycket.  Flaggan  ar nyttig for debian/source/options
              for att exkludera  en  del  automatiskt  genererade  filer  fran
              skapandet av automatiska patchar.

       -I[film"onster], --tar-ignore[=film"onster]
              Om  flaggan  anges  kommer  filnamnet  att  sandas  vidare  till
              tar(1):s --exclude-flagga nar  det  anropas  for  att  skapa  en
              .orig.tar.gz  eller  .tar.gz-fil.  Till exempel kommer -ICVS att
              hoppa over CVS-kataloger nar tar.gz-filen  skapas.  Flaggan  kan
              upprepas  flera  ganger  for  att  lista flera filnamn som skall
              uteslutas.

              -i  ensamt  aktiverar  funktionen,  med  ett  standardvarde  som
              filtrerar  ut  styrfiler  och  kataloger  fran de flesta vanliga
              versionshanteringssystem,  sakerhetskopior,  vaxlingsfiler   och
              Libtool-byggutdatakataloger.

       Observera:  Aven  om de anvands till liknande andamal, sa har -i och -I
       valdigt olika syntax och semantik. -i kan endast anges en gang och  tar
       ett   perl-kompatibelt   reguljart  uttryck,  vilket  matchas  mot  den
       kompletta relativa sokvagen for varje fil. -I kan  anges  flera  ganger
       och  tar  ett  filnamnssokmanster med skaljokertecken. Monstret matchas
       mot den kompletta relativa sokvagen, men aven  individuellt  mot  varje
       komponent  i sokvagen. Den exakta semantiken for tar:s --exclude-flagga
       ar                nagot                 komplicerad,                 se
       http://www.gnu.org/software/tar/manual/tar.html#wildcards           for
       fullstandig dokumentation.

       Forvalt reguljart uttryck och sokmonster for de bagge flaggorna kan ses
       i utdata for --help-kommandot.

ALLM"ANNA UPPACKNINGSFLAGGOR

       --no-copy
              Kopiera  inte  original-tarbollar  i  narheten  av det uppackade
              kallkodspaketet.

       --no-check
              Kontrollera inte signaturer och kontrollsummor fore uppackning.

       --require-valid-signature
              Vagra packa  upp  kallkodspaketet  om  det  inte  innehaller  en
              OpenPGP-signatur  som  kan  verifieras  antingen med anvandarens
              trustedkeys.gpg-nyckelring,    en    av    de     saljarspecifka
              nyckelringarna,  eller  en av de officiella Debiannyckelringarna
              (/usr/share/keyrings/debian-keyring.gpg                      och
              /usr/share/keyrings/debian-maintainers.gpg).

FORMAT PoA K"ALLKODSPAKET

       Om  du  inte  vet  vilket  kallkodspaketformat du skall anvanda, bor du
       antagligen valja  antingen  "3.0  (quilt)"  eller  "3.0  (native)".  Se
       http://wiki.debian.org/Projects/DebSrc3.0  for information om hur dessa
       format satts i produktion i Debian.

   Format: 1.0
       Ett kallkodspaket i detta format bestar antingen  av  en  .orig.tar.gz,
       forbunden  med  en  .diff.gz,  eller  en ensam .tar.gz (i sa fall anses
       paketet vara eget, "native").

       Uppackning

       Att packa upp ett Debianeget paket innebar att packa  upp  den  ensamma
       tarbollen i malkatalogen. Att packa upp ett icke-eget paket innebar att
       forst packa upp .orig.tar.gz-filen och sedan genom att tillampa patchen
       som  finns  i  .diff.gz-filen. Tidsstamplarna for alla filer nollstalls
       till den tidpunkt  da  kallkodspaketet  extraherades  (vilket  undviker
       tidsstampelforskjutningar    som    kunde   leda   till   problem   nar
       autogenererade  filer  patchas).  Diffen  kan  skapa  nya  filer  (hela
       debian-katalogen  skapas  pa  det  sattet),  men kan inte ta bort filer
       (tomma filer kommer lamnas kvar).

       Bygga

       Att bygga ett Debianeget paket innebar bara att skapa en ensam  tarboll
       med  kallkodskatalogen.  Att  bygga  ett icke-eget paket innefattar att
       extrahera original-tarbollen i en  separat  ".orig"-katalog  och  skapa
       .diff.gz-filen  pa  nytt genom att jamfora kallkodspaketets katalog med
       .orig-katalogen.

       Byggflaggor (med -b):

       Om ett andra argument som inte ar en flagga anges skall det vara namnet
       pa  originalkallkodskatalogen  eller -tarfilen eller den tomma strangen
       om   paketet   ar   Debianspecifikt   och   darfor   inte   har   nagra
       Debianiserings-diffar. Om inget andra argument anges kommer dpkg-source
       att           leta            efter            originalkallkodstarfilen
       paket_uppstr"omsversion.orig.tar.gz    eller   originalkallkodskatalogen
       paket.orig beroende pa -sX-flaggorna.

       -sa, -sp, -sk, -su och -sr skriver inte over befintliga  tar-filer  och
       kataloger.  Om  det  onskas  bor   -sA,  -sP,  -sK, -sU och -sR anges i
       stallet.

       -sk    Anger att den ursprungliga kallkoden ar en tar-fil, som standard
              paket_uppstr"omsversion.orig.tar.fil"andelse.   Den   kommer  lata
              originalkallkodsfilen ligga kvar som en  tarfil,  eller  kopiera
              den  till  den  aktuella  katalogen  om  den  inte redan ar dar.
              Tarbollen kommer att packas upp i katalog.orig for att  generera
              diffen.

       -sp    Som -sk, men tar bort katalogen igen efterat.

       -su    Anger   att   originalkallkoden  ar  en  katalog,  som  standard
              paket-uppstr"omsversion.orig och att dpkg-source skall skapa  ett
              nytt originalkallkodsarkiv fran den.

       -sr    Som -su, men tar bort katalogen nar den har anvants.

       -ss    Anger  att  originalkallkoden  finns  bade som en katalog och en
              tar-fil. Katalogen kommer att anvandas av  dpkg-source  for  att
              skapa  diffen,  men  tarfilen  for att skapa .dsc-filen. Flaggan
              maste anvandas med tillforsikt - om katalogen och tarfilen  inte
              stammer overens kommer ett trasigt kallkodsarkiv att skapas.

       -sn    Anger  att dpkg-source inte skall leta efter nagot kallkodsarkiv
              och att ingen diff skall skapas. Det andra  argumentet,  om  det
              anges,  maste  vara  den  tomma  strangen.  Flaggan  anvands for
              Debianspecifika paket som inte har en  separat  uppstromskallkod
              och darfor inte har nagon debianiseringsdiff.

       -sa eller -sA
              Anger att originalkallkoden finns som en katalog eller en tarfil
              - det andra argumentet, om det anges, kan vara det ena eller det
              andra,  eller den tomma strangen (motsvarar att anvanda -sn). Om
              en tarfil hittas kommer programmet att packa  upp  den  for  att
              skapa  en  diff  och  ta bort den efterat (motsvarar -sp). Om en
              katalog  hittas  kommer   den   att   packas   for   att   skapa
              originalkallkoden  och  ta  bort den efterat (motsvarar -sn). Om
              bada hittas  kommer  dpkg-source  att  ignorera  katalogen,  och
              skriva over den om -sA angavs (detta motsvarar -sP) eller ge ett
              felmeddelande om -sa angavs. -sA ar standard.

       --abort-on-upstream-changes
              Processen  misslyckas  om  den  genererade   diffen   innehaller
              andringar  av  filer  utanfor  underkatalogen  debian.  Den  har
              flaggan tillats inte i debian/source/options, men kan anvandas i
              debian/source/local-options.

       Extraheringsflaggor (med -x):

       Oavsett kommer ett befintligt kallkodstrad att tas bort.

       -sp    Anvands  nar  originalkallkoden  som extraheras (om sadan finns)
              skall lamnas kvar som en tarfil. Om den inte redan finns  i  den
              aktuella  katalogen,  eller  om en befintlig men annan fil finns
              dar, kommer den att kopieras dit. (Detta "ar standard.)

       -su    Packar upp originalkallkodstradet.

       -sn    Forsakrar att originalkallkoden varken kopieras till en aktuella
              katalogen  eller packas upp. Eventuella originalkallkodstrad som
              finns i den aktuella katalogen tas fortfarande bort.

       Alla -sX-flaggor ar omsesidigt uteslutande.  Om  du  anger  mer  an  en
       kommer endast den sista att anvandas.

       --skip-debianization
              Hoppas     over     att     tillampa     debian-diffen    ovanpa
              uppstromskallkoden.

   Format: 2.0
       Aven kant som wig&pen.  Detta  format  rekommenderas  inte  for  allman
       anvandning, formatet "3.0 (quilt)" ersatter det. Wig&pen var den forsta
       specifikationen av en ny generation av kallkodspaketformat.

       Beteendet for detta format ar detsamma som for "3.0  (quilt)"-formatet,
       forutom  att  det  inte  anvander en explicit forteckning patchar. Alla
       filer i debian/patches/  som  motsvarar  det  Perl-reguljara  uttrycket
       [\w-]+  maste  vara  giltiga  patchar: de appliceras nar paketet packas
       upp.

       Nar du bygger ett nytt kallkodspaket  kommer  eventuella  andringar  pa
       uppstromskallkoden    att    lagras    i    en    patch    som   kallas
       zz_debian-diff-auto.

   Format: 3.0 (eget)
       Detta format ar en utokning av det  egna  paketformatet  som  anges  av
       1.0-formatet.  Det  stoder alla komprimeringsmetoder och kommer att som
       standard ignorera alla VCS-specifika filer och  kataloger,  samt  manga
       temporarfiler (se standardvardet som ar knutet till flaggan -i i texten
       for --help).

   Format: 3.0 (quilt)
       Ett   kallkodspaket   i   detta   format   innehaller   atminstone   en
       original-tarboll  (.orig.tar.ext,  dar ext kan vara gz, bz2, lzma eller
       xz) och en Debiantarboll  (.debian.tar.ext).  Den  kan  aven  innehalla
       ytterligare original-tarbollar (.orig-komponent.tar.ext). komponent kan
       endast innehalla alfanumeriska tecken och bindestreck ("-").

       Uppackning

       Huvud-originaltarbollen  packas  upp  forst,   darefter   packas   alla
       ytterligare  originaltarbollar  upp  i  underkataloger  med  namn efter
       komponent-delen i sitt filnamn (eventuella redan  befintliga  kataloger
       ersatts).  Debian-tarbollen  packas  sedan upp ovanpa kallkodskatalogen
       efter att en redan befintlig  debian-katalog  har  tagits  bort  forst.
       Observera  att  debian-tarbollen maste besta av en debian-underkatalog,
       men att den aven kan innehalla binarfiler  utanfor  den  katalogen  (se
       flaggan --include-binaries).

       Alla    patchar    listade    i    debian/patches/debian.series   eller
       debian/patches/series tillampas sedan. Om den forstnamnda filen anvands
       och  den sistnamnda inte existerar (eller ar en symbolisk lank), kommer
       den senare att ersattas av en symbolisk lank till den forsta. Tanken ar
       att   gora   det   enklare   att   anvanda   quilt   till  att  hantera
       patchuppsattningen. Observera att, aven om dpkg-source  korrekt  tolkar
       series-filer  som  anvander  explicita  flaggor  till  patch-programmet
       (lagrade pa kommandoraden efter patch-filnamnet  och  ett  eller  flera
       blanksteg),  sa  ignoreras  dessa  flaggor  och  det  forvantar sig att
       patchar kan tillampas med flaggan -p1 till  patch.  Det  kommer  darfor
       visa en varning sadana flaggor upptacks, och bygget kommer troligen att
       misslyckas.

       Patchar kan aven ta bort filer, pa ungfar samma satt som quilt  normalt
       fungerar.

       Filen   .pc/applied-patchers   skapas   om   patchar   tillampades  vid
       uppackningen.

       Bygga

       Alla original-tarbollar som finns i den aktuella katalogen packas upp i
       en   temporar   katalog   med   samma   logik   som   i   uppackningen,
       debian-katalogen kopieras over  i  den  temporara  katalogen  och  alla
       patchar,  forutom  den automatiska patchen (debian-changesversion eller
       debian-changes,   beroende   pa    --single-debian-patch)    tillampas.
       Temporarkatalogen  jamfors  darefter  mot  kallkodskatalogen. Om diffen
       inte ar tom misslyckas bygget, savida inte --single-debian-patch  eller
       --auto-commit  anvants,  i  vilket fall diffen lagras i den automatiska
       patchen. Om den automatiska patchen skapas/tas bort, laggs den till/tas
       bort fran series-filen och fran quilt-metadata.

       Eventuella andringar pa binarfiler kan inte representeras i en diff och
       kommer  darmed  att  leda   till   ett   felmeddelande,   savida   inte
       paketansvariga medvetet valjer att inkludera den modifierade binarfilen
       i      debian-tarbollen      (genom      att      lista      den      i
       debian/source/include-binaries).  Byggningen kommer aven att misslyckas
       om binarfiler upptacks i  debian-underkatalogen,  savida  de  inte  har
       vitlistats i debian/source/include-binaries.

       Den  uppdaterade  debiankatalogen, och listan over modifierade binarer,
       anvands sedan for att skapa debian-tarbollen.

       Den automatiskt genererade diff-filen  innehaller  inte  andringar  for
       VCS-specifika  filer eller for manga temporara filer (se standardvardet
       som ar knutet till flaggan  -i  i  texten  for  --help).  Detta  galler
       speciellt  katalogen  .pc  som  anvands  av quilt, katalogen kommer att
       ignoreras nar den automatiska patchen skapas.

       Observera: dpkg-source  --before-build  (och  -b)  ser  till  att  alla
       patchar  som anges i seriefilen tillampas sa att paketbygget alltid har
       alla  patchar   tillampade.   Detta   gors   genom   att   hitta   alla
       icke-tillampade   patchar   (som  anges  i  filen  series  men  inte  i
       .pc/applied-patches), och om den forsta patchen i listan kan  tillampas
       utan  fel  kommer  samtliga att tillampas. Flaggan --no-preparation kan
       anvandas for att sla av detta beteende.

       Lagra "andringar

       --commit [katalog] [patchnamn] [patch-fil]
              Skapar en patch som  motsvarar  de  lokala  andringar  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 anvands den
              som  patch  som  motsvarar  de  lokala   andringar   som   skall
              integreras.  Detta  ar  oftast  anvandbart  efter ett misslyckat
              bygge som skapat filen pa forhand.  Nar  patchen  ar  integrerad
              startas    ett   redigeringsprogram   sa   att   du   kan   ange
              metainformationen i patchhuvudet.

       Byggflaggor

       --allow-version-of-quilt-db=version
              Tillat dpkg-source att bygga  kallkodspaketet  om  versionen  av
              quilt-metadata  ar  den  som  angavs,  aven  om dpkg-source inte
              kanner  till  den.  Det  betyder  att  den  givna  versionen  av
              quilt-metadata  ar  kompatibel med version 2 som dpkg-source for
              narvarande  stoder.  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 tidsstampel i den automatiskt genererade patchen.

       --include-binaries
              Lagg till alla modifierade binarer i debian-tarbollen. Lagg aven
              till  dem i debian/source/include-binaries: de kommer att laggas
              till som standard i foljande byggen och du behover  inte  langre
              ange den har flaggan.

       --no-preparation
              Forsok  inte att forbereda byggtradet genom att tillampa patchar
              som inte verkar ha tillampas for narvarande.

       --single-debian-patch
              Anvand      debian/patches/debian-changes      istallet      for
              debian/patches/debian-changes-version    som    namn    pa   den
              automatiska patch som genereras  vid  bygget.  Denna  flagga  ar
              speciellt     nyttig     nar     paketet    hanteras    i    ett
              versionshanteringssystem och en patch inte  kan  skapas  pa  ett
              palitligt   satt.  Den  aktuella  diffen  mot  uppstroms  lagras
              istallet   i   en   ensam   patch.   Flaggan   bor    anges    i
              debian/source/local-options      och      foljs     av     filen
              debian/source/local-patch-header     som      beskricer      hur
              Debianandringarna   bast   kan   ses,   till   exempel   i   det
              versionshanteringssystem som anvands.

       --create-empty-orig
              Skapa huvud-originaltarbollen som tom automatiskt om den  saknas
              och  om det finns supplement-originaltarbollar. Flaggan ar tankt
              att anvandas nar kallkodspaketet bara ar  en  samling  av  flera
              uppstromsprogram och dar det inte finns nagot "huvud"-program.

       --unapply-patches
              Ta  bort  patchar i kroken --after-build. Du behover oftast inte
              ange flaggan eftersom dpkg-source automatiskt tar  bort  patchar
              om  de  tillampades  i  --before-build. Flaggan tillats endast i
              debian/source/local-options sa att alla genererade kallkodspaket
              som standard har samma beteende.

       --abort-on-upstream-changes
              Processen  misslyckas  om  en  automatisk  patch har genererats.
              Flaggan kan anvandas for att se  till  att  alla  andringar  har
              lagrats   undan   korrekt   i   separata   quilt-patchar   innan
              kallkodspaketet    byggts.    Flaggan     tillats     inte     i
              debian/source/options,       men       kan       anvandas      i
              debian/source/local-options.

       --auto-commit
              Processen misslyckas inte om en automatisk  patch  har  skapats,
              den laggs istallet direkt in i quilt-serien.

       Extraheringsflaggor

       --skip-debianization
              Hoppas    over    att    packa   upp   debian-tarbollen   ovanpa
              uppstromskallkoden.

       --skip-patches
              Applicera inte patchar i slutet av uppackningen.

   Format: 3.0 (skr"addarsytt)
       Detta   formatet   ar   speciellt.   Det   anger   inte   ett   riktigt
       kallkodspaketformat,  utan kan anvandas for att skapa kallkodspaket med
       godtyckliga filer.

       Byggflaggor

       Alla argument som inte ar flaggor tas som filer som skall integreras  i
       det  skapade  kallkodspaketet.  De  maste  finnas,  och helst i aktuell
       katalog. Atminstone en fil maste anges.

       --target-format=v"arde
              Kr"avs.  Anger   det   riktiga   formatet   pa   det   genererade
              kallkodspaketet.  Den  skapade .dsc-filen kommer innehalla detta
              varde i sitt Format-falt och inte "3.0 (custom)".

   Format: 3.0 (git)
       Formatet ar experimentellt.

       Ett kallkodspaket i detta format bestar av en ensam "bundle"  fran  ett
       git-arkiv  .git, vilket innehaller paketets kallkod. Filen .gitshallow,
       som innehaller revisioner for grunda git-kloner, kan aven forekomma.

       Uppackning

       "Bundle":n  klonas  som  ett  git-arkiv  till  malkatalogen.  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 kallkodstradet.
       (Typiskt "master", men kan vara vad som helst.) Eventuella andra grenar
       kommer ocksa att vara tillgangliga, under "remotes/origin/".

       Bygga

       Innan  uppackningen fortsatter kommer en del tester att utforas for att
       se till att vi inte har nagra ej ignorerade ej incheckade andringar.

       git-bundle(1) anvands for att generera en  "bundle"  fran  git-arkivet.
       Som standard tas alla grenar och taggar i arkivet med i "bundle":n.

       Byggflaggor

       --git-ref=ref
              Gor  det  mojligt  att  ange en git-referens som skall tas med i
              "bundle":n. Om den anges overstyr den standardbeteendet  som  ar
              att  ta  med alla grenar och taggar. Kan anges flera ganger. ref
              kan vara namnet pa en gren eller tagg som skall tas med. Den kan
              aven  vara  vilken  som helst annan parameter som kan sandas med
              till git-rev-list(1). For  att,  till  exempel,  endast  ta  med
              grenen  "master",  angand  --git-ref=master. For att ta med alla
              taggar   och   grenar,   forutom    grenen    private,    anvand
              --git-ref=--all --git-ref=^private

       --git-depth=antal
              Skapar  en  grund  klon  med en historik som ar avhuggen vid det
              angivna antalet revisioner.

   Format: 3.0 (bzr)
       Detta format ar experimentellt. Det  genererar  en  ensam  tarboll  som
       innehaller bzr-arkivet.

       Uppackning

       Tarbollen  packas  upp  och  bzr  anvands  sedan  for  att hamta ut den
       aktuella grenen.

       Bygga

       Innan uppackningen fortsatter kommer en del tester att utforas for  att
       se till att vi inte har nagra ej ignorerade ej incheckade andringar.

       De  VCS-specifika  delarna  av  kallkodskatalogen  kommer  darefter att
       kopieras over till en temporar katalog. Innan den  temporara  katalogen
       packas i en tarboll utfors viss stadning for att spara plats.

VARNINGAR OCH FELMEDDELANDEN

   k"allkodsformat ej angivet i debian/source/format
       Filen  debian/source/format  bor  alltid  finnas  och  ange det onskade
       kallkodsformatet. For bakatkompatibilitet antar formatet "1.0" om filen
       inte  finns,  men  du  bor inte forlita dig pa detta: vid nagon punkt i
       framtiden kommer dpkg-source att justeras  sa  att  det  misslyckas  om
       filen inte finns.

       Resonemanget  bakom  detta  ar  att  formatet  "1.0" inte langre ar det
       rekommenderade formatet, du bor normalt valja ett av de nyare  formaten
       ("3.0  (quilt)",  "3.0  (native)"),  men  dpkg-source  gor  inte  detta
       automatiskt at dig. Om du vill fortsatta anvanda det gamla formatet bor
       du ange det explicit genom att skriva "1.0" i debian/source/format.

   diffen modifierar f"oljande uppstr"omsfiler
       Nar du anvander kallkodsformatet "1.0" ar det oftast inte nagon bra ide
       att modifiera uppstromsfiler direkt eftersom andringarna  doljs  och  i
       huvudsak  ar odokumenterade i diff.gz-filen. Du bor istallet spara dina
       andringar som patchar i debian-katalogen och applicera dem nar  paketet
       skall byggas. For att undvika den har komplexiteten kan du aven anvanda
       formatet "3.0 (quilt)" som later dig gora det har automatiskt.

   kan inte representera "andringen f"or fil
       Andringar pa uppstromsfiler sparas normalt  som  patchfiler,  men  inte
       alla  andringar  kan  representeras  med  patchar:  de kan endast andra
       innehallet i vanliga textfiler. Om du forsoker ersatta en fil med nagot
       som  har  en  annan  typ  (till  exempel  ersatta  en vanlig fil med en
       symbolisk lank eller en katalog) far du det har felmeddelandet.

   den tomma filen fil som just skapats kommer inte representeras i diffen
       Tomma filer kan inte skapas med  patchfiler.  Andringen  kommer  darmed
       inte att sparas i kallkodspaketet och du far en varning om det.

   exekveringsl"age l"age poa fil kommer inte representeras i diffen
   speciall"aget l"age poa fil kommer inte representeras i diffen
       Patchfiler  beskriver inte laget pa filer och andrade lagen sparas inte
       i kallkodspaketet. Den har varningen paminner dig om detta.

FILFORMAT

   debian/source/format
       Filen innehaller pa en ensam rad det format som skall anvandas for  att
       bygga  kallkodspaketet  (mojliga  format beskrivs ovan). Varken ledande
       eller avslutande blanksteg tillats.

   debian/source/include-binaries
       Filen innehaller en forteckning over binarfiler (en per rad) som  skall
       tas  med  i  debian-tarbollen.  Inledande  och avslutande blanksteg tas
       bort. Rader som borjar med "#" ar kommentarer och  hoppas  over.  Tomma
       rader ignoreras.

   debian/source/options
       Filen  innehaller  en lista over langa flaggor som automatiskt satts in
       fore kommandoradsflaggorna som anges i ett  anrop  til  dpkg-source  -b
       eller   dpkg-source   --print-format.  Flaggor  som  --compression  och
       --compression-level ar passande att lagga in i den  har filen.

       Ange varje flagga pa en egen rad. Tomma rader och rader som borjar  med
       "#"  ignoreras. Inledande "--" skall tas bort och korta flaggor ar inte
       tillatna. Blanksteg tillats runt "="-tecknet  och  citattecken  tillats
       runt vardet. Har ar ett exempel pa en sadan fil:

         # lat dpkg-source skapa en debian.tar.bz2 med maximal komprimering
         compression = "bzip2"
         compression-level = 9
         # anvand debian/patches/debian-changes som en automatisk patch
         single-debian-patch
         # ignorera andringar i config.{sub,guess}
         extend-diff-ignore = "(^|/)(config.sub|config.guess)$"

       Observera:  format-flaggor tillats inte i den har filen, du bor anvanda
       filen debian/source/format istallet.

   debian/source/local-options
       Precis som debian/source/options forutom att filen  inte  inkluderas  i
       det  genererade  kallkodspaketet. Det kan vara anvandbart for att spara
       ett   val   som   galler   for   paketansvariga   eller    VCS-systemet
       kallkodspaketet hanteras i.

   debian/source/local-patch-header
   debian/source/patch-header
       Friformstext  som  laggs  in  pa  toppen  av den automatiskt genererade
       patchen i formaten "2.0" eller "3.0  (quilt)".  local-patch-header  tas
       inte med i det genererade kallkodspaketet medan patch-header tas med.

   debian/patches/series
       Listar  alla patchar som maste tillampas (i den givna ordningen) ovanpa
       uppstromskallkodspaketet. Inledande och avslutande blanksteg tas  bort.
       Rader  som  borjar  med  "#"  ar kommentarer och ignoreras. Tomma rader
       ignoreras. De rader som ar kvar inleds med  filnamnet  pa  en  patchfil
       (relativt   till   debian/patches/-katalogen)   upp   till  det  forsta
       blankstegstecknet eller slutet pa raden. Valfria flaggor till quilt kan
       folja  fram till slutet av raden eller det forsta "#" som foljer pa ett
       eller flera blanksteg (vilket anger borjan pa en  kommentar  fram  till
       slutet av raden).

PROGRAMFEL

       Tidpunkten  pa  faltoverstyrning  intraffar  jamfort med installning av
       vissa standardutdatafalt ar ganska forvirrad.

SE "AVEN

       dpkg-deb(1), dpkg(1), dselect(1).

F"ORFATTARE

       Upphovsrattsskyddat (C) 1995-1996 Ian Jackson
       Upphovsrattsskyddat (C) 2000 Wichert Akkerman
       Upphovsrattsskyddat (C) 2008-2011 Raphael Hertzog

       Detta ar fri programvara; se GNU General Public License version 2 eller
       senare for kopieringsvillkor. Det finns INGEN GARANTI.

"OVERS"ATTNING

       Peter Krefting och Daniel Nylander.