dh-make-perlp - ออนไลน์ใน Cloud

โครงการ:

ชื่อ

dh-make-perl - สร้างแพ็คเกจต้นทางเดเบียนจากโมดูล Perl

เรื่องย่อ

dh-make-perl [ทำ] {SOURCE_DIR - --cpan โมดูล|อ} ตัวเลือก...
dh-make-perl รีเฟรช {--เท่านั้น ...} [ไดเรกทอรี]
dh-make-perl ค้นหา Foo::Bar ...
dh-make-perl รีเฟรชแคช
dh-make-perl การถ่ายโอนข้อมูลการกำหนดค่า
dh-make-perl ช่วย
cpan2deb โมดูล|อ ตัวเลือก...
cpan2dsc โมดูล|อ ตัวเลือก...

DESCRIPTION

dh-ทำ-perl จะสร้างไฟล์ที่จำเป็นในการสร้างแพ็คเกจต้นทางเดเบียนจาก Perl
โมดูลหรือการกระจาย CPAN ใช้งานได้กับแพ็คเกจที่เรียบง่ายที่สุดและยังมีประโยชน์สำหรับ
เริ่มต้นใช้งานโมดูล Perl บรรจุภัณฑ์

คุณสามารถระบุโมดูลหรือชื่อการแจกจ่ายด้วย --cpan สวิตช์และ dh-ทำ-perl จะ
ดาวน์โหลดจากมิเรอร์ CPAN ให้คุณหรือคุณสามารถระบุไดเร็กทอรีที่มีอยู่แล้ว
แหล่งที่มาที่ไม่ได้บรรจุ หากไม่มี --cpan หรือไดเร็กทอรีเป็นอาร์กิวเมนต์ dh-ทำ-perl
พยายามสร้างแพ็คเกจ Perl จากข้อมูลในไดเร็กทอรีปัจจุบัน

คุณสามารถสร้างและติดตั้งแพ็คเกจไบนารีเดเบียนโดยใช้ "--build" และ "--install"
สวิตช์บรรทัดคำสั่ง

If dh-ทำ-perl เรียกว่าเป็น

cpan2deb ฟู::บาร์

มันทำตัวเหมือน

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

If dh-ทำ-perl เรียกว่าเป็น

cpan2dsc ฟู::บาร์

มันทำตัวเหมือน

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

การใช้โปรแกรมนี้ไม่ใช่ข้ออ้างสำหรับการไม่อ่านเอกสารสำหรับนักพัฒนาเดเบียน
รวมถึงนโยบาย Debian, นโยบาย Debian Perl, คู่มือบรรจุภัณฑ์เป็นต้น

คำสั่ง
ทำ
คำสั่งเริ่มต้นหากไม่มีคำสั่งให้ สร้าง debianization ตั้งแต่เริ่มต้น ล้มเหลว
มีข้อผิดพลาด if เดเบียน/ มีไดเร็กทอรีอยู่แล้ว

รีเฟรช [ไดเรกทอรี]
สำหรับการรีเฟรชแพ็คเกจ "ไดเร็กทอรี" เป็นค่าเริ่มต้นของไดเร็กทอรีการทำงานปัจจุบัน
สร้างใหม่ เดเบียน / ลิขสิทธิ์, เดเบียน / กฎ, เดเบียน/compat โดยใช้เทมเพลตปัจจุบัน
ก่อนที่จะทำการเปลี่ยนแปลงใดๆ กับไฟล์เหล่านี้ สำเนาสำรองจะถูกสร้างขึ้นด้วย .bak
วิภัตติ

สิ่งนี้มีประโยชน์เมื่อ เดเบียน / กฎ ถูกสร้างขึ้นโดยใช้เทมเพลตที่เก่ากว่าและไม่มี
การปรับแต่งมากมาย และเช่นเคย เราขอแนะนำให้คุณตรวจสอบว่า เดเบียน / กฎ
ดูมีเหตุผล

"รีเฟรช" ยังพยายามอัปเดตรายการการพึ่งพาใน เดเบียน / ควบคุม ราคาเริ่มต้นที่ META.yml. มัน
ตะขอ ผ้าห่ม(1) เป็น เดเบียน / กฎ และสร้าง เดเบียน/README.source

เมื่อทำการอัพเดท เดเบียน / ลิขสิทธิ์ dh-make-perl พยายามฉลาดในการจำอีเมล
ที่อยู่ ได้รับรายชื่อผู้ถือลิขสิทธิ์และอีเมลของพวกเขาสำหรับ เดเบียน/* ราคาเริ่มต้นที่
ป้ายปิดบรรทัดใน เดเบียน/บันทึกการเปลี่ยนแปลง. อย่างไรก็ตามเพื่อให้ที่อยู่อีเมล
การเปลี่ยนแปลงจะมองหาการเปลี่ยนแปลงของแบบฟอร์ม

* เปลี่ยนอีเมล: Debbie Devlin -> [ป้องกันอีเมล]

ดังนั้นตอนนี้ "Debbie Devlin[ป้องกันอีเมล]>" จะถูกนำไปใช้ในลิขสิทธิ์แทน
"เด็บบี้ เดฟลิน[ป้องกันอีเมล]>".

--เท่านั้น | -o ควบคุม|ลิขสิทธิ์|เอกสาร|ตัวอย่าง|กฎ
ตัวเลือกนี้อนุญาตให้อัปเดตหนึ่งไฟล์ขึ้นไปในไดเร็กทอรี debian/
เมื่อ dh-ทำ-perl ทำงานในโหมด "รีเฟรช" ชื่อไฟล์คั่นด้วยเครื่องหมายจุลภาค NS
สามารถให้ตัวเลือกได้หลายครั้ง สะสมอาร์กิวเมนต์

ค้นหา โมดูล ...
พยายามค้นหาแพ็คเกจที่มี Perl . ที่กำหนด โมดูลs.

ตัวอย่าง:

dh-make-perl ค้นหา IPC::Run3 XML::Tidy

รีเฟรชแคช
dh-ทำ-perl แยกวิเคราะห์ไฟล์เนื้อหาที่ดึงมาโดย ไฟล์ apt(1) และเก็บผลลัพธ์
ในแคช แคชจะรีเฟรชโดยอัตโนมัติหากเก่ากว่าเนื้อหาใด ๆ
ไฟล์. แต่ถ้าคุณวิ่ง ไฟล์ apt(1) ในงาน cron ตอนกลางคืนของคุณ ครั้งแรกที่คุณวิ่ง
dh-ทำ-perl ในระหว่างวัน คุณจะต้องรอให้แคชถูกสร้างขึ้นใหม่ กับ
ตัวเลือกนี้ คุณสามารถย้ายการสร้างแคชใหม่ไปยังงาน cron ได้หลังจาก "apt-file
อัปเดต".

ไม่ทำอะไรเลยหากแคชใหม่กว่าไฟล์เนื้อหา

การถ่ายโอนข้อมูลการกำหนดค่า
ทำให้การกำหนดค่าปัจจุบัน รวมถึงการตั้งค่าเริ่มต้นใดๆ ที่จะพิมพ์ไปที่
เอาต์พุตมาตรฐาน

มีประโยชน์สำหรับการเติมไฟล์ dh-make-perl.conf

ช่วย
แสดงข้อมูลการใช้งานแบบสั้น

OPTIONS
--apt-เนื้อหา-ผบ dir
ตำแหน่งของไดเร็กทอรีเนื้อหา apt-file ค่าเริ่มต้นคือ /var/cache/apt/apt-ไฟล์

--โค้ง ใด | ทั้งหมด
สิ่งนี้จะสลับระหว่างแพ็คเกจแบบขึ้นอยู่กับส่วนโค้งและแบบอิสระ ถ้า --โค้ง ไม่ใช่
ใช้ dh-ทำ-perl ใช้อัลกอริธึมที่ค่อนข้างทำงานได้ดีในการตัดสินใจเพียงอย่างเดียว

--การสำรองข้อมูล | --ไม่มีการสำรองข้อมูล
ในโหมด "รีเฟรช" สร้างข้อมูลสำรองของ เดเบียน / ลิขสิทธิ์ และ เดเบียน / กฎ ก่อน
เขียนทับพวกเขา เปิดโดยค่าเริ่มต้น

--basepkgs
ให้รายการแพ็คเกจที่คั่นด้วยเครื่องหมายจุลภาคอย่างชัดเจนเพื่อพิจารณาแพ็คเกจ "ฐาน" (เช่น
แพ็คเกจที่ควรมีอยู่ในระบบ Debian เสมอ) ตัวเลือกนี้มีค่าเริ่มต้นเป็น
"perl,perl-base" - ใช้เพื่อตรวจสอบการขึ้นต่อกันของโมดูล หากโมดูลที่จำเป็นคือ
ใน "basepkgs" จะไม่ถูกกล่าวถึงในฟิลด์ "depends:" ของ "debian/control"

หากระบุตัวเลือกนี้ จะไม่รวมแพ็คเกจเริ่มต้นที่กล่าวถึงข้างต้น
(แต่จะถูกกล่าวถึงเป็นการพึ่งพาที่ชัดเจนในแพ็คเกจผลลัพธ์) คุณสามารถของ
ระบุโมดูลของคุณเองและระบุค่าเริ่มต้นอย่างชัดเจน

โปรดทราบว่าตัวเลือกนี้ควรใช้เพียงเล็กน้อยและด้วยความระมัดระวัง เนื่องจากอาจนำไปสู่
แพ็คเกจไม่สามารถสร้างใหม่ได้เนื่องจากการพึ่งพาที่ไม่สำเร็จ

--bขึ้นอยู่กับ สร้าง-ขึ้นอยู่กับ
ระบุสตริงที่จะใช้สำหรับการพึ่งพาบิลด์ของโมดูลด้วยตนเอง (นั่นคือ
แพ็คเกจและเวอร์ชันที่ต้องติดตั้งจึงจะสำเร็จ
สร้างแพ็คเกจ) โปรดทราบว่าแพ็คเกจที่สร้างโดย dh-ทำ-perl ต้องการ
debhelper ที่จะระบุเป็นการพึ่งพาบิลด์ หมายเหตุเช่นเดียวกับ -- ขึ้นอยู่กับใช้
ที่นี่ - ใช้เมื่อจำเป็นเท่านั้น

--bdependsi สร้าง-พึ่งพา-INDEP
ระบุสตริงที่จะใช้สำหรับ build-dependencies for . ของโมดูลด้วยตนเอง
โครงสร้างที่ไม่ขึ้นกับสถาปัตยกรรม บันทึกเดียวกันกับ -- ขึ้นอยู่กับ และ --bdepends
ตัวเลือกใช้ที่นี่

โปรดทราบว่าสำหรับ --depends, --bdepends และ --bdependsi คุณยังสามารถระบุว่า
ฟิลด์ไม่ควรปรากฏในเดเบียน/กฎ (ถ้าคุณหมายความอย่างนั้นจริงๆ แน่นอน ;-) ) โดย
ให้สตริงว่างเป็นอาร์กิวเมนต์

--สร้าง
สร้างแพ็คเกจไบนารี (เช่น ไฟล์ .deb) หลังจากตั้งค่าไดเร็กทอรีแพ็คเกจ

หมายเหตุ: สิ่งนี้สร้างเฉพาะแพ็คเกจไบนารี (โดยเรียก "เดเบียนปลอม / กฎไบนารีปลอม") และ
ไม่ได้ลงนามในแพ็คเกจ มีไว้สำหรับการติดตั้งแพ็คเกจในเครื่องอย่างรวดเร็ว ไม่ใช่สำหรับ
การสร้างแพ็คเกจที่พร้อมส่งไปยังไฟล์เก็บถาวร Debian

--build-แหล่งที่มา
สร้างแพ็คเกจต้นทาง (เช่น ไฟล์ .dsc และ .debian.tar.gz) หลังจากตั้งค่า
ไดเรกทอรีแพ็คเกจขึ้น

หมายเหตุ: สิ่งนี้สร้างเฉพาะแพ็คเกจต้นทาง (โดยเรียก "dpkg-source -b") และไม่ได้ลงนาม
แพคเกจ มีไว้สำหรับการติดตั้งแพ็คเกจต้นทางอย่างรวดเร็วที่จะถูกโยน
เช่น pbuilder ไม่ใช่สำหรับสร้างแพ็คเกจต้นทางที่พร้อมสำหรับส่งไปยัง
ไฟล์เก็บถาวรเดเบียน

--ปิด อิทปุก
ระบุหมายเลขบั๊ก ITP ที่แพ็คเกจนี้ปิดด้วยตนเอง ถ้าไม่ให้ dh-ทำ-
Perl จะพยายามเชื่อมต่อกับbugs.debian.orgเพื่อดึงหมายเลขบั๊กที่เหมาะสมโดยใช้
WWW::เครื่องจักร.

--core-โอเค
อนุญาตให้สร้างโมดูล Perl หลัก โดยค่าเริ่มต้น, dh-ทำ-perl จะไม่อนุญาตให้สร้าง a
โมดูลที่จัดส่งโดยเป็นส่วนหนึ่งของไลบรารี Perl มาตรฐาน โดยระบุสิ่งนี้
ตัวเลือก dh-ทำ-perl จะสร้างพวกเขาต่อไป

โปรดทราบว่าแม้ว่าจะไม่น่าจะเป็นไปได้ แต่สิ่งนี้อาจทำให้รายการที่ไม่เกี่ยวข้องในของคุณ
ระบบ - หากโมดูลหลักเวอร์ชันใหม่กว่าทำลาย API ภูตทุกชนิด
อาจจะอารมณ์เสีย ;-)

--cpan โมดูล|อ
แนะ dh-ทำ-perl เพื่อดึงและแยกโมดูล CPAN ที่กำหนดหรือการแจกจ่าย
ใช้ได้ทั้งกับ "Foo::Bar" และ "Foo-Bar"

--cpan-กระจก กระจก
ระบุไซต์ CPAN เพื่อใช้เป็นมิเรอร์

--data-dir DIRECTORY
ใช้ไดเร็กทอรีข้อมูลอื่นแทนค่าเริ่มต้น "/usr/share/dh-make-perl"

ไดเร็กทอรีข้อมูลคือ dh-ทำ-perl ค้นหากฎเริ่มต้น * เทมเพลต มันคือ
คล้ายกับ --บ้าน-ผบแต่ไม่เปลี่ยนตำแหน่งของแคชเนื้อหา APT
ไฟล์. ถ้าให้ทั้งสองอย่าง --บ้าน-ผบ มีความสำคัญ

--พึ่งพา พึ่งพา
ระบุสตริงที่จะใช้สำหรับการขึ้นต่อกันของโมดูลด้วยตนเอง นี้ควรจะ
ใช้เมื่อสร้างโมดูลโดยที่ dh-ทำ-perl ไม่สามารถเดาการพึ่งพา Perl ได้ (เช่น
เป็นโมดูลที่สร้างขึ้นโดยใช้ Module::Install) หรือเมื่อรหัส Perl ขึ้นอยู่กับไม่ใช่ Perl
ไบนารีหรือไลบรารี โดยปกติ, dh-ทำ-perl จะคิดหาการพึ่งพาโดย
ตัวเอง. ถ้าต้องผ่าน dh-ทำ-perl ข้อมูลการพึ่งพา คุณต้องทำโดยใช้
รูปแบบแพ็คเกจเดเบียน เช่น

dh-make-perl -- ขึ้นอยู่กับ libtest-more-perl

--รายละเอียด สั้น DESCRIPTION
ใช้อาร์กิวเมนต์เพื่อ --desc เป็นคำอธิบายสั้น ๆ สำหรับแพ็คเกจ

--ธ VERSION
ตั้งค่าระดับความเข้ากันได้ของ debhelper ที่ต้องการ ค่าเริ่มต้นคือ 8 สำหรับสถาปัตยกรรม-
แพ็คเกจอิสระ และ 9 สำหรับแพ็คเกจขึ้นอยู่กับสถาปัตยกรรม (XS)

ตั้งแต่เวอร์ชั่น 0.77 dh-ทำ-perl รองรับเฉพาะระดับความเข้ากันได้ของ debhelper > = 8.

ดู debhelper(1)

--ดิสท การแพร่กระจาย
จำกัดการแจกแจงที่มีไฟล์ "เนื้อหา" แยกวิเคราะห์ อาร์กิวเมนต์คือ a
ชื่อการแจกจ่าย

ค่าเริ่มต้น: ว่างเปล่า หมายถึงไม่มีการกรอง

ตัวอย่าง:
dh-make-perl --dist จำหลัก

--อีเมล | -e EMAIL
ระบุที่อยู่อีเมลของผู้ดูแลด้วยตนเองเพื่อใช้ในเดเบียน/ควบคุมและใน
เดเบียน/บันทึกการเปลี่ยนแปลง

--ไม่รวม | -i [REGEX]
สิ่งนี้ทำให้คุณสามารถระบุ PCRE เพื่อแยกไฟล์บางไฟล์ออกจากการค้นหาเอกสารและ
อะไรแบบนั้น หากไม่มีการระบุอาร์กิวเมนต์ (แต่ระบุสวิตช์ - ไม่ได้ระบุ
สวิตช์จะรวมทุกอย่าง) โดยค่าเริ่มต้นเป็นค่าเริ่มต้นของ dpkg-source

--ติดตั้ง
ติดตั้งแพ็คเกจที่สร้างขึ้นใหม่ การระบุ --install หมายถึง --build - แพ็คเกจ
จะไม่ถูกติดตั้งเว้นแต่จะถูกสร้างขึ้น (ชัดเจน ;-) )

--ล่วงล้ำ
เมื่อพิจารณาการขึ้นต่อกันของโมดูล หาก Module::Depends ล้มเหลว ให้ลองอีกครั้งด้วย
โมดูล::ขึ้นอยู่กับ::ล่วงล้ำ M:D:ฉันโหลดไฟล์ .pm ทั้งหมด ขัดขวางการโหลดไฟล์อื่นๆ
โมดูล เรียกใช้โค้ดที่ไม่น่าเชื่อถือในนามของคุณอย่างมีประสิทธิภาพ ใช้ด้วยความระมัดระวัง

--เครือข่าย
เปิดใช้งานการสืบค้นรายการ Debian WNPP สำหรับ ITP และจุดบกพร่องที่คล้ายกัน เปิดใช้งานโดยค่าเริ่มต้น
ใช้ "--no-network" เพื่อปิดการใช้งาน

--notes
ตัวเลือกนี้สำหรับการไม่เรียกใช้การทดสอบอัตโนมัติของโมดูลโดยเป็นส่วนหนึ่งของ build
สคริปต์ถูกลบใน 0.54 กรุณาใส่ nocheck ใน DEB_BUILD_OPTIONS
ตัวแปรสภาพแวดล้อม หากคุณต้องการข้ามการทดสอบเมื่อสร้างแพ็คเกจ

--บ้าน-ผบ DIRECTORY
ตำแหน่งที่จัดเก็บเนื้อหา APT และแคชอื่นๆ

ค่าเริ่มต้น: ~/.dh-make-perl

--ชื่อแพ็คเกจ | -p ชื่อแพ็คเกจ
ระบุชื่อแพ็คเกจด้วยตนเอง ซึ่งมีประโยชน์เมื่อโมดูลมีเครื่องหมายขีดกลางในชื่อ

--pkg-perl
มีประโยชน์ในการเตรียมแพ็คเกจสำหรับ Debian Perl Group
<http://pkg-perl.alioth.debian.org>.

ตั้งค่าฟิลด์ "ผู้ดูแล", "ผู้อัปโหลด", "Vcs-Git" และ "Vcs-Browser" ใน เดเบียน / ควบคุม
ตามนั้น นอกจากนี้ เมื่อใช้ "--vcs git" (ค่าเริ่มต้น) ให้ตั้งค่า Git remote
ชี้ไปถูกที่บน git.debian.org.

- บันทึกซ้ำ
ใช้ได้เฉพาะในโหมด "สร้าง" ด้วย "--cpan" หรือ ไดเรกทอรี อาร์กิวเมนต์ ทำให้เกิด dh-make-perl ถึง
พยายามสร้างบรรจุภัณฑ์ (และอาจสร้างและติดตั้งแพ็คเกจหาก "--build" และ
นอกจากนี้ยังมีตัวเลือก "--install") สำหรับการพึ่งพาใด ๆ ที่ไม่มีแพ็คเกจ

ใช้งานได้ดังนี้: เมื่อสร้างแพ็คเกจ 'หลัก' แพ็คเกจใด ๆ ที่ขาดหายไปคือ
ใส่ในรายการแล้วเรียกใช้ขั้นตอน debianisaion ในแต่ละขั้นตอน
เรียกซ้ำ

--requiredps
ล้มเหลวหากไม่พบแพ็คเกจ Perl การพึ่งพา (การติดตามการพึ่งพาต้องใช้ apt-
แพ็คเกจไฟล์ที่ติดตั้งและอัปเดต)

--แหล่งที่มารูปแบบ รูป
เมื่อสร้างหรือรีเฟรชบรรจุภัณฑ์ ให้ใช้รูปแบบต้นทางที่ระบุ ค่าเริ่มต้นเป็น
"3.0 (ผ้าห่ม)".

--รายการแหล่งที่มา ไฟล์
สั่งให้ตัวแยกวิเคราะห์ไฟล์ "เนื้อหา" ใช้สิ่งนี้ ไฟล์ เมื่อกำหนดว่าไฟล์ที่กำหนด
ควรแยกวิเคราะห์หรือไม่ ไฟล์เนื้อหาไม่ตรงกับบรรทัดใดใน sources.list ไม่ได้
แยกวิเคราะห์เพื่อช่วยคุณประหยัดเวลาในการแยกวิเคราะห์ไฟล์เก่าจากมิเรอร์ที่คุณไม่ได้ใช้อีกต่อไป

ค่าเริ่มต้น: ค่าเริ่มต้นของ apt

--vcs VCS
In --pkg-perl โหมดใช้ระบบควบคุมเวอร์ชันที่ระบุในไฟล์ที่สร้างขึ้น VCS-*
ฟิลด์ ค่าเริ่มต้นคือ "git"

If VCS คือ "git", "dh-make-perl" จะตั้งค่าที่เก็บ Git ที่มีสามสาขา:

ต้นน้ำลำธาร
สาขาเริ่มต้นที่มีต้นน้ำต้นทาง

เจ้านาย
สาขาที่บรรจุเสร็จแล้วแยกออก "ต้นน้ำ" และมีเนื้อหาของ
เพิ่มไดเร็กทอรี "debian/"

เก่าแก่-tar
สาขาที่จะเก็บไว้ เก่าแก่-tar(1) ข้อมูล

If --pkg-perl ยังได้รับรีโมท "ต้นทาง" ที่ชี้ไปที่ที่เก็บ on
git.debian.org.

--รายละเอียด | --ไม่มีรายละเอียด
พิมพ์ข้อมูลเพิ่มเติมขณะดำเนินการ

--verbose เปิดใช้งานโดยค่าเริ่มต้นในโหมด "สร้าง" มิฉะนั้นจะปิด

--รุ่น VERSION
ระบุเวอร์ชันของแพ็กเกจผลลัพธ์

ใช้ dh-make-perlp ออนไลน์โดยใช้บริการ onworks.net