OLD | NEW |
| (Empty) |
1 git-map(1) | |
2 ========== | |
3 | |
4 NAME | |
5 ---- | |
6 git-map - | |
7 include::_git-map_desc.helper.txt[] | |
8 | |
9 SYNOPSIS | |
10 -------- | |
11 [verse] | |
12 'git map' [<extra_args>...] | |
13 | |
14 DESCRIPTION | |
15 ----------- | |
16 | |
17 Git map formats the output of `git log --graph` from all refs such that: | |
18 | |
19 * Current branch is [aqua]#cyan#. | |
20 * Local branches are [green]#green#. | |
21 * Remote branches are [red]#red#. | |
22 * Tags are [fuchsia]#magenta#. | |
23 * Merge Base markers are [black-background white]#white#. | |
24 * The currently checked out commit is highlighted with a [yellow blue-background
]#blue background#. | |
25 | |
26 The output is automatically piped through the `less` pager command, even on | |
27 windows. | |
28 | |
29 OPTIONS | |
30 ------- | |
31 <extra_args>...:: | |
32 Extra parameters to pass to the internal linkgit:git-log[1] invocation. This | |
33 can be used to restrict what refs 'git map' operates on, etc. | |
34 + | |
35 If you run git map with a series of fixed arguments frequently, you can use | |
36 the depot-tools.map-extra configuration variable to pre-set arguments (See | |
37 `CONFIGURATION VARIABLES`) | |
38 | |
39 | |
40 CONFIGURATION VARIABLES | |
41 ----------------------- | |
42 | |
43 depot-tools.map-extra | |
44 ~~~~~~~~~~~~~~~~~~~~~ | |
45 | |
46 Each value of the 'depot-tools.map-extra' config variable is applied as an | |
47 additional argument to `git log` during the execution of git map. If you wish to | |
48 configure this, use git `config --add depot-tools.map-extra <value>` to do so. | |
49 | |
50 EXAMPLE | |
51 ------- | |
52 | |
53 Running 'git map' would result in an output something like: | |
54 demo:1[] | |
55 | |
56 As you can see, the structure of the commit history is visible, particularly | |
57 what the parents of each commit are. In order to see the 'upstream' | |
58 relationships of the branches (i.e. which branch is tracking which other | |
59 branch), use the linkgit:git-map-branches[1] command. | |
60 | |
61 SEE ALSO | |
62 -------- | |
63 linkgit:git-map-branches[1] | |
64 | |
65 include::_footer.txt[] | |
66 | |
67 // vim: ft=asciidoc: | |
OLD | NEW |