gbp-dch - ອອນລາຍໃນຄລາວ

ໂຄງການ:

NAME

gbp-dch - ສ້າງ debian changelog ຈາກ git commit messages

ສະຫຼຸບສັງລວມ

gbp dch [ - ການປ່ຽນແປງ ] [ - ຊ່ວຍ ] [ -- verbose ] [ --color=[ອັດຕະໂນມັດ|ເປີດ|ປິດ] ] [ --ສີ-
ໂຄງ​ການ =​COLOR_SCHEME ] [ --debian-branch=ສາຂາ _name ] [ --debian-tag=tag-format ] [
--upstream-branch=ສາຂາ _name ] [ --upstream-tag=tag-format ] [ --ignore-ສາຂາ ] [
--ພາບຖ່າຍ | --ປ່ອຍ ] [ --ອັດຕະໂນມັດ | --ນັບຕັ້ງແຕ່=ມອບໝາຍ ] [ --new-version=ສະບັບພາສາ ] [ --bpo
| --nmu | --qa | --ທີມ ] [ --ການແຈກຢາຍ=ຊື່ ] [ --ການກະຈາຍຜົນບັງຄັບໃຊ້ ] [
--urgency=ລະດັບ ] [ --[ບໍ່-] ເຕັມ ] [ --[ບໍ່-] meta ] [ --meta-closes=bug-close-tags ] [
--meta-closes-bugnum=bug-number-format ] [ --snapshot-number=ການສະແດງອອກ ] [ --id-
ຄວາມຍາວ=ຈໍານວນ ] [ --git-log=git-log-options ] [ --[no-]git-author ] [ --[ບໍ່-] multimaint ]
[ --[no-] multimaint-merge ] [ --spawn-editor=[ສະເໝີ|ພາບຖ່າຍ|ປ່ອຍ] ] [ --ຄໍາຫມັ້ນສັນຍາ-
msg=msg ຮູບແບບ ] [ -- ຫມັ້ນສັນຍາ ] [ --ການປັບແຕ່ງ=ການປັບແຕ່ງໄຟລ໌ ] [ເສັ້ນທາງ1 ເສັ້ນທາງ 2]

ລາຍລະອຽດ

gbp dch ອ່ານ git commit ຂໍ້ຄວາມແລະສ້າງ Debian changelog ຈາກມັນ. ຖ້າບໍ່ມີ
ການໂຕ້ຖຽງແມ່ນໃຫ້, gbp dch ເລີ່ມຕົ້ນຈາກແພັກເກັດແພັກເກັດ Debian ທີ່ມີ tagged ຫຼ້າສຸດເຖິງ
ປາຍຂອງສາຂາປະຈຸບັນ. ຖ້າຫາກວ່າການແຜ່ກະຈາຍຂອງພາກສ່ວນເທິງສຸດໃນ
debian/changelog is ປ່ອຍອອກມາ, ລາຍການ changelog ຈະຖືກໃສ່ເຂົ້າໄປໃນພາກນີ້.
ຖ້າບໍ່ດັ່ງນັ້ນ, ພາກສ່ວນໃຫມ່ຈະຖືກສ້າງຂື້ນ.

If --ອັດຕະໂນມັດ ແມ່ນໃຫ້ gbp dch, ພະຍາຍາມຄາດເດົາຄໍາຫມັ້ນສັນຍາ Git ສຸດທ້າຍທີ່ບັນທຶກໄວ້ໃນ changelog
- ນີ້ພຽງແຕ່ເຮັດວຽກໃນໂຫມດ snapshot. ຖ້າບໍ່ດັ່ງນັ້ນ, -- ນັບຕັ້ງແຕ່ ສາມາດໃຊ້ເພື່ອບອກໄດ້ gbp dch at
ຈຸດໃດທີ່ມັນຄວນຈະເລີ່ມຕົ້ນໃນປະຫວັດສາດ Git.

ການໂຕ້ຖຽງເສັ້ນທາງເພີ່ມເຕີມສາມາດຖືກນໍາໃຊ້ເພື່ອຈໍາກັດເສັ້ນທາງຂອງບ່ອນເກັບມ້ຽນ gbp dch ເບິ່ງຄືວ່າ
ທີ່. ການຕັ້ງຄ່າ ເສັ້ນທາງ to debian/ ເປັນທາງເລືອກທີ່ດີຖ້າ upstream ໃຊ້ Git ແລະການຫຸ້ມຫໍ່ Debian ທັງຫມົດ
ການ​ປ່ຽນ​ແປງ​ແມ່ນ​ຈໍາ​ກັດ​ການ​ debian/ subdir. ໃນກໍລະນີທີ່ມີຄວາມຊັບຊ້ອນຫຼາຍ (ເຊັ່ນ:
backports), ທ່ານສາມາດນໍາໃຊ້ --git-log ເພື່ອ​ຈໍາ​ກັດ​ການ​ສ້າງ changelog entries ຕື່ມ​ອີກ​,
ສໍາລັບຕົວຢ່າງ, ການນໍາໃຊ້ --git-log="--author=Foo ບາ".

OPTIONS

- ການປ່ຽນແປງ
ສະບັບພິມຂອງໂຄງການ, ie ສະບັບຂອງຊຸດ git-buildpackage

-v

-- verbose
ການ​ປະ​ຕິ​ບັດ​ຄໍາ​ເວົ້າ​

-h

- ຊ່ວຍ ພິມການຊ່ວຍເຫຼືອແລະອອກ

--color=[ອັດຕະໂນມັດ|ເປີດ|ປິດ]
ວ່າຈະໃຊ້ສີອອກຫຼືບໍ່.

--color-scheme=COLOR_SCHEME
ສີທີ່ຈະໃຊ້ໃນຜົນຜະລິດ (ເມື່ອສີຖືກເປີດໃຊ້). ຮູບແບບຂອງ COLOR_SCHEME ແມ່ນ
' : : : '. ຄ່າຕົວເລກແລະຊື່ສີແມ່ນຍອມຮັບ,
ຊ່ອງຫວ່າງເປົ່າຫມາຍເຖິງສີເລີ່ມຕົ້ນ. ຍົກ​ຕົວ​ຢ່າງ, --git-color-scheme='ຟ້າ:34::'
ຈະສະແດງຂໍ້ຄວາມດີບັກໃນສີຟ້າສີຟ້າ, ຂໍ້ຄວາມຂໍ້ມູນເປັນສີຟ້າ ແລະຂໍ້ຄວາມອື່ນໆໃນ
ຄ່າເລີ່ມຕົ້ນ (ເຊັ່ນ: ການເຕືອນໄພ ແລະຂໍ້ຄວາມສະແດງຂໍ້ຜິດພາດເປັນສີແດງ).

--debian-branch=ສາຂາ _name
ສາຂາຢູ່ໃນບ່ອນເກັບມ້ຽນ Git ແພກເກດ Debian ກໍາລັງຖືກພັດທະນາຢູ່ໃນ, ເລີ່ມຕົ້ນ
is ຕົ້ນສະບັບ.

--upstream-branch=ສາຂາ _name
ສາຂາເພື່ອກໍານົດສະບັບຕົ້ນນ້ໍາຈາກ. ຄ່າເລີ່ມຕົ້ນແມ່ນ ສາຍນ້ ຳ.

--git-upstream-tag=TAG-FORMAT
ໃຊ້ຮູບແບບແທັກນີ້ເມື່ອຊອກຫາແທັກຂອງລຸ້ນຕົ້ນໆ, ຄ່າເລີ່ມຕົ້ນແມ່ນ
upstream/%(version)s.

--ignore-ສາຂາ
ຢ່າກວດເບິ່ງວ່າສາຂາປະຈຸບັນກົງກັນບໍ debian-ສາຂາ.

--debian-tag=tag-format
ຮູບແບບແທັກທີ່ໃຊ້, ເມື່ອແທັກສະບັບ debian, ຄ່າເລີ່ມຕົ້ນແມ່ນ debian/%(version)s

--ນັບຕັ້ງແຕ່=ຄະ​ນະ​ກໍາ​ມະ
ເລີ່ມການອ່ານຂໍ້ຄວາມສັນຍາຢູ່ ຄະ​ນະ​ກໍາ​ມະ.

--ອັດຕະໂນມັດ, -a
ຄາດເດົາຄໍາຫມັ້ນສັນຍາສຸດທ້າຍທີ່ບັນທຶກໄວ້ໃນ changelog ຈາກປ້າຍໂຄສະນາ snapshot (ຫຼືຈາກ
ແທັກສຸດທ້າຍຖ້າບໍ່ມີປ້າຍໂຄສະນາ snapshot ຢູ່).

--[ບໍ່-] meta
ແຍກແທໍກ meta ເຊັ່ນ ປິດ:, ຂໍຂອບໃຈ: ແລະ Gbp-Dch:. ເບິ່ງ META TAGS ຂ້າງລຸ່ມນີ້.

--meta-closes=bug-close-tags
ແທໍກ meta ແມ່ນຫຍັງທີ່ຈະຊອກຫາເພື່ອສ້າງລາຍການ changelog ປິດ bug. ຄ່າເລີ່ມຕົ້ນ
ແມ່ນ 'Closes|LP' ເພື່ອຮອງຮັບ Debian ແລະ Launchpad.

--meta-closes-bugnum=bug-number-format
ສິ່ງທີ່ສະແດງອອກເປັນປົກກະຕິຄວນຖືກໃຊ້ເພື່ອວິເຄາະຕົວເລກ bug. ຄ່າເລີ່ມຕົ້ນແມ່ນ
'(?:bug|ບັນຫາ)?\#?\s?\d+'. ຫມາຍເຫດ: regex ຄວນສະກັດກັ້ນທຸກສ່ວນຂອງແມງໄມ້
ຕົວເລກທີ່ບໍ່ຕ້ອງການໂດຍໃຊ້ "(? :)", ເບິ່ງຄູ່ມື Python regex ສໍາລັບລາຍລະອຽດ.

ຕົວຢ່າງ: --meta-closes-bugnum="(?:bug)?\s*ex-\d+" ຈະກົງກັບທັງໝົດຕໍ່ໄປນີ້:

ການແຂ່ງຂັນ Txt ທີ່ເປັນໄປໄດ້ບໍ? ຜົນໄດ້ຮັບ
------------ ------ ------
ບັກ EX-12345 Y EX-12345
ex-01273 Y ex-01273
bug ex-1ab Y ex-1
EX--12345 ນ

--[ບໍ່-] ເຕັມ
ລວມເອົາຂໍ້ຄວາມຄໍາຫມັ້ນສັນຍາເຕັມຢູ່ໃນຜົນໄດ້ຮັບການປ່ຽນແປງ.

-- ພາບ​ລວມ​, -S
ສ້າງລາຍການການປ່ອຍພາບຖ່າຍ. ນີ້ເພີ່ມຕົວເລກການປ່ອຍພາບຖ່າຍແລະການເຕືອນ
ປ້າຍໂຄສະນາໄປຫາລາຍການ changelog. ໝາຍເລກລຸ້ນລຸ້ນກຳລັງຖືກເພີ່ມອັດຕະໂນມັດ
ກັບທຸກໆການປ່ອຍ snapshot ໃຫມ່ເພື່ອຫຼີກເວັ້ນການ downgrades packages ໃນລະຫວ່າງການ snapshot
ການທົດສອບ.

--snapshot-number=ການສະແດງອອກ
Python expression ທີ່ໄດ້ຮັບ eval()ed ກັບຕົວເລກ snapshot ໃຫມ່.

--ປ່ອຍ, -R
ເອົາປ້າຍໂຄສະນາການປ່ອຍ snapshot ແລະສ່ວນທ້າຍສະບັບ, ກໍານົດປະຈຸບັນ
ແຈກຢາຍໃຫ້ ບໍ່ຫມັ້ນຄົງ, ແລະເປີດ changelog ສໍາລັບການ tweaking ສຸດທ້າຍ.

--new-version=ສະບັບພາສາ, -N ສະບັບພາສາ
ເພີ່ມສ່ວນ changelog ໃໝ່ດ້ວຍເວີຊັນ ລຸ້ນໃໝ່. ພ້ອມດ້ວຍ --ພາບຖ່າຍ, ການ
ຕົວເລກ snapshot ຈະຖືກຕໍ່ທ້າຍໃສ່ ລຸ້ນໃໝ່.

--ທີມ ສ້າງທີມງານອັບໂຫລດ changelog entry.

--bpo ເພີ່ມຕົວເລກການປ່ອຍ Debian ສໍາລັບການອັບໂຫລດໄປຍັງ backports, ແລະເພີ່ມ backport
ອັບໂຫລດຄໍາຄິດເຫັນ changelog.

--nmu ເພີ່ມຕົວເລກການປ່ອຍ Debian ສໍາລັບການອັບໂຫລດທີ່ບໍ່ແມ່ນການຮັກສາໄວ້.

--qa ເພີ່ມຈໍານວນການປ່ອຍ Debian ສໍາລັບການອັບໂຫລດທີມ Debian QA, ແລະເພີ່ມ QA
ອັບໂຫລດຄໍາຄິດເຫັນ changelog.

--ການແຈກຢາຍ=ຊື່
ກໍານົດພາກສະຫນາມການແຈກຢາຍເປັນ ຊື່.

--ການກະຈາຍຜົນບັງຄັບໃຊ້
ບັງຄັບການແຈກຢາຍທີ່ລະບຸດ້ວຍ -- ການ​ແຜ່​ກະ​ຈາຍ​ ທີ່ຈະນໍາໃຊ້, ເຖິງແມ່ນວ່າມັນບໍ່ໄດ້
ກົງກັບລາຍຊື່ການແຈກຢາຍທີ່ຮູ້ຈັກ.

--urgency=ລະດັບ
ກໍານົດພາກສະຫນາມຮີບດ່ວນ ລະດັບ.

--git-log=git-log-options
ທາງ​ເລືອກ​ທີ່​ໄດ້​ຮັບ​ການ​ຜ່ານ​ຄໍາ​ເວົ້າ​ກັບ​ git-log(1).

--id-length=N
ລວມ N ຕົວເລກຂອງ commit id ໃນການປ້ອນ changelog. ຄ່າເລີ່ມຕົ້ນແມ່ນບໍ່ໃຫ້ລວມ
ids ຄໍາຫມັ້ນສັນຍາຢູ່ໃນທັງຫມົດ.

--ignore-regex=regex
ບໍ່ສົນໃຈສາຍທີ່ກົງກັນ regex ເມື່ອສ້າງ changelog.

--git-ຜູ້ຂຽນ
ໃຊ້ user.name ແລະ user.email ຈາກ git-config(1) ສໍາລັບ trailer changelog.

--[no-] multimaint-merge
Merge ຫມັ້ນສັນຍາໂດຍຜູ້ຮັກສາ.

--spawn-editor=[ສະເໝີ|ພາບຖ່າຍ|ປ່ອຍ]
ວ່າຈະສ້າງຕົວແກ້ໄຂຫຼືບໍ່: ສະເໝີ, ເມື່ອຖ່າຍພາບ ຫຼືເມື່ອອອກຂ່າວ.

--commit-msg=msg ຮູບແບບ
ໃຊ້ສະຕຣິງຮູບແບບນີ້ສໍາລັບຂໍ້ຄວາມຄໍາຫມັ້ນສັນຍາໃນເວລາທີ່ committing ສ້າງຂຶ້ນ
ໄຟລ໌ changelog (ເມື່ອ -- ຫມັ້ນສັນຍາ ແມ່ນໃຫ້). ຄ່າເລີ່ມຕົ້ນແມ່ນ ການປັບປຸງ ການປ່ຽນແປງ ສໍາລັບການ
%(ລຸ້ນ)s ປ່ອຍ

-- ຫມັ້ນສັນຍາ
ສັນຍາການປ່ຽນແປງທີ່ສ້າງຂຶ້ນ.

--ການປັບແຕ່ງ=ການປັບແຕ່ງໄຟລ໌
ໂຫລດລະຫັດ Python ຈາກ ການປັບແຕ່ງໄຟລ໌. ໃນປັດຈຸບັນ, ສິ່ງດຽວທີ່ເປັນປະໂຫຍດ
ລະຫັດສາມາດເຮັດໄດ້ແມ່ນກໍານົດຫນ້າທີ່ກໍາຫນົດເອງ format_changelog_entry().

SNAPSHOT MODE

ໂຫມດ Snapshot ສາມາດຖືກນໍາໃຊ້ສໍາລັບການທົດສອບໄວແລະການຕິດຕັ້ງຮອບວຽນໂດຍບໍ່ຕ້ອງກັງວົນກ່ຽວກັບການ
ຕົວເລກເວີຊັນ ຫຼືລາຍການ changelog.

ເມື່ອນໍາໃຊ້ --ພາບຖ່າຍ or -S, gbp dch ໃຊ້ header pseudo ໃນ Debian changelog to
ຈື່ຈໍາຄໍາຫມັ້ນສັນຍາ git ສຸດທ້າຍມັນໄດ້ເພີ່ມເຂົ້າ changelog ສໍາລັບ. ມັນຍັງກໍານົດຕົວເລກສະບັບ
ສິ້ນສຸດໃນ ~ .gbp. ມັນເພີ່ມພາບຖ່າຍໂດຍອັດຕະໂນມັດ
ຈໍາ​ນວນ​ໃນ​ການ​ຮຽກ​ຮ້ອງ​ຕໍ່​ມາ​ຂອງ​ gbp dch -S ດັ່ງ​ນັ້ນ​ຮູບ​ພາບ​ຕໍ່​ມາ​ອັດ​ຕະ​ໂນ​ມັດ​ມີ​
ຕົວເລກເວີຊັນທີ່ສູງກວ່າ. ເພື່ອອອກຈາກໂໝດຖ່າຍພາບ, ຮຽກຮ້ອງ gbp dch ກັບ --ປ່ອຍ ທາງເລືອກ.
ນີ້ຈະເອົາສ່ວນຫົວ pseudo ແລະ unmangles ຕົວເລກສະບັບດັ່ງນັ້ນສະບັບທີ່ປ່ອຍອອກມາ
ມີຕົວເລກເວີຊັນທີ່ສູງກວ່າພາບຖ່າຍ.

META TAGS

ເພີ່ມເຕີມຕໍ່ກັບທາງເລືອກຂ້າງເທິງ, ຮູບແບບຂອງຂໍ້ຄວາມຄໍາຫມັ້ນສັນຍາໃນ debian/changelog
ສາມາດຖືກດັດແກ້ໂດຍ tags ພິເສດ (ເອີ້ນວ່າ Meta Tags) ທີ່ໃຫ້ຢູ່ໃນຂໍ້ຄວາມ git commit. ເມຕາ
ການປະມວນຜົນແທັກສາມາດຖືກເປີດໃຊ້ຜ່ານທາງ --meta ທາງເລືອກ. tags ຈະຕ້ອງເລີ່ມຕົ້ນໃນຕອນທໍາອິດ
ຖັນຂອງຂໍ້ຄວາມສັນຍາແຕ່ສາມາດປາກົດຢູ່ໃນແຖວໃດນຶ່ງ. ເຂົາເຈົ້າມີຮູບແບບ ຊື່ແທັກ:
ມູນຄ່າ. ແທັກ Meta ທີ່ຖືກຕ້ອງແມ່ນ:

Gbp-Dch: ການປະຕິບັດ
ການ​ປະ​ຕິ​ບັດ​ສະ​ຫນັບ​ສະ​ຫນູນ​ແມ່ນ​: Ignore ເຊິ່ງຈະບໍ່ສົນໃຈຄໍາຫມັ້ນສັນຍານີ້ໃນເວລາສ້າງ
debian/changelog, ສັ້ນ ເຊິ່ງພຽງແຕ່ຈະໃຊ້ຄໍາອະທິບາຍ (ແຖວທໍາອິດ) ຂອງ
ສົ່ງ​ຂໍ້​ຄວາມ​ໃນ​ເວ​ລາ​ທີ່​ສ້າງ​ການ​ເຂົ້າ changelog (ປະ​ໂຫຍດ​ໃນ​ເວ​ລາ​ທີ່ -- ເຕັມ ແມ່ນໃຫ້),
ແລະ ຢ່າງ​ເຕັມ​ທີ່ ເຊິ່ງຈະໃຊ້ຂໍ້ຄວາມເຕັມທີ່ເມື່ອສ້າງການປ້ອນ changelog
(ເປັນປະໂຫຍດເມື່ອ -- ເຕັມ ບໍ່ໄດ້ໃຫ້).

ນອກ​ຈາກ​ນັ້ນ Gbp-Dch, ປະຕິເສດ Git-Dch ຍັງໄດ້ຮັບການສະຫນັບສະຫນູນ.

ຂໍຂອບໃຈ: msg
ເພີ່ມຂໍ້ຄວາມຂອບໃຈຫຼັງຈາກຂໍ້ຄວາມສັນຍາ.

ປິດ: ໝາຍເລກບັກ
ຊີ້ບອກຢູ່ໃນ debian/changelog ວ່າ bug ໄດ້ຖືກປິດໂດຍຄໍາຫມັ້ນສັນຍານີ້. ເບິ່ງ
--meta-ປິດ ກ່ຽວກັບວິທີການຂະຫຍາຍນີ້ສໍາລັບ bugtrackers ອື່ນໆ.

ຂໍ້ຄວາມ git commit ຕໍ່ໄປນີ້:

ແທັກ meta ເອກະສານ

ດັ່ງນັ້ນຫນຶ່ງບໍ່ຈໍາເປັນຕ້ອງປຶກສາຫາລືຄູ່ມື

Gbp-Dch: ສັ້ນ
ປິດ: #636088
ຂອບໃຈ: Raphaël Hertzog ສໍາລັບຄໍາແນະນໍາ

ຜົນໄດ້ຮັບໃນນີ້ debian/changelog ເຂົ້າ:

* ແທັກ meta ເອກະສານ.
ຂອບໃຈ Raphaël Hertzog ສໍາລັບຄໍາແນະນໍາ (ປິດ: #636088)

CONFIGURATION ເອກະສານ

ຫຼາຍ gbp.conf ໄຟລ໌ຖືກວິເຄາະເພື່ອກໍານົດຄ່າເລີ່ມຕົ້ນສໍາລັບການໂຕ້ຖຽງແຖວຄໍາສັ່ງຂ້າງເທິງ.
ເບິ່ງ gbp.conf(5)> manpage ສໍາລັບລາຍລະອຽດ.

ໃຊ້ gbp-dch ອອນໄລນ໌ໂດຍໃຊ້ບໍລິການ onworks.net