git-rev-parse - Dalam talian dalam Awan

JADUAL:

NAMA

git-rev-parse - Pilih dan urut parameter

SINOPSIS

pergi huraian semula [ --pilihan ] ...

DESCRIPTION

Banyak arahan porselin Git mengambil campuran bendera (iaitu parameter yang bermula dengan a
dash -) dan parameter yang dimaksudkan untuk asas pergi senarai semula arahan yang mereka gunakan secara dalaman
dan bendera dan parameter untuk arahan lain yang mereka gunakan di hiliran pergi senarai semula. ini
perintah digunakan untuk membezakan antara mereka.

PILIHAN

Operasi Mod
Setiap pilihan ini mesti muncul dahulu pada baris arahan.

--parseopt
Penggunaan pergi huraian semula dalam mod penghuraian pilihan (lihat bahagian PARSEOPT di bawah).

--sq-quote
Penggunaan pergi huraian semula dalam mod petikan shell (lihat bahagian SQ-QUOTE di bawah). Berbeza dengan
pilihan --sq di bawah, mod ini hanya memetik. Tiada apa-apa lagi yang dilakukan untuk memerintah
input.

Pilihan Untuk --parseopt
--keep-dashdash
Hanya bermakna dalam mod --parseopt. Memberitahu penghurai pilihan untuk menggemakan yang pertama --
bertemu dan bukannya melangkaunya.

--berhenti-di-bukan-pilihan
Hanya bermakna dalam mod --parseopt. Benarkan penghurai pilihan berhenti pada mulanya
hujah bukan pilihan. Ini boleh digunakan untuk menghuraikan sub-perintah yang mengambil pilihan
diri sendiri.

--terperangkap-panjang
Hanya bermakna dalam mod --parseopt. Keluarkan pilihan dalam bentuk panjangnya jika
tersedia, dan dengan hujah mereka terperangkap.

Pilihan Untuk Penapisan
--revs-sahaja
Jangan keluarkan bendera dan parameter yang tidak dimaksudkan pergi senarai semula perintah.

--no-revs
Jangan keluarkan bendera dan parameter yang dimaksudkan untuk pergi senarai semula perintah.

--bendera
Jangan keluarkan parameter bukan bendera.

--tiada-bendera
Jangan keluarkan parameter bendera.

Pilihan Untuk Output
--lalai
Jika tiada parameter yang diberikan oleh pengguna, gunakan sebaliknya.

--awalan
Berkelakuan seolah-olah pergi huraian semula telah dipanggil daripada subdirektori kerja
pokok. Mana-mana nama fail relatif diselesaikan seolah-olah ia diawali oleh dan akan menjadi
dicetak dalam bentuk tersebut.

Ini boleh digunakan untuk menukar argumen kepada arahan yang dijalankan dalam subdirektori supaya ia
masih boleh digunakan selepas berpindah ke peringkat atas repositori. Sebagai contoh:

awalan=$(git rev-parse --show-prefix)
cd "$(git rev-parse --show-toplevel)"
eval "set -- $(git rev-parse --sq --prefix "$prefix" "$@")"

--sahkan
Sahkan bahawa betul-betul satu parameter disediakan dan ia boleh ditukar menjadi mentah
20-bait SHA-1 yang boleh digunakan untuk mengakses pangkalan data objek. Jika ya, pancarkan ke
keluaran standard; jika tidak, ralat keluar.

Jika anda ingin memastikan bahawa output sebenarnya menamakan objek dalam objek anda
pangkalan data dan/atau boleh digunakan sebagai jenis objek tertentu yang anda perlukan, anda boleh menambah
^{type} mengelupas operator kepada parameter. Contohnya, git rev-parse "$VAR^{commit}"
akan memastikan $VAR menamakan objek sedia ada yang merupakan commit-ish (iaitu komit, atau
teg beranotasi yang menunjuk pada komit). Untuk memastikan bahawa $VAR menamakan yang sedia ada
objek dari sebarang jenis, git rev-parse "$VAR^{object}" boleh digunakan.

-q, --senyap
Hanya bermakna dalam mod --verify. Jangan keluarkan mesej ralat jika hujah pertama
bukan nama objek yang sah; sebaliknya keluar dengan status bukan sifar secara senyap. SHA-1 untuk
nama objek yang sah dicetak untuk melihat kejayaan.

--persegi
Biasanya output dibuat satu baris setiap bendera dan parameter. Pilihan ini menjadikan output a
baris tunggal, dipetik dengan betul untuk penggunaan oleh shell. Berguna apabila anda mengharapkan anda
parameter untuk mengandungi ruang putih dan baris baharu (cth apabila menggunakan pickaxe -S dengan pergi
berbeza-*). Berbeza dengan pilihan --sq-quote, input arahan masih ditafsirkan
seperti biasa.

--bukan
Apabila menunjukkan nama objek, awalan dengan ^ dan jalur ^ awalan daripada nama objek
yang sudah mempunyai satu.

--abbrev-ref[=(ketat|longgar)]
Nama pendek bukan samar-samar bagi nama objek. Teras pilihan.warnAmbiguousRefs ialah
digunakan untuk memilih mod singkatan yang ketat.

--pendek, --pendek=nombor
Daripada mengeluarkan nilai SHA-1 penuh nama objek, cuba singkatkan nama objek tersebut
nama unik yang lebih pendek. Apabila tiada panjang dinyatakan 7 digunakan. Panjang minimum ialah 4.

--simbolik
Biasanya nama objek dikeluarkan dalam bentuk SHA-1 (dengan kemungkinan ^ awalan); ini
pilihan menjadikan mereka output dalam bentuk sehampir mungkin dengan input asal.

--simbolik-nama-penuh
Ini serupa dengan --simbolik, tetapi ia mengetepikan input yang bukan rujukan (iaitu cawangan atau
tag nama; atau lebih jelas nyahkekaburan borang "ketua/tuan", apabila anda mahu
namakan cawangan "master" apabila terdapat teg yang malangnya bernama "master"), dan tunjukkan
mereka sebagai nama semula penuh (cth "refs/heads/master").

Pilihan Untuk Objek
--semua
Tunjukkan semua rujukan yang terdapat dalam rujukan/.

--cawangan[=corak], --tag[=corak], --jauh[=corak]
Tunjukkan semua cawangan, teg, atau cawangan penjejakan jauh, masing-masing (iaitu, rujukan ditemui
dalam rujukan/kepala, rujukan/tag, atau rujukan/jarak jauh, masing-masing).

Jika corak diberikan, hanya rujukan yang sepadan dengan glob cangkerang yang diberikan ditunjukkan. Sekiranya
corak tidak mengandungi aksara globbing (?, *, atau [), ia ditukar menjadi awalan
padankan dengan menambahkan /*.

--glob=corak
Tunjukkan semua rujukan yang sepadan dengan corak corak glob shell. Jika corak tidak bermula
dengan refs/, ini ditambah secara automatik. Jika corak tidak mengandungi a
aksara globbing (?, *, atau [), ia ditukar menjadi padanan awalan dengan menambahkan /*.

--exclude=
Jangan sertakan rujukan yang sepadan bahawa seterusnya --semua, --cawangan, --tag,
--remotes, atau --glob sebaliknya akan mempertimbangkan. Pengulangan pilihan ini terkumpul
corak pengecualian sehingga seterusnya --semua, --cawangan, --tag, --jauh atau --glob
pilihan (pilihan atau hujah lain tidak mengosongkan corak terkumpul).

Corak yang diberikan tidak seharusnya bermula dengan rujukan/kepala, rujukan/tag, atau rujukan/jauh apabila
digunakan pada --cawangan, --tag, atau --remote, masing-masing, dan ia mesti bermula dengan
refs/ apabila digunakan pada --glob atau --semua. Jika mengekori /* diniatkan, mesti diberikan
secara eksplisit.

--nyahkekaburan=
Tunjukkan setiap objek yang namanya bermula dengan awalan yang diberikan. The mesti di
sekurang-kurangnya 4 digit perenambelasan panjang untuk mengelak daripada menyenaraikan setiap objek dalam
repositori secara tidak sengaja.

Pilihan Untuk Fail
--local-env-vars
Senaraikan pembolehubah persekitaran GIT_* yang setempat kepada repositori (cth GIT_DIR atau
GIT_WORK_TREE, tetapi bukan GIT_EDITOR). Hanya nama pembolehubah disenaraikan, tidak
nilai mereka, walaupun ia ditetapkan.

--git-dir
Tunjukkan $GIT_DIR jika ditakrifkan. Jika tidak tunjukkan laluan ke direktori .git. Jalan itu
ditunjukkan, apabila relatif, adalah relatif kepada direktori kerja semasa.

Jika $GIT_DIR tidak ditakrifkan dan direktori semasa tidak dikesan terletak dalam Git
repositori atau pokok kerja mencetak mesej ke stderr dan keluar dengan status bukan sifar.

--git-common-dir
Tunjukkan $GIT_COMMON_DIR jika ditakrifkan, jika tidak $GIT_DIR.

--is-inside-git-dir
Apabila direktori kerja semasa berada di bawah direktori repositori cetak "benar",
sebaliknya "palsu".

--adalah-dalam-pokok-kerja
Apabila direktori kerja semasa berada di dalam pepohon kerja cetakan repositori
"benar", sebaliknya "palsu".

--adalah-repositori kosong
Apabila repositori dicetak kosong "benar", sebaliknya "palsu".

--resolve-git-dir
Semak jika ialah repositori yang sah atau fail git yang menunjuk pada repositori yang sah,
dan cetak lokasi repositori. Jika ialah fail git maka diselesaikan
laluan ke repositori sebenar dicetak.

--git-path
Selesaikan "$GIT_DIR/ " dan mengambil pembolehubah penempatan semula laluan lain seperti
$GIT_OBJECT_DIRECTORY, $GIT_INDEX_FILE... ke dalam akaun. Sebagai contoh, jika
$GIT_OBJECT_DIRECTORY ditetapkan kepada /foo/bar kemudian "git rev-parse --git-path objects/abc"
mengembalikan /foo/bar/abc.

--tunjukkan-cdup
Apabila arahan itu dipanggil daripada subdirektori, tunjukkan laluan peringkat atas
direktori relatif kepada direktori semasa (biasanya urutan "../", atau an
rentetan kosong).

--tunjuk-awalan
Apabila arahan itu dipanggil daripada subdirektori, tunjukkan laluan semasa
direktori relatif kepada direktori peringkat atas.

--show-level atas
Tunjukkan laluan mutlak direktori peringkat atas.

--shared-index-path
Tunjukkan laluan ke fail indeks kongsi dalam mod indeks berpecah, atau kosongkan jika tidak masuk
mod indeks pecahan.

lain-lain Pilihan
--since=datestring, --after=datestring
Parsing rentetan tarikh, dan keluarkan parameter --max-age= yang sepadan untuk pergi
senarai semula.

--until=datestring, --before=datestring
Parsing rentetan tarikh, dan keluarkan parameter --min-age= yang sepadan untuk pergi
senarai semula.

...
Bendera dan parameter untuk dihuraikan.

MENYERTAI ULASAN

Parameter semakan biasanya, tetapi tidak semestinya, menamakan objek komit. Ia menggunakan
apa yang dipanggil an dilanjutkan SHA-1 sintaks. Berikut ialah pelbagai cara untuk mengeja nama objek. The
yang disenaraikan berhampiran penghujung senarai ini pepohon nama dan gumpalan yang terkandung dalam komit.

, contohnya dae86e1950b1277e545cee180551750029cfe735, dae86e
Nama objek SHA-1 penuh (rentetan perenambelasan 40-bait), atau subrentetan utama yang
adalah unik dalam repositori. Cth dae86e1950b1277e545cee180551750029cfe735 dan
dae86e kedua-duanya menamakan objek komit yang sama jika tiada objek lain dalam repositori anda
yang nama objeknya bermula dengan dae86e.

, contohnya v1.7.4.2-679-g3bee7fb
Output daripada git describe; iaitu teg terdekat, secara pilihan diikuti dengan sempang dan a
bilangan komitmen, diikuti dengan sengkang, a g, dan nama objek yang disingkatkan.

, contohnya master, ketua/guru, rujukan/ketua/guru
Nama rujukan simbolik. Cth master biasanya bermaksud objek komit yang dirujuk oleh
rujukan/ketua/guru. Jika anda mempunyai kedua-duanya ketua/guru and tag/master, Anda boleh
jelas berkata ketua/guru untuk memberitahu Git yang mana satu yang anda maksudkan. Apabila samar-samar, a
dinyahkekaburan dengan mengambil perlawanan pertama dalam peraturan berikut:

1. Jika $GIT_DIR/ wujud, itulah yang anda maksudkan (ini biasanya berguna sahaja
Untuk KETUA, FETCH_HEAD, ORIG_HEAD, MERGE_HEAD and CHERRY_PICK_HEAD);

2. jika tidak, rujuk/ jika ia wujud;

3. jika tidak, rujukan/tag/ jika ia wujud;

4. jika tidak, rujukan/kepala/ jika ia wujud;

5. jika tidak, rujukan/jarak jauh/ jika ia wujud;

6. jika tidak, rujukan/jarak jauh/ /KEPALA jika ia wujud.

KETUA menamakan komit yang anda mendasarkan perubahan dalam pokok kerja.
FETCH_HEAD merekodkan cawangan yang anda ambil dari repositori jauh dengan anda
invocation git fetch terakhir. ORIG_HEAD dicipta oleh arahan yang menggerakkan anda KETUA
secara drastik, untuk merekodkan kedudukan KETUA sebelum operasi mereka, jadi
bahawa anda boleh menukar hujung cawangan kembali ke keadaan dengan mudah sebelum anda berlari
Mereka. MERGE_HEAD merekodkan komitmen yang anda gabungkan ke dalam cawangan anda
apabila anda menjalankan git merge. CHERRY_PICK_HEAD merekodkan komitmen yang anda ada
memetik ceri apabila anda menjalankan git cherry-pick.

Ambil perhatian bahawa mana-mana rujuk/* kes di atas mungkin datang sama ada daripada $GIT_DIR/ref
direktori atau daripada $GIT_DIR/packed-refs fail. Manakala pengekodan nama ref ialah
tidak ditentukan, UTF-8 lebih disukai kerana sesetengah pemprosesan output mungkin menganggap nama rujukan masuk
UTF-8.

@
@ sahaja adalah jalan pintas untuk KETUA.

@{ }, contohnya master@{semalam}, KEPALA@{5 minit lalu}
Rujuk diikuti dengan akhiran @ dengan spesifikasi tarikh disertakan dalam sepasang pendakap
(contohnya {semalam}, {1 bulan 2 minggu 3 hari 1 jam 1 kedua lalu} or {1979-02-26
18:30:00}) menentukan nilai ref pada titik masa sebelumnya. Akhiran ini mungkin
hanya digunakan serta-merta mengikut nama rujukan dan rujukan mesti mempunyai log sedia ada
($GIT_DIR/log/). Ambil perhatian bahawa ini melihat keadaan anda tempatan ref pada yang diberikan
masa; cth, apa yang terdapat dalam tempatan anda master cawangan minggu lepas. Kalau nak tengok
komitmen yang dibuat pada masa-masa tertentu, lihat --sejak and --sehingga.

@{ }, contohnya tuan@{1}
Rujuk diikuti dengan akhiran @ dengan spesifikasi ordinal yang disertakan dalam pasangan pendakap
(contohnya 1 {}, 15 {}) menentukan nilai terdahulu ke-n bagi rujukan itu. Sebagai contoh tuan@{1}
ialah nilai terdahulu segera bagi master manakala tuan@{5} ialah nilai terdahulu ke-5 bagi
master. Akhiran ini hanya boleh digunakan sejurus selepas nama rujukan dan rujukan mesti
mempunyai log sedia ada ($GIT_DIR/log/).

@{ }, contohnya @{1}
Anda boleh menggunakan @ bina dengan bahagian ref kosong untuk mendapatkan entri reflog daripada
cawangan semasa. Sebagai contoh, jika anda berada di cawangan blabla kemudian @{1} bererti sama dengan
blabla@{1}.

@{- }, contohnya @{-1}
Konstruk @{- } bermakna cawangan/komit ke- telah diperiksa sebelum arus
one.

@{hulu}, contohnya master@{hulu}, @{u}
Akhiran itu @{hulu} kepada nama cawangan (bentuk pendek @{u}merujuk kepada
cawangan yang cawangan yang ditentukan oleh nama cawangan ditetapkan untuk dibina di atasnya (konfigurasi
dengan cawangan. .jauh dan cawangan. .gabung). Nama cawangan yang hilang ditetapkan secara lalai
yang semasa.

@{push}, contohnya tuan@{push}, @{tolak}
Akhiran itu @{tolak} melaporkan cawangan "di mana kami akan menolak ke" jika git push dijalankan
semasa nama cawangan telah diperiksa (atau semasa KETUA jika tiada nama cawangan dinyatakan).
Memandangkan destinasi tolakan kami berada dalam repositori jauh, sudah tentu, kami melaporkan setempat
menjejak cawangan yang sepadan dengan cawangan itu (iaitu, sesuatu dalam rujukan/jarak jauh/).

Berikut ialah contoh untuk menjadikannya lebih jelas:

$ git config push.default semasa
$ git config remote.pushdefault myfork
$ git checkout -b mybranch origin/master

$ git rev-parse --symbolic-full-name @{upstream}
refs/remote/origin/master

$ git rev-parse --symbolic-full-name @{push}
refs/remote/myfork/mybranch

Perhatikan dalam contoh bahawa kami menyediakan aliran kerja segi tiga, di mana kami menarik daripada satu
lokasi dan tolak ke tempat lain. Dalam aliran kerja bukan segi tiga, @{tolak} adalah sama seperti
@{hulu}, dan tidak perlu untuk itu.

^, contohnya KEPALA^, v1.5.1^0
Sufiks ^ kepada parameter semakan bermaksud induk pertama objek komit itu. ^
bermakna ibu bapa ke (cth ^ adalah bersamaan dengan ^1). Sebagai peraturan khas,
^0 bermakna komit itu sendiri dan digunakan apabila ialah nama objek tag
objek yang merujuk kepada objek komit.

~, contohnya tuan~3
Sufiks ~ kepada parameter semakan bermaksud objek komit iaitu ke
nenek moyang generasi objek komit yang dinamakan, hanya mengikut ibu bapa pertama. iaitu
~3 adalah bersamaan dengan ^^^ yang bersamaan dengan ^1^1^1. Lihat di bawah untuk
ilustrasi penggunaan borang ini.

^{ }, contohnya v0.99.8^{commit}
Sufiks ^ diikuti dengan nama jenis objek yang disertakan dalam pasangan pendakap bermaksud dereference
objek di secara rekursif sehingga objek jenis ditemui atau objek
tidak boleh dinyahrujuk lagi (dalam hal ini, barf). Sebagai contoh, jika ialah
komited, ^{commit} menerangkan objek komit yang sepadan. Begitu juga jika
adalah sejenis pokok, ^{pokok} menerangkan objek pokok yang sepadan. ^0 is
tangan pendek untuk ^{commit}.

rev^{objek} boleh digunakan untuk memastikan rev menamakan objek yang wujud, tanpa
memerlukan rev menjadi tag, dan tanpa merujuk rev; kerana tag sudah pun menjadi
objek, ia tidak perlu dinyahrujuk walaupun sekali untuk sampai ke objek.

rev^{tag} boleh digunakan untuk memastikan bahawa rev mengenal pasti objek teg sedia ada.

^{}, contohnya v0.99.8^{}
Sufiks ^ diikuti dengan pasangan pendakap kosong bermakna objek itu boleh menjadi tag, dan
nyahrujuk teg secara rekursif sehingga objek bukan teg ditemui.

^{/ }, contohnya HEAD^{/betulkan jahat pepijat}
Sufiks ^ kepada parameter semakan, diikuti dengan pasangan pendakap yang mengandungi teks yang dipimpin
dengan sebatan, adalah sama dengan :/menetapkan jahat pepijat sintaks di bawah kecuali ia mengembalikan
Komit padanan termuda yang boleh dicapai daripada sebelum ^.

:/, contohnya :/menetapkan jahat pepijat
Titik bertindih, diikuti dengan garis miring, diikuti dengan teks, menamakan komit yang mesej komitnya
sepadan dengan ungkapan biasa yang ditentukan. Nama ini mengembalikan padanan termuda
commit yang boleh dicapai daripada mana-mana rujukan. Jika mesej komit bermula dengan a ! anda
perlu mengulanginya; urutan khas :/!, diikuti dengan sesuatu yang lain daripada !, Adalah
dikhaskan buat masa ini. Ungkapan biasa boleh memadankan mana-mana bahagian mesej komit. Kepada
padankan mesej bermula dengan rentetan, seseorang boleh menggunakan cth :/^foo.

:, contohnya KETUA: BACA SAYA, :BACA SAYA, tuan:./README
Sufiks : diikuti dengan laluan menamakan gumpalan atau pokok pada laluan yang diberikan dalam tree-ish
objek yang dinamakan oleh bahagian sebelum kolon. :jalan (dengan bahagian kosong sebelum
kolon) ialah kes khas sintaks yang diterangkan seterusnya: kandungan yang direkodkan dalam indeks
pada laluan yang diberikan. Jalan yang bermula dengan ./ or ../ adalah relatif kepada kerja semasa
direktori. Laluan yang diberikan akan ditukar menjadi relatif kepada akar pokok kerja
direktori. Ini paling berguna untuk menangani gumpalan atau pokok daripada komit atau pokok itu
mempunyai struktur pokok yang sama dengan pokok kerja.

: :, contohnya :0:BACA SAYA, :BACA SAYA
Titik bertindih, secara pilihan diikuti dengan nombor peringkat (0 hingga 3) dan bertindih, diikuti dengan a
laluan, menamakan objek gumpalan dalam indeks pada laluan yang diberikan. Nombor peringkat yang hilang (dan
kolon yang mengikutinya) menamakan entri peringkat 0. Semasa penggabungan, peringkat 1 ialah
nenek moyang biasa, peringkat 2 ialah versi cawangan sasaran (biasanya versi semasa
cawangan), dan peringkat 3 ialah versi daripada cawangan yang sedang digabungkan.

Berikut adalah ilustrasi, oleh Jon Loeliger. Kedua-dua nod komit B dan C adalah ibu bapa komit
nod A. Komit ibu bapa disusun dari kiri ke kanan.

GHIJ
\ / \ /
DEF
\ | / \
\ | / |
\|/ |
BC
\ /
\ /
A

A = = A^0
B = A^ = A^1 = A~1
C = A^2 = A^2
D = A^^ = A^1^1 = A~2
E = B^2 = A^^2
F = B^3 = A^^3
G = A^^^ = A^1^1^1 = A~3
H = D^2 = B^^2 = A^^2 = A~2^2
I = F^ = B^3^ = A^^3^
J = F^2 = B^3^2 = A^^3^2

MENYERTAI PERINGKAT

Perintah merentasi sejarah seperti log git beroperasi pada satu set komit, bukan hanya satu
komited. Kepada arahan ini, menyatakan satu semakan dengan notasi yang diterangkan dalam
bahagian sebelumnya bermaksud set komit yang boleh dicapai daripada komit itu, selepas komit
rantai keturunan.

Untuk mengecualikan komit yang boleh dicapai daripada komit, awalan ^ notasi digunakan. Cth ^r1 r2 cara
melakukan boleh dicapai daripada r2 tetapi kecualikan yang boleh dicapai daripada r1.

Operasi set ini muncul begitu kerap sehingga terdapat singkatan untuknya. Apabila anda mempunyai dua
berkomitmen r1 and r2 (dinamakan mengikut sintaks yang dijelaskan dalam MENENTUKAN SEMAKAN di atas),
anda boleh meminta komitmen yang boleh dicapai daripada r2 tidak termasuk yang boleh dicapai daripada
r1 oleh ^r1 r2 dan ia boleh ditulis sebagai r1..r2.

Notasi yang serupa r1...r2 dipanggil perbezaan simetri bagi r1 and r2 dan ditakrifkan sebagai
r1 r2 --bukan $(git asas gabungan --semua r1 r2). Ia adalah set komitmen yang boleh dicapai
daripada salah satu daripada r1 or r2 tetapi bukan dari kedua-duanya.

Dalam dua trengkas ini, anda boleh meninggalkan satu hujung dan biarkan ia menjadi lalai kepada HEAD. Sebagai contoh,
asal usul.. adalah singkatan untuk asal..KEPALA dan bertanya "Apa yang saya lakukan sejak saya bercabang dari
cawangan asal?" Begitu juga, .. asal adalah singkatan untuk KEPALA..asal usul dan bertanya "Apa yang dilakukan
asal saya lakukan sejak saya bercabang daripada mereka?" Perhatikan itu .. bermaksud KEPALA..KEPALA yang kosong
julat yang boleh dicapai dan tidak boleh dicapai daripada HEAD.

Dua singkatan lain untuk menamakan set yang dibentuk oleh komit dan komit induknya
wujud. The r1^@ tatatanda bermaksud semua ibu bapa kepada r1. r1^! termasuk komit r1 tetapi tidak termasuk semua
daripada ibu bapanya.

Ringkasnya:


Sertakan komitmen yang boleh dicapai daripada (iaitu nenek moyang) .

^
Kecualikan komitmen yang boleh dicapai daripada (iaitu nenek moyang) .

..
Sertakan komitmen yang boleh dicapai daripada tetapi kecualikan yang boleh dicapai
daripada . Apabila sama ada atau ditinggalkan, ia lalai kepada KETUA.

...
Sertakan komitmen yang boleh dicapai daripada mana-mana atau tetapi tidak termasuk yang itu
boleh dicapai daripada kedua-duanya. Apabila sama ada atau ditinggalkan, ia lalai kepada KETUA.

^@, contohnya KEPALA^@
Sufiks ^ diikuti dengan tanda at adalah sama seperti menyenaraikan semua ibu bapa
(maksudnya, masukkan apa sahaja yang boleh dicapai daripada ibu bapanya, tetapi bukan komitmen itu sendiri).

^!, contohnya KEPALA^!
Sufiks ^ diikuti dengan tanda seru adalah sama dengan memberi komitmen dan kemudian
semua ibu bapanya diawali dengan ^ untuk mengecualikan mereka (dan nenek moyang mereka).

Berikut adalah segelintir contoh:

DGHD
DFGHIJDF
^GDHD
^DBEIJFB
B..CC
B...CGHDEBC
^DBCEIJFBC
CIJFC
C^@ IJF
C^! C
F^! DGHDF

PARSEOPT

Dalam mod --parseopt, pergi huraian semula membantu pilihan mengurut untuk membawa ke skrip shell
kemudahan yang sama C builtins mempunyai. Ia berfungsi sebagai penormal pilihan (cth splits single
menukar nilai agregat), sedikit seperti getopt(1) tidak.

Ia mengambil input standard spesifikasi pilihan untuk menghuraikan dan memahami,
dan bergema pada output standard rentetan yang sesuai untuk sh(1) eval untuk menggantikan
hujah dengan yang dinormalisasi. Sekiranya berlaku ralat, ia mengeluarkan penggunaan pada ralat standard
strim, dan keluar dengan kod 129.

Nota: Pastikan anda memetik keputusan apabila menghantarnya ke eval. Lihat di bawah untuk contoh.

Input format
pergi huraian semula --parseopt format input berasaskan teks sepenuhnya. Ia mempunyai dua bahagian, dipisahkan oleh
baris yang mengandungi hanya --. Garisan sebelum pemisah (sepatutnya satu atau lebih) ialah
digunakan untuk kegunaan. Garisan selepas pemisah menerangkan pilihan.

Setiap baris pilihan mempunyai format ini:

* ? SP+ membantu LF


formatnya ialah aksara pilihan pendek, kemudian nama pilihan panjang dipisahkan dengan a
koma. Kedua-dua bahagian tidak diperlukan, walaupun sekurang-kurangnya satu diperlukan. Tidak boleh mengandungi
mana-mana daripada watak. h,help, dry-run dan f ialah contoh betul
.


adalah daripada *, =, ? atau!.

· Gunakan = jika pilihan mengambil hujah.

· Gunakan ? bermakna bahawa pilihan mengambil hujah pilihan. Anda mungkin mahu
gunakan mod --stuck-long untuk dapat menghuraikan hujah pilihan dengan jelas.

· Gunakan * untuk bermaksud bahawa pilihan ini tidak harus disenaraikan dalam penggunaan yang dijana untuk
-h hujah. Ia ditunjukkan untuk --help-all seperti yang didokumenkan dalam gitcli(7).

· Gunakan ! untuk tidak menyediakan pilihan panjang dinafikan yang sepadan.


, jika dinyatakan, digunakan sebagai nama argumen dalam output bantuan, untuk
pilihan yang mengambil hujah. ditamatkan oleh ruang putih pertama. Ia adalah
lazim menggunakan tanda sempang untuk memisahkan perkataan dalam pembayang hujah berbilang perkataan.

Baki baris, selepas melucutkan ruang, digunakan sebagai bantuan yang berkaitan dengan
pilihannya.

Garis kosong diabaikan dan baris yang tidak sepadan dengan spesifikasi ini digunakan sebagai pilihan
pengepala kumpulan (mulakan baris dengan ruang untuk mencipta baris sedemikian dengan sengaja).

Contoh
OPTS_SPEC="\
beberapa arahan [pilihan] ...

some-command does foo and bar!
--
h, tolong tunjukkan bantuan

foo beberapa pilihan bagus --foo
bar= beberapa pilihan hebat --bar dengan hujah
baz=arg pilihan lain yang hebat --baz dengan hujah bernama
qux?path qux mungkin mengambil hujah laluan tetapi mempunyai makna dengan sendirinya

Pengepala kumpulan pilihan
C? pilihan C dengan hujah pilihan"

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

Penggunaan teks
Apabila "$@" ialah -h atau --help dalam contoh di atas, teks penggunaan berikut akan ditunjukkan:

penggunaan: beberapa arahan [pilihan] ...

some-command does foo and bar!

-h, --bantu tunjukkan bantuan
--foo beberapa pilihan bagus --foo
--bar ... beberapa pilihan hebat --bar dengan hujah
--baz satu lagi pilihan hebat --baz dengan hujah bernama
--qux[= ] qux mungkin mengambil hujah laluan tetapi mempunyai makna dengan sendirinya

Pengepala kumpulan pilihan
-C[...] pilihan C dengan hujah pilihan

SQ-QUOTE

Dalam mod --sq-quote, pergi huraian semula bergema pada output standard satu baris yang sesuai untuk
sh(1) eval. Baris ini dibuat dengan menormalkan hujah berikut --sq-quote. tiada apa-apa
selain memetik hujah dilakukan.

Jika anda mahu input arahan masih ditafsirkan seperti biasa oleh pergi huraian semula sebelum
output dipetik shell, lihat pilihan --sq.

Contoh
$ cat >your-git-script.sh <<\EOF
#!/ Bin / sh
args=$(git rev-parse --sq-quote "$@") # petikan hujah yang dibekalkan pengguna
command="git frotz -n24 $args" # dan gunakannya di dalam buatan tangan
# baris arahan
eval "$command"
EOF

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

CONTOH

· Cetak nama objek komit semasa:

$ git rev-parse --verify HEAD

· Cetak nama objek komit daripada semakan dalam pembolehubah shell $REV:

$ git rev-parse --verify $REV^{commit}

Ini akan ralat jika $REV kosong atau bukan semakan yang sah.

· Sama seperti di atas:

$ git rev-parse --default master --verify $REV

tetapi jika $REV kosong, nama objek komit daripada master akan dicetak.

GIT

Sebahagian daripada pergi(1) suite

Gunakan git-rev-parse dalam talian menggunakan perkhidmatan onworks.net