git-rev-parse - Online di Cloud

PROGRAM:

NAMA

git-rev-parse - Pilih dan pijat parameter

RINGKASAN

git parsing ulang [ --pilihan ] ...

DESKRIPSI

Banyak perintah porselen Git mengambil campuran flag (yaitu parameter yang dimulai dengan a
berlari -) dan parameter yang dimaksudkan untuk yang mendasari git daftar ulang perintah yang mereka gunakan secara internal
dan flag dan parameter untuk perintah lain yang mereka gunakan di bagian hilir git daftar ulang. Ini
perintah digunakan untuk membedakannya.

PILIHAN

Operasi Mode
Masing-masing opsi ini harus muncul terlebih dahulu di baris perintah.

--parseopt
penggunaan git parsing ulang dalam mode penguraian opsi (lihat bagian PARSEOPT di bawah).

--kutipan persegi
penggunaan git parsing ulang dalam mode kutipan shell (lihat bagian SQ-QUOTE di bawah). Berlawanan dengan
opsi --sq di bawah, mode ini hanya mengutip. Tidak ada lagi yang dilakukan untuk memerintahkan
memasukkan.

Opsi untuk --parseopt
--simpan-dashdash
Hanya bermakna dalam mode --parseopt. Memberitahu parser opsi untuk menggemakan yang pertama --
bertemu bukannya melewatkannya.

--stop-di-non-opsi
Hanya bermakna dalam mode --parseopt. Biarkan pengurai opsi berhenti terlebih dahulu
argumen non-opsi. Ini dapat digunakan untuk mengurai sub-perintah yang mengambil opsi
diri.

--macet-lama
Hanya bermakna dalam mode --parseopt. Keluarkan opsi dalam bentuk panjangnya jika
tersedia, dan dengan argumen mereka macet.

Opsi untuk Penyaringan
--revs-saja
Jangan keluarkan flag dan parameter yang tidak dimaksudkan untuk git daftar ulang perintah.

--tidak ada putaran
Jangan menampilkan flag dan parameter yang dimaksudkan untuk git daftar ulang perintah.

--bendera
Jangan menampilkan parameter non-bendera.

--tanpa bendera
Jangan menampilkan parameter bendera.

Opsi untuk Keluaran
--bawaan
Jika tidak ada parameter yang diberikan oleh pengguna, gunakan sebagai gantinya.

--awalan
Berperilaku seolah-olah git parsing ulang dipanggil dari subdirektori kerja
pohon. Setiap nama file relatif diselesaikan seolah-olah diawali oleh dan akan menjadi
dicetak dalam bentuk itu.

Ini dapat digunakan untuk mengonversi argumen menjadi perintah yang dijalankan di subdirektori sehingga
masih dapat digunakan setelah pindah ke tingkat atas repositori. Sebagai contoh:

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

--memeriksa
Verifikasi bahwa tepat satu parameter disediakan, dan itu dapat diubah menjadi mentah
SHA-20 1-byte yang dapat digunakan untuk mengakses database objek. Jika demikian, pancarkan ke
keluaran standar; jika tidak, kesalahan keluar.

Jika Anda ingin memastikan bahwa output benar-benar menamai objek di objek Anda
database dan/atau dapat digunakan sebagai jenis objek tertentu yang Anda butuhkan, Anda dapat menambahkan
^{type} mengupas operator ke parameter. Misalnya, git rev-parse "$VAR^{commit}"
akan memastikan $VAR menamai objek yang sudah ada yang merupakan komit (yaitu komit, atau
tag beranotasi yang menunjuk pada komit). Untuk memastikan bahwa $VAR menamai yang sudah ada
objek jenis apa pun, git rev-parse "$VAR^{object}" dapat digunakan.

-q, --tenang
Hanya bermakna dalam mode --verify. Jangan menampilkan pesan kesalahan jika argumen pertama
bukan nama objek yang valid; alih-alih keluar dengan status bukan nol secara diam-diam. SHA-1 untuk
nama objek yang valid dicetak ke stdout jika berhasil.

--persegi
Biasanya output dibuat satu baris per flag dan parameter. Opsi ini membuat output a
satu baris, dikutip dengan benar untuk dikonsumsi oleh shell. Berguna saat Anda mengharapkan
parameter berisi spasi putih dan baris baru (misalnya saat menggunakan beliung -S dengan git
berbeda-*). Berbeda dengan opsi --sq-quote, input perintah masih ditafsirkan
seperti biasa.

--bukan
Saat menunjukkan nama objek, awali dengan ^ dan strip ^ awalan dari nama objek
yang sudah punya.

--abbrev-ref[=(ketat|longgar)]
Nama pendek yang tidak ambigu dari nama objek. Opsi core.warnAmbiguousRefs adalah
digunakan untuk memilih mode singkatan yang ketat.

--pendek, --pendek=angka
Alih-alih mengeluarkan nilai SHA-1 penuh dari nama objek, cobalah menyingkatnya menjadi
nama unik yang lebih pendek. Ketika tidak ada panjang yang ditentukan 7 digunakan. Panjang minimal 4

--simbolis
Biasanya nama objek ditampilkan dalam bentuk SHA-1 (dengan kemungkinan ^ awalan); ini
opsi membuat mereka menghasilkan dalam bentuk yang sedekat mungkin dengan input asli.

--simbol-nama lengkap
Ini mirip dengan --symbolic, tetapi menghilangkan input yang bukan referensi (yaitu cabang atau
nama tag; atau lebih jelas mengaburkan bentuk "kepala/master", bila Anda ingin
beri nama cabang "master" ketika ada tag bernama "master" yang sayangnya, dan tunjukkan
mereka sebagai refnames lengkap (misalnya "refs/heads/master").

Opsi untuk benda
--semua
Tampilkan semua referensi yang ditemukan di referensi/.

--branch[=pattern], --tags[=pattern], --remotes[=pattern]
Tampilkan semua cabang, tag, atau cabang pelacakan jarak jauh, masing-masing (yaitu, referensi ditemukan
di ref/heads, ref/tags, atau ref/remote, masing-masing).

Jika sebuah pola diberikan, hanya referensi yang cocok dengan glob shell yang diberikan yang ditampilkan. jika
pola tidak mengandung karakter globbing (?, *, atau [), itu berubah menjadi awalan
cocokkan dengan menambahkan /*.

--glob=pola
Tampilkan semua referensi yang cocok dengan pola pola glob shell. Jika polanya tidak dimulai
dengan referensi/, ini secara otomatis ditambahkan. Jika pola tidak mengandung
karakter globbing (?, *, atau [), diubah menjadi kecocokan awalan dengan menambahkan /*.

--tidak termasuk=
Jangan sertakan referensi yang cocok bahwa --all, --branchs, --tags berikutnya,
--remotes, atau --glob sebaliknya akan mempertimbangkan. Pengulangan opsi ini terakumulasi
pola pengecualian hingga --all, --branches, --tags, --remotes, atau --glob . berikutnya
option (opsi atau argumen lain tidak menghapus pola akumulasi).

Pola yang diberikan tidak boleh dimulai dengan ref/heads, ref/tags, atau ref/remote ketika
diterapkan ke --branch, --tags, atau --remotes, masing-masing, dan harus dimulai dengan
refs/ ketika diterapkan ke --glob atau --all. Jika tertinggal /* dimaksudkan, itu harus diberikan
secara eksplisit.

--disambiguate=
Tampilkan setiap objek yang namanya dimulai dengan awalan yang diberikan. Itu harus di
setidaknya 4 digit heksadesimal panjang untuk menghindari daftar setiap objek di
penyimpanan secara tidak sengaja.

Opsi untuk File
--lokal-env-vars
Buat daftar variabel lingkungan GIT_* yang bersifat lokal ke repositori (mis. GIT_DIR atau
GIT_WORK_TREE, tetapi bukan GIT_EDITOR). Hanya nama variabel yang dicantumkan, bukan
nilai mereka, bahkan jika mereka ditetapkan.

--git-dir
Tampilkan $GIT_DIR jika ditentukan. Jika tidak, tunjukkan jalur ke direktori .git. Jalan
ditampilkan, ketika relatif, adalah relatif terhadap direktori kerja saat ini.

Jika $GIT_DIR tidak ditentukan dan direktori saat ini tidak terdeteksi terletak di Git
repositori atau pohon kerja mencetak pesan ke stderr dan keluar dengan status bukan nol.

--git-umum-dir
Tampilkan $GIT_COMMON_DIR jika ditentukan, selain itu $GIT_DIR.

--ada-di dalam-git-dir
Ketika direktori kerja saat ini berada di bawah direktori repositori, cetak "true",
sebaliknya "salah".

--adalah-di-dalam-kerja-pohon
Ketika direktori kerja saat ini berada di dalam pohon kerja dari repositori, cetak
"benar", jika tidak "salah".

--is-telanjang-repositori
Ketika repositori kosong, cetak "benar", jika tidak "salah".

--resolve-git-dir
Periksa apakah adalah repositori yang valid atau gitfile yang menunjuk ke repositori yang valid,
dan cetak lokasi repositori. Jika adalah gitfile maka diselesaikan
path ke repositori nyata dicetak.

--git-path
Selesaikan "$GIT_DIR/ " dan mengambil variabel relokasi jalur lain seperti
$GIT_OBJECT_DIRECTORY, $GIT_INDEX_FILE... ke dalam akun. Misalnya, jika
$GIT_OBJECT_DIRECTORY disetel ke /foo/bar lalu "git rev-parse --git-path objects/abc"
mengembalikan /foo/bar/abc.

--tunjukkan-cdup
Saat perintah dipanggil dari subdirektori, tunjukkan jalur level teratas
direktori relatif terhadap direktori saat ini (biasanya urutan "../", atau an
string kosong).

--tampilkan-awalan
Saat perintah dipanggil dari subdirektori, tunjukkan jalur arus
direktori relatif terhadap direktori tingkat atas.

--tampilkan-tingkat atas
Tampilkan jalur absolut dari direktori tingkat atas.

--jalur indeks-bersama
Tampilkan jalur ke file indeks bersama dalam mode indeks terpisah, atau kosongkan jika tidak dalam
mode indeks terpisah.

Lainnya Opsi
--sejak=string tanggal, --setelah=string tanggal
Parsing string tanggal, dan hasilkan parameter --max-age= yang sesuai untuk git
daftar ulang.

--sampai=string tanggal, --sebelum=string tanggal
Parsing string tanggal, dan hasilkan parameter --min-age= yang sesuai untuk git
daftar ulang.

...
Bendera dan parameter yang akan diuraikan.

SPESIFIKASI REVISI

Parameter revisi biasanya, tetapi tidak harus, menamai objek komit. Ini menggunakan
apa yang disebut luas SHA-1 sintaksis. Berikut adalah berbagai cara untuk mengeja nama objek. Itu
yang terdaftar di dekat akhir daftar ini menamai pohon dan gumpalan yang terkandung dalam komit.

, misalnya dae86e1950b1277e545cee180551750029cfe735, dae86e
Nama objek SHA-1 lengkap (string heksadesimal 40-byte), atau substring utama yang
unik di dalam repositori. Misalnya dae86e1950b1277e545cee180551750029cfe735 dan
dae86e keduanya menamai objek komit yang sama jika tidak ada objek lain di repositori Anda
yang nama objeknya dimulai dengan dae86e.

, misalnya v1.7.4.2-679-g3bee7fb
Keluaran dari git mendeskripsikan; yaitu tag terdekat, opsional diikuti oleh tanda hubung dan a
jumlah komit, diikuti oleh tanda hubung, a g, dan nama objek yang disingkat.

, misalnya menguasai, kepala/master, ref/kepala/master
Nama referensi simbolis. Misalnya menguasai biasanya berarti objek komit yang direferensikan oleh
ref/kepala/master. Jika Anda memiliki keduanya kepala/master dan tag/master, Anda dapat
secara eksplisit mengatakan kepala/master untuk memberi tahu Git yang mana yang Anda maksud. Ketika ambigu, a
disamarkan dengan mengambil pertandingan pertama dalam aturan berikut:

1. Jika $GIT_DIR/ ada, itulah yang Anda maksud (ini biasanya hanya berguna
untuk KEPALA, FETCH_HEAD, ORIG_HEAD, MERGE_HEAD dan CHERRY_PICK_HEAD);

2. jika tidak, referensi/ jika ada;

3. jika tidak, referensi/tag/ jika ada;

4. jika tidak, referensi/kepala/ jika ada;

5. jika tidak, referensi/jarak jauh/ jika ada;

6. jika tidak, referensi/jarak jauh/ /KEPALA jika itu ada.

KEPALA beri nama komit tempat Anda mendasarkan perubahan di pohon kerja.
FETCH_HEAD merekam cabang yang Anda ambil dari repositori jarak jauh dengan . Anda
permintaan pengambilan git terakhir. ORIG_HEAD dibuat oleh perintah yang menggerakkan KEPALA
secara drastis, untuk merekam posisi KEPALA sebelum operasi mereka, jadi
bahwa Anda dapat dengan mudah mengubah ujung cabang kembali ke keadaan sebelum Anda berlari
Mereka. MERGE_HEAD mencatat komit yang Anda gabungkan ke cabang Anda
ketika Anda menjalankan git merge. CHERRY_PICK_HEAD mencatat komit yang Anda
cherry-picking saat Anda menjalankan git cherry-pick.

Perhatikan bahwa salah satu dari referensi/* kasus di atas bisa berasal dari $GIT_DIR/ref
direktori atau dari $GIT_DIR/refs-paket mengajukan. Sedangkan pengkodean nama ref adalah
tidak ditentukan, UTF-8 lebih disukai karena beberapa pemrosesan keluaran mungkin menggunakan nama referensi di
UTF-8.

@
@ sendiri adalah jalan pintas untuk KEPALA.

@{ }, misalnya master@{kemarin}, KEPALA@{5 menit yang lalu}
Sebuah ref diikuti oleh akhiran @ dengan spesifikasi tanggal terlampir dalam pasangan penjepit
(misalnya {kemarin}, {1 bulan tersebut. 2 minggu 3 hari-hari 1 jam 1 kedua yang lalu} or {1979-02-26
18:30:00}) menentukan nilai ref pada titik waktu sebelumnya. Akhiran ini mungkin
hanya digunakan segera setelah nama referensi dan referensi harus memiliki log yang ada
($GIT_DIR/log/). Perhatikan bahwa ini mencari status Anda lokal ref di diberikan
waktu; misalnya, apa yang ada di lokal Anda menguasai cabang minggu lalu. Jika Anda ingin melihat
komit yang dibuat selama waktu-waktu tertentu, lihat --sejak dan --sampai.

@{ }, misalnya tuan@{1}
Sebuah ref diikuti oleh akhiran @ dengan spesifikasi ordinal terlampir dalam pasangan penjepit
(misalnya 1 {}, 15 {}) menentukan nilai sebelumnya ke-n dari ref itu. Sebagai contoh tuan@{1}
adalah nilai awal langsung dari menguasai sementara tuan@{5} adalah nilai sebelumnya ke-5 dari
menguasai. Sufiks ini hanya dapat digunakan segera setelah nama ref dan ref harus
memiliki log yang ada ($GIT_DIR/log/).

@{ }, misalnya @{1}
Anda dapat menggunakan @ buat dengan bagian ref kosong untuk mendapatkan entri reflog dari
cabang saat ini. Misalnya, jika Anda berada di cabang blabla kemudian @{1} artinya sama dengan
blabla@{1}.

@{- }, misalnya @{-1}
Konstruksinya @{- } berarti cabang/komit diperiksa sebelum saat ini
satu.

@{ke hulu}, misalnya master@{hulu}, @{u}
Sufiks @{ke hulu} ke nama cabang (bentuk pendek @{u}) mengacu kepada
cabang tempat cabang yang ditentukan oleh nama cabang diatur untuk dibangun di atas (dikonfigurasi
dengan cabang. .remote dan cabang. .menggabungkan). Nama cabang yang hilang default ke
yang sekarang.

@{dorongan}, misalnya master@{dorong}, @{dorongan}
Sufiks @{dorongan} melaporkan cabang "di mana kita akan Push to" jika git Push dijalankan
sementara nama cabang diperiksa (atau saat ini KEPALA jika tidak ada nama cabang yang ditentukan).
Karena tujuan push kami ada di repositori jarak jauh, tentu saja, kami melaporkan lokal
cabang pelacakan yang sesuai dengan cabang itu (yaitu, sesuatu di referensi/jarak jauh/).

Berikut ini contoh untuk membuatnya lebih jelas:

$ git config Push.default saat ini
$ git config jarak jauh.pushdefault garpu saya
$ git checkout -b mybranch Origin/master

$ git rev-parse --simbol-nama lengkap @{upstream}
referensi/jarak jauh/asal/master

$ git rev-parse --simbolis-nama lengkap @{push}
ref/remote/myfork/mybranch

Perhatikan dalam contoh bahwa kami menyiapkan alur kerja segitiga, di mana kami menarik dari satu
lokasi dan mendorong ke yang lain. Dalam alur kerja non-segitiga, @{dorongan} sama dengan
@{ke hulu}, dan tidak perlu untuk itu.

^, misalnya KEPALA^, v1.5.1^0
Sebuah akhiran ^ ke parameter revisi berarti induk pertama dari objek komit itu. ^
berarti orang tua (yaitu ^ adalah setara dengan ^1). Sebagai aturan khusus,
^0 berarti komit itu sendiri dan digunakan ketika adalah nama objek dari sebuah tag
objek yang merujuk ke objek komit.

~, misalnya tuan~3
Sebuah akhiran ~ ke parameter revisi berarti objek komit yang th
generasi nenek moyang dari objek komit bernama, hanya mengikuti orang tua pertama. Yaitu
~3 adalah setara dengan ^^^ yang setara dengan ^1^1^1. Lihat di bawah untuk
ilustrasi penggunaan formulir ini.

^{ }, misalnya v0.99.8^{komit}
Sebuah akhiran ^ diikuti dengan nama tipe objek yang diapit oleh pasangan kurung kurawal berarti dereferensi
objek di secara rekursif sampai objek bertipe ditemukan atau objeknya
tidak dapat direferensikan lagi (dalam hal ini, muntah). Misalnya, jika adalah
berkomitmen, ^{komit} menggambarkan objek komit yang sesuai. Demikian pula, jika
adalah pohon-ish, ^{pohon} menggambarkan objek pohon yang sesuai. ^0 is
kependekan dari ^{komit}.

rev^{objek} dapat digunakan untuk memastikan putaran menyebutkan objek yang ada, tanpa
Mewajibkan putaran untuk menjadi tag, dan tanpa dereferensi putaran; karena tag sudah menjadi
objek, itu tidak harus direferensikan bahkan sekali untuk sampai ke objek.

putaran^{tag} dapat digunakan untuk memastikan bahwa putaran mengidentifikasi objek tag yang ada.

^{}, misalnya v0.99.8^{}
Sebuah akhiran ^ diikuti oleh pasangan kurung kurawal kosong berarti objek bisa berupa tag, dan
dereferensi tag secara rekursif hingga objek non-tag ditemukan.

^{/ }, misalnya KEPALA^{/perbaiki mesum serangga}
Sebuah akhiran ^ ke parameter revisi, diikuti oleh sepasang kurung kurawal yang berisi teks yang dipimpin
dengan garis miring, sama dengan :/memperbaiki mesum kesalahan sintaks di bawah ini kecuali yang mengembalikan
komit pencocokan termuda yang dapat dijangkau dari sebelum ^.

:/, misalnya :/memperbaiki mesum kesalahan
Tanda titik dua, diikuti dengan garis miring, diikuti dengan teks, menamai komit yang pesan komitnya
cocok dengan ekspresi reguler yang ditentukan. Nama ini mengembalikan pencocokan termuda
komit yang dapat dijangkau dari referensi mana pun. Jika pesan komit dimulai dengan a ! kamu
harus mengulangi itu; urutan khusus :/!, diikuti oleh sesuatu selain !, Apakah
dipesan untuk saat ini. Ekspresi reguler bisa cocok dengan bagian mana pun dari pesan komit. Ke
mencocokkan pesan yang dimulai dengan string, seseorang dapat menggunakan mis :/^foo.

:, misalnya KEPALA: BACA, :BACA AKU, menguasai:./README
Sebuah akhiran : diikuti dengan nama jalan gumpalan atau pohon di jalan yang diberikan di pohon-ish
objek diberi nama oleh bagian sebelum titik dua. :jalur (dengan bagian kosong sebelum
titik dua) adalah kasus khusus dari sintaks yang dijelaskan selanjutnya: konten yang direkam dalam indeks
pada jalan yang diberikan. Sebuah jalan yang dimulai dengan ./ or ../ relatif terhadap kerja saat ini
direktori. Jalur yang diberikan akan dikonversi menjadi relatif terhadap akar pohon kerja
direktori. Ini paling berguna untuk mengatasi gumpalan atau pohon dari komit atau pohon yang
memiliki struktur pohon yang sama dengan pohon kerja.

: :, misalnya :0:BACA, :BACA AKU
Tanda titik dua, secara opsional diikuti dengan nomor tahap (0 hingga 3) dan titik dua, diikuti oleh a
path, menamai objek blob dalam indeks pada path yang diberikan. Nomor panggung yang hilang (dan
titik dua yang mengikutinya) menamai entri tahap 0. Selama penggabungan, tahap 1 adalah
nenek moyang yang sama, tahap 2 adalah versi cabang target (biasanya saat ini
cabang), dan tahap 3 adalah versi dari cabang yang digabung.

Berikut adalah ilustrasinya, oleh Jon Loeliger. Kedua simpul komit B dan C adalah orang tua dari komit
node A. Parent commit diurutkan dari kiri ke kanan.

GHIJ
\ / \ /
DEF
\ | /\
\ | / |
\|/ |
SM
\ /
\ /
A

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

SPESIFIKASI JANGKAUAN

Perintah penelusuran riwayat seperti git log beroperasi pada serangkaian komit, bukan hanya satu
melakukan. Untuk perintah ini, menentukan revisi tunggal dengan notasi yang dijelaskan dalam
bagian sebelumnya berarti kumpulan komit yang dapat dicapai dari komit itu, setelah komit
rantai keturunan.

Untuk mengecualikan komit yang dapat dijangkau dari komit, sebuah awalan ^ notasi digunakan. Misalnya ^r1 r2 cara
komit dapat dijangkau dari r2 tetapi kecualikan yang dapat dijangkau dari r1.

Operasi himpunan ini muncul begitu sering sehingga ada singkatan untuk itu. Ketika Anda memiliki dua
melakukan r1 dan r2 (dinamai sesuai dengan sintaks yang dijelaskan dalam MENETAPKAN REVISI di atas),
anda dapat meminta komit yang dapat dijangkau dari r2 tidak termasuk yang dapat dijangkau dari
r1 oleh ^r1 r2 dan dapat ditulis sebagai r1..r2.

Notasi serupa r1...r2 disebut beda simetris dari r1 dan r2 dan didefinisikan sebagai
r1 r2 --bukan $(git gabungan-basis --semua r1 r2). Ini adalah kumpulan komitmen yang dapat dijangkau
dari salah satu dari r1 or r2 tapi tidak dari keduanya.

Dalam dua singkatan ini, Anda dapat menghilangkan salah satu ujungnya dan membiarkannya default ke HEAD. Sebagai contoh,
asal.. adalah singkatan dari asal..HEAD dan bertanya "Apa yang saya lakukan sejak saya bercabang dari
cabang asal?" Demikian pula, ..asal adalah singkatan dari KEPALA..asal dan bertanya "Apa yang
asal lakukan sejak saya bercabang dari mereka?" Perhatikan bahwa .. berarti KEPALA.. KEPALA yang kosong
rentang yang dapat dijangkau dan tidak dapat dijangkau dari HEAD.

Dua singkatan lain untuk menamai himpunan yang dibentuk oleh komit dan komit induknya
ada. NS r1^@ notasi berarti semua orang tua dari r1. r1^! termasuk komit r1 tapi tidak termasuk semua
dari orang tuanya.

Untuk meringkas:


Sertakan komit yang dapat dijangkau dari (yaitu nenek moyang) .

^
Kecualikan komit yang dapat dijangkau dari (yaitu nenek moyang) .

..
Sertakan komit yang dapat dijangkau dari tetapi kecualikan yang dapat dijangkau
dari . kapan? atau dihilangkan, defaultnya adalah KEPALA.

...
Sertakan komit yang dapat dijangkau dari keduanya atau tetapi kecualikan yang itu
dapat dijangkau dari keduanya. kapan? atau dihilangkan, defaultnya adalah KEPALA.

^@, misalnya KEPALA^@
Sebuah akhiran ^ diikuti oleh tanda sama dengan mendaftar semua orang tua dari
(artinya, sertakan apa pun yang dapat dijangkau dari induknya, tetapi bukan komit itu sendiri).

^!, misalnya KEPALA^!
Sebuah akhiran ^ diikuti dengan tanda seru sama dengan memberikan komit lalu
semua orang tuanya diawali dengan ^ untuk mengecualikan mereka (dan nenek moyang mereka).

Berikut adalah beberapa contoh:

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

PARSEOP

Dalam mode --parseopt, git parsing ulang membantu memijat opsi untuk membawa skrip shell ke
fasilitas yang sama yang dimiliki C builtin. Ini berfungsi sebagai penormalisasi opsi (mis. splits single
beralih nilai agregat), sedikit seperti dapatkan opt(1) tidak.

Dibutuhkan input standar spesifikasi opsi untuk menguraikan dan memahami,
dan menggemakan pada output standar string yang cocok untuk sh(1) evaluasi untuk menggantikan
argumen dengan yang dinormalisasi. Jika terjadi kesalahan, ini menampilkan penggunaan pada kesalahan standar
streaming, dan keluar dengan kode 129.

Catatan: Pastikan Anda mengutip hasilnya saat meneruskannya ke eval. Lihat di bawah untuk contoh.

Memasukkan dibentuk
git parsing ulang --parseopt format input sepenuhnya berbasis teks. Ini memiliki dua bagian, dipisahkan oleh
baris yang hanya berisi --. Garis sebelum pemisah (harus satu atau lebih) adalah
digunakan untuk penggunaan. Garis setelah pemisah menjelaskan opsi.

Setiap baris opsi memiliki format ini:

* ? SP+ bantu LF


formatnya adalah karakter opsi pendek, lalu nama opsi panjang dipisahkan oleh a
koma. Kedua bagian tidak diperlukan, meskipun setidaknya satu diperlukan. Mungkin tidak mengandung
salah satu dari karakter. h,help, dry-run dan f adalah contoh yang benar
.


adalah dari *, =, ? atau !.

· Gunakan = jika opsi mengambil argumen.

· Menggunakan ? berarti bahwa opsi mengambil argumen opsional. Anda mungkin ingin
gunakan mode --stuck-long untuk dapat menguraikan argumen opsional dengan jelas.

· Gunakan * berarti bahwa opsi ini tidak boleh dicantumkan dalam penggunaan yang dihasilkan untuk
-h argumen. Ini ditampilkan untuk --help-all seperti yang didokumentasikan dalam gitcli(7).

· Menggunakan ! untuk tidak membuat opsi panjang yang dinegasikan yang sesuai tersedia.


, jika ditentukan, digunakan sebagai nama argumen dalam keluaran bantuan, untuk
pilihan yang mengambil argumen. diakhiri dengan spasi pertama. Dia
biasa menggunakan tanda hubung untuk memisahkan kata-kata dalam petunjuk argumen multi-kata.

Sisa baris, setelah menghilangkan spasi, digunakan sebagai bantuan yang terkait dengan
pilihan.

Baris kosong diabaikan, dan baris yang tidak sesuai dengan spesifikasi ini digunakan sebagai opsi
header grup (mulai baris dengan spasi untuk membuat baris seperti itu dengan sengaja).

Contoh
OPTS_SPEC="\
beberapa-perintah [opsi] ...

beberapa-perintah melakukan foo dan bar!
--
h, bantu tunjukkan bantuannya

foo beberapa pilihan bagus --foo
bar= beberapa opsi keren --bar dengan argumen
baz=arg opsi keren lainnya --baz dengan argumen bernama
qux?path qux dapat mengambil argumen path tetapi memiliki arti tersendiri

Header grup opsi
C? opsi C dengan argumen opsional"

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

penggunaan teks
Ketika "$@" adalah -h atau --help dalam contoh di atas, teks penggunaan berikut akan ditampilkan:

penggunaan: beberapa-perintah [opsi] ...

beberapa-perintah melakukan foo dan bar!

-h, --help tunjukkan bantuannya
--foo beberapa pilihan bagus --foo
--bar ... beberapa opsi keren --bar dengan argumen
--baz opsi keren lainnya --baz dengan argumen bernama
--qux[= ] qux dapat mengambil argumen jalur tetapi memiliki makna dengan sendirinya

Header grup opsi
-C[...] opsi C dengan argumen opsional

SQ-KUTIPAN

Dalam mode --sq-quote, git parsing ulang menggema pada output standar satu baris yang cocok untuk
sh(1) evaluasi. Baris ini dibuat dengan menormalkan argumen berikut --sq-quote. Tidak
selain mengutip argumen dilakukan.

Jika Anda ingin input perintah tetap ditafsirkan seperti biasa oleh git parsing ulang sebelum
output adalah kutipan shell, lihat opsi --sq.

Contoh
$ cat >your-git-script.sh <<\EOF
#!/ Bin / sh
args=$(git rev-parse --sq-quote "$@") # mengutip argumen yang disediakan pengguna
command="git frotz -n24 $args" # dan gunakan di dalam kerajinan tangan
# garis komando
evaluasi "$perintah"
EOF

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

CONTOH

· Cetak nama objek dari komit saat ini:

$ git rev-parse --verifikasi KEPALA

· Cetak nama objek komit dari revisi dalam variabel shell $REV:

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

Ini akan error jika $REV kosong atau bukan revisi yang valid.

· Mirip dengan di atas:

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

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

GIT

Bagian dari git(1) kamar

Gunakan git-rev-parse online menggunakan layanan onworks.net