X-Git-Url: https://git.tokkee.org/?a=blobdiff_plain;f=tig.1.txt;h=490a0a247008663da6e0fc021150f09255e634ff;hb=cbc5ebaaf7f082f334d06d770efddd37dea91e7f;hp=ee96a97b3277491e0490ece12789376b8e009c96;hpb=33d43e78b3c214adc9178b1c3b6e02311247da79;p=tig.git diff --git a/tig.1.txt b/tig.1.txt index ee96a97..490a0a2 100644 --- a/tig.1.txt +++ b/tig.1.txt @@ -10,7 +10,7 @@ SYNOPSIS [verse] tig [options] [revisions] [--] [paths] tig show [options] [revisions] [--] [paths] -tig blame [rev] path +tig blame [options] [rev] path tig status tig < [git command output] @@ -37,10 +37,11 @@ parsing. All following options will be passed untouched to the underlying git command. show:: - Open diff view using the given git show options. + Open diff view using the given git-show(1) options. blame:: - Show given file annotated or blamed by commits. + Show given file annotated by commits. + Takes zero or more git-blame(1) options. Optionally limited from given revision. status:: @@ -94,7 +95,9 @@ ENVIRONMENT VARIABLES --------------------- In addition to environment variables used by git (e.g. GIT_DIR), tig defines -the following: +the ones below. The command related environment variables have access to the +internal state of tig via replacement variables, such as `%(commit)` and +`%(blob)`. See manpage:tigrc[5] for a full list. TIGRC_USER:: Path of the user configuration file (defaults to `~/.tigrc`). @@ -107,48 +110,30 @@ TIG_LS_REMOTE:: Set command for retrieving all repository references. The command should output data in the same format as git-ls-remote(1). -TIG_DIFF_CMD:: - The command used for the diff view. By default, git show is used - as a backend. - -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. - -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. - -Tree commands -~~~~~~~~~~~~~ -TIG_TREE_CMD:: - The command used for the tree view. By default, git-ls-tree(1) is - used. The commands should expect first the commit ID and second - a path. - -TIG_BLOB_CMD:: - The command used for the blob view. By default, git-cat-file(1) is - used. The command gets the blob ID. +TIG_DIFF_OPTS:: + The diff options to use in the diff view. The diff view uses + git-show(1) for formatting and always passes --patch-with-stat, + --find-copies-harder, and -C. FILES ----- '~/.tigrc':: - User configuration file. See gitlink:tigrc[5] for examples. + User configuration file. See manpage:tigrc[5] for examples. '{sysconfdir}/tigrc':: System wide configuration file. '$GIT_DIR/config':: - Repository config file. Read on start-up with the help of +'~/.gitconfig:: +'{sysconfdir}/etc/gitconfig:: + Git configuration files. Read on start-up with the help of git-config(1). include::BUGS[] COPYRIGHT --------- -Copyright (c) 2006-2008 Jonas Fonseca +Copyright (c) 2006-2010 Jonas Fonseca This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by @@ -158,8 +143,7 @@ the Free Software Foundation; either version 2 of the License, or SEE ALSO -------- -gitlink:tigrc[5], git(7), cogito(7), as well as other git repository browsers: -gitk(1), qgit(1), gitview(1). +manpage:tigrc[5], manpage:tigmanual[7], git(7), gitk(1) Online resources: