dpkg-source - Dalam Talian di Awan

JADUAL:

NAMA

dpkg-source - Alat manipulasi pakej sumber Debian (.dsc).

SINOPSIS

dpkg-source [pilihan...] arahan

DESCRIPTION

dpkg-source mengemas dan membongkar arkib sumber Debian.

Tiada satu pun daripada arahan ini membenarkan berbilang pilihan untuk digabungkan menjadi satu, dan mereka tidak
benarkan nilai untuk pilihan dinyatakan dalam hujah yang berasingan.

PERINTAH

-x, --ekstrak nama fail.dsc [direktori keluaran]
Ekstrak pakej sumber (--ekstrak sejak dpkg 1.17.14). Satu hujah bukan pilihan
mesti dibekalkan, nama fail kawalan sumber Debian (.dsc). Pilihan
hujah bukan pilihan kedua mungkin dibekalkan untuk menentukan direktori untuk mengekstrak
pakej sumber ke, ini mesti tidak wujud. Jika tiada direktori output ditentukan,
pakej sumber diekstrak ke dalam direktori bernama sumber-versi di bawah arus
direktori kerja.

dpkg-source akan membaca nama fail lain yang membentuk pakej sumber
daripada fail kawalan; mereka diandaikan berada dalam direktori yang sama dengan .dsc.

Fail dalam pakej yang diekstrak akan ditetapkan kebenaran dan pemilikannya
kepada mereka yang dijangkakan sekiranya fail dan direktori mempunyai
telah dibuat - direktori dan fail boleh laku akan menjadi 0777 dan fail biasa akan
be 0666, kedua-duanya diubah suai oleh umask pengekstrak; jika direktori induk ditetapkan
maka direktori yang diekstrak akan menjadi juga, dan semua fail dan direktori akan
mewarisi pemilikan kumpulannya.

Jika pakej sumber menggunakan format bukan standard (pada masa ini ini bermakna semua format
kecuali "1.0"), namanya akan disimpan dalam debian/sumber/format supaya yang
binaan pakej sumber berikut menggunakan format yang sama secara lalai.

-b, --bina direktori [format-spesifik-parameter]
Bina pakej sumber (--bina sejak dpkg 1.17.14). Hujah bukan pilihan pertama
diambil sebagai nama direktori yang mengandungi pokok sumber debian (mis
dengan sub-direktori debian dan mungkin berubah kepada fail asal). Bergantung kepada
format pakej sumber yang digunakan untuk membina pakej, parameter tambahan mungkin
diterima.

dpkg-source akan membina pakej sumber dengan format pertama yang terdapat dalam ini
senarai pesanan: format yang ditunjukkan dengan --format pilihan baris arahan, the
format yang ditunjukkan dalam debian/sumber/format, “1.0”. Sandaran kepada "1.0" ialah
ditamatkan dan akan dialih keluar pada satu ketika pada masa hadapan, anda harus sentiasa
dokumenkan format sumber yang dikehendaki dalam debian/sumber/format. Lihat bahagian SUMBER
PAKEJ FORMATS untuk penerangan yang meluas tentang pelbagai format pakej sumber.

--format-cetak direktori
Cetak format sumber yang akan digunakan untuk membina pakej sumber jika
dpkg-source --bina direktori telah dipanggil (dalam keadaan yang sama dan dengan keadaan yang sama
parameter; sejak dpkg 1.15.5).

--sebelum-membina direktori
Jalankan cangkuk yang sepadan dengan format pakej sumber (sejak dpkg 1.15.8). ini
cangkuk dipanggil sebelum sebarang binaan pakej (dpkg-buildpackage memanggilnya sangat
awal walaupun sebelum ini debian/peraturan membersihkan). Perintah ini adalah idempoten dan boleh dipanggil
berkali-kali. Tidak semua format sumber melaksanakan sesuatu dalam cangkuk ini, dan itu
yang biasanya menyediakan pokok sumber untuk binaan contohnya dengan memastikan bahawa
tampung Debian digunakan.

--selepas-bina direktori
Jalankan cangkuk yang sepadan dengan format pakej sumber (sejak dpkg 1.15.8). ini
cangkuk dipanggil selepas sebarang binaan pakej (dpkg-buildpackage memanggilnya terakhir).
Perintah ini adalah idempoten dan boleh dipanggil beberapa kali. Bukan semua format sumber
melaksanakan sesuatu dalam cangkuk ini, dan mereka yang melakukannya biasanya menggunakannya untuk membuat asal apa
--sebelum-membina telah dilakukan.

--komit [direktori] ...
Rekodkan perubahan dalam pokok sumber yang dibongkar direktori (sejak dpkg 1.16.1). ini
arahan boleh mengambil parameter tambahan bergantung pada format sumber. Ia akan
ralat keluar untuk format yang operasi ini tidak bermakna apa-apa.

-?, - membantu
Tunjukkan mesej penggunaan dan keluar.

--versi
Tunjukkan versi dan keluar.

PILIHAN

Generik membina pilihan
-cfail kawalan
Menentukan fail kawalan sumber utama untuk membaca maklumat daripadanya. Lalainya ialah
debian / kawalan. Jika diberikan dengan nama laluan relatif ini ditafsirkan bermula pada
direktori peringkat atas pokok sumber.

-lchangelog-fail
Menentukan fail changelog untuk membaca maklumat daripada. Lalainya ialah
debian/changelog. Jika diberikan dengan nama laluan relatif ini ditafsirkan bermula pada
direktori peringkat atas pokok sumber.

-Fchangelog-format
Menentukan format log perubahan. Lihat dpkg-parsechangelog(1) untuk maklumat
mengenai format alternatif.

--format=nilai
Gunakan format yang diberikan untuk membina pakej sumber (sejak dpkg 1.14.17). Ia berlaku
mengatasi sebarang format yang diberikan debian/sumber/format.

-Vnama=nilai
Tetapkan pembolehubah penggantian keluaran. Lihat deb-substvars(5) untuk perbincangan tentang
penggantian keluaran.

-Tsubstvars-file
Baca pembolehubah penggantian dalam substvars-file; lalainya adalah untuk tidak membaca sebarang fail.
Pilihan ini boleh digunakan beberapa kali untuk membaca pembolehubah penggantian daripada berbilang
fail (sejak dpkg 1.15.6).

-Dbidang=nilai
Tolak atau tambah medan fail kawalan output.

-Ubidang
Alih keluar medan fail kawalan output.

-Zmampatan, --mampatan=mampatan
Tentukan pemampatan untuk digunakan untuk fail tarball dan perbezaan yang dibuat (--mampatan
sejak dpkg 1.15.5). Ambil perhatian bahawa pilihan ini tidak akan menyebabkan tarball sedia ada
dimampatkan semula, ia hanya menjejaskan fail baharu. Nilai yang disokong ialah: gzip, bzip2, lzma
and xz. Lalai adalah xz untuk format 2.0 dan lebih baharu, dan gzip untuk format 1.0. xz
hanya disokong sejak dpkg 1.15.5.

-ztahap, --tahap mampatan=tahap
Tahap mampatan untuk digunakan (--tahap mampatan sejak dpkg 1.15.5). Seperti dengan -Z it
hanya menjejaskan fail yang baru dibuat. Nilai yang disokong ialah: 1 kepada 9, terbaik, dan cepat.
Lalai adalah 9 untuk gzip dan bzip2, 6 untuk xz dan lzma.

-i[regex], --berbeza-abaikan[=regex]
Anda boleh menentukan ungkapan biasa perl untuk memadankan fail yang anda mahu ditapis
senarai fail untuk perbezaan (--berbeza-abaikan sejak dpkg 1.15.6). (Senarai ini ialah
dijana oleh arahan cari.) (Jika pakej sumber sedang dibina sebagai versi 3
pakej sumber menggunakan VCS, ini boleh digunakan untuk mengabaikan perubahan tanpa komitmen pada
fail tertentu. Menggunakan -i.* akan mengabaikan kesemuanya.)

. -i pilihan dengan sendirinya membolehkan tetapan ini dengan regex lalai (memelihara sebarang
pengubahsuaian kepada regex lalai yang dilakukan oleh penggunaan sebelumnya --extend-diff-ignore)
yang akan menapis fail kawalan dan direktori semakan yang paling biasa
sistem kawalan, sandaran dan swap fail dan Libtool membina direktori output. di sana
hanya boleh menjadi satu regex aktif, daripada berbilang -i pilihan hanya yang terakhir akan diambil
kesan.

Ini sangat membantu dalam memotong fail luar yang disertakan dalam perbezaan,
cth jika anda mengekalkan sumber anda dalam sistem kawalan semakan dan ingin menggunakan a
checkout untuk membina pakej sumber tanpa memasukkan fail tambahan dan
direktori yang biasanya akan mengandungi (cth CVS/, .cvsignore, .svn/). The
regex lalai sudah sangat lengkap, tetapi jika anda perlu menggantikannya, sila
ambil perhatian bahawa secara lalai ia boleh memadankan mana-mana bahagian laluan, jadi jika anda mahu memadankan
permulaan nama fail atau hanya nama fail penuh, anda perlu menyediakan yang diperlukan
sauh (cth '(^|/)', '($|/)') sendiri.

--extend-diff-ignore=regex
Ungkapan biasa perl yang ditentukan akan memanjangkan nilai lalai yang digunakan oleh
--berbeza-abaikan dan nilai semasanya, jika ditetapkan (sejak dpkg 1.15.6). Ia melakukan ini dengan
menggabungkan "|regex” kepada nilai sedia ada. Pilihan ini mudah digunakan dalam
debian/sumber/pilihan untuk mengecualikan beberapa fail yang dijana secara automatik daripada tampung automatik
Generasi.

-I[corak fail], --tar-abaikan[=corak fail]
Jika pilihan ini ditentukan, corak akan dihantar ke tar(1)'s --kecualikan
pilihan apabila ia dipanggil untuk menjana fail .orig.tar atau .tar (--tar-abaikan sejak
dpkg 1.15.6). Sebagai contoh, -ICVS akan membuat tar melangkau direktori CVS apabila
menjana fail .tar.gz. Pilihan mungkin diulang beberapa kali untuk disenaraikan
berbilang corak untuk dikecualikan.

-I dengan sendirinya menambah lalai --kecualikan pilihan yang akan menapis fail kawalan dan
direktori sistem kawalan semakan yang paling biasa, fail sandaran dan pertukaran dan
Libtool membina direktori output.

Catatan: Walaupun mereka mempunyai tujuan yang sama, -i and -I mempunyai sintaks yang sangat berbeza dan
semantik. -i hanya boleh ditentukan sekali dan mengambil ungkapan biasa yang serasi dengan perl
yang dipadankan dengan laluan relatif penuh setiap fail. -I boleh ditentukan berbilang
kali dan mengambil corak nama fail dengan kad bebas shell. Corak digunakan pada
laluan relatif penuh tetapi juga kepada setiap bahagian laluan secara individu. Semantik yang tepat bagi
tar --kecualikan pilihan agak rumit, lihat
https://www.gnu.org/software/tar/manual/tar.html#wildcards for a full documentation.

Regex lalai dan corak untuk kedua-dua pilihan boleh dilihat dalam output fail - membantu
perintah.

Generik mengekstrak pilihan
--tiada-salinan
Jangan salin tarball asal berhampiran pakej sumber yang diekstrak (sejak dpkg
1.14.17).

--tidak-semak
Jangan semak tandatangan dan jumlah semak sebelum membongkar (sejak dpkg 1.14.17).

--memerlukan-tandatangan-sah
Enggan membongkar pakej sumber jika ia tidak mengandungi tandatangan OpenPGP itu
boleh disahkan (sejak dpkg 1.15.0) sama ada dengan pengguna trustedkeys.gpg cincin kunci,
salah satu cincin kunci khusus vendor, atau salah satu cincin kunci Debian rasmi
(/usr/share/keyrings/debian-keyring.gpg and
/usr/share/keyrings/debian-maintainers.gpg).

--abaikan-versi-buruk
Mengubah semakan versi pakej sumber buruk menjadi amaran tidak membawa maut (sejak dpkg
1.17.7). Pilihan ini hanya perlu apabila mengekstrak sumber purba
pakej dengan versi yang rosak, hanya untuk keserasian ke belakang.

SUMBER PAKEJ FORMATS

Jika anda tidak tahu format sumber yang hendak digunakan, anda mungkin perlu memilih sama ada "3.0 (kuilt)"
atau “3.0 (asli)”. Lihat https://wiki.debian.org/Projects/DebSrc3.0 untuk maklumat tentang
penggunaan format tersebut dalam Debian.

Format: 1.0
Pakej sumber dalam format ini mengandungi sama ada a .orig.tar.gz dikaitkan dengan a .diff.gz
atau bujang .tar.gz (dalam kes itu pakej itu dikatakan asli).

Mengekstrak

Mengekstrak pakej asli ialah pengekstrakan mudah tarball tunggal dalam sasaran
direktori. Mengekstrak pakej bukan asli dilakukan dengan terlebih dahulu membongkar pakej .orig.tar.gz and
kemudian memohon tampalan yang terkandung dalam .diff.gz fail. Cap masa semua fail yang ditambal
ditetapkan semula kepada masa pengekstrakan pakej sumber (ini mengelakkan pencongan cap masa mendahului
kepada masalah apabila fail yang dijana secara automatik ditampal). Perbezaan boleh mencipta fail baharu (the
keseluruhan direktori debian dibuat dengan cara itu) tetapi tidak boleh mengalih keluar fail (fail kosong akan menjadi
sisa).

Bangunan

Membina pakej asli hanyalah mencipta satu tarball dengan direktori sumber.
Membina pakej bukan asli melibatkan pengekstrakan tarball asal secara berasingan
direktori “.orig” dan menjana semula .diff.gz dengan membandingkan pakej sumber direktori
dengan direktori .orig.

Membina pilihan (dengan --bina):

Jika argumen bukan pilihan kedua dibekalkan, ia mestilah nama sumber asal
direktori atau tarfile atau rentetan kosong jika pakej tersebut adalah khusus Debian dan sebagainya
tidak mempunyai perbezaan Debianisasi. Jika tiada hujah kedua dibekalkan maka dpkg-source akan kelihatan
untuk tarfile sumber asal package_upstream-version.orig.tar.gz atau yang asal
direktori sumber direktori.orig bergantung kepada -sX hujah-hujah.

-sa, -sp, -sk, -su and -sr tidak akan menimpa tarfiles atau direktori sedia ada. Jika ini
dikehendaki kemudian -sA, -sP, -sK, -sU and -sR hendaklah digunakan sebaliknya.

-sk Menentukan untuk mengharapkan sumber asal sebagai fail tar, secara lalai pakej_hulu-
versi.orig.tar.lanjutan. Ia akan meninggalkan sumber asal ini sebagai a
tarfile, atau salin ke direktori semasa jika ia belum ada. Bola tar itu
akan dibongkar ke dalam direktori.orig untuk generasi diff.

-sp suka -sk tetapi akan mengalih keluar direktori semula selepas itu.

-su Menentukan bahawa sumber asal dijangka sebagai direktori, secara lalai pakej-
versi huluan.orig and dpkg-source akan membuat arkib sumber asal baharu
dari sini.

-sr suka -su tetapi akan mengalih keluar direktori itu selepas ia digunakan.

-ss Menentukan bahawa sumber asal tersedia sebagai direktori dan sebagai a
tarfile. dpkg-source akan menggunakan direktori untuk mencipta perbezaan, tetapi tarfile ke
buat .dsc. Pilihan ini mesti digunakan dengan berhati-hati - jika direktori dan tarfile
tidak sepadan arkib sumber yang buruk akan dihasilkan.

-sn Menentukan untuk tidak mencari mana-mana sumber asal, dan untuk tidak menjana perbezaan. The
hujah kedua, jika dibekalkan, mestilah rentetan kosong. Ini digunakan untuk Debian-
pakej khusus yang tidak mempunyai sumber huluan yang berasingan dan oleh itu mempunyai
tiada debianisasi berbeza.

-sa or -sA
Menentukan untuk mencari arkib sumber asal sebagai fail tar atau sebagai direktori -
hujah kedua, jika ada, mungkin sama ada, atau rentetan kosong (ini bersamaan
untuk menggunakan -sn). Jika fail tar ditemui, ia akan membongkarnya untuk mencipta perbezaan dan
keluarkannya selepas itu (ini bersamaan dengan -sp); jika direktori ditemui ia akan
bungkusnya untuk mencipta sumber asal dan keluarkannya selepas itu (ini bersamaan
kepada -sr); jika kedua-duanya tidak dijumpai, ia akan menganggap bahawa pakej itu tidak mempunyai debianisasi
diffs, hanya arkib sumber yang mudah (ini bersamaan dengan -sn). Jika kedua-duanya
ditemui kemudian dpkg-source akan mengabaikan direktori, menimpanya, jika -sA adalah
ditentukan (ini bersamaan dengan -sP) atau menimbulkan ralat jika -sa telah dinyatakan. -sA
adalah lalai.

--abort-on-upstream-perubahan
Proses gagal jika perbezaan yang dihasilkan mengandungi perubahan pada fail di luar
sub-direktori debian (sejak dpkg 1.15.8). Pilihan ini tidak dibenarkan masuk
debian/sumber/pilihan tetapi boleh digunakan dalam debian/source/local-options.

Mengekstrak pilihan (dengan --ekstrak):

Dalam semua kes, mana-mana pokok sumber asal sedia ada akan dialih keluar.

-sp Digunakan semasa mengekstrak maka sumber asal (jika ada) akan ditinggalkan sebagai tarfile.
Jika ia belum terletak dalam direktori semasa atau jika ada tetapi
fail yang berbeza di sana ia akan disalin di sana. (ini is yang lalai).

-su Membongkar pokok sumber asal.

-sn Memastikan bahawa sumber asal tidak disalin ke direktori semasa mahupun
dibongkar. Mana-mana pokok sumber asal yang berada dalam direktori semasa masih
dikeluarkan.

Semua -sX pilihan adalah saling eksklusif. Jika anda menentukan lebih daripada satu sahaja yang terakhir
akan digunakan.

--langkau-debianisasi
Melangkau penggunaan perbezaan debian di atas sumber huluan (sejak dpkg
1.15.1).

Format: 2.0
Pengekstrakan disokong sejak dpkg 1.13.9, bangunan disokong sejak dpkg 1.14.8. Juga dikenali
sebagai rambut palsu&pen. Format ini tidak disyorkan untuk penggunaan meluas, format "3.0 (kuilt)"
menggantikannya. Wig&pen ialah spesifikasi pertama pakej sumber generasi baharu
format.

Gelagat format ini adalah sama seperti format "3.0 (kuilt)" kecuali ia
tidak menggunakan senarai tampung yang jelas. Semua fail masuk debian/patches/ sepadan dengan perl
ekspresi biasa [\w-]+ mestilah patch yang sah: ia digunakan pada masa pengekstrakan.

Apabila membina pakej sumber baharu, sebarang perubahan kepada sumber huluan disimpan dalam tampung
bernama zz_debian-diff-auto.

Format: 3.0 (asli)
Disokong sejak dpkg 1.14.17. Format ini adalah lanjutan daripada format pakej asli sebagai
ditakrifkan dalam format 1.0. Ia menyokong semua kaedah pemampatan dan akan mengabaikan secara lalai
sebarang fail dan direktori khusus VCS serta banyak fail sementara (lihat nilai lalai
dikaitkan dengan -I pilihan dalam - membantu pengeluaran).

Format: 3.0 (selimut)
Disokong sejak dpkg 1.14.17. Pakej sumber dalam format ini mengandungi sekurang-kurangnya satu
tarball asal (.orig.tar.ext di mana ext boleh gz, bz2, lzma and xz) dan debian
bola tar (.debian.tar.ext). Ia juga boleh mengandungi tarball asli tambahan
(.asal-komponen.tar.ext). komponen hanya boleh mengandungi aksara alfanumerik dan sempang
('-').

Mengekstrak

Tarball asal utama diekstrak dahulu, kemudian semua tarball asli tambahan
diekstrak dalam subdirektori yang dinamakan sempena komponen sebahagian daripada nama fail mereka (sebarang pra-
direktori sedia ada diganti). Tarball debian diekstrak di atas sumber
direktori selepas mengalih keluar mana-mana yang sedia ada Debian direktori. Perhatikan bahawa debian
tarball mesti mengandungi a Debian sub-direktori tetapi ia juga boleh mengandungi fail binari di luar
daripada direktori itu (lihat --termasuk-perduaan pilihan).

Semua patch disenaraikan dalam debian/patches/debian.series or debian/tampung/siri adalah kemudian
digunakan. Jika fail yang pertama digunakan dan yang terakhir tidak wujud (atau merupakan symlink),
maka yang terakhir digantikan dengan symlink kepada yang pertama. Ini bertujuan untuk memudahkan penggunaan
of selimut untuk menguruskan set tampalan. Perhatikan bagaimanapun bahawa sementara dpkg-source menghurai
siri fail dengan betul dengan pilihan eksplisit yang digunakan untuk aplikasi tampalan (disimpan pada setiap
baris selepas nama fail tampalan dan satu atau lebih ruang), ia mengabaikan pilihan tersebut dan
sentiasa mengharapkan patch yang boleh digunakan dengan -p1 pilihan untuk tampalan. Ia dengan itu akan memancarkan
amaran apabila ia menghadapi pilihan sedemikian, dan binaan berkemungkinan gagal.

Cap masa semua fail yang ditampal ditetapkan semula kepada masa pengekstrakan pakej sumber
(ini mengelakkan pencongan cap masa yang membawa kepada masalah apabila fail yang dijana secara automatik ditampal).

Bertentangan dengan selimutTingkah laku lalai, tampungan dijangka akan digunakan tanpa sebarang kabur.
Apabila itu tidak berlaku, anda harus menyegarkan semula patch tersebut dengan selimut, Atau dpkg-source akan
ralat semasa cuba menerapkannya.

Begitu juga dengan selimutTingkah laku lalai, tampung boleh mengalih keluar fail juga.

Fail .pc/applied-patches dicipta jika beberapa tampalan telah digunakan semasa
pengekstrakan.

Bangunan

Semua tarball asal yang terdapat dalam direktori semasa diekstrak secara sementara
direktori dengan mengikut logik yang sama seperti untuk membongkar, direktori debian disalin
di dalam direktori sementara, dan semua tampalan kecuali tampalan automatik
(debian-perubahan-versi or debian-perubahan, bergantung kepada --tampalan-debian-tunggal) adalah
digunakan. Direktori sementara dibandingkan dengan direktori pakej sumber. Apabila
diff tidak kosong, binaan gagal melainkan --tampalan-debian-tunggal or --auto-komit telah
digunakan, dalam hal ini perbezaan disimpan dalam patch automatik. Jika tampalan automatik adalah
dicipta/dipadamkan, ia ditambah/dialih keluar daripada fail siri dan daripada fail selimut metadata.

Sebarang perubahan pada fail binari tidak boleh diwakili dalam perbezaan dan dengan itu akan membawa kepada kegagalan
melainkan penyelenggara dengan sengaja memutuskan untuk memasukkan fail binari yang diubah suai itu dalam
debian tarball (dengan menyenaraikannya dalam debian/sumber/include-binary). Binaan juga akan gagal
jika ia menemui fail binari dalam sub-direktori debian melainkan ia telah disenarai putih
melalui debian/sumber/include-binary.

Direktori debian yang dikemas kini dan senarai binari yang diubah suai kemudian digunakan untuk menjana
tarball debian.

Perbezaan yang dijana secara automatik tidak termasuk perubahan pada fail khusus VCS serta
banyak fail sementara (lihat nilai lalai yang dikaitkan dengan -i pilihan dalam - membantu pengeluaran). Dalam
khususnya, yang .pc direktori yang digunakan oleh selimut diabaikan semasa penjanaan automatik
tampalan.

Catatan: dpkg-source --sebelum-membina (Dan --bina) akan memastikan bahawa semua patch yang disenaraikan dalam
fail siri digunakan supaya binaan pakej sentiasa menggunakan semua tampung. Ia berlaku
ini dengan mencari patch yang tidak digunakan (ia disenaraikan dalam siri fail tetapi tidak masuk
.pc/applied-patches), dan jika tampalan pertama dalam set itu boleh digunakan tanpa ralat, ia
akan menerapkan kesemuanya. Pilihannya --tiada-persediaan boleh digunakan untuk melumpuhkan tingkah laku ini.

Rakaman perubahan

--komit [direktori] [nama tampalan] [fail tampalan]
Menghasilkan tampung yang sepadan dengan perubahan setempat yang tidak diuruskan oleh
selimut sistem tampalan dan menyepadukannya dalam sistem tampalan di bawah nama nama tampalan.
Jika nama itu tiada, ia akan ditanya secara interaktif. Jika fail tampalan diberikan, ia
digunakan sebagai tampung yang sepadan dengan perubahan setempat untuk disepadukan. sekali
bersepadu, editor dilancarkan supaya anda boleh mengedit maklumat meta dalam
pengepala tampalan.

Pemergian fail tampalan berguna terutamanya selepas kegagalan binaan yang menjana ini
fail, dan atas alasan ini fail yang diberikan dialih keluar selepas penyepaduan. Perhatikan juga
bahawa perubahan yang terkandung dalam fail tampalan mestilah telah digunakan pada pokok
dan bahawa fail yang diubah suai oleh tampung mestilah tidak mempunyai tambahan yang tidak direkodkan
perubahan.

Jika penjanaan tampalan mengesan fail binari yang diubah suai, ia akan secara automatik
ditambah kepada debian/sumber/include-binary supaya mereka berakhir dalam tarball debian
(sama seperti dpkg-source --termasuk-perduaan --bina akan melakukan).

Membina pilihan

--allow-version-of-quilt-db=versi
Benarkan dpkg-source untuk membina pakej sumber jika versi selimut metadata
adalah yang dinyatakan, walaupun dpkg-source tidak tahu mengenainya (sejak dpkg
1.15.5.4). Secara berkesan ini mengatakan bahawa versi yang diberikan selimut metadata ialah
serasi dengan versi 2 itu dpkg-source kini menyokong. Versi daripada
yang selimut metadata disimpan dalam .pc/.version.

--termasuk-penyingkiran
Jangan abaikan fail yang dialih keluar dan masukkannya dalam tampung yang dijana secara automatik.

--sertakan-cap masa
Sertakan cap masa dalam tampung yang dijana secara automatik.

--termasuk-perduaan
Tambah semua binari yang diubah suai dalam tarball debian. Juga tambahkannya ke
debian/sumber/include-binary: ia akan ditambah secara lalai dalam binaan seterusnya
dan pilihan ini tidak diperlukan lagi.

--tiada-persediaan
Jangan cuba menyediakan pokok binaan dengan menggunakan tampalan yang nampaknya
tidak digunakan (sejak dpkg 1.14.18).

--tampalan-debian-tunggal
Penggunaan debian/patches/debian-changes bukan debian/patches/debian-changes-versi
untuk nama tampung automatik yang dijana semasa binaan (sejak dpkg 1.15.5.4).
Pilihan ini amat berguna apabila pakej dikekalkan dalam VCS dan a
set patch tidak boleh dijana dengan pasti. Sebaliknya arus berbeza dengan hulu
hendaklah disimpan dalam satu tampalan. Pilihan itu akan dimasukkan
debian/source/local-options dan akan disertai oleh a
debian/sumber/local-patch-header fail yang menerangkan bagaimana perubahan Debian boleh menjadi yang terbaik
disemak, contohnya dalam VCS yang digunakan.

--buat-kosong-orig
Buat tarball asal utama secara automatik sebagai kosong jika tiada dan jika
terdapat tambahan tarball asli (sejak dpkg 1.15.6). Pilihan ini adalah
dimaksudkan untuk digunakan apabila pakej sumber hanyalah himpunan berbilang hulu
perisian dan jika tiada perisian "utama".

--no-unapply-patch, --nyahpakai-tampalan
Secara lalai, dpkg-source secara automatik akan menyahguna tampung dalam --selepas-bina
cangkuk jika ia digunakan semasa --sebelum-membina (--nyahpakai-tampalan sejak dpkg
1.15.8, --tiada-nyahgunakan-tampalan sejak dpkg 1.16.5). Pilihan tersebut membolehkan anda
lumpuhkan atau dayakan proses tidak aplikasi tampung secara paksa. Pilihan tersebut adalah
hanya dibenarkan masuk debian/source/local-options supaya semua pakej sumber yang dihasilkan
mempunyai tingkah laku yang sama secara lalai.

--abort-on-upstream-perubahan
Proses ini gagal jika tampalan automatik telah dihasilkan (sejak dpkg 1.15.8).
Pilihan ini boleh digunakan untuk memastikan semua perubahan telah direkodkan dengan betul
berasingan selimut patch sebelum binaan pakej sumber. Pilihan ini tidak
dibenarkan masuk debian/sumber/pilihan tetapi boleh digunakan dalam debian/source/local-options.

--auto-komit
Proses ini tidak gagal jika tampalan automatik telah dihasilkan, sebaliknya ia
segera direkodkan dalam selimut siri.

Mengekstrak pilihan

--langkau-debianisasi
Melangkau pengekstrakan tarball debian di atas sumber huluan (sejak dpkg
1.15.1).

--langkau-tompok
Jangan gunakan tampalan pada akhir pengekstrakan (sejak dpkg 1.14.18).

Format: 3.0 (adat)
Disokong sejak dpkg 1.14.17. Format ini istimewa. Ia tidak mewakili sumber sebenar
format pakej tetapi boleh digunakan untuk mencipta pakej sumber dengan fail sewenang-wenangnya.

Membina pilihan

Semua hujah bukan pilihan diambil sebagai fail untuk disepadukan dalam pakej sumber yang dijana.
Ia mesti wujud dan sebaiknya berada dalam direktori semasa. Sekurang-kurangnya satu fail mestilah
diberi.

--format-sasaran=nilai
diperlukan. Mentakrifkan format sebenar pakej sumber yang dijana. Yang dihasilkan
Fail .dsc akan mengandungi nilai ini di dalamnya format medan dan bukan "3.0 (tersuai)".

Format: 3.0 (git)
Disokong sejak dpkg 1.14.17. Format ini adalah percubaan.

Pakej sumber dalam format ini terdiri daripada satu berkas repositori git .git kepada
memegang sumber pakej. Mungkin juga ada a .gitshallow semakan penyenaraian fail untuk
klon git cetek.

Mengekstrak

Bundle diklonkan sebagai repositori git ke direktori sasaran. Jika terdapat a
fail gitshallow, ia dipasang sebagai .git/cetek di dalam repositori git klon.

Ambil perhatian bahawa secara lalai repositori baharu akan mempunyai cawangan yang sama yang telah diperiksa
diperiksa dalam sumber asal. (Biasanya "tuan", tetapi boleh jadi apa sahaja.) Mana-mana
cawangan lain akan tersedia di bawah alat kawalan jauh/asal/.

Bangunan

Sebelum pergi lebih jauh, beberapa semakan dilakukan untuk memastikan bahawa kami tidak mempunyai sebarang
mengabaikan perubahan tanpa komitmen.

git-bundle(1) digunakan untuk menjana himpunan repositori git. Secara lalai, semua
cawangan dan tag dalam repositori disertakan dalam berkas.

Membina pilihan

--git-ref=ref
Membenarkan menentukan ref git untuk disertakan dalam berkas git. Penggunaan melumpuhkan lalai
tingkah laku termasuk semua cawangan dan tag. Boleh dinyatakan beberapa kali. The
ref boleh menjadi nama cawangan atau tag untuk disertakan. Ia juga mungkin sebarang parameter
yang boleh diteruskan kepada git-rev-list(1). Sebagai contoh, untuk memasukkan hanya tuan
cawangan, gunakan --git-ref=tuan. Untuk memasukkan semua tag dan cawangan, kecuali untuk
cawangan swasta, gunakan --git-ref=--semua --git-ref=^persendirian

--git-depth=nombor
Mencipta klon cetek dengan sejarah dipotong kepada bilangan yang ditentukan
semakan.

Format: 3.0 (bzr)
Disokong sejak dpkg 1.14.17. Format ini adalah percubaan. Ia menjana satu tarball
yang mengandungi repositori bzr.

Mengekstrak

Tarball dibongkar dan kemudian bzr digunakan untuk menyemak cawangan semasa.

Bangunan

Sebelum pergi lebih jauh, beberapa semakan dilakukan untuk memastikan bahawa kami tidak mempunyai sebarang
mengabaikan perubahan tanpa komitmen.

Kemudian bahagian khusus VCS direktori sumber disalin ke sementara
direktori. Sebelum direktori sementara ini dibungkus dalam tarball, pelbagai pembersihan dilakukan
dilakukan untuk menjimatkan ruang.

DIAGNOSTIK

tidak sumber format dinyatakan in debian/sumber/format
Fail debian/sumber/format hendaklah sentiasa wujud dan menunjukkan format sumber yang dikehendaki.
Untuk keserasian ke belakang, format "1.0" diandaikan apabila fail itu tidak wujud tetapi anda
tidak harus bergantung pada ini: pada satu ketika pada masa hadapan dpkg-source akan diubah suai untuk gagal
apabila fail itu tidak wujud.

Rasionalnya ialah format "1.0" bukan lagi format yang disyorkan, seperti biasa anda sepatutnya
pilih salah satu format yang lebih baharu (“3.0 (kuilt)”, “3.0 (asli)”) tetapi dpkg-source tidak akan buat
ini secara automatik untuk anda. Jika anda ingin terus menggunakan format lama, anda sepatutnya
jelas mengenainya dan letakkan "1.0". debian/sumber/format.

yang diff mengubah yang berikutan huluan fail
Apabila menggunakan format sumber "1.0" selalunya idea yang tidak baik untuk mengubah suai fail huluan secara langsung
kerana perubahan akhirnya tersembunyi dan kebanyakannya tidak didokumenkan dalam fail .diff.gz. Sebaliknya awak
harus menyimpan perubahan anda sebagai tampung dalam direktori debian dan menggunakannya pada masa bina.
Untuk mengelakkan kerumitan ini, anda juga boleh menggunakan format "3.0 (kuilt)" yang menawarkan ini
secara asli.

tidak boleh mewakili menukar kepada fail
Perubahan kepada sumber huluan biasanya disimpan dengan fail tampalan, tetapi tidak semua perubahan boleh
diwakili dengan tampalan: ia hanya boleh mengubah kandungan fail teks biasa. Jika awak
cuba gantikan fail dengan sesuatu jenis yang berbeza (contohnya menggantikan plain
fail dengan symlink atau direktori), anda akan mendapat mesej ralat ini.

baru diwujudkan kosong fail fail akan tidak be diwakili in diff
Fail kosong tidak boleh dibuat dengan fail tampalan. Oleh itu perubahan ini tidak direkodkan dalam
pakej sumber dan anda diberi amaran mengenainya.

boleh dilaksanakan mod kebenaran of fail akan tidak be diwakili in diff
Fail tampalan tidak merekodkan kebenaran fail dan oleh itu kebenaran boleh laku tidak
disimpan dalam pakej sumber. Amaran ini mengingatkan anda tentang fakta itu.

khas mod kebenaran of fail akan tidak be diwakili in diff
Fail tampalan tidak merekodkan kebenaran fail dan oleh itu kebenaran yang diubah suai tidak
disimpan dalam pakej sumber. Amaran ini mengingatkan anda tentang fakta itu.

FAIL FORMATS

debian/sumber/format
Fail ini mengandungi pada satu baris format yang harus digunakan untuk membina sumber
pakej (format yang mungkin diterangkan di atas). Tiada ruang hadapan atau belakang dibenarkan.

debian/sumber/include-binary
Fail ini mengandungi senarai fail binari (satu setiap baris) yang harus disertakan dalam fail
tarball debian. Ruang hadapan dan belakang dilucutkan. Baris bermula dengan '#' adalah
komen dan dilangkau. Baris kosong diabaikan.

debian/sumber/pilihan
Fail ini mengandungi senarai pilihan panjang yang harus ditambah secara automatik ke
set pilihan baris arahan a dpkg-source --bina or dpkg-source --format-cetak panggil.
Pilihan seperti --mampatan and --tahap mampatan sangat sesuai untuk fail ini.

Setiap pilihan hendaklah diletakkan pada baris yang berasingan. Baris dan baris kosong bermula dengan '#' adalah
diabaikan. yang terkemuka '--' harus dilucutkan dan pilihan pendek tidak dibenarkan. Pilihan
ruang dibenarkan di sekeliling '=' simbol dan petikan pilihan dibenarkan di sekitar nilai.
Berikut ialah contoh fail sedemikian:

# biarkan dpkg-source mencipta debian.tar.bz2 dengan pemampatan maksimum
mampatan = "bzip2"
tahap mampatan = 9
# gunakan debian/patches/debian-changes sebagai patch automatik
tampalan-debian tunggal
# abaikan perubahan pada konfigurasi.{sub, guess}
extend-diff-ignore = "(^|/)(config.sub|config.guess)$"

Catatan: format pilihan tidak diterima dalam fail ini, anda harus gunakan debian/sumber/format
sebaliknya.

debian/source/local-options
Betul-betul suka debian/sumber/pilihan kecuali bahawa fail tidak termasuk dalam yang dihasilkan
pakej sumber. Ia boleh berguna untuk menyimpan keutamaan yang terikat pada penyelenggara atau pada
Repositori VCS di mana pakej sumber dikekalkan.

debian/sumber/local-patch-header and debian/source/patch-header
Teks bentuk percuma yang diletakkan di atas tampung automatik yang dijana dalam format "2.0" atau
“3.0 (selimut)”. local-patch-header tidak termasuk dalam pakej sumber yang dijana manakala
tampalan kepala adalah.

debian/tampung/siri
Fail ini menyenaraikan semua patch yang perlu digunakan (dalam susunan yang diberikan) di atas
pakej sumber huluan. Ruang hadapan dan belakang dilucutkan. Garisan bermula dengan
'#' adalah ulasan dan dilangkau. Baris kosong diabaikan. Baki baris bermula dengan a
nama fail tampalan (berbanding dengan debian/patches/ direktori) sehingga aksara ruang pertama
atau hujung baris. Pilihan selimut pilihan boleh menyusuli sehingga ke akhir baris atau yang pertama
'#' didahului oleh satu atau lebih ruang (yang menandakan permulaan ulasan sehingga akhir
baris).

Gunakan dpkg-source dalam talian menggunakan perkhidmatan onworks.net