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