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