SYNOPSIS

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

DESCRIPTION

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

OPTIONS

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

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

rev-list options and arguments

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

--all

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

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

--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 {caret}commit1)場合、 commit1とcommit2の間の祖先チェーンに直接存在するコミット、つまりcommit1の子孫であり、commit2の祖先でもあるコミットのみを表示します。(詳細な説明については、 linkgit：git-log[1] の「History simplification」を参照してください。)

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

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

<start> と <end> は、以下のいずれかの形式です:

  • 数値

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

  • /regex/

    この形式は、指定されたPOSIX正規表現に一致する最初の行を使用します。 <start> が正規表現の場合、前の -L 範囲の末尾から検索します。それ以外の場合は、ファイルの先頭から検索します。 <start> が ^/regex/ の場合、ファイルの先頭から検索します。 <end> が正規表現の場合、 <start> で指定された行から検索開始します。

  • +offset or -offset

    これは <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-specific options

--argscmd=<command>

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

--select-commit=<ref>

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

Examples

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

バージョン「v2.6.12」以降の変更で、include/scsiまたはdrivers/scsiサブディレクトリ内で変更されたファイルを表示する

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

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

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

ファイル Makefile に加えられた最大100個の変更を表示します。現在のブランチの変更だけを探すのではなく、すべてのブランチを調べます。

Files

ユーザー構成と設定は以下の場所に保存されます:

  • 存在すれば $XDG_CONFIG_HOME/git/gitk です。でなければ、

  • 存在すれば $HOME/.gitk です。

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

History

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

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

gitk-git/ は、 Paul Mackerras のgitkプロジェクトからのものです:

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

SEE ALSO

qgit(1)

Qtを使用してC++で記述されたリポジトリブラウザです。

tig(1)

Ncursesを使用してCで記述された最小限のリポジトリブラウザーとGitツールの出力ハイライト。

GIT

Part of the git(1) suite