tig(1) - f7

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

NAME

6       tig - text-mode interface for git
7

SYNOPSIS

9       tig [options]
10       tig [options] [--] [git options]
11       tig [options] log  [git options]
12       tig [options] diff [git options]
13       tig [options] show [git options]
14       tig [options] <    [git command output]
15
16

DESCRIPTION

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

OPTIONS

30       -l
31          Start up in log view using the internal log command.
32
33
34       -d
35          Start up in diff view using the internal diff command.
36
37
38       -S
39          Start up in status view.
40
41
42       -n[INTERVAL], --line-number[=INTERVAL]
43          Prefix line numbers in log and diff view. Optionally, with interval
44          different than each line.
45
46
47       -b[NSPACES], --tab-size[=NSPACES]
48          Set the number of spaces tabs should be expanded to.
49
50
51       -v, --version
52          Show version and exit.
53
54
55       -h, --help
56          Show help message and exit.
57
58
59       --
60          End of tig(1) options. Useful when specifying command options for
61          the main view. Example:
62
63
64          $ tig -- --since=1.month
65
66
67       log
68          Open log view using the given git log options.
69
70
71       diff
72          Open diff view using the given git diff options.
73
74
75       show
76          Open diff view using the given git show options.
77
78
79       [git options]
80          tig(1) will stop the option parsing when the first command line
81          parameter not starting with "-" is encountered. All options
82          including this one will be passed to git log when loading the main
83          view. This makes it possible to say:
84
85
86          $ tig tag-1.0..HEAD
87
88

ENVIRONMENT VARIABLES

90       TIG_LS_REMOTE
91          Set command for retrieving all repository references. The command
92          should output data in the same format as git-ls-remote(1).
93
94
95       TIG_DIFF_CMD
96          The command used for the diff view. By default, git show is used as
97          a backend.
98
99
100       TIG_LOG_CMD
101          The command used for the log view. If you prefer to have both author
102          and committer shown in the log view be sure to pass --pretty=fuller
103          to git log.
104
105
106       TIG_MAIN_CMD
107          The command used for the main view. Note, you must always specify
108          the option: --pretty=raw since the main view parser expects to read
109          that format.
110
111
112   Tree commands
113       TIG_TREE_CMD
114          The command used for the tree view. By default, git-ls-tree(1) is
115          used. The commands should expect first the commit ID and second a
116          path.
117
118
119       TIG_BLOB_CMD
120          The command used for the blob view. By default, git-cat-file(1) is
121          used. The command gets the blob ID.
122
123

FILES

125       ~/.tigrc
126          User configuration file. See tigrc(5) for examples.
127
128
129       .git/config
130          Repository config file. Read on start-up with the help of
131          git-repo-config(1).
132
133

BUGS

135       Known bugs and problems:
136
137
138       ·  Proper locale support: in it's current state tig is pretty much
139          UTF-8 only.
140
141
142       ·  Horizontal scrolling.
143
144

COPYRIGHT

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