SYNOPSIS

git map [<extra_args>…]

DESCRIPTION

Git map formats the output of git log --graph from all refs such that:

  • Current branch is cyan.

  • Local branches are green.

  • Remote branches are red.

  • Tags are magenta.

  • Merge Base markers are white.

  • The currently checked out commit is highlighted with a blue background.

The output is automatically piped through the less pager command, even on windows.

OPTIONS

<extra_args>…

Extra parameters to pass to the internal git-log(1) invocation. This can be used to restrict what refs git map operates on, etc.

If you run git map with a series of fixed arguments frequently, you can use the depot-tools.map-extra configuration variable to pre-set arguments (See CONFIGURATION VARIABLES)

CONFIGURATION VARIABLES

depot-tools.map-extra

Each value of the depot-tools.map-extra config variable is applied as an additional argument to git log during the execution of git map. If you wish to configure this, use git config --add depot-tools.map-extra <value> to do so.

EXAMPLE

Running git map would result in an output something like:

$ git map
*​ 7dcfe47        (​frozen_changes​) 2014-03-12 ~ FREEZE.unindexed
* 4b0c180        2014-03-12 ~ modfile
* 59a7cca        2014-03-12 ~ a deleted file
* 6bec695        (​origin/master​) 2014-03-11 ~ Add neat feature    <(frozen_changes)
* d15a38a        2014-03-11 ~ Epic README update
* d559894        (​master​) 2014-03-11 ~ Important upstream change
| * 9c311fd      (​cool_feature​) 2014-03-11 ~ Respond to CL comments
| | * 2a1eeb2    (​subfeature​) 2014-03-11 ~ integrate with CoolService
| | * d777af6    2014-03-11 ~ slick commenting action
| |/
| * 265803a      2014-03-11 ~ another improvement    <(subfeature)
| * 6d831ac      (​spleen_tag​) 2014-03-11 ~ Refactor spleen
| * 82e74ab      2014-03-11 ~ Add widget
|/
* d08c5b3        (​bogus_noparent​) 2014-03-11 ~ Wonderful beginnings    <(cool_feature)

As you can see, the structure of the commit history is visible, particularly what the parents of each commit are. In order to see the upstream relationships of the branches (i.e. which branch is tracking which other branch), use the git-map-branches(1) command.

SEE ALSO

git-map-branches(1)

CHROMIUM DEPOT_TOOLS

Part of the chromium depot_tools(1) suite. These tools are meant to assist with the development of chromium and related projects. Download the tools from here.