tig

TIG(1)                                                                    TIG(1)



NAME
       tig - text-mode interface for git

SYNOPSIS
          tig [options]
          tig [options] [--] [git options]
          tig [options] log  [git options]
          tig [options] diff [git options]
          tig [options] show [git options]
          tig [options] <    [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..sp When browsing
       repositories, tig(1) uses the underlying git commands to present the user
       with various views, such as summarized commit log and showing the commit
       with the log message, diffstat, and the diff..sp Using tig(1) as a pager,
       it will display input from stdin and try to colorize it..sp

OPTIONS
       -l
          Start up in log view using the internal log command.

       -d
          Start up in diff view using the internal diff command.

       -n[INTERVAL], --line-number[=INTERVAL]
          Prefix line numbers in log and diff view. Optionally, with interval
          different than each line.

       -b[NSPACES], --tab-size[=NSPACES]
          Set the number of spaces tabs should be expanded to.

       -v, --version
          Show version and exit.

       -h, --help
          Show help message and exit.

       --
          End of tig(1) options. Useful when specifying command options for the
          main view. Example:

             $ tig -- --since=1.month

       log
          Open log view using the given git log options.

       diff
          Open diff view using the given git diff options.

       show
          Open diff view using the given git show options.

       [git options]
          tig(1) will stop the option parsing when the first command line
          parameter not starting with "-" is encountered. All options including
          this one will be passed to git log when loading the main view. This
          makes it possible to say:

             $ tig tag-1.0..HEAD

ENVIRONMENT VARIABLES
       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.

FILES
       ~/.tigrc
          User configuration file. See tigrc(5) for examples.

       .git/config
          Repository config file. Read on start-up with the help of
          git-repo-config(1).

BUGS
       Known bugs and problems:.sp

       ·  Proper locale support: in it's current state tig is pretty much UTF-8
          only.

       ·  Horizontal scrolling.

COPYRIGHT
       Copyright (c) 2006 Jonas Fonseca <fonseca@diku.dk>.sp 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 the Free Software
       Foundation; either version 2 of the License, or (at your option) any
       later version..sp

SEE ALSO
       tigrc(5), git(7), cogito(7), as well as other git repository browsers:
       gitk(1), qgit(1), gitview(1)..sp Online resources:.sp

       ·  Homepage: http://jonas.nitro.dk/tig

       ·  Manual: http://jonas.nitro.dk/tig/manual.html

       ·  Releases: http://jonas.nitro.dk/tig/releases

       ·  Git URL: http://jonas.nitro.dk/tig/tig.git or git://repo.or.cz/tig.git

       ·  Gitweb: http://repo.or.cz/?p=tig.git;a=summary



                                   01/26/2007                             TIG(1)