\-v, \-\-version
Show version and exit\&.
+.TP
+\-h, \-\-help
+Show help message and exit\&.
+
.TP
\-\-
End of tig(1) options\&. Useful when specifying command options for the main view\&. Example:
.SH "THE VIEWER"
+The display consists of a status window on the last line of the screen and one or more views\&. The default is to only show one view at the time but it is possible to split both the main and log view to also show the commit diff\&.
+
+
+If you are in the log view and press \fIEnter\fR when the current line is a commit line, such as:
+
+.nf
+commit 4d55caff4cc89335192f3e566004b4ceef572521
+.fi
+
+
+You will split the view so that the log view is displayed in the top window and the diff view in the bottom window\&. You can switch between the two views by pressing \fITab\fR\&. To maximize the log view again, simply press \fIl\fR\&.
+
+.SS "Current head and commit ID"
+
+
+The viewer keeps track of both what head and commit ID you are currently viewing\&. The commit ID will follow the cursor line and change everytime time you highlight a different commit\&. Whenever you reopen the diff view it will be reloaded, if the commit ID changed\&.
+
+
+The head ID is used when opening the main and log view to indicate from what revision to show history\&.
+
+.SS "Views"
+
+
tig(1) presents various \fIviews\fR of a repository\&. Each view is based on output from an external command, most often \fIgit log\fR, \fIgit diff\fR, or \fIgit show\fR\&.
.TP
The help view
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\&.
+.SS "Title windows"
+
+
+Each view has a title window which shows the name of the view, current commit ID if available, and where the view is positioned:
+
+.nf
+[main] c622eefaa485995320bc743431bae0d497b1d875 \- commit 1 of 61 (1%)
+.fi
+
+
+By default, the title of the current view is highlighted using bold font\&.
+
.SH "KEYS"
h
Show man page\&.
+.SS "View manipulation"
+
.TP
-Return
-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 \fId\fR or press Return twice\&.
+q
+Close view, if multiple views are open it will jump back to the previous view in the view stack\&. If it is the last open view it will quit\&. Use \fIQ\fR to quit all views at once\&.
+
+.TP
+Enter
+This key is "context sensitive" depending on what view you are currently in\&. When in log view on a commit line or in the main view, split the view and show the commit diff\&. In the diff view pressing Enter will simply scroll the view one line down\&.
.TP
Tab
Switch to next view\&.
-.SS "Cursor navigation"
-
.TP
Up
-Move cursor one line up\&.
+This key is "context sensitive" and will move the cursor one line up\&. However, uf you opened a diff view from the main view (split\- or full\-screen) it will change the cursor to point to the previous commit in the main view and update the diff view to display it\&.
.TP
Down
-Move cursor one line down\&.
+Similar to \fIUp\fR but will move down\&.
-.TP
-k
-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\&.
+.SS "Cursor navigation"
.TP
j
-Move cursor one line down and enter\&.
+Move cursor one line up\&.
.TP
-PgUp
+k
+Move cursor one line down\&.
+
+.TP
+PgUp, b, \-
Move cursor one page up\&.
.TP
-PgDown
+PgDown, Space
Move cursor one page down\&.
.TP
.SS "Misc"
.TP
-q
-Quit
+Q
+Quit\&.
.TP
r
If you are interested only in those revisions that made changes to a specific file (or even several files) list the files like this:
.nf
-$ tig log Makefile
+$ tig log Makefile README
.fi
If you are only interested in changed that happened between two dates you can use:
.nf
-$ tig \-\- \-\-after=May\&.5th \-\-before=2006\-05\-16\&.15:44
+$ tig \-\- \-\-after="May 5th" \-\-before="2006\-05\-16 15:44"
.fi
.RS
.Sh "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"\&.
+If you want to avoid having to quote dates containing spaces you can use "\&." instead, e\&.g\&. \-\-after=May\&.5th\&.
.RE
.TP 3
\(bu
+In it's current state tig is pretty much UTF\-8 only\&.
+.TP
+\(bu
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\&.
.LP
~mdw / tig / blobdiff