git-rev-parse - ออนไลน์ใน Cloud

โครงการ:

ชื่อ

git-rev-parse - เลือกและนวดค่าพารามิเตอร์

เรื่องย่อ

คอมไพล์ รอบแยกวิเคราะห์ [ --ตัวเลือก ] ...

DESCRIPTION

คำสั่งเครื่องเคลือบ Git จำนวนมากใช้แฟล็กผสมกัน (เช่น พารามิเตอร์ที่ขึ้นต้นด้วย a
สาด -) และพารามิเตอร์ที่มีความหมายสำหรับตัวอ้างอิง คอมไพล์ รายการรอบ คำสั่งที่ใช้ภายใน
และแฟล็กและพารามิเตอร์สำหรับคำสั่งอื่นๆ ที่ใช้ดาวน์สตรีมของ คอมไพล์ รายการรอบ. นี้
คำสั่งใช้เพื่อแยกความแตกต่างระหว่างพวกเขา

OPTIONS

การดำเนินการ โหมด
แต่ละตัวเลือกเหล่านี้ต้องปรากฏก่อนในบรรทัดคำสั่ง

--พาร์ซอปต์
ใช้ คอมไพล์ รอบแยกวิเคราะห์ ในโหมดแยกวิเคราะห์ตัวเลือก (ดูหัวข้อ PARSEOPT ด้านล่าง)

--sq-อ้าง
ใช้ คอมไพล์ รอบแยกวิเคราะห์ ในโหมดเสนอราคาเชลล์ (ดูส่วน SQ-QUOTE ด้านล่าง) ตรงกันข้ามกับ
ตัวเลือก --sq ด้านล่าง โหมดนี้อ้างอิงเท่านั้น ไม่มีอะไรทำอย่างอื่นที่จะสั่ง
อินพุต

Options for --พาร์ซอปต์
--keep-dashdash
มีความหมายเฉพาะในโหมด --parseopt บอกตัวเลือก parser ให้สะท้อนออกมาก่อน --
เจอกันแทนที่จะข้ามไป

--stop-at-non-ตัวเลือก
มีความหมายเฉพาะในโหมด --parseopt ให้ตัวเลือก parser หยุดที่แรก
อาร์กิวเมนต์ที่ไม่ใช่ตัวเลือก สามารถใช้เพื่อแยกคำสั่งย่อยที่ใช้ตัวเลือก
ตัวเอง

--ติดยาว
มีความหมายเฉพาะในโหมด --parseopt เอาต์พุตตัวเลือกในรูปแบบยาว if
ใช้ได้และมีข้อโต้แย้งติดอยู่

Options for กรอง
--revs-เท่านั้น
ห้ามส่งออกแฟล็กและพารามิเตอร์ที่ไม่ได้มีไว้สำหรับ คอมไพล์ รายการรอบ คำสั่ง

--no-รอบ
ห้ามส่งออกแฟล็กและพารามิเตอร์ที่มีไว้สำหรับ คอมไพล์ รายการรอบ คำสั่ง

--ธง
ห้ามส่งออกพารามิเตอร์ที่ไม่ใช่แฟล็ก

--ไม่มีธง
ห้ามส่งออกพารามิเตอร์แฟล็ก

Options for เอาท์พุต
--ค่าเริ่มต้น
หากไม่มีพารามิเตอร์ที่กำหนดโดยผู้ใช้ ให้ใช้ แทนที่.

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

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

คำนำหน้า=$(git rev-parse --show-prefix)
cd "$(git rev-parse --show-toplevel)"
eval "set -- $(git rev-parse --sq --prefix "$prefix" "$@")"

--ตรวจสอบ
ตรวจสอบว่ามีพารามิเตอร์เพียงตัวเดียว และสามารถเปลี่ยนเป็นค่า raw ได้
SHA-20 ขนาด 1 ไบต์ที่สามารถใช้เข้าถึงฐานข้อมูลอ็อบเจ็กต์ ถ้าเป็นเช่นนั้น ให้ปล่อยไปที่
เอาต์พุตมาตรฐาน มิฉะนั้น ข้อผิดพลาดออก

หากคุณต้องการให้แน่ใจว่าผลลัพธ์นั้นตั้งชื่อวัตถุในวัตถุของคุณจริง ๆ
ฐานข้อมูล และ/หรือ สามารถใช้เป็นวัตถุเฉพาะที่ต้องการได้ คุณสามารถเพิ่ม
^{type} ตัวดำเนินการลอกไปยังพารามิเตอร์ ตัวอย่างเช่น git rev-parse "$VAR^{commit}"
จะทำให้แน่ใจว่า $VAR ตั้งชื่ออ็อบเจกต์ที่มีอยู่ที่เป็น commit-ish (เช่น การคอมมิต หรือ
แท็กที่มีคำอธิบายประกอบซึ่งชี้ไปที่การคอมมิต) เพื่อให้แน่ใจว่า $VAR ตั้งชื่อว่าสิ่งที่มีอยู่
วัตถุประเภทใดก็ได้ git rev-parse "$VAR^{object}" สามารถใช้ได้

-q, --เงียบ
มีความหมายเฉพาะในโหมด --verify อย่าแสดงข้อความแสดงข้อผิดพลาดหากอาร์กิวเมนต์แรก
ไม่ใช่ชื่ออ็อบเจ็กต์ที่ถูกต้อง แทนที่จะออกด้วยสถานะที่ไม่ใช่ศูนย์อย่างเงียบๆ SHA-1s สำหรับ
ชื่ออ็อบเจ็กต์ที่ถูกต้องจะพิมพ์ไปที่ stdout เมื่อสำเร็จ

--ตร
โดยปกติเอาต์พุตจะทำหนึ่งบรรทัดต่อแฟล็กและพารามิเตอร์ ตัวเลือกนี้ทำให้เอาต์พุต a
บรรทัดเดียว เสนอราคาอย่างเหมาะสมสำหรับการบริโภคโดยเชลล์ มีประโยชน์เมื่อคุณคาดหวังของคุณ
พารามิเตอร์ให้มีช่องว่างและการขึ้นบรรทัดใหม่ (เช่นเมื่อใช้ pickaxe -S with คอมไพล์
ต่าง-*). ตรงกันข้ามกับตัวเลือก --sq-quote อินพุตคำสั่งยังคงถูกตีความ
เหมือนปกติ

--ไม่
เมื่อแสดงชื่อวัตถุ ให้นำหน้าด้วย ^ และเปลื้องผ้า ^ คำนำหน้าจากชื่อวัตถุ
ที่มีอยู่แล้ว

--abbrev-ref[=(เข้มงวด | หลวม)]
ชื่อสั้นที่ไม่คลุมเครือของชื่ออ็อบเจ็กต์ ตัวเลือก core.warnAmbiguousRefs คือ
ใช้เพื่อเลือกโหมดตัวย่อที่เข้มงวด

--สั้น, --สั้น=จำนวน
แทนที่จะแสดงค่า SHA-1 แบบเต็มของชื่ออ็อบเจ็กต์ ให้ลองย่อให้เป็น
ชื่อเฉพาะที่สั้นกว่า เมื่อไม่ได้ระบุความยาว 7 จะใช้ ความยาวขั้นต่ำคือ 4

--สัญลักษณ์
โดยปกติชื่ออ็อบเจ็กต์จะแสดงในรูปแบบ SHA-1 (เป็นไปได้ ^ คำนำหน้า); นี้
option ทำให้พวกเขาส่งออกในรูปแบบที่ใกล้เคียงกับอินพุตดั้งเดิมมากที่สุด

--สัญลักษณ์-ชื่อเต็ม
สิ่งนี้คล้ายกับ --symbolic แต่ละเว้นอินพุตที่ไม่ใช่ refs (เช่น branch หรือ
ชื่อแท็ก; หรือรูปแบบ "หัวหน้า/อาจารย์" ที่ชัดเจนยิ่งขึ้นเมื่อคุณต้องการ
ตั้งชื่อสาขา "master" เมื่อมีแท็กชื่อ "master" ที่น่าเสียดาย" และแสดง
เป็นชื่อผู้อ้างอิงแบบเต็ม (เช่น "refs/heads/master")

Options for วัตถุ
--ทั้งหมด
แสดงผู้อ้างอิงทั้งหมดที่พบใน refs/

--สาขา[=รูปแบบ], --แท็ก[=รูปแบบ], --รีโมท[=รูปแบบ]
แสดงสาขา แท็ก หรือสาขาการติดตามระยะไกลทั้งหมด ตามลำดับ (เช่น พบการอ้างอิง
ใน refs/heads, refs/tags หรือ refs/remotes ตามลำดับ)

หากกำหนดรูปแบบไว้ จะแสดงเฉพาะการอ้างอิงที่ตรงกับ shell glob ที่กำหนด ถ้า
รูปแบบไม่มีอักขระลูกโลก (?, * หรือ [) จะกลายเป็นคำนำหน้า
จับคู่โดยการต่อท้าย /*

--glob=รูปแบบ
แสดงการอ้างอิงทั้งหมดที่ตรงกับรูปแบบเชลล์โกลบอล ถ้ารูปแบบไม่เริ่ม
ด้วย refs/ สิ่งนี้จะถูกนำหน้าโดยอัตโนมัติ หากรูปแบบไม่มี a
อักขระลูกโลก (?, * หรือ [) จะกลายเป็นการจับคู่คำนำหน้าโดยการต่อท้าย /*

--exclude=
ไม่รวมผู้อ้างอิงที่ตรงกัน ที่ต่อไป --ทั้งหมด --สาขา --tags,
--remotes หรือ --glob จะพิจารณาเป็นอย่างอื่น การทำซ้ำของตัวเลือกนี้สะสม
รูปแบบการยกเว้นขึ้นไป --all, --branches, --tags, --remotes หรือ --glob
ตัวเลือก (ตัวเลือกหรือข้อโต้แย้งอื่น ๆ ไม่ชัดเจนรูปแบบสะสม)

รูปแบบที่กำหนดไม่ควรเริ่มต้นด้วย refs/heads, refs/tags หรือ refs/remotes เมื่อ
นำไปใช้กับ --branches, --tags หรือ --remotes ตามลำดับ และต้องขึ้นต้นด้วย
refs/ เมื่อใช้กับ --glob หรือ --all ถ้าตามหลัง /* ตั้งใจไว้ก็ต้องให้
อย่างชัดเจน

--disambiguate=
แสดงทุกอ็อบเจ็กต์ที่มีชื่อขึ้นต้นด้วยคำนำหน้าที่กำหนด ดิ ต้องอยู่ที่
เลขฐานสิบหกอย่างน้อย 4 หลักเพื่อหลีกเลี่ยงการแสดงรายการแต่ละรายการใน
ที่เก็บโดยไม่ได้ตั้งใจ

Options for ไฟล์
--local-env-vars
แสดงรายการตัวแปรสภาพแวดล้อม GIT_* ที่อยู่ในพื้นที่เก็บข้อมูล (เช่น GIT_DIR หรือ
GIT_WORK_TREE แต่ไม่ใช่ GIT_EDITOR) ระบุเฉพาะชื่อของตัวแปรเท่านั้น ไม่ใช่
ค่าของมันแม้ว่าจะถูกกำหนดไว้แล้วก็ตาม

--git-dir
แสดง $GIT_DIR หากกำหนดไว้ หรือแสดงพาธไปยังไดเร็กทอรี .git เส้นทาง
แสดง เมื่อสัมพันธ์กัน จะสัมพันธ์กับไดเร็กทอรีการทำงานปัจจุบัน

หากไม่ได้กำหนด $GIT_DIR และไม่พบไดเร็กทอรีปัจจุบันว่าอยู่ใน Git
ที่เก็บหรือแผนผังงานพิมพ์ข้อความไปยัง stderr และออกด้วยสถานะที่ไม่ใช่ศูนย์

--git-ทั่วไป-dir
แสดง $GIT_COMMON_DIR หากกำหนดไว้ มิฉะนั้น $GIT_DIR

--is-inside-git-dir
เมื่อไดเร็กทอรีการทำงานปัจจุบันอยู่ด้านล่างไดเร็กทอรีที่เก็บพิมพ์ "จริง"
มิฉะนั้น "เท็จ"

--is-ภายในต้นไม้งาน
เมื่อไดเร็กทอรีการทำงานปัจจุบันอยู่ภายในแผนผังการทำงานของที่เก็บ print
"จริง" หรือ "เท็จ"

--is-พื้นที่เก็บข้อมูลเปล่า
เมื่อพื้นที่เก็บข้อมูลว่างเปล่าให้พิมพ์ "จริง" มิฉะนั้น "เท็จ"

--resolve-git-dir
ตรวจสอบว่า เป็นที่เก็บที่ถูกต้องหรือ gitfile ที่ชี้ไปที่ที่เก็บที่ถูกต้อง
และพิมพ์ตำแหน่งของที่เก็บ ถ้า เป็น gitfile แล้วแก้ไข
มีการพิมพ์พาธไปยังที่เก็บจริง

--git-เส้นทาง
แก้ไข "$GIT_DIR/ " และรับตัวแปรการโยกย้ายพาธอื่นๆ เช่น
$GIT_OBJECT_DIRECTORY, $GIT_INDEX_FILE... เข้าบัญชี ตัวอย่างเช่น if
$GIT_OBJECT_DIRECTORY ถูกตั้งค่าเป็น /foo/bar จากนั้น "git rev-parse --git-path object/abc"
ส่งคืน /foo/bar/abc.js

--show-cdup
เมื่อคำสั่งถูกเรียกใช้จากไดเร็กทอรีย่อย ให้แสดงพาธของระดับบนสุด
ไดเร็กทอรีที่สัมพันธ์กับไดเร็กทอรีปัจจุบัน (โดยทั่วไปจะเป็นลำดับของ "../" หรือ an
สตริงว่าง)

--show-คำนำหน้า
เมื่อคำสั่งถูกเรียกใช้จากไดเร็กทอรีย่อย ให้แสดงพาธของ current
ไดเร็กทอรีที่สัมพันธ์กับไดเร็กทอรีระดับบนสุด

--show-ระดับบนสุด
แสดงพาธสัมบูรณ์ของไดเร็กทอรีระดับบนสุด

--shared-index-เส้นทาง
แสดงพาธไปยังไฟล์ดัชนีที่ใช้ร่วมกันในโหมดแยกดัชนี หรือเว้นว่างไว้หากไม่ใช่ใน
โหมดแยกดัชนี

อื่นๆ Options
--since=datestring, --หลัง=datestring
แยกวิเคราะห์สตริงวันที่และส่งออกพารามิเตอร์ --max-age= ที่สอดคล้องกันสำหรับ คอมไพล์
รายการรอบ.

--จนถึง=วันที่สตริง --ก่อน=วันที่สตริง
แยกวิเคราะห์สตริงวันที่และส่งออกพารามิเตอร์ --min-age= ที่สอดคล้องกันสำหรับ คอมไพล์
รายการรอบ.

...
แฟล็กและพารามิเตอร์ที่จะแยกวิเคราะห์

การระบุ การแก้ไข

พารามิเตอร์การแก้ไข โดยทั่วไป แต่ไม่จำเป็นต้องตั้งชื่อวัตถุกระทำ มันใช้
สิ่งที่เรียกว่า อัน ขยาย SHA-1 ไวยากรณ์ ต่อไปนี้เป็นวิธีต่างๆ ในการสะกดชื่อวัตถุ ดิ
รายการที่อยู่ท้ายรายการชื่อต้นไม้และ blobs ที่มีอยู่ในการคอมมิต

, เช่น dae86e1950b1277e545cee180551750029cfe735, แด86อี
ชื่ออ็อบเจ็กต์ SHA-1 แบบเต็ม (สตริงเลขฐานสิบหก 40 ไบต์) หรือสตริงย่อยนำหน้าซึ่ง
เป็นเอกลักษณ์ภายในที่เก็บ เช่น dae86e1950b1277e545cee180551750029cfe735 และ
dae86e ทั้งสองตั้งชื่ออ็อบเจกต์คอมมิทเดียวกันหากไม่มีอ็อบเจกต์อื่นในที่เก็บของคุณ
ซึ่งชื่อวัตถุขึ้นต้นด้วย dae86e

, เช่น v1.7.4.2-679-g3bee7fb
เอาต์พุตจาก git อธิบาย; คือแท็กที่ใกล้เคียงที่สุด ตามด้วยเครื่องหมายขีดคั่นและ a
จำนวนคอมมิชชัน ตามด้วย dash, a gและชื่ออ็อบเจ็กต์แบบย่อ

, เช่น เจ้านาย, หัวหน้า/อาจารย์, กรรมการ/หัวหน้า/อาจารย์
ชื่ออ้างอิงเชิงสัญลักษณ์ เช่น เจ้านาย โดยทั่วไปหมายถึงวัตถุกระทำที่อ้างอิงโดย
กรรมการ/หัวหน้า/อาจารย์. หากคุณมีทั้งสองอย่าง หัวหน้า/อาจารย์ และ Tags/master, คุณสามารถ
พูดอย่างชัดเจน หัวหน้า/อาจารย์ เพื่อบอก Git ว่าคุณหมายถึงอะไร เมื่อคลุมเครือ a
จะแก้ความกำกวมโดยการจับคู่นัดแรกในกฎต่อไปนี้:

1 ถ้า $GIT_DIR/ มีอยู่ นั่นคือสิ่งที่คุณหมายถึง (ซึ่งมักจะมีประโยชน์เท่านั้น
for HEAD, FETCH_HEAD, ORIG_HEAD, MERGE_HEAD และ CHERRY_PICK_HEAD);

2. มิฉะนั้น ผู้อ้างอิง/ ถ้ามันมีอยู่;

3. มิฉะนั้น อ้างอิง/แท็ก/ ถ้ามันมีอยู่;

4. มิฉะนั้น กรรมการ/หัวหน้า/ ถ้ามันมีอยู่;

5. มิฉะนั้น อ้างอิง/รีโมท/ ถ้ามันมีอยู่;

6. มิฉะนั้น อ้างอิง/รีโมท/ /ศีรษะ ถ้ามันมีอยู่

HEAD ตั้งชื่อคอมมิตที่คุณยึดตามการเปลี่ยนแปลงในแผนผังการทำงาน
FETCH_HEAD บันทึกสาขาที่คุณดึงมาจากที่เก็บระยะไกลด้วย your
คำสั่ง git ดึงข้อมูลล่าสุด ORIG_HEAD ถูกสร้างขึ้นโดยคำสั่งที่ย้ายของคุณ HEAD
ในทางที่รุนแรงเพื่อบันทึกตำแหน่งของ HEAD ก่อนดำเนินการ ดังนั้น
ที่คุณสามารถเปลี่ยนปลายกิ่งให้กลับเป็นเหมือนเดิมได้ก่อนวิ่ง
พวกเขา MERGE_HEAD บันทึกการกระทำที่คุณกำลังรวมเข้ากับสาขาของคุณ
เมื่อคุณเรียกใช้ git merge CHERRY_PICK_HEAD บันทึกการกระทำที่คุณเป็น
การเลือกเชอร์รี่เมื่อคุณเรียกใช้ git cherry-pick

โปรดทราบว่า ผู้อ้างอิง/* กรณีข้างต้นอาจมาจาก $GIT_DIR/อ้างอิง
ไดเรกทอรีหรือจาก $GIT_DIR/แพ็คอ้างอิง ไฟล์. ในขณะที่การเข้ารหัสชื่อผู้อ้างอิงคือ
ไม่ระบุ แนะนำให้ใช้ UTF-8 เนื่องจากการประมวลผลเอาต์พุตบางอย่างอาจถือว่าชื่ออ้างอิงเป็น
UTF-8

@
@ เพียงอย่างเดียวคือทางลัดสำหรับ HEAD.

@{ }, เช่น มาสเตอร์@{เมื่อวาน}, หัวหน้า@{5 นาที ที่ผ่านมา}
ผู้อ้างอิงตามด้วยคำต่อท้าย @ พร้อมระบุวันที่ในวงเล็บปีกกา
(เช่น {เมื่อวาน}, {1 เดือน 2 สัปดาห์ที่ผ่านมา 3 วัน 1 ชั่วโมง 1 ที่สอง ที่ผ่านมา} or {1979-02-26
18:30:00}) ระบุมูลค่าของผู้อ้างอิง ณ เวลาก่อนหน้า คำต่อท้ายนี้อาจ
ใช้ต่อจากชื่อผู้อ้างอิงเท่านั้นและผู้อ้างอิงจะต้องมีบันทึกอยู่
($GIT_DIR/บันทึก/). โปรดทราบว่าสิ่งนี้จะค้นหาสถานะของ .ของคุณ ในประเทศ อ้างอิงที่กำหนด
เวลา; เช่น สิ่งที่อยู่ในท้องถิ่นของคุณ เจ้านาย สาขาเมื่ออาทิตย์ที่แล้ว ถ้าต้องการดู
กระทำในช่วงเวลาใดเวลาหนึ่ง ดู --ตั้งแต่ และ --จนกระทั่ง.

@{ }, เช่น มาสเตอร์@{1}
ผู้อ้างอิงตามด้วยคำต่อท้าย @ โดยมีข้อกำหนดลำดับที่อยู่ในวงเล็บปีกกา
(เช่น 1 {}, 15 {}) ระบุค่าก่อนหน้าที่ n ของการอ้างอิงนั้น ตัวอย่างเช่น มาสเตอร์@{1}
เป็นค่าก่อนหน้าทันทีของ เจ้านาย ในขณะที่ มาสเตอร์@{5} เป็นค่าก่อนหน้าที่ 5 ของ
เจ้านาย. คำต่อท้ายนี้ใช้ได้เฉพาะต่อจากชื่อผู้อ้างอิงและผู้อ้างอิงเท่านั้น
มีบันทึกที่มีอยู่ ($GIT_DIR/บันทึก/).

@{ }, เช่น @{1}
คุณสามารถใช้ @ สร้างด้วยส่วนอ้างอิงที่ว่างเปล่าเพื่อรับรายการ reflog ของ
สาขาปัจจุบัน. ตัวอย่างเช่น หากคุณอยู่ในสาขา blabla แล้วก็ @{1} หมายถึงเช่นเดียวกับ
บลาบลา@{1}.

@{- }, เช่น @{-1}
โครงสร้าง @{- } หมายถึง th สาขา/commit เช็คเอาท์ก่อนปัจจุบัน
หนึ่ง.

@{ต้นน้ำ}, เช่น มาสเตอร์@{ต้นน้ำ}, @{ยู}
คำต่อท้าย @{ต้นน้ำ} เป็นชื่อสาขา (แบบย่อ @{ยู}) หมายถึง
สาขาที่สาขาที่ระบุโดยชื่อสาขาถูกตั้งค่าให้สร้างบน (configured
กับสาขา. .remote และสาขา .ผสาน). ชื่อสาขาที่หายไปมีค่าเริ่มต้นเป็น
อันปัจจุบัน

@{ดัน}, เช่น มาสเตอร์@{ดัน}, @{ดัน}
คำต่อท้าย @{ดัน} รายงานสาขา "ที่เราจะกดไปที่" หากมีการเรียกใช้ git push
ขณะเช็คชื่อสาขา (หรือปัจจุบัน HEAD หากไม่มีการระบุชื่อสาขา)
เนื่องจากปลายทางการพุชของเราอยู่ในที่เก็บระยะไกล เราจึงรายงานท้องถิ่น
ติดตามสาขาที่สอดคล้องกับสาขานั้น (เช่นบางสิ่งบางอย่างใน อ้างอิง/รีโมท/).

นี่คือตัวอย่างเพื่อให้ชัดเจนยิ่งขึ้น:

$ git config push.default ปัจจุบัน
$ git config remote.pushdefault myfork
$ git เช็คเอาต์ -b mybranch origin/master

$ git rev-parse -- symbolic-full-name @{อัปสตรีม}
อ้างอิง / รีโมท / ต้นทาง / master

$ git rev-parse -- symbolic-full-name @{push}
อ้างอิง/รีโมท/myfork/mybranch

สังเกตในตัวอย่างที่เราตั้งค่าเวิร์กโฟลว์สามเหลี่ยมที่เราดึงจากหนึ่ง
ตำแหน่งและกดไปที่อื่น ในเวิร์กโฟลว์ที่ไม่ใช่รูปสามเหลี่ยม @{ดัน} เป็นเช่นเดียวกับ
@{ต้นน้ำ}และไม่มีความจำเป็นใดๆ

^, เช่น หัว^, เวอร์ชัน 1.5.1^0
คำต่อท้าย ^ กับพารามิเตอร์การแก้ไขหมายถึงพาเรนต์แรกของอ็อบเจกต์ที่คอมมิตนั้น ^
หมายถึง ผู้ปกครองที่ (เช่น ^ เทียบเท่ากับ ^1). ตามกฎพิเศษคือ
^0 หมายถึงการคอมมิทเองและใช้เมื่อ เป็นชื่อวัตถุของแท็ก
วัตถุที่อ้างถึงวัตถุกระทำ

~, เช่น อาจารย์~3
คำต่อท้าย ~ พารามิเตอร์การแก้ไขหมายถึงอ็อบเจกต์การคอมมิตที่เป็น ไทย
บรรพบุรุษรุ่นของอ็อบเจกต์ commit ที่มีชื่อ ต่อจากพาเรนต์แรกเท่านั้น เช่น
~3 เทียบเท่ากับ ^^^ ซึ่งเทียบเท่ากับ ^1^1^1. ดูด้านล่างสำหรับ an
ภาพประกอบการใช้แบบฟอร์มนี้

^{ }, เช่น v0.99.8^{ตกลง}
คำต่อท้าย ^ ตามด้วยชื่อประเภทวัตถุที่อยู่ในวงเล็บปีกกา หมายถึง dereference
วัตถุที่ ซ้ำๆ จนเป็นวัตถุประเภท ถูกพบหรือวัตถุ
ไม่สามารถเพิกเฉยได้อีกต่อไป (ในกรณีนี้คือ barf) ตัวอย่างเช่น if คือ
กระทำ-ish, ^{มุ่งมั่น} อธิบายวัตถุกระทำที่สอดคล้องกัน ในทำนองเดียวกัน ถ้า
เป็นต้นไม้ ^{ต้นไม้} อธิบายวัตถุต้นไม้ที่เกี่ยวข้อง ^0 is
อักษรย่อสำหรับ ^{มุ่งมั่น}.

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

รอบ^{tag} สามารถใช้เพื่อให้มั่นใจว่า การหมุนรอบ ระบุวัตถุแท็กที่มีอยู่

^{}, เช่น เวอร์ชัน 0.99.8^{}
คำต่อท้าย ^ ตามด้วยวงเล็บปีกกาว่างหมายความว่าวัตถุอาจเป็นแท็กและ
ยกเลิกการอ้างอิงแท็กซ้ำๆ จนกว่าจะพบวัตถุที่ไม่ใช่แท็ก

^{/ }, เช่น หัว^{/แก้ไข น่ารังเกียจ ข้อผิดพลาด}
คำต่อท้าย ^ ไปยังพารามิเตอร์การแก้ไข ตามด้วยวงเล็บปีกกาที่มีข้อความled
โดยเครื่องหมายทับ เหมือนกับ :/แก้ไข น่ารังเกียจ ข้อผิดพลาด ไวยากรณ์ด้านล่างยกเว้นว่าจะส่งกลับ
คอมมิตการจับคู่ที่อายุน้อยที่สุดซึ่งสามารถเข้าถึงได้จาก ก่อน ^.

:/, เช่น :/แก้ไข น่ารังเกียจ ข้อผิดพลาด
โคลอน ตามด้วยเครื่องหมายทับ ตามด้วยข้อความ ตั้งชื่อคอมมิตที่มีข้อความคอมมิต
ตรงกับนิพจน์ทั่วไปที่ระบุ ชื่อนี้ส่งคืนการจับคู่ที่อายุน้อยที่สุด
กระทำซึ่งสามารถเข้าถึงได้จากผู้อ้างอิงใด ๆ หากข้อความยืนยันขึ้นต้นด้วย a ! เธอ
ต้องย้ำว่า; ลำดับพิเศษ -ตามด้วยอย่างอื่นที่ไม่ใช่ !, เป็น
สงวนไว้สำหรับตอนนี้ นิพจน์ทั่วไปสามารถจับคู่ส่วนใดก็ได้ของข้อความยืนยัน ถึง
จับคู่ข้อความที่ขึ้นต้นด้วยสตริง สามารถใช้เช่น :/^ฟู.

:, เช่น หัว:README, :README, มาสเตอร์:./README
คำต่อท้าย : ตามด้วยชื่อเส้นทาง blob หรือ tree ตามเส้นทางที่กำหนดใน tree-ish
วัตถุที่ตั้งชื่อโดยส่วนที่อยู่หน้าเครื่องหมายทวิภาค :เส้นทาง (มีส่วนว่างก่อน
โคลอน) เป็นกรณีพิเศษของไวยากรณ์ที่อธิบายไว้ถัดไป: เนื้อหาที่บันทึกในดัชนี
ตามเส้นทางที่กำหนด เส้นทางที่ขึ้นต้นด้วย ./ or ../ สัมพันธ์กับการทำงานในปัจจุบัน
ไดเร็กทอรี เส้นทางที่กำหนดจะถูกแปลงให้สัมพันธ์กับรากของต้นไม้ทำงาน
ไดเร็กทอรี สิ่งนี้มีประโยชน์มากที่สุดในการจัดการกับหยดหรือทรีจากการคอมมิตหรือทรีที่
มีโครงสร้างแบบต้นไม้เดียวกับต้นไม้ทำงาน

: :, เช่น :0:README, :README
ทวิภาค ตามด้วยหมายเลขสเตจ (0 ถึง 3) และโคลอน ตามด้วย a
เส้นทาง ตั้งชื่อวัตถุหยดในดัชนีที่เส้นทางที่กำหนด หมายเลขสเตจที่ขาดหายไป (และ
โคลอนที่ตามมา) ตั้งชื่อรายการสเตจ 0 ในระหว่างการรวม ระยะที่ 1 คือ
บรรพบุรุษร่วมกัน ระยะที่ 2 เป็นเวอร์ชันของสาขาเป้าหมาย (โดยทั่วไปคือปัจจุบัน
แบรนช์) และสเตจ 3 เป็นเวอร์ชันจากแบรนช์ที่กำลังจะถูกรวมเข้าด้วยกัน

นี่คือภาพประกอบโดย Jon Loeliger ทั้งคอมมิทโหนด B และ C เป็นพาเรนต์ของคอมมิท
โหนด A การคอมมิทของพาเรนต์จะถูกเรียงลำดับจากซ้ายไปขวา

กิจจิ
-
DEF
- -
- -
-
ก่อนคริสต์ศักราช
-
-
A

ก = = ก^0
ข = ก^ = ก^1 = ก~1
ค = ก^2 = ก^2
ง = ก^^ = ก^1^1 = ก~2
จ = ข^2 = ก^2
ฉ = ข^3 = ก^3
ก = ก^^ = ก^1^1^1 = ก~3
เอช = ดี^2 = ข^^2 = เอ^^^2 = เอ~2^2
ฉัน = F^ = B^3^ = A^^3^
J = F^2 = B^3^2 = A^3^2

การระบุ ช่วง R

คำสั่งการสำรวจประวัติ เช่น บันทึก git ทำงานบนชุดของคอมมิต ไม่ใช่แค่คำสั่งเดียว
ให้สัญญา. สำหรับคำสั่งเหล่านี้ การระบุการแก้ไขครั้งเดียวด้วยสัญกรณ์ที่อธิบายไว้ใน
ส่วนก่อนหน้า หมายถึง ชุดของการคอมมิตที่เข้าถึงได้จากการคอมมิตนั้น ต่อจากคอมมิต
ห่วงโซ่บรรพบุรุษ

เพื่อแยกการคอมมิตที่เข้าถึงได้จากการคอมมิต คำนำหน้า ^ มีการใช้สัญกรณ์ เช่น ^r1 r2 วิธี
สัญญาที่เข้าถึงได้จาก r2 แต่ยกเว้นสิ่งที่เข้าถึงได้จาก r1.

การดำเนินการชุดนี้ปรากฏขึ้นบ่อยครั้งจนมีการจดชวเลข เมื่อคุณมีสอง
มุ่งมั่น r1 และ r2 (ตั้งชื่อตามไวยากรณ์ที่อธิบายไว้ใน SPECIFYING REVISIONS ด้านบน)
คุณสามารถขอคอมมิตที่สามารถเข้าถึงได้จาก r2 ยกเว้นที่สามารถเข้าถึงได้จาก
r1 โดย ^r1 r2 และสามารถเขียนได้เป็น r1..r2.

สัญกรณ์ที่คล้ายกัน ร1...ร2 เรียกว่าผลต่างสมมาตรของ r1 และ r2 และถูกกำหนดเป็น
r1 r2 --ไม่ $(git รวมฐาน --ทั้งหมด r1 r2). เป็นชุดของการคอมมิตที่เข้าถึงได้
จากอย่างใดอย่างหนึ่งของ r1 or r2 แต่ไม่ใช่จากทั้งสองอย่าง

ในชวเลขทั้งสองนี้ คุณสามารถละเว้นปลายด้านหนึ่งและปล่อยให้ค่าเริ่มต้นเป็น HEAD ตัวอย่างเช่น,
ต้นทาง.. เป็นชวเลขสำหรับ ที่มา..HEAD และถามว่า "ฉันทำอะไรตั้งแต่แยกจาก
สาขาต้นทาง" ในทำนองเดียวกัน ..ต้นทาง เป็นชวเลขสำหรับ หัว..ที่มา และถามว่า "อะไรที่ทำ
กำเนิดทำตั้งแต่ฉันแยกจากพวกเขาหรือไม่" สังเกตว่า .. จะหมายถึง หัว..หัว ที่ว่างเปล่า
ช่วงที่เข้าถึงได้และไม่สามารถเข้าถึงได้จาก HEAD

อีกสองชวเลขสำหรับการตั้งชื่อชุดที่เกิดจากการกระทำและการกระทำของผู้ปกครอง
มีอยู่. NS ร1^@ สัญกรณ์หมายถึงผู้ปกครองทั้งหมดของ r1. ร1^! รวมค่าคอมมิชชัน r1 แต่ไม่รวมทั้งหมด
ของพ่อแม่ของมัน

เพื่อสรุป:


รวมคอมมิตที่สามารถเข้าถึงได้จาก (เช่น บรรพบุรุษของ) .

^
ไม่รวมคอมมิตที่สามารถเข้าถึงได้จาก (เช่น บรรพบุรุษของ) .

..
รวมคอมมิตที่สามารถเข้าถึงได้จาก แต่ยกเว้นที่เข้าถึงได้
จาก . เมื่อทั้ง หรือ ถูกละไว้ ค่าเริ่มต้นคือ HEAD.

...
รวมคอมมิตที่สามารถเข้าถึงได้จากทั้ง หรือ แต่ไม่รวมผู้ที่
สามารถเข้าถึงได้จากทั้งสอง เมื่อทั้ง หรือ ถูกละไว้ ค่าเริ่มต้นคือ HEAD.

^@, เช่น หัว^@
คำต่อท้าย ^ ตามด้วยเครื่องหมาย at เหมือนกับรายการผู้ปกครองทั้งหมดของ
(หมายถึง รวมทุกอย่างที่เข้าถึงได้จากผู้ปกครอง แต่ไม่ใช่ตัวกระทำเอง)

^!, เช่น หัว^!
คำต่อท้าย ^ ตามด้วยเครื่องหมายตกใจเหมือนกับให้กระทำ แล้วก็
ผู้ปกครองทั้งหมดนำหน้าด้วย ^ เพื่อแยกพวกเขา (และบรรพบุรุษของพวกเขา)

ต่อไปนี้คือตัวอย่างบางส่วน:

DGHD
DFGHIJDF
^GDHD
^DBEJFB
ข..CC
B...CGHDEBC
^DBCEIJFBC
CIJFC
C^@ IJF
ค^! ค
ฟ^! DGHDF

พาร์ซอปต์

ในโหมด --parseopt คอมไพล์ รอบแยกวิเคราะห์ ช่วยให้ตัวเลือกการนวดเพื่อนำไปใช้กับเชลล์สคริปต์
สิ่งอำนวยความสะดวกแบบเดียวกันกับ C builtins มันทำงานเป็นออปชั่นนอร์มัลไลเซอร์ (เช่น splits single
สลับค่ารวม) คล้ายกับ รับ(1) ทำ

ใช้อินพุตมาตรฐานในข้อกำหนดของตัวเลือกเพื่อแยกวิเคราะห์และทำความเข้าใจ
และสะท้อนเอาต์พุตมาตรฐานเป็นสตริงที่เหมาะสมสำหรับ sh(1) ประเมินเพื่อแทนที่
อาร์กิวเมนต์กับคนที่ทำให้เป็นมาตรฐาน ในกรณีที่เกิดข้อผิดพลาด จะแสดงผลการใช้งานบนข้อผิดพลาดมาตรฐาน
สตรีมและออกด้วยรหัส 129

หมายเหตุ: ตรวจสอบให้แน่ใจว่าคุณอ้างอิงผลลัพธ์เมื่อส่งต่อไปยัง eval ดูตัวอย่างด้านล่าง

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

ตัวเลือกแต่ละบรรทัดมีรูปแบบดังนี้:

* ? SP+ ช่วย LF


รูปแบบของมันคืออักขระตัวเลือกแบบสั้น จากนั้นชื่อตัวเลือกแบบยาวคั่นด้วย a
จุลภาค ไม่จำเป็นต้องใช้ทั้งสองส่วน แต่อย่างน้อยก็จำเป็นอย่างน้อยหนึ่งส่วน อาจไม่มี
ใด ๆ ของ ตัวอักษร h,help, dry-run และ f เป็นตัวอย่างที่ถูกต้อง
.


เป็นของ *, =, ? หรือ !.

· ใช้ = ถ้าตัวเลือกใช้อาร์กิวเมนต์

· ใช้ ? หมายความว่าตัวเลือกใช้อาร์กิวเมนต์ที่เป็นทางเลือก คุณอาจต้องการ
ใช้โหมด --stuck-long เพื่อให้สามารถแยกวิเคราะห์อาร์กิวเมนต์ที่ไม่บังคับได้อย่างชัดเจน

· ใช้ * เพื่อหมายความว่าตัวเลือกนี้ไม่ควรแสดงรายการในการใช้งานที่สร้างขึ้นสำหรับ
-h อาร์กิวเมนต์ มันแสดงสำหรับ --help-all ตามที่ระบุไว้ใน gitcli(7)

· ใช้ ! เพื่อไม่ให้มีตัวเลือกยาวที่ถูกปฏิเสธที่เกี่ยวข้อง


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

ส่วนที่เหลือของบรรทัดหลังจากลอกช่องว่างจะใช้เป็นตัวช่วยที่เกี่ยวข้องกับ
ทางเลือก.

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

ตัวอย่าง
OPTS_SPEC="\
คำสั่งบางอย่าง [ตัวเลือก] ...

บางคำสั่งทำ foo และบาร์!
--
h ช่วยแสดงความช่วยเหลือ

foo บางตัวเลือกที่ดี --foo
bar= ตัวเลือกเจ๋ง ๆ --bar พร้อมอาร์กิวเมนต์
baz=arg อีกตัวเลือกที่ยอดเยี่ยม --baz พร้อมอาร์กิวเมนต์ที่มีชื่อ
qux?path qux อาจใช้อาร์กิวเมนต์ของเส้นทาง แต่มีความหมายโดยตัวมันเอง

ส่วนหัวของกลุ่มตัวเลือก
ค? ตัวเลือก C พร้อมอาร์กิวเมนต์เสริม"

eval "$(echo "$OPTS_SPEC" | git rev-parse --parseopt -- "$@" || echo exit $?)"

การใช้ ข้อความ
เมื่อ "$@" เป็น -h หรือ --help ในตัวอย่างข้างต้น ข้อความการใช้งานต่อไปนี้จะแสดงขึ้น:

การใช้งาน: บางคำสั่ง [ตัวเลือก] ...

บางคำสั่งทำ foo และบาร์!

-h, --help แสดงความช่วยเหลือ
--foo บางตัวเลือกที่ดี --foo
--bar ... ตัวเลือกที่ยอดเยี่ยม --bar พร้อมอาร์กิวเมนต์
--baz อีกตัวเลือกที่ยอดเยี่ยม --baz พร้อมอาร์กิวเมนต์ที่มีชื่อ
--qux[= ] qux อาจใช้อาร์กิวเมนต์เส้นทาง แต่มีความหมายโดยตัวมันเอง

ส่วนหัวของกลุ่มตัวเลือก
-C[...] ตัวเลือก C พร้อมอาร์กิวเมนต์เสริม

SQ-ใบเสนอราคา

ในโหมด --sq-quote คอมไพล์ รอบแยกวิเคราะห์ ก้องบนเอาต์พุตมาตรฐานบรรทัดเดียวเหมาะสำหรับ
sh(1) การประเมิน บรรทัดนี้สร้างขึ้นโดยการทำให้อาร์กิวเมนต์เป็นปกติตาม --sq-quote ไม่มีอะไร
นอกเหนือจากการอ้างอาร์กิวเมนต์เสร็จแล้ว

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

ตัวอย่าง
$ cat >your-git-script.sh <<\EOF
#!bin / sh /
args=$(git rev-parse --sq-quote "$@") # อ้างอาร์กิวเมนต์ที่ผู้ใช้จัดหา
command="git frotz -n24 $args" # และใช้ในงานฝีมือ
# บรรทัดคำสั่ง
eval "คำสั่ง $"
EOF

$ sh your-git-script.sh "a b'c"

ตัวอย่าง

· พิมพ์ชื่ออ็อบเจ็กต์ของการคอมมิตปัจจุบัน:

$ git rev-parse -- ตรวจสอบ HEAD

· พิมพ์ชื่ออ็อบเจ็กต์การคอมมิตจากการแก้ไขในตัวแปรเชลล์ $REV:

$ git rev-parse --ยืนยัน $REV^{commit}

สิ่งนี้จะเกิดข้อผิดพลาดหาก $REV ว่างเปล่าหรือไม่ใช่การแก้ไขที่ถูกต้อง

· คล้ายกับด้านบน:

$ git rev-parse --default master -- ตรวจสอบ $REV

แต่ถ้า $REV ว่างเปล่า ชื่ออ็อบเจ็กต์การคอมมิทจากมาสเตอร์จะถูกพิมพ์ออกมา

GIT

เป็นส่วนหนึ่งของ คอมไพล์(1) ห้องชุด

ใช้ git-rev-parse ออนไลน์โดยใช้บริการ onworks.net