docs/git-dag.rst

   1 ==========
   2 git-dag(1)
   3 ==========
   4
   5 SYNOPSIS
   6 ========
   7 git dag [options] [<since>..<until>] [[--] [<path>...]]
   8
   9 DESCRIPTION
  10 ===========
  11 `git-dag` is a powerful Git history visualizer.
  12 `git-dag` presents powerful `git log` features in a simple-to-use
  13 graphical interface.
  14
  15 OPTIONS
  16 =======
  17
  18 ``--prompt``
  19 ------------
  20 Prompt for a Git repository instead of using the current directory.
  21
  22 ``-r, --repo <path>``
  23 ---------------------
  24 Run `git dag` on the git repository in `<path>`.
  25 Defaults to the current directory.
  26
  27 ``--version``
  28 -------------
  29 Print the `git dag` version and exit.
  30
  31 ``-h, --help``
  32 --------------
  33 Show usage and optional arguments.
  34
  35 Log Options
  36 ===========
  37 The `Log` prompt allows you to pass arguments to `git log`.
  38 This can be used to filter the displayed history, for example
  39 entering `main -- Makefile` will display only commits on the
  40 `main` branch that touch the `Makefile`.
  41
  42 CONTEXT-MENU ACTIONS
  43 ====================
  44 The right-click menu can be used to perform various actions.
  45 All actions operate on the selected commit.
  46
  47 You can create branches and tags, cherry-pick commits, save patches,
  48 export tarballs, and grab files from older commits using the context menu.
  49
  50 DIFF COMMITS
  51 ============
  52 You can diff arbitrary commits.  Select a single commit in either the list
  53 view or the graph view and then right-click on a second commit.
  54
  55 A menu will appear allowing you to diff the two commits.
  56
  57 SHORTCUTS
  58 =========
  59 You can run commands using dedicated shortcuts. Select a single commit
  60 and then press `Ctrl-Alt-c` to copy sha1 or `Ctrl-d` to run diff tool.
  61
  62 You can read more about hotkeys from 'keyboard shortcuts' window or context menu.
  63
  64 CONFIGURATION VARIABLES
  65 =======================
  66
  67 log.date
  68 --------
  69 Set the default date-time format for the 'Date' field.
  70 Setting a value for log.date is similar to using `git log`'s
  71 `--date` option.  Possible values are `relative`, `local`,
  72 `default`, `iso`, `rfc`, and `short`; see git-log(1) for details.