git-blame - Dalam talian di Awan

JADUAL:

NAMA

git-blame - Tunjukkan semakan dan pengarang yang terakhir mengubah suai setiap baris fail

SINOPSIS

pergi menyalahkan [-c] [-b] [-l] [--root] [-t] [-f] [-n] [-s] [-e] [-p] [-w] [--incremental]
[-L ] [-S ] [-M] [-C] [-C] [-C] [--sejak= ]
[--singkatan= ] [ | --kandungan | --terbalik ] [--]

DESCRIPTION

Menganotasi setiap baris dalam fail yang diberikan dengan maklumat daripada semakan yang terakhir
mengubah suai talian. Secara pilihan, mulakan anotasi daripada semakan yang diberikan.

Apabila dinyatakan satu kali atau lebih, -L mengehadkan anotasi kepada baris yang diminta.

Asal baris diikuti secara automatik merentasi nama semula keseluruhan fail (pada masa ini ada
tiada pilihan untuk mematikan penggantian nama). Untuk mengikuti baris yang dialihkan dari satu fail ke
lain, atau untuk mengikuti baris yang disalin dan ditampal daripada fail lain, dsb., lihat
-C dan -M pilihan.

Laporan itu tidak memberitahu anda apa-apa tentang baris yang telah dipadam atau diganti; awak
perlu menggunakan alat seperti pergi diff atau antara muka "pickaxe" yang disebut secara ringkas dalam
perenggan berikut.

Selain daripada menyokong anotasi fail, Git juga menyokong carian sejarah pembangunan
untuk apabila coretan kod berlaku dalam perubahan. Ini membolehkan anda menjejak apabila kod
coretan telah ditambahkan pada fail, dialihkan atau disalin antara fail, dan akhirnya dipadamkan atau
diganti. Ia berfungsi dengan mencari rentetan teks dalam perbezaan. Contoh kecil dari
antara muka pickaxe yang mencari blame_usage:

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

PILIHAN

-b
Tunjukkan SHA-1 kosong untuk komit sempadan. Ini juga boleh dikawal melalui
pilihan konfigurasi blame.blankboundary.

--akar
Jangan layan root commit sebagai sempadan. Ini juga boleh dikawal melalui
blame.showRoot pilihan konfigurasi.

--tunjuk-statistik
Sertakan statistik tambahan pada akhir output menyalahkan.

-L , , -L :
Anotasi hanya julat baris yang diberikan. Boleh dinyatakan beberapa kali. Bertindih
julat dibenarkan.

dan adalah pilihan. “-L ” atau “-L ,” merangkumi daripada kepada
akhir fail. “-L , ” merangkumi dari permulaan fail hingga .

dan boleh mengambil salah satu daripada borang ini:

· nombor

Jika atau ialah nombor, ia menentukan nombor baris mutlak (bilangan baris
daripada 1).

· /regex/

Borang ini akan menggunakan baris pertama yang sepadan dengan regex POSIX yang diberikan. Jika ialah
regex, ia akan mencari dari penghujung julat -L sebelumnya, jika ada, sebaliknya
dari permulaan fail. Jika ialah “^/regex/”, ia akan mencari dari permulaan
fail. Jika ialah regex, ia akan mencari bermula pada baris yang diberikan oleh .

· +offset atau -offset

Ini hanya sah untuk dan akan menentukan beberapa baris sebelum atau selepas
garisan yang diberikan oleh .

Jika ": ” diberikan sebagai ganti dan , ia adalah ungkapan biasa
yang menandakan julat daripada baris nama fungsi pertama yang sepadan , sehingga ke
baris nama fungsi seterusnya. “: ” carian dari hujung julat -L sebelumnya, jika
mana-mana, sebaliknya dari permulaan fail. “^: ” carian dari permulaan fail.

-l
Tunjukkan pusingan panjang (Lalai: mati).

-t
Tunjukkan cap masa mentah (Lalai: dimatikan).

-S
Gunakan semakan daripada revs-file dan bukannya memanggil git-rev-list(1).

--terbalik
Berjalan sejarah ke hadapan dan bukannya ke belakang. Daripada menunjukkan semakan di mana a
baris muncul, ini menunjukkan semakan terakhir yang mana baris telah wujud. Ini memerlukan
julat semakan seperti START..END di mana laluan untuk menyalahkan wujud dalam MULA.

-p, --porselin
Tunjukkan dalam format yang direka untuk penggunaan mesin.

--garis-porselin
Tunjukkan format porselin, tetapi maklumat komit output untuk setiap baris, bukan hanya baris
kali pertama komit dirujuk. Menyiratkan --porselin.

--bertambah
Tunjukkan hasil secara berperingkat dalam format yang direka untuk penggunaan mesin.

--pengekodan=
Menentukan pengekodan yang digunakan untuk mengeluarkan nama pengarang dan membuat ringkasan. Menetapkannya kepada
tiada yang menyalahkan output data yang tidak ditukar. Untuk maklumat lanjut lihat perbincangan
tentang pengekodan dalam git-log(1) halaman manual.

--kandungan
Bila tidak ditentukan, arahan itu mencatatkan perubahan bermula dari belakang
salinan pokok kerja. Bendera ini menjadikan perintah berpura-pura seolah-olah salinan pokok berfungsi
mempunyai kandungan fail bernama (nyatakan - untuk membuat arahan dibaca dari
input standard).

--Tarikh
Menentukan format yang digunakan untuk mengeluarkan tarikh. Jika --date tidak diberikan, nilai bagi
pembolehubah konfigurasi blame.date digunakan. Jika pembolehubah konfigurasi blame.date juga tidak ditetapkan,
format iso digunakan. Untuk nilai yang disokong, lihat perbincangan tentang pilihan --date
at git-log(1).

-M| |
Kesan garis yang dipindahkan atau disalin dalam fail. Apabila komit memindahkan atau menyalin blok
baris (cth fail asal mempunyai A dan kemudian B, dan komit menukarnya kepada B dan
kemudian A), tradisional menyalahkan algoritma perasan hanya separuh daripada pergerakan dan
lazimnya menyalahkan baris yang telah dialihkan ke atas (iaitu B) kepada ibu bapa dan mempersalahkan
kepada baris yang telah dialihkan ke bawah (iaitu A) kepada komit kanak-kanak. Dengan pilihan ini, kedua-duanya
kumpulan garisan dipersalahkan kepada ibu bapa dengan menjalankan pas pemeriksaan tambahan.

adalah pilihan tetapi ia adalah sempadan bawah pada bilangan aksara alfanumerik
bahawa Git mesti mengesan sebagai bergerak/menyalin dalam fail untuk ia mengaitkan baris tersebut
dengan komitmen ibu bapa. Nilai lalai ialah 20.

-C| |
Selain -M, mengesan baris yang dialihkan atau disalin daripada fail lain yang telah diubah suai
komitmen yang sama. Ini berguna apabila anda menyusun semula program anda dan mengalihkan kod
merentasi fail. Apabila pilihan ini diberikan dua kali, arahan itu juga mencari
salinan daripada fail lain dalam komit yang mencipta fail. Apabila pilihan ini diberikan
tiga kali, arahan itu juga mencari salinan daripada fail lain dalam sebarang komit.

adalah pilihan tetapi ia adalah sempadan bawah pada bilangan aksara alfanumerik
bahawa Git mesti mengesan sebagai bergerak/menyalin antara fail untuk ia mengaitkan baris tersebut
dengan komitmen ibu bapa. Dan nilai lalai ialah 40. Jika terdapat lebih daripada satu -C
pilihan yang diberikan, yang hujah -C terakhir akan berkuat kuasa.

-h
Tunjukkan mesej bantuan.

-c
Gunakan mod keluaran yang sama seperti git-anotasi(1) (Lalai: mati).

--skor-nyahpepijat
Sertakan maklumat penyahpepijatan yang berkaitan dengan pergerakan baris antara fail (lihat -C)
dan garisan dialihkan dalam fail (lihat -M). Nombor pertama yang disenaraikan ialah markah. Ini adalah
bilangan aksara abjad angka yang dikesan sebagai telah dialihkan antara atau dalam
fail. Ini mesti melebihi ambang tertentu untuk pergi menyalahkan untuk mempertimbangkan barisan tersebut
kod telah dialihkan.

-f, --show-name
Tunjukkan nama fail dalam komit asal. Secara lalai nama fail ditunjukkan jika ada
sebarang baris yang datang daripada fail dengan nama yang berbeza, disebabkan pengesanan nama semula.

-n, --tunjuk-nombor
Tunjukkan nombor baris dalam komit asal (Lalai: mati).

-s
Sekat nama pengarang dan cap masa daripada output.

-e, --tunjukkan-e-mel
Tunjukkan e-mel pengarang dan bukannya nama pengarang (Lalai: dimatikan). Ini pun boleh
dikawal melalui pilihan konfigurasi blame.showEmail.

-w
Abaikan ruang kosong apabila membandingkan versi ibu bapa dan anak untuk mencari di mana
garis datang dari.

--singkatan=
Daripada menggunakan digit heksadesimal 7+1 lalai sebagai nama objek yang disingkatkan,
guna +1 digit. Ambil perhatian bahawa 1 lajur digunakan untuk karet untuk menandakan komit sempadan.

THE PORSELAIN FORMAT

Dalam format ini, setiap baris adalah output selepas pengepala; pengepala sekurang-kurangnya mempunyai
baris pertama yang mempunyai:

· 40-bait SHA-1 baris komit dikaitkan dengan;

· nombor baris baris dalam fail asal;

· nombor baris baris dalam fail akhir;

· pada baris yang memulakan sekumpulan baris daripada komit yang berbeza daripada yang sebelumnya,
bilangan baris dalam kumpulan ini. Pada baris berikutnya medan ini tiada.

Baris pengepala ini diikuti oleh maklumat berikut sekurang-kurangnya sekali untuk setiap komit:

· nama pengarang ("pengarang"), e-mel ("mel pengarang"), masa ("masa pengarang"), dan zon waktu
("pengarang-tz"); begitu juga untuk committer.

· nama fail dalam komit yang dikaitkan dengan baris itu.

· baris pertama mesej log komit ("ringkasan").

Kandungan baris sebenar adalah output selepas pengepala di atas, diawali dengan TAB. ini
adalah untuk membenarkan menambah lebih banyak elemen pengepala kemudian.

Format porselin secara amnya menyekat maklumat komit yang telah dilihat.
Sebagai contoh, dua baris yang dipersalahkan kepada komit yang sama akan ditunjukkan, tetapi
butiran untuk komit itu akan ditunjukkan sekali sahaja. Ini lebih cekap, tetapi mungkin memerlukan
lebih banyak keadaan disimpan oleh pembaca. Pilihan --line-porcelain boleh digunakan untuk mengeluarkan penuh
komit maklumat untuk setiap baris, membenarkan penggunaan yang lebih mudah (tetapi kurang cekap) seperti:

# kira bilangan baris yang dikaitkan dengan setiap pengarang
git blame --line-porcelain file |
sed -n 's/^author //p' |
menyusun | uniq -c | sort -rn

MENYERTAI PERINGKAT

Tidak seperti pergi menyalahkan and pergi memberi keterangan dalam versi lama git, sejauh mana anotasi
boleh dihadkan kepada kedua-dua julat baris dan julat semakan. Pilihan -L, yang mengehadkan
anotasi kepada julat baris, boleh dinyatakan beberapa kali.

Apabila anda berminat untuk mencari asal bagi baris 40-60 untuk fail foo, anda boleh gunakan
pilihan -L seperti itu (maksudnya sama — kedua-duanya meminta 21 baris bermula pada baris
40):

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

Anda juga boleh menggunakan ungkapan biasa untuk menentukan julat baris:

git blame -L '/^sub hello {/,/^}$/' foo

yang mengehadkan anotasi kepada badan subrutin hello.

Apabila anda tidak berminat dengan perubahan yang lebih lama daripada versi v2.6.18, atau perubahan yang lebih lama daripada 3
minggu, anda boleh menggunakan penentu julat semakan yang serupa dengan pergi senarai semula:

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

Apabila penentu julat semakan digunakan untuk mengehadkan anotasi, baris yang tidak mempunyai
berubah sejak sempadan julat (sama ada komit v2.6.18 atau komit terbaharu yang
berumur lebih daripada 3 minggu dalam contoh di atas) dipersalahkan untuk komit sempadan julat itu.

Cara yang amat berguna adalah untuk melihat sama ada fail yang ditambahkan mempunyai baris yang dibuat melalui salin dan tampal
daripada fail sedia ada. Kadang-kadang ini menunjukkan bahawa pembangun bersikap cuai dan melakukannya
tidak memfaktorkan semula kod dengan betul. Anda boleh mencari komit yang memperkenalkan fail itu dahulu
dengan:

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

dan kemudian nyatakan perubahan antara komit dan ibu bapanya, menggunakan komit^! tatatanda:

git blame -C -C -f $commit^! -- foo

BERTAMBAH OUTPUT

Apabila dipanggil dengan --incremental option, arahan mengeluarkan hasil semasa ia dibina. The
output secara amnya akan bercakap tentang baris yang disentuh oleh komit yang lebih baru dahulu (iaitu
baris akan diberi anotasi tidak teratur) dan bertujuan untuk digunakan oleh penonton interaktif.

Format output adalah serupa dengan format Porcelain, tetapi ia tidak mengandungi yang sebenar
baris daripada fail yang sedang dianotasi.

1. Setiap entri kesalahan sentiasa bermula dengan baris:

<40-bait heks sha1>

Nombor baris dikira dari 1.

2. Kali pertama komit muncul dalam strim, ia mempunyai pelbagai maklumat lain
mengenainya dicetak dengan tag satu perkataan pada permulaan setiap baris yang menerangkan
maklumat komitmen tambahan (pengarang, e-mel, penyusun, tarikh, ringkasan, dsb.).

3. Tidak seperti format Porcelain, maklumat nama fail sentiasa diberikan dan ditamatkan
entri:

"nama fail"

dan oleh itu ia adalah benar-benar agak mudah untuk menghuraikan beberapa penghurai berorientasikan baris dan perkataan
(yang sepatutnya agak semula jadi untuk kebanyakan bahasa skrip).

Nota
Bagi orang yang melakukan penghuraian: untuk menjadikannya lebih mantap, abaikan sahaja sebarang baris antara
yang pertama dan yang terakhir (" baris " dan "nama fail") yang anda tidak kenali
perkataan tag (atau mengambil berat tentang yang tertentu) pada permulaan
baris "maklumat lanjutan". Dengan cara itu, jika terdapat maklumat tambahan (seperti
pengekodan komit atau ulasan komit lanjutan), penonton yang menyalahkan tidak akan peduli.

MAPPING PENGARANG

Jika fail .mailmap wujud di peringkat atas repositori atau pada lokasi yang ditunjukkan
oleh pilihan konfigurasi mailmap.file atau mailmap.blob, ia digunakan untuk memetakan pengarang dan
nama pemacu dan alamat e-mel kepada nama sebenar berkanun dan alamat e-mel.

Dalam bentuk ringkas, setiap baris dalam fail terdiri daripada nama sebenar kanonik an
pengarang, ruang kosong dan alamat e-mel yang digunakan dalam komit (disertakan oleh < and >) untuk memetakan
kepada nama. Sebagai contoh:

Nama yang betul[e-mel dilindungi]>

Bentuk yang lebih kompleks ialah:

<[e-mel dilindungi]>[e-mel dilindungi]>

yang membenarkan peta mel menggantikan hanya bahagian e-mel komit, dan:

Nama yang betul[e-mel dilindungi]>[e-mel dilindungi]>

yang membenarkan peta mel menggantikan kedua-dua nama dan e-mel komit yang sepadan dengan
alamat e-mel komit yang ditentukan, dan:

Nama yang betul[e-mel dilindungi]> Nama Komit[e-mel dilindungi]>

yang membolehkan peta mel menggantikan kedua-dua nama dan e-mel komit yang sepadan dengan kedua-dua
nama komit dan alamat e-mel yang dinyatakan.

Contoh 1: Sejarah anda mengandungi komitmen oleh dua pengarang, Jane dan Joe, yang namanya muncul
dalam repositori di bawah beberapa bentuk:

Joe Developer[e-mel dilindungi]>
Joe R. Pemaju[e-mel dilindungi]>
Jane Doe[e-mel dilindungi]>
Jane Doe
Jane D.

Sekarang anggap Joe mahu nama tengahnya digunakan, dan Jane lebih suka nama keluarganya
dinyatakan sepenuhnya. Fail .mailmap yang betul akan kelihatan seperti:

Jane Doe
Joe R. Pemaju[e-mel dilindungi]>

Perhatikan bagaimana tidak perlu untuk entri untuk , kerana nama sebenar
penulis itu sudah betul.

Contoh 2: Repositori anda mengandungi komit daripada pengarang berikut:

nick1[e-mel dilindungi]>
nick2[e-mel dilindungi]>
nick2[e-mel dilindungi]>
santa[e-mel dilindungi]>
klaus[e-mel dilindungi]>
CTO[e-mel dilindungi]>

Kemudian anda mungkin mahukan fail .mailmap yang kelihatan seperti:

<[e-mel dilindungi]>[e-mel dilindungi]>
Beberapa Kawan[e-mel dilindungi]> nick1[e-mel dilindungi]>
Pengarang Lain[e-mel dilindungi]> nick2[e-mel dilindungi]>
Pengarang Lain[e-mel dilindungi]>[e-mel dilindungi]>
Santa Claus[e-mel dilindungi]>[e-mel dilindungi]>

Gunakan hash # untuk komen yang sama ada pada baris mereka sendiri, atau selepas alamat e-mel.

Gunakan git-blame dalam talian menggunakan perkhidmatan onworks.net