日本語 ▾ トピック ▾ 最新バージョン ▾ gitk の最終更新は 2.44.0

名前

gitk - Gitリポジトリブラウザ

概要

gitk [<options>] [<revision-range>] [--] [<path>…​]

説明

リポジトリまたは選択されたコミットセットの変更を表示します。これには、コミットグラフの視覚化、各コミットに関する情報の表示、および各リビジョンのツリー内のファイルの表示が含まれます。

オプション

表示するリビジョンを制御するために、gitkは git rev-list コマンドに適用できるほとんどのオプションをサポートしています。また、各コミットが導入する変更の表示方法を制御するために、 git diff-* コマンドに適用できるいくつかのオプションもサポートしています。最後に、gitk固有のオプションもいくつかサポートしています。

コマンドラインパーサーの制限により、gitkは通常、 スタック 形式 ( gitcli[7] を参照) の引数を持つオプションのみを理解します。

rev-list オプションと引数

このマニュアルページでは、最も頻繁に使用されるオプションのみを説明しています。完全なリストについては、 git-rev-list[1] を参照してください。

--all

すべての参照 (ブランチ、タグなど) を表示します。

--branches[=<pattern>]
--tags[=<pattern>]
--remotes[=<pattern>]

すべてのブランチ (タグ、リモートブランチ、それぞれ) がコマンドラインに <commit> としてリストされているかのように振る舞います。 <pattern> が指定されている場合、参照を、指定されたシェルglobに一致するものに限定します。パターンに ?*、または [ がない場合、最後に /* が暗黙的に追加されます。

--since=<date>

特定の時刻よりも新しいコミットを表示します。

--until=<date>

特定の時刻よりも古いコミットを表示します。

--date-order

可能な場合、コミットを日付順にソートします。

--merge

マージが競合で停止した後、競合ファイルを変更し、マージされるすべてのヘッドに存在しない、2つのブランチ (HEADとMERGE_HEAD) の間の履歴上のコミットを表示します。

--left-right

コミットが対称差のどちら側から到達可能であるかをマークします。左側のコミットには < 記号が、右側のコミットには > 記号がプレフィックスとして付きます。

--full-history

履歴を <path>…​ でフィルタリングするとき、一部の履歴を刈り込みません。(詳細な説明については、 git-log[1] の「History simplification」を参照してください。)

--simplify-merges

--full-history の追加オプションで、選択されたコミットがこのマージに寄与しないため、結果の履歴から不要なマージを削除します。(詳細な説明については、 git-log[1] の「History simplification」を参照してください。)

--ancestry-path

表示するコミットの範囲 (例: commit1..commit2 または commit2 ^commit1) が与えられた場合、 commit1commit2 の間の祖先チェーン上に直接存在するコミットのみを表示します。つまり、 commit1 の子孫であり、かつ commit2 の祖先であるコミットです。(詳細な説明については、 git-log[1] の「History simplification」を参照してください。)

-L<start>,<end>:<file>
-L:<funcname>:<file>

<file> 内の <start>,<end> で与えられる行範囲、または関数名正規表現 <funcname> の進化をトレースします。パス指定の制限は与えられません。これは現在、単一のリビジョンから始まるウォークに限定されており、つまり、正のリビジョン引数を0または1つしか与えることができず、 <start><end> (または <funcname>) は開始リビジョンに存在する必要があります。このオプションを複数回指定できます。--patch を暗黙的に指定します。パッチ出力は --no-patch を使用して抑制できますが、他の差分形式 (つまり --raw, --numstat, --shortstat, --dirstat, --summary, --name-only, --name-status, --check) は現在実装されていません。

<start><end> は次のいずれかの形式を取ることができます

  • 数値

    <start> または <end> が数字の場合、それは絶対行番号 (行は1から数えられます) を指定します。

  • /正規表現/

    この形式は、与えられたPOSIX正規表現に一致する最初の行を使用します。 <start> が正規表現の場合、前の -L 範囲 (存在する場合) の終わりから検索します。存在しない場合はファイルの最初から検索します。 <start>^/regex/ の場合、ファイルの最初から検索します。 <end> が正規表現の場合、 <start> で与えられた行から検索を開始します。

  • +オフセット または -オフセット

    これは <end> にのみ有効で、<start> で与えられた行の前または後の行数を指定します。

<start><end> の代わりに :<funcname> が与えられた場合、それは <funcname> に一致する最初の関数名行から次の関数名行までの範囲を示す正規表現です。:<funcname> は、前の -L 範囲 (存在する場合) の終わりから検索します。存在しない場合はファイルの最初から検索します。^:<funcname> はファイルの最初から検索します。関数名は git diff がパッチのハンクヘッダーを決定するのと同じ方法で決定されます ( gitattributes[5]Defining a custom hunk-header を参照)。

<revision range>

表示するリビジョンを制限します。これは、指定されたリビジョンから遡って表示する単一のリビジョン、または「<from>..<to>」の形式で、 <from> から <to> まで遡るすべてのリビジョンを表示する範囲のいずれかです。より高度なリビジョン選択を適用できることに注意してください。オブジェクト名の表記方法のより完全なリストについては、 gitrevisions[7] を参照してください。

<path>…​

指定されたパス内のファイルに影響するコミットに限定します。リビジョン名との曖昧さを避けるため、パスを先行するオプションと区切るために「--」を使用することに注意してください。

gitk固有のオプション

--argscmd=<command>

gitkが表示するリビジョン範囲を決定するたびに実行されるコマンド。このコマンドは、標準出力に表示する追加のリビジョンのリストを1行に1つずつ出力することが期待されます。表示するコミットセットが更新ごとに異なる可能性がある場合、明示的に <revision-range> を指定する代わりにこれを使用します。

--select-commit=<ref>

グラフの読み込み後に指定されたコミットを選択します。デフォルトの動作は --select-commit=HEAD を指定することと同じです。

gitk v2.6.12.. include/scsi drivers/scsi

v2.6.12 以降で、include/scsi または drivers/scsi サブディレクトリ内のファイルを変更した変更を表示します。

gitk --since="2 weeks ago" -- gitk

過去2週間のファイル gitk への変更を表示します。「--」は、 gitk という名前のブランチとの混同を避けるために必要です。

gitk --max-count=100 --all -- Makefile

ファイル Makefile に対して行われた最大100件の変更を表示します。現在のブランチでの変更のみを探すのではなく、すべてのブランチで変更を探します。

ファイル

ユーザー設定と環境設定は、

  • $XDG_CONFIG_HOME/git/gitk に存在する場合、それ以外の場合は

  • $HOME/.gitk に存在する場合

上記のいずれも存在しない場合、$XDG_CONFIG_HOME/git/gitk が作成され、デフォルトで使用されます。 $XDG_CONFIG_HOME が設定されていない場合、すべての場合でデフォルトで $HOME/.config になります。

履歴

Gitkは最初のグラフィカルなリポジトリブラウザでした。tcl/tkで書かれています。

gitk は実際には独立したプロジェクトとしてメンテナンスされていますが、エンドユーザーの利便のためにGitスイートの一部として安定版が配布されています。

gitk-git/ は Paul Mackerras の gitk プロジェクトから来ています。

git://ozlabs.org/~paulus/gitk

関連項目

qgit(1)

Qt を使用して C++ で書かれたリポジトリブラウザ。

tig(1)

Ncurses を使用して C で書かれた、最小限のリポジトリブラウザおよび Git ツール出力ハイライター。

GIT

git[1]スイートの一部

scroll-to-top