git-blame - Online di Cloud

PROGRAM:

NAMA

git-blame - Tampilkan revisi dan penulis yang terakhir memodifikasi setiap baris file

RINGKASAN

git menyalahkan [-c] [-b] [-l] [--root] [-t] [-f] [-n] [-s] [-e] [-p] [-w] [--inkremental]
[-L ] [-S ] [-M] [-C] [-C] [-C] [--since= ]
[--singkatan= ] [ | --isi | --membalikkan ] [--]

DESKRIPSI

Anotasi setiap baris dalam file yang diberikan dengan informasi dari revisi yang terakhir
memodifikasi garis. Secara opsional, mulailah membuat anotasi dari revisi yang diberikan.

Ketika ditentukan satu kali atau lebih, -L membatasi anotasi ke baris yang diminta.

Asal baris secara otomatis diikuti di seluruh penggantian nama file (saat ini ada
tidak ada opsi untuk mematikan rename-following). Untuk mengikuti baris yang dipindahkan dari satu file ke
lain, atau untuk mengikuti baris yang disalin dan ditempel dari file lain, dll., lihat
-C dan -M pilihan.

Laporan tidak memberi tahu Anda apa pun tentang baris yang telah dihapus atau diganti; Anda
perlu menggunakan alat seperti git diff atau antarmuka "beliung" yang disebutkan secara singkat di
paragraf berikut.

Selain mendukung anotasi file, Git juga mendukung pencarian riwayat pengembangan
ketika cuplikan kode terjadi dalam perubahan. Hal ini memungkinkan untuk melacak ketika kode
snippet ditambahkan ke file, dipindahkan atau disalin antar file, dan akhirnya dihapus atau
diganti. Ia bekerja dengan mencari string teks di diff. Contoh kecil dari
antarmuka beliung yang mencari kesalahan_penggunaan:

$ git log --pretty=oneline -S'blame_usage'
5040f17eba15504bad66b14a645bddd9b015ebb7 blame -S <ancestry-file>
ea4c7f9bf69e781dd0cd88d2bccb2bf5cc15c9a7 git-blame: Make the output

PILIHAN

-b
Tampilkan SHA-1 kosong untuk komitmen batas. Ini juga dapat dikontrol melalui
opsi konfigurasi menyalahkan.blankboundary.

--akar
Jangan perlakukan root commit sebagai batasan. Ini juga dapat dikontrol melalui
opsi konfigurasi menyalahkan.showRoot.

--tampilkan-statistik
Sertakan statistik tambahan di akhir keluaran kesalahan.

-L , , -L :
Anotasi hanya rentang garis yang diberikan. Dapat ditentukan beberapa kali. Tumpang tindih
rentang diperbolehkan.

dan adalah opsional. “-L ” atau “-L ,” mulai dari ke
akhir berkas. “-L , ” terbentang dari awal file hingga .

dan dapat mengambil salah satu dari bentuk berikut:

· nomor

Jika atau adalah angka, ini menentukan nomor baris absolut (jumlah baris
dari 1).

· /regex/

Formulir ini akan menggunakan baris pertama yang cocok dengan regex POSIX yang diberikan. Jika adalah
regex, itu akan mencari dari akhir rentang -L sebelumnya, jika ada, jika tidak
dari awal file. Jika adalah "^/regex/", itu akan mencari dari awal
mengajukan. Jika adalah regex, itu akan mencari mulai dari baris yang diberikan oleh .

· +offset atau -offset

Ini hanya berlaku untuk dan akan menentukan sejumlah baris sebelum atau sesudah
garis yang diberikan oleh .

Jika ": ” diberikan sebagai pengganti dan , itu adalah ekspresi reguler
yang menunjukkan rentang dari baris funcname pertama yang cocok , sampai
baris funcname berikutnya. “: ” mencari dari akhir rentang -L sebelumnya, jika
any, jika tidak dari awal file. “^: ” mencari dari awal file.

-l
Tampilkan putaran panjang (Default: mati).

-t
Tampilkan stempel waktu mentah (Default: nonaktif).

-S
Gunakan revisi dari file revs alih-alih menelepon git-rev-list(1).

--membalikkan
Jalankan sejarah ke depan, bukan ke belakang. Alih-alih menunjukkan revisi di mana a
garis muncul, ini menunjukkan revisi terakhir di mana garis telah ada. Ini membutuhkan
rentang revisi seperti START..END di mana jalur yang harus disalahkan ada di START.

-p, --porselen
Tampilkan dalam format yang dirancang untuk konsumsi mesin.

--line-porselen
Tampilkan format porselen, tetapi keluaran informasi komit untuk setiap baris, bukan hanya
pertama kali komit dirujuk. Menyiratkan --porselen.

--tambahan
Tampilkan hasilnya secara bertahap dalam format yang dirancang untuk konsumsi mesin.

--pengkodean=
Menentukan pengkodean yang digunakan untuk menampilkan nama penulis dan melakukan ringkasan. Mengaturnya ke
tidak ada yang menyalahkan keluaran data yang tidak dikonversi. Untuk informasi lebih lanjut lihat diskusi
tentang pengkodean di git-log(1) halaman manual.

--isi
Kapan tidak ditentukan, perintah menjelaskan perubahan mulai mundur dari
salinan pohon kerja. Bendera ini membuat perintah berpura-pura seolah-olah salinan pohon yang berfungsi
memiliki konten file bernama (tentukan - untuk membuat perintah dibaca dari
masukan standar).

--tanggal
Menentukan format yang digunakan untuk tanggal keluaran. Jika --date tidak diberikan, nilai dari
variabel konfigurasi fault.date digunakan. Jika variabel konfigurasi fault.date juga tidak disetel,
format iso yang digunakan. Untuk nilai yang didukung, lihat pembahasan opsi --date
at git-log(1).

-M| |
Deteksi baris yang dipindahkan atau disalin dalam file. Saat komit bergerak atau menyalin blok
baris (misalnya file asli memiliki A dan kemudian B, dan komit mengubahnya menjadi B dan
lalu A), tradisional menyalahkan algoritma hanya memperhatikan setengah dari gerakan dan
biasanya menyalahkan garis yang dipindahkan (yaitu B) ke orang tua dan menugaskan kesalahan
ke baris yang dipindahkan ke bawah (yaitu A) ke komit anak. Dengan opsi ini, keduanya
kelompok garis disalahkan pada orang tua dengan menjalankan pemeriksaan ekstra.

adalah opsional tetapi batas bawah pada jumlah karakter alfanumerik
yang harus dideteksi Git sebagai memindahkan/menyalin di dalam file agar dapat mengaitkan baris-baris itu
dengan komitmen induk. Nilai defaultnya adalah 20.

-C| |
Selain -M, deteksi baris yang dipindahkan atau disalin dari file lain yang dimodifikasi di
komit yang sama. Ini berguna saat Anda mengatur ulang program dan memindahkan kode
di seluruh file. Ketika opsi ini diberikan dua kali, perintah tambahan mencari
salinan dari file lain di komit yang membuat file. Ketika opsi ini diberikan
tiga kali, perintah juga mencari salinan dari file lain di komit apa pun.

adalah opsional tetapi batas bawah pada jumlah karakter alfanumerik
yang harus dideteksi Git sebagai pemindahan/penyalinan antar file agar dapat mengaitkan baris-baris itu
dengan komitmen induk. Dan nilai defaultnya adalah 40. Jika ada lebih dari satu -C
pilihan yang diberikan, argumen terakhir -C akan berlaku.

-h
Tampilkan pesan bantuan.

-c
Gunakan mode keluaran yang sama seperti git-anotasi(1) (Default: mati).

--skor-debug
Sertakan informasi debug yang terkait dengan pergerakan garis antar file (lihat -C)
dan garis dipindahkan dalam file (lihat -M). Angka pertama yang tertera adalah skornya. Ini adalah
jumlah karakter alfanumerik yang terdeteksi telah dipindahkan di antara atau di dalam
file. Ini harus di atas ambang batas tertentu untuk git menyalahkan untuk mempertimbangkan garis-garis itu
kode yang telah dipindahkan.

-f, --nama acara
Tampilkan nama file di komit asli. Secara default nama file ditampilkan jika ada
baris apa pun yang berasal dari file dengan nama berbeda, karena deteksi penggantian nama.

-n, --tunjukkan-nomor
Tampilkan nomor baris dalam komit asli (Default: off).

-s
Menekan nama penulis dan cap waktu dari output.

-e, --tampilkan-email
Tampilkan email penulis alih-alih nama penulis (Default: nonaktif). Ini juga bisa
dikontrol melalui opsi konfigurasi menyalahkan.showEmail.

-w
Abaikan spasi putih saat membandingkan versi induk dan versi anak untuk menemukan di mana
garis-garis itu berasal.

--singkatan=
Alih-alih menggunakan angka heksadesimal 7+1 default sebagai nama objek yang disingkat,
menggunakan +1 digit. Perhatikan bahwa 1 kolom digunakan untuk tanda sisipan untuk menandai komit batas.

THE PORSELEN FORMAT

Dalam format ini, setiap baris dikeluarkan setelah header; header minimal memiliki
baris pertama yang memiliki:

· SHA-40 1-byte dari komit yang dikaitkan dengan baris;

· nomor baris dari baris dalam file asli;

· nomor baris dari baris dalam file akhir;

· pada baris yang memulai sekelompok baris dari komit yang berbeda dari komit sebelumnya,
jumlah baris dalam grup ini. Pada baris berikutnya bidang ini tidak ada.

Baris header ini diikuti oleh informasi berikut setidaknya sekali untuk setiap komit:

· nama penulis ("penulis"), email ("penulis-mail"), waktu ("waktu penulis"), dan zona waktu
("penulis-tz"); sama untuk commiter.

· nama file dalam komit yang dikaitkan dengan baris tersebut.

· baris pertama dari pesan log komit ("ringkasan").

Isi dari baris yang sebenarnya adalah output setelah header di atas, diawali dengan TAB. Ini
adalah untuk memungkinkan menambahkan lebih banyak elemen header nanti.

Format porselen umumnya menekan informasi komit yang telah dilihat.
Misalnya, dua baris yang disalahkan pada komit yang sama keduanya akan ditampilkan, tetapi
detail untuk komit itu hanya akan ditampilkan sekali. Ini lebih efisien, tetapi mungkin memerlukan
lebih negara disimpan oleh pembaca. Opsi --line-porcelain dapat digunakan untuk menghasilkan output penuh
komit informasi untuk setiap baris, memungkinkan penggunaan yang lebih sederhana (tetapi kurang efisien) seperti:

# hitung jumlah baris yang dikaitkan dengan setiap penulis
git menyalahkan --line-porselen file |
sed -n 's/^author //p' |
urutkan | uniq -c | urutkan -rn

SPESIFIKASI JANGKAUAN

Berbeda git menyalahkan dan git membubuhi keterangan di versi git yang lebih lama, tingkat anotasi
dapat dibatasi pada rentang baris dan rentang revisi. Opsi -L, yang membatasi
anotasi ke berbagai baris, dapat ditentukan beberapa kali.

Ketika Anda tertarik untuk menemukan asal untuk baris 40-60 untuk file foo, Anda dapat menggunakan
opsi -L seperti itu (maksudnya sama — keduanya meminta 21 baris mulai dari baris
40):

git menyalahkan -L 40,60 foo
git menyalahkan -L 40,+21 foo

Anda juga dapat menggunakan ekspresi reguler untuk menentukan rentang baris:

git menyalahkan -L '/^sub halo {/,/^}$/' foo

yang membatasi anotasi ke badan subrutin hello.

Bila Anda tidak tertarik dengan perubahan yang lebih lama dari versi v2.6.18, atau perubahan yang lebih lama dari 3
minggu, Anda dapat menggunakan penentu rentang revisi yang mirip dengan git daftar ulang:

git menyalahkan v2.6.18.. -- foo
git menyalahkan --since=3.weeks -- foo

Saat penentu rentang revisi digunakan untuk membatasi anotasi, baris yang tidak
berubah sejak batas rentang (baik komit v2.6.18 atau komit terbaru yang
lebih dari 3 minggu dalam contoh di atas) disalahkan untuk komit batas rentang itu.

Cara yang sangat berguna adalah untuk melihat apakah file yang ditambahkan memiliki baris yang dibuat dengan salin-dan-tempel
dari file yang ada. Terkadang ini menunjukkan bahwa pengembang ceroboh dan melakukannya
tidak refactor kode dengan benar. Anda dapat terlebih dahulu menemukan komit yang memperkenalkan file
dengan:

git log --diff-filter=A --pretty=pendek -- foo

dan kemudian beri anotasi perubahan antara komit dan induknya, menggunakan komit^! notasi:

git menyalahkan -C -C -f $komit^! -- foo

TAMBAHAN KELUARAN

Saat dipanggil dengan opsi --incremental, perintah mengeluarkan hasil saat dibuat. NS
output umumnya akan berbicara tentang baris yang disentuh oleh komit yang lebih baru terlebih dahulu (mis
baris akan diberi anotasi rusak) dan dimaksudkan untuk digunakan oleh pemirsa interaktif.

Format output mirip dengan format Porselen, tetapi tidak mengandung yang sebenarnya
baris dari file yang sedang dianotasi.

1. Setiap entri menyalahkan selalu dimulai dengan baris:

<40-byte hex sha1>

Nomor baris dihitung dari 1.

2. Pertama kali komit muncul di aliran, ia memiliki berbagai informasi lain
tentang itu dicetak dengan tag satu kata di awal setiap baris yang menggambarkan
informasi komit tambahan (penulis, email, pembuat, tanggal, ringkasan, dll.).

3. Tidak seperti format Porselen, informasi nama file selalu diberikan dan diakhiri
jalan masuk:

"nama file"

dan dengan demikian sangat mudah untuk menguraikan untuk beberapa pengurai berorientasi baris dan kata
(yang seharusnya cukup alami untuk sebagian besar bahasa skrip).

Note
Untuk orang yang melakukan parsing: untuk membuatnya lebih kuat, abaikan saja garis di antara
yang pertama dan terakhir (" " dan "nama file" baris) di mana Anda tidak mengenali
kata-kata tag (atau peduli tentang yang khusus itu) di awal
baris "informasi yang diperluas". Dengan begitu, jika ada informasi tambahan (seperti
pengkodean komit atau komentar komit yang diperluas), pemirsa yang menyalahkan tidak akan peduli.

PEMETAAN PENULIS

Jika file .mailmap ada di tingkat atas repositori, atau di lokasi yang ditunjuk
oleh opsi konfigurasi mailmap.file atau mailmap.blob, ini digunakan untuk memetakan penulis dan
nama committer dan alamat email menjadi nama asli dan alamat email kanonik.

Dalam bentuk sederhana, setiap baris dalam file terdiri dari nama asli kanonik dari sebuah
penulis, spasi, dan alamat email yang digunakan dalam komit (dilampirkan oleh < dan >) untuk memetakan
untuk nama. Sebagai contoh:

Nama yang sah[email dilindungi]>

Bentuk yang lebih kompleks adalah:

<[email dilindungi]>[email dilindungi]>

yang memungkinkan mailmap untuk mengganti hanya bagian email dari komit, dan:

Nama yang sah[email dilindungi]>[email dilindungi]>

yang memungkinkan mailmap untuk mengganti nama dan email dari komit yang cocok dengan
alamat email komit yang ditentukan, dan:

Nama yang sah[email dilindungi]> Nama Komit[email dilindungi]>

yang memungkinkan mailmap untuk mengganti nama dan email dari komit yang cocok dengan keduanya
nama komit dan alamat email yang ditentukan.

Contoh 1: Riwayat Anda berisi komit oleh dua penulis, Jane dan Joe, yang namanya muncul
dalam repositori dalam beberapa bentuk:

Pengembang Joe[email dilindungi]>
Pengembang Joe R[email dilindungi]>
Jane Doe[email dilindungi]>
Jane Doe
Jane D.

Sekarang anggaplah Joe ingin inisial nama tengahnya digunakan, dan Jane lebih suka nama keluarganya
dijabarkan secara lengkap. File .mailmap yang tepat akan terlihat seperti:

Jane Doe
Pengembang Joe R[email dilindungi]>

Perhatikan bagaimana tidak perlu entri untuk , karena nama asli
bahwa penulis sudah benar.

Contoh 2: Repositori Anda berisi komit dari penulis berikut:

nick1[email dilindungi]>
nick2[email dilindungi]>
nick2[email dilindungi]>
santa[email dilindungi]>
klausa[email dilindungi]>
CTO[email dilindungi]>

Maka Anda mungkin menginginkan file .mailmap yang terlihat seperti:

<[email dilindungi]>[email dilindungi]>
Beberapa Bung[email dilindungi]> nick1[email dilindungi]>
Penulis lain[email dilindungi]> nick2[email dilindungi]>
Penulis lain[email dilindungi]>[email dilindungi]>
Sinterklas[email dilindungi]>[email dilindungi]>

Gunakan hash # untuk komentar yang berada di baris mereka sendiri, atau setelah alamat email.

Gunakan git-blame online menggunakan layanan onworks.net