SYNOPSIS

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

DESCRIPTION

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

OPTIONS

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

gitk generally only understands options with arguments in the stuck form (see gitcli(7)) due to limitations in the command-line parser.

rev-list options and arguments

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

--all

Show all refs (branches, tags, etc.).

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

Pretend as if all the branches (tags, remote branches, resp.) are listed on the command line as <commit>. If <pattern> is given, limit refs to ones matching given shell glob. If pattern lacks ?, *, or [, /* at the end is implied.

--since=<date>

Show commits more recent than a specific date.

--until=<date>

Show commits older than a specific date.

--date-order

Sort commits by date when possible.

--merge

After an attempt to merge stops with conflicts, show the commits on the history between two branches (i.e. the HEAD and the MERGE_HEAD) that modify the conflicted files and do not exist on all the heads being merged.

--left-right

Mark which side of a symmetric difference a commit is reachable from. Commits from the left side are prefixed with a < symbol and those from the right with a > symbol.

--full-history

When filtering history with <path>…, does not prune some history. (See "History simplification" in git-log(1) for a more detailed explanation.)

--simplify-merges

Additional option to --full-history to remove some needless merges from the resulting history, as there are no selected commits contributing to this merge. (See "History simplification" in git-log(1) for a more detailed explanation.)

--ancestry-path

When given a range of commits to display (e.g. commit1..commit2 or commit2 ^commit1), only display commits that exist directly on the ancestry chain between the commit1 and commit2, i.e. commits that are both descendants of commit1, and ancestors of commit2. (See "History simplification" in git-log(1) for a more detailed explanation.)

-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>

Command to be run each time gitk has to determine the revision range to show. The command is expected to print on its standard output a list of additional revisions to be shown, one per line. Use this instead of explicitly specifying a <revision-range> if the set of commits to show may vary between refreshes.

--select-commit=<ref>

Select the specified commit after loading the graph. Default behavior is equivalent to specifying --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