cpan2dscp - Dalam talian dalam Awan

JADUAL:

NAMA

dh-make-perl - Cipta pakej sumber debian daripada modul Perl

SINOPSIS

dh-make-perl [buat] {SOURCE_DIR | --cpan MODULE|JAUH} pilihan ...
dh-make-perl refresh {--sahaja ...} [direktori]
dh-make-perl cari Foo::Bar ...
dh-make-perl refresh-cache
dh-make-perl dump-config
bantuan dh-make-perl
cpan2deb MODULE|JAUH pilihan ...
cpan2dsc MODULE|JAUH pilihan ...

DESCRIPTION

dh-make-perl akan mencipta fail yang diperlukan untuk membina pakej sumber debian daripada Perl
modul atau pengedaran CPAN. Ini berfungsi untuk kebanyakan pakej mudah dan juga berguna untuk
bermula dengan pembungkusan modul Perl.

Anda boleh menentukan modul atau nama pengedaran dengan suis --cpan dan dh-make-perl akan
muat turun untuk anda dari cermin CPAN, atau anda boleh menentukan direktori dengan sudah
sumber yang dibongkar. Jika --cpan mahupun direktori tidak diberikan sebagai hujah, dh-make-perl
cuba mencipta pakej Perl daripada data dalam direktori semasa.

Anda boleh membina dan memasang pakej binari debian menggunakan "--build" dan "--install"
suis baris arahan.

If dh-make-perl dipanggil sebagai

cpan2deb Foo::Bar

ia berkelakuan seperti

dh-make-perl buat --build --cpan Foo::Bar

If dh-make-perl dipanggil sebagai

cpan2dsc Foo::Bar

ia berkelakuan seperti

dh-make-perl buat --build-source --cpan Foo::Bar

Menggunakan program ini bukan alasan untuk tidak membaca dokumentasi pembangun debian,
termasuk dasar Debian, dasar Debian Perl, manual pembungkusan dan sebagainya.

PERINTAH
membuat
Perintah lalai jika tiada arahan diberikan. Mencipta debianisasi dari awal. gagal
dengan ralat jika debian/ direktori sudah wujud.

muat semula [direktori]
Untuk menyegarkan pakej. "direktori" lalai kepada direktori kerja semasa.
Membina semula debian/hak cipta, debian/peraturan, debian/compat menggunakan templat semasa.
Sebelum sebarang perubahan dibuat pada fail ini, salinan sandaran dibuat dengan .bak
akhiran.

Ini berguna apabila debian/peraturan telah dibuat menggunakan templat lama dan tidak mengandungi
banyak penyesuaian. Seperti biasa, anda amat digalakkan untuk mengesahkan sama ada debian/peraturan
nampak waras.

"refresh" juga cuba mengemas kini senarai pergantungan dalam debian / kawalan dari META.yml. ia
cangkuk selimut(1) menjadi debian/peraturan dan mencipta debian/README.source

Apabila mengemas kini debian/hak cipta dh-make-perl cuba pandai mengingati e-mel
alamat. Ia mendapat senarai pemegang hak cipta dan e-mel mereka untuk debian/* dari
tanda keluar talian masuk debian/changelog. Walau bagaimanapun untuk membenarkan alamat e-mel
berubah, ia mencari baris perubahan bentuk

* Perubahan e-mel: Debbie Devlin -> [e-mel dilindungi]

Jadi sekarang "Debbie Devlin[e-mel dilindungi]>" akan digunakan dalam hak cipta dan bukannya
"Debbie Devlin[e-mel dilindungi]>".

--sahaja | -o kawalan|hak cipta|dokumen|contoh|peraturan
Pilihan ini membenarkan seseorang mengemas kini hanya satu atau lebih fail dalam direktori debian/
apabila dh-make-perl dijalankan dalam mod "refresh". Nama fail dipisahkan dengan koma. The
pilihan boleh diberikan beberapa kali, mengumpul hujah.

Cari MODULE ...
Cuba untuk mencari pakej yang mengandungi Perl yang diberikan MODULEs.

Contoh:

dh-make-perl cari IPC::Run3 XML::Tidy

refresh-cache
dh-make-perl menghuraikan fail Kandungan, diambil oleh apt-fail(1) dan menyimpan hasilnya
dalam cache. Cache dimuat semula secara automatik jika ia lebih lama daripada mana-mana Kandungan
fail. Namun, jika anda berlari apt-fail(1) dalam kerja cron setiap malam anda, kali pertama anda berlari
dh-make-perl pada siang hari, anda hendaklah menunggu sehingga cache dibina semula. Dengan
pilihan ini, anda boleh mengalihkan penciptaan semula cache ke tugas cron, sejurus selepas "apt-file
kemas kini".

Tidak melakukan apa-apa jika cache lebih baharu daripada fail Kandungan.

dump-config
Menyebabkan konfigurasi semasa, termasuk sebarang tetapan lalai dicetak ke
keluaran standard.

Berguna untuk mengisi fail dh-make-perl.conf.

membantu
Memaparkan maklumat penggunaan pendek.

PILIHAN
--apt-contents-dir dir
Lokasi direktori Kandungan apt-file. Lalai ialah /var/cache/apt/apt-file

--lengkungan mana-mana | semua
Ini bertukar antara pakej yang bergantung kepada gerbang dan tidak bebas. Jika --lengkungan tidak
terpakai, dh-make-perl menggunakan algoritma yang agak berkesan untuk memutuskan perkara ini sahaja.

--sandaran | --tiada-sandaran
Dalam mod "refresh", buat sandaran debian/hak cipta and debian/peraturan sebelum
menimpa mereka. Hidup secara lalai.

--basekgs
Secara eksplisit memberikan senarai pakej yang dipisahkan koma untuk mempertimbangkan pakej "asas" (cth
pakej yang sepatutnya sentiasa tersedia dalam sistem Debian). Pilihan ini lalai kepada
"perl,perl-base" - ia digunakan untuk menyemak kebergantungan modul. Jika modul yang diperlukan adalah
dalam "basekgs", ia tidak akan disebut dalam medan "depends:" "debian/control".

Jika pilihan ini ditentukan, pakej lalai yang disebutkan di atas tidak akan disertakan
(tetapi akan disebut sebagai kebergantungan eksplisit dalam pakej yang terhasil). Anda boleh, daripada
tentu saja, sebutkan modul anda sendiri dan nyatakan nilai lalai secara eksplisit.

Ambil perhatian bahawa pilihan ini harus digunakan secara jarang dan berhati-hati, kerana ia mungkin membawa kepada
pakej tidak boleh dibina semula kerana kebergantungan yang tidak dipenuhi.

--bbergantung BINA-BERGANTUNG
Tentukan rentetan secara manual untuk digunakan untuk kebergantungan binaan modul (iaitu,
pakej dan versi mereka yang perlu dipasang untuk berjaya
membina pakej). Perlu diingat bahawa pakej yang dihasilkan oleh dh-make-perl memerlukan
debhelper untuk ditentukan sebagai kebergantungan binaan. Nota yang sama seperti untuk --depends terpakai
di sini - gunakan hanya apabila diperlukan.

--bdependsi BINA-BERGANTUNG-INDEP
Tentukan rentetan secara manual untuk digunakan untuk kebergantungan binaan modul
binaan bebas seni bina. Nota yang sama seperti nota untuk --depends dan --bdepends
pilihan terpakai di sini.

Ambil perhatian bahawa untuk --depends, --bdepends dan --bdependsi anda juga boleh menentukan bahawa
medan tidak sepatutnya muncul dalam debian/peraturan (jika anda benar-benar maksudkannya, sudah tentu ;-) ) oleh
memberikannya rentetan kosong sebagai hujah.

--bina
Membina pakej binari (iaitu fail .deb) selepas menetapkan direktori pakej.

NB: Ini hanya membina pakej binari (dengan memanggil "fakeroot debian/rules binary") dan
tidak menandatangani pakej. Ia bertujuan untuk pemasangan tempatan yang pantas bagi sesuatu pakej, bukan untuk
mencipta pakej sedia untuk diserahkan ke arkib Debian.

--bina-sumber
Membina pakej sumber (iaitu fail .dsc dan .debian.tar.gz) selepas menetapkan
direktori pakej naik.

NB: Ini hanya membina pakej sumber (dengan memanggil "dpkg-source -b") dan tidak menandatangani
bungkusan itu. Ia bertujuan untuk pemasangan tempatan pantas pakej sumber untuk dibuang
ke dalam contohnya pbuilder, bukan untuk mencipta pakej sumber yang sedia untuk diserahkan kepada
Arkib Debian.

--tutup ITPBUG
Tentukan secara manual nombor pepijat ITP yang ditutup oleh pakej ini. Jika tidak diberi, dh-buat-
perl akan cuba menyambung ke bugs.debian.org untuk mendapatkan nombor pepijat yang sesuai, menggunakan
WWW:: Mekanisasi.

--teras-ok
Membenarkan membina modul teras Perl. Secara lalai, dh-make-perl tidak akan membenarkan bangunan a
modul yang dihantar sebagai sebahagian daripada perpustakaan Perl standard; dengan menyatakan ini
pilihan, dh-make-perl akan membina mereka pula.

Ambil perhatian bahawa, walaupun tidak berkemungkinan, ini mungkin memecahkan item yang tidak berkaitan dalam anda
sistem - jika versi modul teras yang lebih baharu memecahkan API, semua jenis daemon
mungkin marah ;-)

--cpan MODULE|JAUH
Mengarahkan dh-make-perl untuk mengambil dan mengekstrak modul atau pengedaran CPAN yang diberikan.
Berfungsi kedua-duanya dengan "Foo::Bar" dan "Foo-Bar".

--cpan-cermin MIRROR
Menentukan tapak CPAN untuk digunakan sebagai cermin.

--data-dir DIREKTORI
Gunakan direktori data lain, bukannya lalai, "/usr/share/dh-make-perl"

Direktori data ialah was dh-make-perl mencari peraturan lalainya.* templat. Ia adalah
sama dengan --home-dir, tetapi tidak mengubah lokasi cache Kandungan APT
fail. Jika kedua-duanya diberikan, --home-dir diutamakan.

--bergantung BERGANTUNG
Tentukan rentetan secara manual untuk digunakan untuk kebergantungan modul. Ini sepatutnya
digunakan semasa membina modul di mana dh-make-perl tidak dapat meneka kebergantungan Perl (seperti
sebagai modul yang dibina menggunakan Module::Install), atau apabila kod Perl bergantung pada bukan Perl
binari atau perpustakaan. Biasanya, dh-make-perl akan mengetahui kebergantungan oleh
sendiri. Jika anda perlu lulus dh-make-perl maklumat pergantungan, anda mesti melakukannya menggunakan
format pakej debian. iaitu

dh-make-perl --depends libtest-more-perl

--desc PENDEK DESCRIPTION
Menggunakan hujah untuk --desc sebagai penerangan ringkas untuk pakej.

--dh VERSION
Tetapkan tahap keserasian debhelper yang diingini. Lalai ialah 8 untuk seni bina-
pakej bebas, dan 9 untuk pakej bergantung kepada seni bina (XS).

Sejak versi 0.77, dh-make-perl hanya menyokong tahap keserasian debhelper > = 8.

Lihat debhelper(1).

--dist PENGAGIHAN
Hadkan pengedaran yang fail "Kandungan" dihuraikan. Hujahnya ialah a
nama pengedaran.

Lalai: kosong, bermakna tiada penapisan.

Contoh:
dh-make-perl --dist etch

--e-mel | -e EMAIL
Tentukan alamat e-mel Maintainer secara manual untuk digunakan dalam debian/kawalan dan masuk
debian/changelog.

--kecualikan | -i [Regex]
Ini membolehkan anda menentukan PCRE untuk mengecualikan beberapa fail daripada carian untuk dokumen dan
barangan seperti itu. Jika tiada hujah diberikan (tetapi suis ditentukan - tidak menyatakan
suis akan memasukkan segala-galanya), ia lalai kepada nilai lalai dpkg-source.

--pasang
Memasang pakej yang baru dibina. Menentukan --install membayangkan --build - Pakej
tidak akan dipasang melainkan ia dibina (jelas ;-) )

--mengganggu
Apabila menentukan kebergantungan modul, jika Modul::Depends gagal, cuba lagi dengan
Modul::Bergantung::Mengganggu. M:D:Saya memuatkan semua fail .pm, memintas memuatkan fail lain
modul, menjalankan kod yang tidak dipercayai dengan berkesan bagi pihak anda. Gunakan dengan berhati-hati.

--rangkaian
Mendayakan pertanyaan senarai WNPP Debian untuk ITP dan pepijat yang serupa. Didayakan secara lalai,
gunakan "--no-network" untuk melumpuhkan.

--nota
Pilihan ini untuk tidak menjalankan ujian automatik modul sebagai sebahagian daripada binaan
skrip telah dialih keluar dalam 0.54. Sila letakkan nocheck dalam DEB_BUILD_OPTIONS
pembolehubah persekitaran jika anda ingin melangkau ujian semasa membina pakej.

--home-dir DIREKTORI
Di mana Kandungan APT dan cache lain disimpan.

default: ~/.dh-make-perl

--nama pakej | -p NAMA PAKEJ
Tentukan Nama Pakej secara manual, berguna apabila modul mempunyai sempang dalam namanya.

--pkg-perl
Berguna semasa menyediakan pakej untuk Kumpulan Perl Debian
<http://pkg-perl.alioth.debian.org>.

Tetapkan medan "Maintainer", "Pemuat naik", "Vcs-Git" dan "Vcs-Browser" dalam debian / kawalan
sewajarnya. Selain itu, apabila "--vcs git" digunakan (lalai), sediakan alat kawalan jauh Git
menunjuk ke tempat yang betul pada git.debian.org.

- berulang
Sah hanya dalam mod "buat" dengan "--cpan" atau direktori hujah. Menyebabkan dh-make-perl kepada
cuba buat pembungkusan (dan mungkin bina dan pasang pakej jika "--build" dan
Pilihan "--install" juga diberikan) untuk sebarang kebergantungan yang tiada pakej.

Ini berfungsi seperti ini: apabila pakej 'utama' dibina, mana-mana pakej yang hilang adalah
dimasukkan ke dalam senarai, dan kemudian prosedur debianisasi dijalankan secara bergilir-gilir pada setiap daripada mereka,
secara berulang.

--diperlukan
Gagal jika pakej Perl pergantungan tidak dijumpai (penjejakan pergantungan memerlukan apt-
pakej fail dipasang dan dikemas kini)

--format-sumber format
Apabila membuat atau menyegarkan pembungkusan, gunakan format sumber yang ditentukan. Lalai kepada
"3.0 (selimut)".

--senarai-sumber FAIL
Arahkan penghurai fail "Kandungan" untuk menggunakan ini fail apabila menentukan sama ada fail yang diberikan
perlu dihuraikan atau tidak. Fail kandungan tidak sepadan dengan mana-mana baris dalam sources.list tidak
dihuraikan untuk menjimatkan masa anda menghuraikan fail lama daripada cermin yang tidak anda gunakan lagi.

Lalai: lalai apt.

--vcs VCS
In --pkg-perl mod, gunakan sistem kawalan versi yang ditentukan dalam yang dihasilkan Vcs-*
padang. Lalai ialah "git".

If VCS ialah "git", "dh-make-perl" akan menyediakan repositori Git dengan tiga cawangan:

huluan
Cawangan awal yang mengandungi sumber huluan

master
Cawangan tempat pembungkusan dilakukan, bercabang "hulu" dan dengan kandungan
direktori "debian/" ditambah.

murni-tar
Cawangan untuk disimpan murni-tar(1) data.

If --pkg-perl juga diberikan, alat kawalan jauh "asal" ditambah menunjuk ke repositori dihidupkan
git.debian.org.

--verbose | --tidak bertele-tele
Cetak maklumat tambahan semasa memproses.

--verbose dihidupkan secara lalai dalam mod "buat", dimatikan jika tidak.

--versi VERSION
Menentukan versi pakej yang terhasil.

Gunakan cpan2dscp dalam talian menggunakan perkhidmatan onworks.net