git-describe - Online di Cloud

PROGRAM:

NAMA

git-describe - Jelaskan komit menggunakan tag terbaru yang dapat dijangkau darinya

RINGKASAN

git menggambarkan [--all] [--tags] [--contains] [--abbrev= ] [ ...]
git menggambarkan [--all] [--tags] [--contains] [--abbrev= ] --kotor[= ]

DESKRIPSI

Perintah menemukan tag terbaru yang dapat dijangkau dari komit. Jika tag menunjuk
ke komit, maka hanya tag yang ditampilkan. Jika tidak, itu akan menambahkan nama tag dengan
jumlah komit tambahan di atas objek yang ditandai dan nama objek yang disingkat
dari komit terbaru.

Secara default (tanpa --all atau --tags) git mendeskripsikan hanya menampilkan tag beranotasi. Untuk lebih
informasi tentang membuat tag beranotasi lihat opsi -a dan -s untuk git-tag(1).

PILIHAN

...
Komit-ish nama objek untuk dijelaskan. Default ke HEAD jika dihilangkan.

--kotor[= ]
Jelaskan pohon kerja. Itu berarti menggambarkan KEPALA dan menambahkan (-kotor oleh
default) jika pohon kerja kotor.

--semua
Alih-alih hanya menggunakan tag beranotasi, gunakan referensi apa pun yang ditemukan di refs/ namespace. Ini
opsi memungkinkan pencocokan cabang yang dikenal, cabang pelacakan jarak jauh, atau tag ringan.

--tag
Alih-alih hanya menggunakan tag beranotasi, gunakan tag apa pun yang ditemukan di ruang nama referensi/tag.
Opsi ini memungkinkan pencocokan tag ringan (tidak beranotasi).

--mengandung
Alih-alih menemukan tag yang mendahului komit, temukan tag yang muncul setelah
komit, dan dengan demikian berisi itu. Secara otomatis menyiratkan --tags.

--singkatan=
Alih-alih menggunakan 7 digit heksadesimal default sebagai nama objek yang disingkat, gunakan
digit, atau digit sebanyak yang diperlukan untuk membentuk nama objek yang unik. NS dari 0 kemauan
tekan format panjang, hanya menampilkan tag terdekat.

--calon=
Alih-alih mempertimbangkan hanya 10 tag terbaru sebagai kandidat untuk menggambarkan
masukan commit-ish pertimbangkan hingga calon. meningkat di atas 10 akan mengambil
sedikit lebih lama tetapi dapat menghasilkan hasil yang lebih akurat. NS dari 0 hanya akan menyebabkan
kecocokan yang tepat untuk menjadi output.

--benar-benar cocok
Hanya keluaran yang sama persis (sebuah tag secara langsung merujuk pada komit yang disediakan). Ini adalah sebuah
sinonim untuk --calon=0.

--debug
Menampilkan informasi secara verbal tentang strategi pencarian yang digunakan untuk standar
kesalahan. Nama tag masih akan dicetak ke standar keluar.

--panjang
Selalu tampilkan format panjang (tag, jumlah komit, dan singkatannya
komit nama) bahkan ketika cocok dengan tag. Ini berguna ketika Anda ingin melihat bagian dari
nama objek komit dalam output "jelaskan", bahkan ketika komit yang dimaksud terjadi
menjadi versi yang ditandai. Alih-alih hanya memancarkan nama tag, itu akan menggambarkan seperti
komit sebagai v1.2-0-gdeadbee (komit ke-0 sejak tag v1.2 yang menunjuk ke objek
lebah mati....).

--cocok
Hanya pertimbangkan tag yang cocok dengan yang diberikan bola(7) pola, tidak termasuk "ref/tag/"
awalan. Ini dapat digunakan untuk menghindari kebocoran tag pribadi dari repositori.

--selalu
Tampilkan objek komit yang disingkat secara unik sebagai fallback.

--orang tua pertama
Ikuti hanya komit induk pertama setelah melihat komit gabungan. Ini berguna ketika
Anda tidak ingin mencocokkan tag pada cabang yang digabungkan dalam riwayat komit target.

CONTOH

Dengan sesuatu seperti pohon git.git saat ini, saya mendapatkan:

[torvalds@g5 git]$ git mendeskripsikan induk
v1.0.4-14-g2414721

yaitu kepala cabang "induk" saya saat ini didasarkan pada v1.0.4, tetapi karena memiliki beberapa
komit di atas itu, jelaskan telah menambahkan jumlah komit tambahan ("14") dan an
nama objek disingkat untuk komit itu sendiri ("2414721") di akhir.

Jumlah komit tambahan adalah jumlah komit yang akan ditampilkan oleh "git
log v1.0.4..parent". Akhiran hash adalah "-g" + singkatan 7-char untuk komit tip dari
induk (yaitu 2414721b194453f058079d897d13c4e377f92dc6). Awalan "g" adalah singkatan dari
"git" dan digunakan untuk menjelaskan versi perangkat lunak tergantung pada SCM-nya
perangkat lunak dikelola dengan. Ini berguna dalam lingkungan di mana orang dapat menggunakan yang berbeda
SCM.

Melakukan a git menggambarkan pada nama tag hanya akan menampilkan nama tag:

[torvalds@g5 git]$ git jelaskan v1.0.4
v1.0.4

Dengan --all, perintah dapat menggunakan kepala cabang sebagai referensi, sehingga output menunjukkan
jalur referensi juga:

[torvalds@g5 git]$ git jelaskan --all --abbrev=4 v1.0.5^2
tag/v1.0.0-21-g975b

[torvalds@g5 git]$ git jelaskan --all --abbrev=4 KEPALA^
kepala/lt/jelaskan-7-g975b

Dengan --abbrev disetel ke 0, perintah dapat digunakan untuk menemukan nama tag terdekat tanpa ada
akhiran:

[torvalds@g5 git]$ git jelaskan --abbrev=0 v1.0.5^2
tag/v1.0.0

Perhatikan bahwa akhiran yang Anda dapatkan jika Anda mengetik perintah ini hari ini mungkin lebih panjang dari apa
Linus melihat di atas ketika dia menjalankan perintah ini, karena repositori Git Anda mungkin memiliki komit baru
yang nama objeknya dimulai dengan 975b yang tidak ada saat itu, dan akhiran "-g975b" saja
mungkin tidak cukup untuk membedakan komitmen ini.

CARI STRATEGI

Untuk setiap komitmen yang disediakan, git menggambarkan pertama-tama akan mencari tag yang tagnya tepat
komit itu. Tag beranotasi akan selalu lebih disukai daripada tag ringan, dan tag dengan
tanggal yang lebih baru akan selalu lebih disukai daripada tag dengan tanggal yang lebih lama. Jika kecocokan tepat adalah
ditemukan, namanya akan ditampilkan dan pencarian akan berhenti.

Jika kecocokan yang tepat tidak ditemukan, git menggambarkan akan berjalan kembali melalui sejarah komit untuk
temukan komit leluhur yang telah ditandai. Tag leluhur akan ditampilkan
dengan singkatan dari input commit-ish's SHA-1. Jika --orang tua pertama ditentukan kemudian
jalan hanya akan mempertimbangkan induk pertama dari setiap komit.

Jika beberapa tag ditemukan selama perjalanan, maka tag yang memiliki commit paling sedikit
berbeda dari input commit-ish akan dipilih dan output. Di sini paling sedikit komit
berbeda didefinisikan sebagai jumlah komit yang akan ditampilkan oleh tag log git..input
akan menjadi jumlah komitmen terkecil yang mungkin.

GIT

Bagian dari git(1) kamar

Gunakan git-describe online menggunakan layanan onworks.net