git-describe - ອອນລາຍໃນຄລາວ

ໂຄງການ:

NAME

git-describe - ອະທິບາຍຄໍາຫມັ້ນສັນຍາໂດຍໃຊ້ແທັກຫຼ້າສຸດທີ່ສາມາດບັນລຸໄດ້ຈາກມັນ

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

ໄປ ອະທິບາຍ [--all] [--tags] [--contains] [--abbrev= ] [ ...]
ໄປ ອະທິບາຍ [--all] [--tags] [--contains] [--abbrev= ] --ເປື້ອນ[= ]

ລາຍລະອຽດ

ຄໍາສັ່ງຊອກຫາແທັກຫຼ້າສຸດທີ່ສາມາດບັນລຸໄດ້ຈາກຄໍາຫມັ້ນສັນຍາ. ຖ້າ tag ຈຸດ
ກັບຄໍາຫມັ້ນສັນຍາ, ຫຼັງຈາກນັ້ນພຽງແຕ່ແທັກຖືກສະແດງ. ຖ້າບໍ່ດັ່ງນັ້ນ, ມັນຕໍ່ທ້າຍຊື່ແທັກດ້ວຍ
ຈໍານວນຄໍາຫມັ້ນສັນຍາເພີ່ມເຕີມຢູ່ເທິງສຸດຂອງວັດຖຸ tagged ແລະຊື່ວັດຖຸຫຍໍ້
ຂອງຄໍາຫມັ້ນສັນຍາທີ່ຜ່ານມາ.

ໂດຍຄ່າເລີ່ມຕົ້ນ (ໂດຍບໍ່ມີ --all ຫຼື --tags) git ອະທິບາຍພຽງແຕ່ສະແດງ tags ຄໍາບັນຍາຍ. ສໍາລັບການເພີ່ມເຕີມ
ຂໍ້​ມູນ​ກ່ຽວ​ກັບ​ການ​ສ້າງ tags ຄໍາ​ອະ​ທິ​ບາຍ​ເບິ່ງ​ທາງ​ເລືອກ -a ແລະ -s ກັບ git-tag(1).

OPTIONS

...
commit-ish ຊື່ວັດຖຸເພື່ອອະທິບາຍ. ຄ່າເລີ່ມຕົ້ນເປັນ HEAD ຖ້າຖືກລະເວັ້ນ.

--ເປື້ອນ[= ]
ອະທິບາຍຕົ້ນໄມ້ທີ່ເຮັດວຽກ. ມັນຫມາຍຄວາມວ່າອະທິບາຍ HEAD ແລະຕໍ່ທ້າຍ (-ເປື້ອນ​ໂດຍ
default) ຖ້າຕົ້ນໄມ້ທີ່ເຮັດວຽກແມ່ນເປື້ອນ.

--ທັງໝົດ
ແທນທີ່ຈະໃຊ້ພຽງແຕ່ແທັກຄໍາບັນຍາຍ, ໃຫ້ໃຊ້ ref ໃດໆທີ່ພົບເຫັນຢູ່ໃນ refs / namespace. ນີ້
ທາງເລືອກເຮັດໃຫ້ການຈັບຄູ່ສາຂາທີ່ຮູ້ຈັກ, ສາຂາການຕິດຕາມໄລຍະໄກ, ຫຼືແທັກທີ່ມີນ້ໍາຫນັກເບົາ.

--ແທັກ
ແທນທີ່ຈະໃຊ້ພຽງແຕ່ແທັກທີ່ລະບຸໄວ້, ໃຫ້ໃຊ້ແທັກທີ່ພົບໃນ refs/tags namespace.
ຕົວເລືອກນີ້ເຮັດໃຫ້ການຈັບຄູ່ແທໍກທີ່ມີນໍ້າໜັກເບົາ (ບໍ່ມີໝາຍເຫດ).

-- ປະກອບດ້ວຍ
ແທນທີ່ຈະຊອກຫາແທັກທີ່ເຮັດສັນຍາລ່ວງໜ້າ, ຊອກຫາແທັກທີ່ມາຫຼັງ
ຄໍາຫມັ້ນສັນຍາ, ແລະດັ່ງນັ້ນຈຶ່ງປະກອບດ້ວຍມັນ. ອັດຕະໂນມັດຫມາຍເຖິງ --tags.

--abbrev=
ແທນ​ທີ່​ຈະ​ນໍາ​ໃຊ້​ມາດ​ຕະ​ຖານ 7 ຕົວ​ເລກ​ເລກ​ຖານ​ສິບ​ຫົກ​ເປັນ​ຊື່​ວັດ​ຖຸ​ຫຍໍ້, ໃຫ້​ນໍາ​ໃຊ້
ຕົວເລກ, ຫຼືຕົວເລກຫຼາຍເທົ່າທີ່ຕ້ອງການເພື່ອສ້າງເປັນຊື່ວັດຖຸທີ່ເປັນເອກະລັກ. ອັນ ຂອງ 0 ຈະ
ສະກັດກັ້ນຮູບແບບຍາວ, ພຽງແຕ່ສະແດງແທັກທີ່ໃກ້ຄຽງທີ່ສຸດ.

--ຜູ້ສະໝັກ=
ແທນທີ່ຈະພິຈາລະນາພຽງແຕ່ 10 tags ຫຼ້າສຸດເປັນຜູ້ສະຫມັກເພື່ອອະທິບາຍ
input commit-ish ພິຈາລະນາເຖິງ ຜູ້ສະໝັກ. ເພີ່ມຂຶ້ນ ຂ້າງເທິງ 10 ຈະໃຊ້ເວລາ
ຍາວເລັກນ້ອຍແຕ່ອາດຈະໃຫ້ຜົນໄດ້ຮັບທີ່ຖືກຕ້ອງກວ່າ. ອັນ ຂອງ 0 ຈະເຮັດໃຫ້ເກີດພຽງແຕ່
ກົງກັນທີ່ແນ່ນອນທີ່ຈະອອກ.

--ກົງກັນແທ້
ຜົນໄດ້ຮັບທີ່ກົງກັນທີ່ແນ່ນອນ (ແທັກອ້າງອີງໂດຍກົງກັບຄໍາຫມັ້ນສັນຍາທີ່ສະຫນອງໃຫ້). ນີ້​ແມ່ນ
ຄໍາສັບຄ້າຍຄືສໍາລັບ --candidates=0.

--debug
ສະແດງຂໍ້ມູນກ່ຽວກັບຍຸດທະສາດການຊອກຫາທີ່ຖືກໃຊ້ເປັນມາດຕະຖານ
ຄວາມຜິດພາດ. ຊື່ແທັກຈະຍັງຖືກພິມອອກເປັນມາດຕະຖານ.

-- ຍາວ
ສະເຫມີອອກຮູບແບບຍາວ (ແທັກ, ຈໍານວນຄໍາຫມັ້ນສັນຍາແລະຕົວຫຍໍ້
commit name) ເຖິງແມ່ນວ່າໃນເວລາທີ່ມັນກົງກັບແທັກ. ນີ້ແມ່ນເປັນປະໂຫຍດໃນເວລາທີ່ທ່ານຕ້ອງການເບິ່ງພາກສ່ວນຂອງ
ຊື່ວັດຖຸຄໍາຫມັ້ນສັນຍາໃນ "ອະທິບາຍ" ຜົນຜະລິດ, ເຖິງແມ່ນວ່າໃນເວລາທີ່ຄໍາຫມັ້ນສັນຍາໃນຄໍາຖາມເກີດຂຶ້ນ
ຈະເປັນສະບັບ tagged. ແທນທີ່ຈະພຽງແຕ່ປ່ອຍຊື່ແທັກ, ມັນຈະອະທິບາຍເຊັ່ນ
commit ເປັນ v1.2-0-gdeadbee (ຄໍາຫມັ້ນສັນຍາທີ 0 ນັບຕັ້ງແຕ່ tag v1.2 ທີ່ຊີ້ໃສ່ວັດຖຸ.
ຕາຍ....).

--ການແຂ່ງຂັນ
ພິຈາລະນາພຽງແຕ່ແທັກທີ່ກົງກັບທີ່ໃຫ້ ໂລກ(7) ຮູບແບບ, ບໍ່ລວມເອົາ "refs/tags/"
ຄຳນຳໜ້າ. ນີ້ສາມາດຖືກນໍາໃຊ້ເພື່ອຫຼີກເວັ້ນການຮົ່ວໄຫລ tags ສ່ວນຕົວຈາກ repository.

--ສະເໝີ
ສະ​ແດງ​ການ​ຫຍໍ້​ເປັນ​ເອ​ກະ​ລັກ commit ເປັນ​ຕົວ​ເລືອກ​.

-- ພໍ່​ແມ່​ຄັ້ງ​ທໍາ​ອິດ​
ປະຕິບັດຕາມພຽງແຕ່ພໍ່ແມ່ທໍາອິດທີ່ຫມັ້ນສັນຍາເມື່ອເຫັນຄໍາຫມັ້ນສັນຍາລວມ. ນີ້ແມ່ນເປັນປະໂຫຍດໃນເວລາທີ່
ທ່ານຕ້ອງການບໍ່ກົງກັບ tags ໃນສາຂາທີ່ຖືກລວມເຂົ້າໃນປະຫວັດສາດຂອງຄໍາຫມັ້ນສັນຍາເປົ້າຫມາຍ.

ຕົວຢ່າງ

ດ້ວຍບາງສິ່ງບາງຢ່າງເຊັ່ນ: git.git ຕົ້ນໄມ້ປະຈຸບັນ, ຂ້ອຍໄດ້ຮັບ:

[torvalds@g5 git]$ git ອະທິບາຍພໍ່ແມ່
v1.0.4-14-g2414721

ie ຫົວປະຈຸບັນຂອງສາຂາ "ພໍ່ແມ່" ຂອງຂ້ອຍແມ່ນອີງໃສ່ v1.0.4, ແຕ່ເນື່ອງຈາກວ່າມັນມີຈໍານວນຫນ້ອຍ.
commits ສຸດເທິງຂອງທີ່, ອະທິບາຍໄດ້ເພີ່ມຈໍານວນຂອງ commits ເພີ່ມເຕີມ ("14") ແລະເປັນ.
ຊື່ວັດຖຸຫຍໍ້ສໍາລັບຄໍາຫມັ້ນສັນຍາຕົວມັນເອງ ("2414721") ໃນຕອນທ້າຍ.

ຈໍານວນຄໍາຫມັ້ນສັນຍາເພີ່ມເຕີມແມ່ນຈໍານວນຄໍາຫມັ້ນສັນຍາທີ່ຈະຖືກສະແດງໂດຍ "git
ບັນທຶກ v1.0.4..parent ". ສ່ວນທ້າຍ hash ແມ່ນ "-g" + ຕົວຫຍໍ້ 7-char ສໍາລັບຄໍາຫມັ້ນສັນຍາປາຍຂອງ.
ພໍ່ແມ່ (ເຊິ່ງແມ່ນ 2414721b194453f058079d897d13c4e377f92dc6). ຄໍານໍາຫນ້າ "g" ຫຍໍ້ມາຈາກ
"git" ແລະຖືກນໍາໃຊ້ເພື່ອອະນຸຍາດໃຫ້ອະທິບາຍສະບັບຂອງຊອບແວໂດຍອີງຕາມ SCM ໄດ້
ຊອບແວໄດ້ຖືກຄຸ້ມຄອງດ້ວຍ. ນີ້ແມ່ນເປັນປະໂຫຍດໃນສະພາບແວດລ້ອມທີ່ຄົນອາດຈະໃຊ້ທີ່ແຕກຕ່າງກັນ
SCMs.

ການເຮັດກ ໄປ ອະທິບາຍ ໃນຊື່ແທັກຈະສະແດງຊື່ແທັກ:

[torvalds@g5 git]$ git ອະທິບາຍ v1.0.4
v1.0.4

ດ້ວຍ --all, ຄໍາສັ່ງສາມາດໃຊ້ຫົວສາຂາເປັນເອກະສານອ້າງອີງ, ດັ່ງນັ້ນຜົນໄດ້ຮັບສະແດງໃຫ້ເຫັນເຖິງ
ເສັ້ນທາງອ້າງອີງເຊັ່ນດຽວກັນ:

[torvalds@g5 git]$ git ອະທິບາຍ --all --abbrev=4 v1.0.5^2
tags/v1.0.0-21-g975b

[torvalds@g5 git]$ git ອະທິບາຍ --all --abbrev=4 HEAD^
heads/lt/describe-7-g975b

ດ້ວຍ --abbrev ຕັ້ງເປັນ 0, ຄໍາສັ່ງສາມາດຖືກນໍາໃຊ້ເພື່ອຊອກຫາ tagname ທີ່ໃກ້ຄຽງທີ່ສຸດໂດຍບໍ່ມີການໃດໆ
ຄຳຕໍ່ທ້າຍ:

[torvalds@g5 git]$ git ອະທິບາຍ --abbrev=0 v1.0.5^2
tags/v1.0.0

ໃຫ້ສັງເກດວ່າຄໍາຕໍ່ທ້າຍທີ່ທ່ານໄດ້ຮັບຖ້າທ່ານພິມຄໍາສັ່ງເຫຼົ່ານີ້ໃນມື້ນີ້ອາດຈະຍາວກວ່າອັນໃດ
Linus ເຫັນຂ້າງເທິງໃນເວລາທີ່ລາວດໍາເນີນການຄໍາສັ່ງເຫຼົ່ານີ້, ຍ້ອນວ່າບ່ອນເກັບມ້ຽນ Git ຂອງທ່ານອາດຈະມີຄໍາຫມັ້ນສັນຍາໃຫມ່
ຊື່ວັດຖຸທີ່ເລີ່ມຕົ້ນດ້ວຍ 975b ທີ່ບໍ່ມີຢູ່ໃນຕອນນັ້ນ, ແລະ "-g975b" ຕໍ່ທ້າຍຢ່າງດຽວ
ອາດຈະບໍ່ພຽງພໍເພື່ອ disambiguate ຄໍາຫມັ້ນສັນຍາເຫຼົ່ານີ້.

ຄົ້ນຫາ ກົນລະຍຸດ

ສໍາລັບແຕ່ລະ commit-ish ສະຫນອງໃຫ້, ໄປ ອະທິບາຍ ທໍາອິດຈະຊອກຫາແທັກທີ່ແທັກແທ້
ຄໍາຫມັ້ນສັນຍານັ້ນ. tags ຄໍາບັນຍາຍສະເຫມີຈະມັກຫຼາຍກວ່າແທັກທີ່ມີນ້ໍາຫນັກເບົາ, ແລະແທັກດ້ວຍ
ວັນທີໃໝ່ກວ່າຈະມັກຫຼາຍກວ່າແທັກທີ່ມີວັນທີເກົ່າກວ່າສະເໝີ. ຖ້າກົງກັນແນ່ນອນ
ພົບເຫັນ, ຊື່ຂອງມັນຈະອອກແລະການຊອກຫາຈະຢຸດເຊົາ.

ຖ້າ​ຫາກ​ວ່າ​ການ​ແຂ່ງ​ຂັນ​ທີ່​ແນ່​ນອນ​ບໍ່​ໄດ້​ພົບ​ເຫັນ​, ໄປ ອະທິບາຍ ຈະຍ່າງກັບຄືນໄປບ່ອນໂດຍຜ່ານປະຫວັດສາດຄໍາຫມັ້ນສັນຍາກັບ
ຊອກ​ຫາ​ບັນ​ພະ​ບຸ​ລຸດ​ຄໍາ​ຫມັ້ນ​ສັນ​ຍາ​ທີ່​ໄດ້​ຮັບ​ການ tagged​. ໂຄດຄໍາສັ່ງຂອງບັນພະບຸລຸດຈະຖືກຜົນຜະລິດຕາມ
ດ້ວຍຕົວຫຍໍ້ຂອງ SHA-1 ຂອງ commit-ish. ຖ້າ -- ພໍ່​ແມ່​ຄັ້ງ​ທໍາ​ອິດ​ ໄດ້ລະບຸໄວ້ຫຼັງຈາກນັ້ນ
ການຍ່າງພຽງແຕ່ຈະພິຈາລະນາພໍ່ແມ່ທໍາອິດຂອງແຕ່ລະຄໍາຫມັ້ນສັນຍາ.

ຖ້າຫຼາຍແທັກຖືກພົບເຫັນໃນລະຫວ່າງການຍ່າງຫຼັງຈາກນັ້ນແທັກທີ່ມີຄໍາຫມັ້ນສັນຍາຫນ້ອຍທີ່ສຸດ
ທີ່ແຕກຕ່າງຈາກ input commit-ish ຈະຖືກເລືອກແລະຜົນຜະລິດ. ນີ້ແມ່ນຄໍາຫມັ້ນສັນຍາຫນ້ອຍທີ່ສຸດ
ທີ່ແຕກຕ່າງກັນແມ່ນຖືກກໍານົດເປັນຈໍານວນຄໍາຫມັ້ນສັນຍາທີ່ຈະສະແດງໂດຍ git log tag..input
ຈະເປັນຈໍານວນຄໍາຫມັ້ນສັນຍາທີ່ນ້ອຍທີ່ສຸດທີ່ເປັນໄປໄດ້.

GIT

ສ່ວນຫນຶ່ງຂອງ ໄປ(1) ຊຸດ

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