$ git show | tig-
@@ -335,6 +335,14 @@ to colorize it.
+ Show help message and exit. +
+If stdin is a pipe, any log or diff options will be ignored and the -pager view will be opened loading data from stdin. The pager mode -can be used for colorizing output from various git commands.
-Example on how to colorize the output of git-show(1):
-$ git show | tig-
All git command options specified on the command line will -be passed to the given command and all will be shell quoted -before they are passed to the shell.
-|
- Note
- |
-If you specify options for the main view, you should -not use the --pretty option as this option will be set -automatically to the format expected by the main view. | -
Example on how to open the log view and show both author and -committer information:
-$ tig log --pretty=fuller-
See the "Specifying revisions" section below -for an introduction to revision options supported by the git -commands. For details on specific git command options, refer -to the man page of the command in question.
Several options related to the interface with git can be configured -via environment options.
-Commits that are referenced by tags and branch heads will be marked -by the reference name surrounded by [ and ]:
-2006-03-26 19:42 Petr Baudis | [cogito-0.17.1] Cogito 0.17.1-
If you want to filter out certain directories under .git/refs/, say -tmp you can do it by setting the following variable:
-$ TIG_LS_REMOTE="git ls-remote . | sed /\/tmp\//d" tig-
Or set the variable permanently in your environment.
It is possible to alter which commands are used for the different views. -If for example you prefer commits in the main view to be sorted by date -and only show 500 commits, use:
-$ TIG_MAIN_CMD="git log --date-order -n500 --pretty=raw %s" tig-
Or set the variable permanently in your environment.
-Notice, how %s is used to specify the commit reference. There can -be a maximum of 5 %s ref specifications.
-tig(1) presents various views of a repository. Each view is based on output -from an external command, most often git log, git diff, or git show.
- Is the default view, and it shows a one line summary of each commit - in the chosen list of revision. The summary includes commit date, - author, and the first line of the log message. Additionally, any - repository references, such as tags, will be shown. + User configuration file. See tigrc(5) for examples.
- Presents a more rich view of the revision log showing the whole log - message and the diffstat. -
-- Shows either the diff of the current working tree, that is, what - has changed since the last commit, or the commit diff complete - with log message, diffstat and diff. -
-- Is used for displaying both input from stdin and output from git - commands entered in the internal prompt. -
-- Displays the information from the tig(1) man page. For the help view - to work you need to have the tig(1) man page installed. + Repository config file. Read on startup with the help of + git-repo-config(1).
Below the default key bindings are shown.
-- Switch to main view. -
-- Switch to diff view. -
-- Switch to log view. -
-- Switch to pager view. -
-- Show man page. -
-- If on a commit line show the commit diff. Additionally, if in - main or log view this will split the view. To open the commit - diff in full size view either use d or press Return twice. -
-- Switch to next view. -
-- Move cursor one line up. -
-- Move cursor one line down. -
-- Move cursor one line up and enter. When used in the main view - this will always show the diff of the current commit in the - split diff view. -
-- Move cursor one line down and enter. -
-- Move cursor one page up. -
-- Move cursor one page down. -
-- Jump to first line. -
-- Jump to last line. -
-Known bugs and problems:
+- Scroll view one line up. +In it's current state tig is pretty much UTF-8 only.
-- Scroll view one line down. +If the screen width is very small the main view can draw + outside the current view causing bad wrapping. Same goes + for title and status windows.
-- Scroll view one page up. +The cursor can wrap-around on the last line and cause the + window to scroll.
-- Scroll view one page down. +The prompt doesn't work while loading.
-Copyright (c) 2006 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 +the Free Software Foundation; either version 2 of the License, or +(at your option) any later version.
+Other git repository browsers:
+- Stop all background loading. This can be useful if you use - tig(1) in a repository with a long history without limiting - the revision log. +gitk(1)
- -- Show version. +qgit(1)
- -- Toggle line numbers on/off. +gitview(1)
- -Sites:
+- Open prompt. This allows you to specify what git command - to run. Example: +Homepage: http://jonas.nitro.dk/tig
-:log -p-
This section describes various ways to specify what revisions to display -or otherwise limit the view to. tig(1) does not itself parse the described -revision options so refer to the relevant git man pages for futher -information. Relevant man pages besides git-log(1) are git-diff(1) and -git-rev-list(1).
-You can tune the interaction with git by making use of the options -explained in this section. For example, by configuring the environment -variables described in the "View commands" section.
-If you are interested only in those revisions that made changes to a -specific file (or even several files) list the files like this:
-$ tig log Makefile-
To avoid ambiguity with repository references such as tag name, be sure -to separate file names from other git options using "--". So if you -have a file named master it will clash with the reference named -master, and thus you will have to use:
-$ tig log -- master-
|
- Note
- |
-For the main view, avoiding ambiguity will in some cases require -you to specify two "--" options. The first will make tig(1) stop -option processing and the latter will be passed to git log. | -
To speed up interaction with git, you can limit the amount of commits -to show both for the log and main view. Either limit by date using -e.g. --since=1.month or limit by the number of commits using -n400.
-If you are only interested in changed that happened between two dates -you can use:
-$ tig -- --after=May.5th --before=2006-05-16.15:44-
|
- Note
- |
-The dot (".") is used as a separator instead of a space to avoid -having to quote the option value. If you prefer use --after="May 5th" -instead of --after="May 5th". | -
Alternatively, commits can be limited to a specific range, such as -"all commits between tag-1.0 and tag-2.0". For example:
-$ tig log tag-1.0..tag-2.0-
This way of commit limiting makes it trivial to only browse the commits -which haven't been pushed to a remote branch. Assuming origin is your -upstream remote branch, using:
-$ tig log origin..HEAD-
will list what will be pushed to the remote branch. Optionally, the ending -HEAD can be left out since it is implied.
-Git interprets the range specifier "tag-1.0..tag-2.0" as -"all commits reachable from tag-2.0 but not from tag-1.0". -Where reachability refers to what commits are ancestors (or part of the -history) of the branch or tagged revision in question.
-If you prefer to specify which commit to preview in this way use the -following:
-$ tig log tag-2.0 ^tag-1.0-
You can think of ^ as a negation operator. Using this alternate syntax, -it is possible to further prune commits by specifying multiple branch -cut offs.
-Revisions options can to some degree be combined, which makes it possible -to say "show at most 20 commits from within the last month that changed -files under the Documentation/ directory."
-$ tig -- --since=1.month -n20 -- Documentation/-
In some cases, it can be useful to query changes across all references -in a repository. An example is to ask "did any line of development in -this repository change a particular file within the last week". This -can be accomplished using:
-$ tig -- --all --since=1.week -- Makefile-
Known bugs and problems:
--If the screen width is very small the main view can draw -outside the current view causing bad wrapping. Same goes -for title and status windows. +Releases: http://jonas.nitro.dk/tig/releases
Features that should be explored.
--Searching. +Git URL: http://jonas.nitro.dk/tig/tig.git
-Locale support. +Gitweb: http://pasky.or.cz/gitweb.cgi?p=tig.git;a=summary
Copyright (c) Jonas Fonseca <fonseca@diku.dk>, 2006
-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.
-