?
本文檔使用 php中文網(wǎng)手冊 發(fā)布
gitk - Git 存儲庫瀏覽器
gitk [<options>] [<revision range>] [\--] [<path>…]
顯示存儲庫或選定提交集中的更改。這包括可視化提交圖,顯示與每個提交相關(guān)的信息以及每個修訂的樹中的文件。
為了控制顯示哪些版本,gitk 支持適用于該git rev-list
命令的大多數(shù)選項。它還支持適用于這些git diff-*
命令的幾個選項,以控制每個提交所引入的更改的方式。最后,它支持一些特定于 gitk 的選項。
sticked
由于命令行解析器的局限性,gitk 通常只能理解表單中帶有參數(shù)的選項(請參閱 gitcli [7])。
本手冊頁僅介紹最常用的選項。請參閱 git-rev-list [1] 獲取完整列表。
--all
顯示所有參考(分支,標(biāo)簽等)。
--branches=<pattern> --tags=<pattern> --remotes=<pattern>
假設(shè)所有分支(標(biāo)記,遠(yuǎn)程分支,響應(yīng))都在命令行中列為<commit>
。如果<pattern>
給出,則限制引用與給定 shell glob 相匹配的引用。如果模式?jīng)]有?
,*
或者[
,/*
在結(jié)束時暗示。
--since=<date>
顯示比特定日期更近的提交。
--until=<date>
顯示比特定日期更早的提交。
--date-order
盡可能按日期排序提交。
--merge
在嘗試合并帶有沖突的停止之后,在兩個分支(即 HEAD 和 MERGE_HEAD )之間顯示修改沖突文件并且不存在于合并的所有頭上的歷史提交。
--left-right
標(biāo)記可以從中提交提交的對稱差異的哪一側(cè)。左側(cè)的提交前面帶有一個<
符號,右側(cè)帶有>
符號。
--full-history
過濾歷史記錄時<path>…
,不會刪除一些歷史記錄。(有關(guān)更詳細(xì)的解釋,請參閱 git-log [1] 中的“歷史簡化”。)
--simplify-merges
附加選項可--full-history
從結(jié)果歷史記錄中刪除一些不必要的合并,因?yàn)闆]有選定的提交對此合并作出貢獻(xiàn)。(有關(guān)更詳細(xì)的解釋,請參閱 git-log [1] 中的“歷史簡化”。)
--ancestry-path
當(dāng)給定一系列提交顯示(例如commit1..commit2
或commit2 ^commit1
)時,只顯示直接存在于commit1
和之間的祖先鏈上的commit2
提交,即提交都是后代commit1
,以及祖先commit2
。(有關(guān)更詳細(xì)的解釋,請參閱 git-log [1] 中的“歷史簡化”。)
-L<start>,<end>:<file> -L:<funcname>:<file>
跟蹤由 <file> 中的 “<start>,<end>”(或函數(shù)名稱 regex <funcname> )給出的行范圍的演變。您不可以提供任何路徑限制器。這目前僅限于從單一修訂開始,也就是說,您可能只給出零個或一個正面修訂參數(shù)。您可以多次指定此選項。
注意: gitk(不像 git-log [1] )當(dāng)前只理解這個選項,如果你用它的參數(shù)指定它“粘在一起”。難道不是后加一個空格-L
。
<start> 和 <end> 可以采取以下形式之一:
數(shù)字如果 <start> 或 <end> 是一個數(shù)字,它將指定一個絕對行號(行數(shù)從1開始)。
/ regex /此表單將使用與給定的 POSIX 正則表達(dá)式匹配的第一行。如果 <start> 是一個正則表達(dá)式,它將從前一個-L
范圍的末尾(如果有的話)開始搜索,否則從文件起始處開始搜索。如果 <start> 是“^ / regex /”,它將從文件開頭搜索。如果 <end> 是一個正則表達(dá)式,它將從 <start> 給出的行開始搜索。
+ offset 或 -offset 這僅對 <end> 有效,并將在 <start> 給出的行之前或之后指定行數(shù)。
如果給出“:<funcname>”來代替 <start> 和 <end> ,它是一個正則表達(dá)式,表示從匹配 <funcname> 的第一個 funcname 行到下一個 funcname 行的范圍?!埃?lt;funcname>”從上一個-L
范圍的末尾(如果有)搜索,否則從文件開頭搜索?!癪:<funcname>”從文件開頭搜索。
<revision range>
限制修改顯示。這可以是單個修訂版的含義,從給定的修訂版本開始顯示,也可以是“ <from>
.. <to>
” 格式的范圍,以顯示所有修訂版本之間的<from>
返回<to>
。請注意,可以應(yīng)用更高級的修訂選擇。有關(guān)拼寫對象名稱的更完整列表,請參閱 gitrevisions [7] 。
<path>…
限制提交給定路徑中的文件。請注意,為避免版本名稱出現(xiàn)歧義,請使用“ - ”將路徑與前面的選項分開。
--argscmd=<command>
gitk 必須確定要顯示的修訂范圍時才運(yùn)行命令。預(yù)計該命令將在其標(biāo)準(zhǔn)輸出上打印一份附加修訂清單,每行一個。使用它而不是顯式地指定一個<revision range>
提交的集合是否可以在刷新之間變化。
--select-commit=<ref>
加載圖形后選擇指定的提交。默認(rèn)行為等同于指定--select-commit=HEAD
。
gitk v2.6.12 .. include / scsi drivers / scsi
顯示更改版本后v2.6.12
更改 include / scsi 或 drivers / scsi 子目錄中的任何文件的更改
gitk --since="2 weeks ago" -- gitk
在過去的兩周內(nèi)向文件顯示更改gitk
?!?- ”是避免與名稱gitk
分支混淆的必要條件
gitk --max-count=100 --all -- Makefile
最多顯示100個對該文件所做的更改Makefile
。而不是只查找所有分支中當(dāng)前分支的變化。
用戶配置和首選項存儲在:
$XDG_CONFIG_HOME/git/gitk
如果它存在,否則
$HOME/.gitk
如果存在
如果上述都不存在,則$XDG_CONFIG_HOME/git/gitk
默認(rèn)情況下會創(chuàng)建并使用它。如果$XDG_CONFIG_HOME
未設(shè)置,則默認(rèn)為$HOME/.config
所有情況。
Gitk 是第一個圖形資源庫瀏覽器。它是用 tcl / tk 編寫的。
gitk
實(shí)際上是作為一個獨(dú)立的項目來維護(hù)的,但為了方便最終用戶,穩(wěn)定版本作為 Git 套件的一部分進(jìn)行分發(fā)。
gitk-git /來自 Paul Mackerras 的 gitk 項目:
git://ozlabs.org/~paulus/gitk