tig(1) - f14

1TIG(1)                            Tig Manual                            TIG(1)
2
3
4

NAME

6       tig - text-mode interface for git
7

SYNOPSIS

9       tig        [options] [revisions] [--] [paths]
10       tig show   [options] [revisions] [--] [paths]
11       tig blame  [rev] path
12       tig status
13       tig <      [git command output]
14
15

DESCRIPTION

17       Browse changes in a git repository. Additionally, tig(1) can also act
18       as a pager for output of various git commands.
19
20       When browsing repositories, tig(1) uses the underlying git commands to
21       present the user with various views, such as summarized commit log and
22       showing the commit with the log message, diffstat, and the diff.
23
24       Using tig(1) as a pager, it will display input from stdin and try to
25       colorize it.
26

OPTIONS

28       Command line options recognized by tig include all valid git-log(1) and
29       git-diff(1) options, as well as the following subcommands and tig
30       specific options. The first command line parameter not starting with
31       "-" is interpreted as being either a revision specification or a path
32       and will end the option parsing. All following options will be passed
33       untouched to the underlying git command.
34
35       show
36           Open diff view using the given git show options.
37
38       blame
39           Show given file annotated or blamed by commits. Optionally limited
40           from given revision.
41
42       status
43           Start up in status view.
44
45       -v, --version
46           Show version and exit.
47
48       -h, --help
49           Show help message and exit.
50

EXAMPLES

52       Display the current branch:
53
54           $ tig
55
56
57       Display one or more specific branches:
58
59           $ tig test master
60
61
62       Display all branches:
63
64           $ tig --all
65
66
67       Display differences between two branches:
68
69           $ tig test..master
70
71
72       Display changes for a single file:
73
74           $ tig -- README
75
76
77       Display contents of the README file in a specific revision:
78
79           $ tig show tig-0.8:README
80
81
82       Display revisions between two dates for a specific file:
83
84           $ tig --after="2004-01-01" --before="2006-05-16" -- README
85
86

ENVIRONMENT VARIABLES

88       In addition to environment variables used by git (e.g. GIT_DIR), tig
89       defines the ones below. The command related environment variables have
90       access to the internal state of tig via replacement variables, such as
91       %(commit) and %(blob). See manpage:tigrc[5] for a full list.
92
93       TIGRC_USER
94           Path of the user configuration file (defaults to ~/.tigrc).
95
96       TIGRC_SYSTEM
97           Path of the system wide configuration file (defaults to
98           {sysconfdir}/tigrc).
99
100       TIG_LS_REMOTE
101           Set command for retrieving all repository references. The command
102           should output data in the same format as git-ls-remote(1).
103
104       TIG_DIFF_CMD
105           The command used for the diff view. By default, git show is used as
106           a backend.
107
108       TIG_LOG_CMD
109           The command used for the log view. If you prefer to have both
110           author and committer shown in the log view be sure to pass
111           --pretty=fuller to git log.
112
113       TIG_MAIN_CMD
114           The command used for the main view. Note, you must always specify
115           the option: --pretty=raw since the main view parser expects to read
116           that format.
117
118   Tree commands
119       TIG_TREE_CMD
120           The command used for the tree view. By default, git-ls-tree(1) is
121           used.
122
123       TIG_BLOB_CMD
124           The command used for the blob view. By default, git-cat-file(1) is
125           used.
126

FILES

128       ~/.tigrc
129           User configuration file. See manpage:tigrc[5] for examples.
130
131       /etc/tigrc
132           System wide configuration file.
133
134       $GIT_DIR/config, ´~/.gitconfig, ´/etc/etc/gitconfig
135           Git configuration files. Read on start-up with the help of
136           git-config(1).
137

BUGS

139       Known bugs and problems:
140
141       ·   Proper locale support: in it’s current state tig is pretty much
142           UTF-8 only.
143

COPYRIGHT

145       Copyright (c) 2006-2009 Jonas Fonseca <fonseca@diku.dk[1]>
146
147       This program is free software; you can redistribute it and/or modify it
148       under the terms of the GNU General Public License as published by the
149       Free Software Foundation; either version 2 of the License, or (at your
150       option) any later version.
151

NOTES

169        1. fonseca@diku.dk
170           mailto:fonseca@diku.dk
171
172
173
174Tig 0.15                          11/20/2009                            TIG(1)