TIG(1) | Tig Manual | TIG(1) |
NAME¶
tig - text-mode interface for gitSYNOPSIS¶
tig [options] [revisions] [--] [paths] tig show [options] [revisions] [--] [paths] tig blame [options] [rev] [--] path tig status tig < [git command output]
DESCRIPTION¶
Browse changes in a git repository. Additionally, tig(1) can also act as a pager for output of various git commands.OPTIONS¶
Command line options recognized by tig include all valid git-log(1) and git-diff(1) options, as well as the following subcommands and tig specific options. The first command line parameter not starting with "-" is interpreted as being either a revision specification or a path and will end the option parsing. All following options will be passed untouched to the underlying git command. showOpen diff view using the given git-show(1)
options.
blame
Show given file annotated by commits. Takes
zero or more git-blame(1) options. Optionally limited from given
revision.
status
Start up in status view.
+<number>
Show the first view with line <number>
visible and selected.
-v, --version
Show version and exit.
-h, --help
Show help message and exit.
EXAMPLES¶
Display the current branch:$ tig
$ tig test master
$ tig --all
$ tig test..master
$ tig -- README
$ tig show tig-0.8:README
$ tig --after="2004-01-01" --before="2006-05-16" -- README
$ tig blame -C README
ENVIRONMENT VARIABLES¶
In addition to environment variables used by git (e.g. GIT_DIR), tig defines 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 tigrc(5) for a full list. TIGRC_USERPath of the user configuration file (defaults
to ~/.tigrc).
TIGRC_SYSTEM
Path of the system wide configuration file
(defaults to {sysconfdir}/tigrc).
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_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.
TIG_TRACE
Path for trace file where information about
git commands are logged.
FILES¶
~/.tigrcUser configuration file. See tigrc(5)
for examples.
/etc/tigrc
System wide configuration file.
$GIT_DIR/config, '~/.gitconfig, '/etc/etc/gitconfig
Git configuration files. Read on start-up with
the help of git-config(1).
BUGS¶
Bugs and feature requests can be reported using the issue tracker at https://github.com/jonas/tig/issues or by mail to either the git mailing list or directly to the maintainer. Ensure that the word "tig" is in the subject.COPYRIGHT¶
Copyright (c) 2006-2012 Jonas Fonseca < fonseca@diku.dk[1]>SEE ALSO¶
tigrc(5), tigmanual(7), git(7), gitk(1)•Homepage:
http://jonas.nitro.dk/tig/
•Tarballs:
http://jonas.nitro.dk/tig/releases/
•Git URL: git://github.com/jonas/tig.git
(master) or git://repo.or.cz/tig.git (mirror)
•Gitweb:
http://repo.or.cz/w/tig.git
NOTES¶
- 1.
- fonseca@diku.dk
mailto:fonseca@diku.dk
07/15/2012 | Tig 1.0 |