@@ -4,19 +4,23 @@ git-dag
44
55SYNOPSIS
66========
7+
78``git dag [options] [<revision-range>] [[--] [<path>...]] ``
89
910
1011DESCRIPTION
1112===========
13+
1214`git-dag ` is an advanced Git history visualizer that presents ``git log ``'s
1315powerful features in an easy to use graphical interface.
1416
1517
1618OPTIONS
1719=======
20+
1821``<revision-range> ``
1922--------------------
23+
2024Show only commits in the specified revision range.
2125When no ``<revision-range> `` is specified, it defaults to ``HEAD ``
2226(i.e. the whole history leading to the current commit).
@@ -28,27 +32,31 @@ For a complete list of ways to spell ``<revision-range>``, see the Specifying Ra
2832section of `gitrevisions(7) <https://git-scm.com/docs/gitrevisions >`_
2933(``man gitrevisions ``).
3034
31-
3235``--prompt ``
3336------------
37+
3438Prompt for a Git repository instead of using the current directory.
3539
3640``-r, --repo <path> ``
3741---------------------
42+
3843Open the git repository located at ``<path> ``.
3944Defaults to the current directory.
4045
4146``--version ``
4247-------------
48+
4349Print the version number and exit.
4450
4551``-h, --help ``
4652--------------
53+
4754Show usage and optional arguments.
4855
4956
5057Log Arguments
5158=============
59+
5260The ``Log `` text field allows you to pass arguments to `git log `.
5361This can be used to filter the displayed history, for example
5462entering `main -- Makefile ` will display only commits on the
@@ -58,33 +66,41 @@ The `Log` text field lets you interactively edit and replace the
5866``[<revision-range>] [[--] [<path>...]] `` arguments that were initially
5967specified on the command-line.
6068
69+
6170CONTEXT-MENU ACTIONS
6271====================
72+
6373The right-click menu can be used to perform various actions.
6474All actions operate on the selected commit.
6575
6676You can create branches and tags, cherry-pick commits, save patches,
6777export tarballs, and grab files from older commits using the context menu.
6878
79+
6980DIFF COMMITS
7081============
82+
7183You can diff arbitrary commits. Select a single commit in either the list
7284view or the graph view and then right-click on a second commit.
7385
7486A menu will appear allowing you to diff the two commits.
7587
88+
7689SHORTCUTS
7790=========
91+
7892You can run commands using dedicated shortcuts. Select a single commit
7993and then press `Ctrl-Alt-c ` to copy sha1 or `Ctrl-d ` to run diff tool.
8094
8195You can read more about hotkeys from 'keyboard shortcuts' window or context menu.
8296
97+
8398CONFIGURATION VARIABLES
8499=======================
85100
86101log.date
87102--------
103+
88104Set the default date-time format for the 'Date' field.
89105Setting a value for log.date is similar to using `git log `'s
90106`--date ` option. Possible values are `relative `, `local `,
0 commit comments