Code

get_author_initials: various fixes
[tig.git] / tig.1.txt
index 6a7e266332ffcff9cb0c0b586b4781a246d9e3ce..490a0a247008663da6e0fc021150f09255e634ff 100644 (file)
--- 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,30 +110,10 @@ 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
 -----
@@ -141,14 +124,16 @@ FILES
        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 <fonseca@diku.dk>
+Copyright (c) 2006-2010 Jonas Fonseca <fonseca@diku.dk>
 
 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
 --------
 
-manpage: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: