?
本文檔使用 php中文網(wǎng)手冊(cè) 發(fā)布
git-annotate - 用提交信息注釋文件行
git annotate [options] file [revision]
使用引入該行的提交的信息來(lái)標(biāo)注給定文件中的每一行??梢詮慕o定的修訂中注釋。
這個(gè)命令與 git-blame [1] 唯一的區(qū)別在于它們使用稍微不同的輸出格式,并且此命令僅用于向后兼容以支持現(xiàn)有腳本,并為來(lái)自其他 SCM 系統(tǒng)的人員提供更熟悉的命令名稱(chēng)。
-b
顯示邊界提交的空白 SHA-1。這也可以通過(guò)blame.blankboundary
配置選項(xiàng)來(lái)控制。
--root
不要將根提交視為邊界。這也可以通過(guò)blame.showRoot
配置選項(xiàng)來(lái)控制。
--show-stats
在過(guò)失輸出結(jié)尾包含更多統(tǒng)計(jì)數(shù)據(jù)。
-L <start>,<end> -L :<funcname>
僅注釋給定的線范圍??梢远啻沃付?。重疊范圍是允許的。
<start>(<開(kāi)始>)和<end> (<結(jié)束>)是可選的?!?L <start>(-L <開(kāi)始>)”或“-L <start>(-L <開(kāi)始>)”跨越從 <start> (<開(kāi)始>)到文件結(jié)束。“-L,<end>(-L ,<結(jié)束>)”從文件開(kāi)始到<end>(<結(jié)束>)。
<start>(<開(kāi)始>)和<end>(<結(jié)束>)可以采取以下形式之一:
數(shù)字 如果<start> (<開(kāi)始>)或<end>(<結(jié)束>)是一個(gè)數(shù)字,它指定一個(gè)絕對(duì)行號(hào)(行數(shù)從1開(kāi)始)。
/regex/
這個(gè)表單將使用與給定的 POSIX 正則表達(dá)式匹配的第一行。如果 <start> 是一個(gè)正則表達(dá)式,它將從前一個(gè)-L
范圍的末尾(如果有的話)開(kāi)始搜索,否則從文件起始處開(kāi)始搜索。如果 <start> 是“^ / regex /”,它將從文件開(kāi)頭搜索。如果 <end> 是一個(gè)正則表達(dá)式,它將從 <start> 給出的行開(kāi)始搜索。
+offset or -offset
This is only valid for <end> and will specify a number of lines before or after the line given by <start>.
如果給出“:<funcname>”來(lái)代替<start>和<end>,它是一個(gè)正則表達(dá)式,表示從匹配<funcname>的第一個(gè) funcname 行到下一個(gè)funcname行的范圍。“:<funcname>”從上一個(gè)-L
范圍的末尾(如果有)搜索,否則從文件開(kāi)頭搜索?!癪:<funcname>”從文件開(kāi)頭搜索。
-l
顯示長(zhǎng)時(shí)間(默認(rèn):關(guān)閉)。
-t
顯示原始時(shí)間印章(默認(rèn)值:關(guān)閉)。
-S <revs-file>
使用 revs-file 中的修訂版而不是調(diào)用 git-rev-list [1]。
--reverse <rev>..<rev>
前進(jìn)而不是后退。它不是顯示一行出現(xiàn)的修訂,而是顯示一行存在的最后修訂。這需要一系列的修訂,如 START..END,在 START 中存在責(zé)任路徑。git blame --reverse START
是git blame --reverse START..HEAD
為了方便而用以代替的。
-p --porcelain
以設(shè)計(jì)用于機(jī)器消耗的格式顯示。
--line-porcelain
顯示易碎的格式,但輸出每行的提交信息,而不僅僅是第一次引用提交。意味著 - 易碎品。
--incremental
以設(shè)計(jì)用于機(jī)器消耗的格式逐步顯示結(jié)果。
--encoding=<encoding>
指定用于輸出作者姓名和提交摘要的編碼。將其設(shè)置為none
使責(zé)備輸出未轉(zhuǎn)換的數(shù)據(jù)。有關(guān)更多信息,請(qǐng)參閱有關(guān) git-log [1]手冊(cè)頁(yè)中編碼的討論。
--contents <file>
當(dāng)未指定<rev>時(shí),該命令注釋從工作樹(shù)副本向后開(kāi)始的更改。該標(biāo)志使命令假裝工作樹(shù)副本具有指定文件的內(nèi)容(指定-
使命令從標(biāo)準(zhǔn)輸入中讀?。?。
--date <format>
指定用于輸出日期的格式。如果未提供--date,則使用 blame.date 配置變量的值。如果 blame.date 配置變量也未設(shè)置,則使用 iso 格式。有關(guān)支持的值,請(qǐng)參閱 git-log [1]上的--date 選項(xiàng)的討論。
--no-progress
當(dāng)連接到終端時(shí),默認(rèn)情況下標(biāo)準(zhǔn)錯(cuò)誤流會(huì)報(bào)告進(jìn)度狀態(tài)。即使沒(méi)有附加到終端,該標(biāo)志也可以進(jìn)行進(jìn)度報(bào)告。不能將--progress
與--porcelain
或者--incremental
一起使用。
-M<num>
檢測(cè)文件中移動(dòng)或復(fù)制的行。當(dāng)提交移動(dòng)或復(fù)制一行代碼塊時(shí)(例如,原始文件有A然后B,提交將其更改為B然后A),傳統(tǒng)blame
算法只會(huì)注意到一半的移動(dòng),并且通常會(huì)將移動(dòng)的線(即B)交給雙親,并將責(zé)任分配給向下移動(dòng)(即A)到孩子提交的行。有了這個(gè)選項(xiàng),通過(guò)運(yùn)行額外的檢查通道,這兩組線都被歸咎于雙親。
<num>是可選的,但它是 Git 必須檢測(cè)的字母數(shù)字字符數(shù)的下限,以便在文件中移動(dòng)/復(fù)制,以便將這些行與父提交相關(guān)聯(lián)。默認(rèn)值是20。
-C<num>
除了-M
檢測(cè)從同一提交中修改的其他文件移動(dòng)或復(fù)制的行之外。當(dāng)您重新組織您的程序并在各個(gè)文件之間移動(dòng)代碼時(shí),這非常有用。當(dāng)該選項(xiàng)被賦予兩次時(shí),該命令會(huì)另外在創(chuàng)建該文件的提交中查找來(lái)自其他文件的副本。當(dāng)該選項(xiàng)被賦予三次時(shí),該命令還會(huì)在任何提交中查找來(lái)自其他文件的副本。
<num>是可選的,但它是 Git 必須檢測(cè)的字母數(shù)字字符數(shù)的下限,作為文件之間的移動(dòng)/復(fù)制,以便將這些行與父提交相關(guān)聯(lián)。默認(rèn)值是40。如果有多個(gè)-C
選項(xiàng),最后的<num>參數(shù)-C
將生效。
-h
顯示幫助信息。
--indent-heuristic --no-indent-heuristic
這些是為了幫助調(diào)試和調(diào)整實(shí)驗(yàn)啟發(fā)式(默認(rèn)情況下是關(guān)閉的),這些啟發(fā)式技術(shù)改變了差異邊界以使修補(bǔ)程序更易于閱讀。