diff --git a/manual.txt b/manual.txt
index b8536da6242efc12078603a26ed5381658cabaae..c9b18932fd98705bff238aa1af9b897094f6a16d 100644 (file)
--- a/manual.txt
+++ b/manual.txt
empty for the root directory.
|%(file) |The currently selected file.
|%(ref) |The reference given to blame or HEAD if undefined.
-|%(rev-args) |The revision arguments passed on the command line.
-|%(file-args) |The file arguments passed on the command line.
-|%(diff-args) |The diff options passed on the command line.
+|%(revargs) |The revision arguments passed on the command line.
+|%(fileargs) |The file arguments passed on the command line.
+|%(diffargs) |The diff options passed on the command line.
|=============================================================================
[[title-window]]
--
-[[history-commands]]
-History Commands
-~~~~~~~~~~~~~~~~
+[[diff-options]]
+Diff options
+~~~~~~~~~~~~
-It is possible to alter which commands are used for the different views. If
-for example you prefer commits in the main view to be sorted by date and only
-show 500 commits, use:
+It is possible to alter how diffs are shown by the diff view. If for example
+you prefer to have commit and author dates shown as relative dates, use:
-----------------------------------------------------------------------------
-$ TIG_MAIN_CMD="git log --date-order -n500 --pretty=raw %(head)" tig
+$ TIG_DIFF_OPTS="--relative-date" tig
-----------------------------------------------------------------------------
Or set the variable permanently in your environment.
-Notice, how `%(head)` is used to specify the commit reference.
-
---
-
-TIG_DIFF_CMD::
-
- The command used for the diff view. Defaults to:
------------------------------------------------------------------------------
-git show --pretty=fuller --no-color --root
- --patch-with-stat --find-copies-harder -C %(commit)
------------------------------------------------------------------------------
-
-TIG_LOG_CMD::
-
- The command used for the log view. If you prefer to have both
- author and committer shown in the log view be sure to pass
- `--pretty=fuller` to git log. Defaults to:
------------------------------------------------------------------------------
-git log --no-color --cc --stat -n100 %(head)
------------------------------------------------------------------------------
-
-TIG_MAIN_CMD::
-
- The command used for the main view. Note, you must always specify
- the option: `--pretty=raw` since the main view parser expects to
- read that format.
------------------------------------------------------------------------------
-git log --no-color --pretty=raw --parents --topo-order %(head)
------------------------------------------------------------------------------
-
---
-
-[[tree-commands]]
-Tree Commands
-~~~~~~~~~~~~~
-
---
-
-TIG_TREE_CMD::
-
- The command used for the tree view. Defaults to:
------------------------------------------------------------------------------
-git ls-tree %(commit) %(directory)
------------------------------------------------------------------------------
-
-TIG_BLOB_CMD::
-
- The command used for the blob view. Defaults to:
------------------------------------------------------------------------------
-git cat-file blob %(blob)
------------------------------------------------------------------------------
-
---
-
[[keys]]
Default Keybindings
-------------------
|s |Scroll view one page down.
|Left |Scroll view one column left.
|Right |Scroll view one column right.
+|\| |Scroll view to the first column.
|=============================================================================
[[searching]]
|D |Toggle date display on/off/short/relative/local.
|A |Toggle author display on/off/abbreviated.
|g |Toggle revision graph visualization on/off.
+|~ |Toggle (line) graphics mode
|F |Toggle reference display on/off (tag and branch names).
|: |Open prompt. This allows you to specify what git command
to run. Example `:log -p`. You can also use this to jump
git-rev-list(1).
You can tune the interaction with git by making use of the options explained
-in this section. For example, by configuring the environment variables
-described in the section on <<history-commands, history commands>>.
+in this section. For example, by configuring the environment variable
+described in the section on <<diff-options, diff options>>.
[[path-limiting]]
Limit by Path Name