นี่คือคำสั่ง gbp-dch ที่สามารถเรียกใช้ในผู้ให้บริการโฮสติ้งฟรีของ OnWorks โดยใช้หนึ่งในเวิร์กสเตชันออนไลน์ฟรีของเรา เช่น Ubuntu Online, Fedora Online, โปรแกรมจำลองออนไลน์ของ Windows หรือโปรแกรมจำลองออนไลน์ของ MAC OS
โครงการ:
ชื่อ
gbp-dch - สร้าง Debian changelog จาก git commit message
เรื่องย่อ
GBP ดีช [ --รุ่น ] [ --ช่วยด้วย ] [ --รายละเอียด ] [ --สี=[อัตโนมัติ|เปิด|ปิด] ] [ --สี-
แบบแผน=สี_SCHEME ] [ --debian-สาขา=ชื่อสาขา ] [ --debian-แท็ก=รูปแบบแท็ก ] [
--ต้นน้ำสาขา=ชื่อสาขา ] [ --upstream-แท็ก=รูปแบบแท็ก ] [ --ignore-สาขา ] [
--ภาพรวม | --ปล่อย ] [ --อัตโนมัติ | --ตั้งแต่=มุ่งมั่น ] [ --รุ่นใหม่=รุ่น ] [ --bpo
| --Nmu | --qa | --ทีม ] [ --การกระจาย=ชื่อ ] [ --แรง-การกระจาย ] [
--เร่งด่วน=ระดับ ] [ --[ไม่-]เต็ม ] [ --[ไม่-]เมตา ] [ --meta-closes=bug-close-แท็ก ] [
--meta-closes-bugnum=bug-number-format ] [ --snapshot-number=การแสดงออก ] [ --NS-
ความยาว=จำนวน ] [ --git-log=git-log-ตัวเลือก ] [ --[no-]git-ผู้เขียน ] [ --[ไม่-]มัลติเมน ]
[ --[ไม่-]มัลติแมต-ผสาน ] [ --spawn-editor=[เสมอ|สแนปชอต|ปล่อย] ] [ --ให้สัญญา-
ข้อความ=msg-รูปแบบ ] [ --ให้สัญญา ] [ --การปรับแต่ง=ปรับแต่งไฟล์ ] [เส้นทาง1 เส้นทาง2]
DESCRIPTION
GBP ดีช อ่านข้อความคอมมิต git และสร้างบันทึกการเปลี่ยนแปลงเดเบียนจากมัน ถ้าไม่
อาร์กิวเมนต์จะได้รับ GBP ดีช เริ่มจากเวอร์ชันแพ็คเกจ Debian ที่ติดแท็กล่าสุดจนถึง
เคล็ดลับปัจจุบันของสาขาปัจจุบัน ถ้าการกระจายของส่วนบนสุดใน
เดเบียน/บันทึกการเปลี่ยนแปลง is อาคิโอะ, รายการบันทึกการเปลี่ยนแปลงจะถูกแทรกลงในส่วนนี้
มิฉะนั้น ส่วนใหม่จะถูกสร้างขึ้น
If --อัตโนมัติ ได้รับ GBP ดีชพยายามเดา Git คอมมิทล่าสุดที่บันทึกไว้ในบันทึกการเปลี่ยนแปลง
- ใช้งานได้ในโหมดสแนปชอตเท่านั้น มิฉะนั้น, --ตั้งแต่ ใช้บอกได้ GBP ดีช at
จุดที่มันควรเริ่มต้นในประวัติ Git
สามารถใช้อาร์กิวเมนต์พาธเพิ่มเติมเพื่อจำกัดพาธที่เก็บได้ GBP ดีช รูปลักษณ์
ที่. การตั้งค่า เส้นทาง ไปยัง เดเบียน/ เป็นตัวเลือกที่ดีหากอัปสตรีมใช้ Git และบรรจุภัณฑ์เดเบียนทั้งหมด
การเปลี่ยนแปลงจะถูกจำกัดให้ เดเบียน/ ตำบล ในกรณีที่ซับซ้อนมากขึ้น (เช่น
backport) คุณสามารถใช้ --git-บันทึก เพื่อจำกัดรายการบันทึกการเปลี่ยนแปลงที่สร้างขึ้นเพิ่มเติม
เช่น โดยใช้ --git-log="--ผู้เขียน=Foo บาร์".
OPTIONS
--รุ่น
เวอร์ชันพิมพ์ของโปรแกรม เช่น เวอร์ชันของ git-buildpackage suite
-v
--รายละเอียด
การดำเนินการอย่างละเอียด
-h
--ช่วยด้วย พิมพ์วิธีใช้และออก
--สี=[อัตโนมัติ|เปิด|ปิด]
ไม่ว่าจะใช้เอาต์พุตสี
--ชุดสี=สี_SCHEME
สีที่จะใช้ในการส่งออก (เมื่อเปิดใช้งานสี) รูปแบบของ COLOR_SCHEME คือ
' : : : '. ยอมรับค่าตัวเลขและชื่อสี
ฟิลด์ว่างหมายถึงสีเริ่มต้น ตัวอย่างเช่น, --git-สีแบบแผน='ฟ้า:34::'
จะแสดงข้อความแก้ไขข้อบกพร่องเป็นสีฟ้า ข้อความข้อมูลเป็นสีน้ำเงินและข้อความอื่นๆ ใน
ค่าเริ่มต้น (เช่น คำเตือนและข้อความแสดงข้อผิดพลาดเป็นสีแดง)
--debian-สาขา=ชื่อสาขา
สาขาในที่เก็บ Git ที่แพ็คเกจ Debian กำลังได้รับการพัฒนาโดยค่าเริ่มต้น
is เจ้านาย.
--ต้นน้ำสาขา=ชื่อสาขา
แบรนช์เพื่อกำหนดเวอร์ชันต้นน้ำจาก ค่าเริ่มต้นคือ ต้นน้ำลำธาร.
--git-upstream-tag=รูปแบบแท็ก
ใช้รูปแบบแท็กนี้เมื่อค้นหาแท็กของเวอร์ชันอัปสตรีม ค่าเริ่มต้นคือ
ต้นน้ำ/%(รุ่น)s.
--ignore-สาขา
อย่าตรวจสอบว่าสาขาปัจจุบันตรงกันหรือไม่ เดเบียนสาขา.
--debian-แท็ก=รูปแบบแท็ก
รูปแบบแท็กที่ใช้ เมื่อติดแท็กเวอร์ชันเดเบียน ค่าเริ่มต้นคือ เดเบียน/%(รุ่น)s
--ตั้งแต่=มุ่งมั่น
เริ่มอ่านข้อความยืนยันที่ มุ่งมั่น.
--อัตโนมัติ, -a
เดาการคอมมิตล่าสุดที่บันทึกไว้ในบันทึกการเปลี่ยนแปลงจากแบนเนอร์สแน็ปช็อต (หรือจาก
แท็กสุดท้ายหากไม่มีแบนเนอร์สแนปชอต)
--[ไม่-]เมตา
แยกวิเคราะห์เมตาแท็กเช่น ปิด:, ขอขอบคุณ: และ Gbp-Dch:. ดูเมตาแท็กด้านล่าง
--meta-ปิด=ปิดแท็กข้อผิดพลาด
เมตาแท็กใดที่จะมองหาเพื่อสร้างรายการบันทึกการเปลี่ยนแปลงที่ปิดจุดบกพร่อง ค่าเริ่มต้น
คือ 'ปิด|LP' เพื่อรองรับ Debian และ Launchpad
--meta-ปิด-bugnum=รูปแบบหมายเลขข้อผิดพลาด
ควรใช้นิพจน์ทั่วไปใดในการแยกวิเคราะห์หมายเลขจุดบกพร่อง ค่าเริ่มต้นคือ
'(?:bug|issue)?\#?\s?\d+'. หมายเหตุ: regex ควรระงับทุกส่วนของจุดบกพร่อง
หมายเลขที่ไม่ต้องการโดยใช้ "(?:)" โปรดดูรายละเอียดในคู่มือ Python regex
ตัวอย่าง: --meta-ปิด-bugnum="(?:bug)?\s*ex-\d+" จะจับคู่สิ่งต่อไปนี้ทั้งหมด:
การจับคู่ Txt ที่เป็นไปได้? ผลลัพธ์
------ ------ ------
ข้อผิดพลาด EX-12345 Y EX-12345
อดีต-01273 และอดีต-01273
ข้อผิดพลาด ex-1ab Y ex-1
EX--12345 ไม่มี
--[ไม่-]เต็ม
รวมข้อความยืนยันแบบเต็มในเอาต์พุตบันทึกการเปลี่ยนแปลง
--ภาพรวม -S
สร้างรายการปล่อยสแน็ปช็อต ซึ่งจะเพิ่มหมายเลขเผยแพร่สแนปชอตและคำเตือน
แบนเนอร์ไปยังรายการบันทึกการเปลี่ยนแปลง กำลังเพิ่มหมายเลขเวอร์ชันเผยแพร่โดยอัตโนมัติ
กับการเปิดตัวสแน็ปช็อตใหม่ทุกครั้งเพื่อหลีกเลี่ยงการดาวน์เกรดแพ็คเกจระหว่างสแนปชอต
การทดสอบ
--snapshot-number=การแสดงออก
นิพจน์ Python ที่ได้รับ eval()ed เป็นหมายเลขสแน็ปช็อตใหม่
--ปล่อย, -R
ลบแบนเนอร์เผยแพร่สแน็ปช็อตและส่วนต่อท้ายเวอร์ชัน ตั้งค่าปัจจุบัน
แจกจ่ายไปยัง ไม่แน่นอนและเปิดบันทึกการเปลี่ยนแปลงเพื่อปรับแต่งขั้นสุดท้าย
--รุ่นใหม่=รุ่น, -N รุ่น
เพิ่มส่วนการเปลี่ยนแปลงใหม่ด้วย version เวอร์ชั่นใหม่. ร่วมกับ --ภาพรวมที่
หมายเลขสแนปชอตจะถูกผนวกเข้ากับ เวอร์ชั่นใหม่.
--ทีม สร้างรายการบันทึกการเปลี่ยนแปลงการอัปโหลดของทีม
--bpo เพิ่มหมายเลขรีลีส Debian สำหรับการอัปโหลดไปยัง backport และเพิ่ม backport
อัปโหลดความคิดเห็นบันทึกการเปลี่ยนแปลง
--Nmu เพิ่มหมายเลขรีลีส Debian สำหรับการอัปโหลดที่ไม่ใช่ผู้ดูแล
--qa เพิ่มหมายเลขรีลีส Debian สำหรับการอัปโหลดทีม Debian QA และเพิ่ม QA
อัปโหลดความคิดเห็นบันทึกการเปลี่ยนแปลง
--การกระจาย=ชื่อ
ตั้งค่าช่องการแจกจ่ายเป็น ชื่อ.
--แรง-การกระจาย
บังคับการกระจายที่ระบุด้วย --การกระจาย ที่จะใช้แม้ว่าจะไม่ได้
ตรงกับรายการการแจกแจงที่รู้จัก
--เร่งด่วน=ระดับ
ตั้งค่าฟิลด์เร่งด่วนเป็น ระดับ.
--git-log=git-log-ตัวเลือก
ตัวเลือกที่ส่งต่อคำต่อคำไปยัง คอมไพล์ล็อก(1)
--id-ความยาว=N
รวมไปถึง N ตัวเลขของรหัสยืนยันในรายการบันทึกการเปลี่ยนแปลง ค่าเริ่มต้นคือไม่รวม
รหัสการคอมมิตใด ๆ เลย
--ignore-regex=นิพจน์ทั่วไป
ละเว้นการคอมมิตบรรทัดที่ตรงกัน นิพจน์ทั่วไป เมื่อสร้างบันทึกการเปลี่ยนแปลง
--git-ผู้เขียน
ใช้ชื่อผู้ใช้และชื่อผู้ใช้อีเมลจาก git-config.php(1) สำหรับตัวอย่างการเปลี่ยนแปลง
--[ไม่-]มัลติแมต-ผสาน
การผสานกระทำโดยผู้ดูแล
--spawn-ตัวแก้ไข=[เสมอ | สแนปชอต | ปล่อย]
ไม่ว่าจะวางไข่เอดิเตอร์: เสมอ เมื่อทำสแนปชอตหรือเมื่อทำการรีลีส
--commit-msg=msg-รูปแบบ
ใช้สตริงรูปแบบนี้สำหรับข้อความยืนยันเมื่อคอมมิตไฟล์ที่สร้าง
ไฟล์บันทึกการเปลี่ยนแปลง (เมื่อ --ให้สัญญา จะได้รับ) ค่าเริ่มต้นคือ บันทึก การเปลี่ยนแปลง for
%(เวอร์ชั่น)s ปล่อย
--ให้สัญญา
คอมมิตบันทึกการเปลี่ยนแปลงที่สร้างขึ้น
--การปรับแต่ง=ปรับแต่งไฟล์
โหลดโค้ด Python จาก ปรับแต่งไฟล์. ในขณะนี้สิ่งเดียวที่มีประโยชน์คือ
โค้ดที่ทำได้คือกำหนดฟังก์ชัน format_changelog_entry() ที่กำหนดเอง
ภาพรวม โหมด
โหมดสแนปชอตสามารถใช้สำหรับการทดสอบอย่างรวดเร็วและติดตั้งรอบโดยไม่ต้องกังวลกับ
หมายเลขรุ่นหรือรายการบันทึกการเปลี่ยนแปลง
เมื่อใช้ --ภาพรวม or -S, GBP ดีช ใช้ส่วนหัวหลอกใน Debian changelog to
จำ git ล่าสุดที่คอมมิตมันเพิ่มรายการบันทึกการเปลี่ยนแปลงสำหรับ นอกจากนี้ยังกำหนดหมายเลขเวอร์ชัน
ลงท้ายด้วย ~ .gbp. มันเพิ่มสแนปชอตโดยอัตโนมัติ
หมายเลขในการเรียกต่อไปของ GBP ดีช -S เพื่อให้สแนปชอตในภายหลังมี
หมายเลขเวอร์ชันที่สูงกว่า หากต้องการออกจากโหมดสแน็ปช็อต ให้เรียกใช้ GBP ดีช กับ --ปล่อย ตัวเลือก
สิ่งนี้จะลบส่วนหัวหลอกและคลายหมายเลขเวอร์ชันเพื่อให้เวอร์ชันที่เผยแพร่
มีหมายเลขเวอร์ชันที่สูงกว่าสแน็ปช็อต
META TAGS
นอกเหนือจากตัวเลือกข้างต้น การจัดรูปแบบของข้อความยืนยันใน เดเบียน/บันทึกการเปลี่ยนแปลง
สามารถแก้ไขได้โดยแท็กพิเศษ (เรียกว่า Meta Tags) ที่ให้ไว้ในข้อความคอมมิต git เมต้า
การประมวลผลแท็กสามารถเปิดใช้งานได้ผ่านทาง --เมตา ตัวเลือก. แท็กต้องเริ่มที่ตัวแรก
คอลัมน์ของข้อความยืนยัน แต่สามารถปรากฏบนบรรทัดใดก็ได้ อยู่ในรูปแบบ ชื่อแท็ก:
ความคุ้มค่า. Meta Tags ที่ถูกต้องคือ:
Gbp-Dch: การกระทำ
การดำเนินการที่รองรับคือ: ไม่สนใจ ซึ่งจะละเว้นการคอมมิตนี้เมื่อสร้าง
เดเบียน/บันทึกการเปลี่ยนแปลง, สั้น ซึ่งจะใช้เฉพาะคำอธิบาย (บรรทัดแรก) ของ
ส่งข้อความเมื่อสร้างรายการบันทึกการเปลี่ยนแปลง (มีประโยชน์เมื่อ --เต็ม จะได้รับ)
และ เต็ม ซึ่งจะใช้ข้อความยืนยันแบบเต็มเมื่อสร้างรายการบันทึกการเปลี่ยนแปลง
(มีประโยชน์เมื่อ --เต็ม ไม่ได้รับ)
นอกจาก Gbp-Dch, เลิกใช้แล้ว Git-Dch ยังคงได้รับการสนับสนุน
ขอขอบคุณ: msg
เพิ่มข้อความขอบคุณหลังข้อความยืนยัน
ปิด: หมายเลขข้อผิดพลาด
ระบุใน เดเบียน/บันทึกการเปลี่ยนแปลง ว่าจุดบกพร่องถูกปิดโดยการกระทำนี้ ดู
--meta-ปิด เกี่ยวกับวิธีการขยายสิ่งนี้สำหรับเครื่องมือติดตามบั๊กอื่นๆ
ข้อความคอมมิต git ต่อไปนี้:
เมตาแท็กเอกสาร
จะได้ไม่ต้องดูคู่มือ
Gbp-Dch: สั้น
ปิด: #636088
ขอขอบคุณ: Raphaël Hertzog สำหรับคำแนะนำ
ผลลัพธ์ในสิ่งนี้ เดเบียน/บันทึกการเปลี่ยนแปลง รายการ:
* เมตาแท็กเอกสาร
ขอขอบคุณ Raphaël Hertzog สำหรับคำแนะนำ (ปิด: #636088)
การกำหนดค่า ไฟล์
หลาย gbp.conf ไฟล์จะถูกแยกวิเคราะห์เพื่อตั้งค่าเริ่มต้นสำหรับอาร์กิวเมนต์บรรทัดคำสั่งด้านบน
ดู gbp.conf(5)> manpage สำหรับรายละเอียด
ใช้ gbp-dch ออนไลน์โดยใช้บริการ onworks.net