X-Git-Url: https://git.distorted.org.uk/~mdw/tig/blobdiff_plain/a643fbd72dc16eb863c4a564c23e7a54a5e9dd73..9d6976b987b08e6b4c4077352ef72bbfd4eccce6:/manual.txt diff --git a/manual.txt b/manual.txt index 637b85c..cf7b83f 100644 --- a/manual.txt +++ b/manual.txt @@ -12,6 +12,8 @@ the user with various views, such as summarized commit log and showing the commit with the log message, diffstat, and the diff. ifndef::backend-docbook[] +*Table of Contents* + include::manual.toc[] endif::backend-docbook[] @@ -142,7 +144,7 @@ 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 +viewing. The commit ID will follow the cursor line and change every time you highlight a different commit. Whenever you reopen the diff view it will be reloaded, if the commit ID changed. @@ -171,6 +173,15 @@ The diff view:: has changed since the last commit, or the commit diff complete with log message, diffstat and diff. +The tree view:: + Lists directory trees associated with the current revision allowing + subdirectories to be descended or ascended and file blobs to be + viewed. + +The blob view:: + Displays the file content or "blob" of data associated with a file + name. + The pager view:: Is used for displaying both input from stdin and output from git commands entered in the internal prompt. @@ -198,100 +209,109 @@ be appended: ----------------------------------------------------------------------------- [[keys]] -Keys ----- +Default Keybindings +------------------- Below the default key bindings are shown. [[view-switching]] View Switching ~~~~~~~~~~~~~~ -m:: - Switch to main view. -d:: - Switch to diff view. -l:: - Switch to log view. -p:: - Switch to pager view. -h, ?:: - Show man page. + +`-------`-------------------------------------------------------------------- +Key Action +----------------------------------------------------------------------------- +m Switch to main view. +d Switch to diff view. +l Switch to log view. +p Switch to pager view. +t Switch to (directory) tree view. +f Switch to (file) blob view. +h Show man page. +----------------------------------------------------------------------------- [[view-manipulation]] View Manipulation ~~~~~~~~~~~~~~~~~ -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 + +`-------`-------------------------------------------------------------------- +Key Action +----------------------------------------------------------------------------- +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 'Q' to quit all views at once. -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 +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. -Tab:: - Switch to next view. -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 +Tab Switch to next view. +Up This key is "context sensitive" and will move the cursor one \ + line up. However, if 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. -Down:: - Similar to 'Up' but will move down. +Down Similar to 'Up' but will move down. +----------------------------------------------------------------------------- [[cursor-nav]] Cursor Navigation ~~~~~~~~~~~~~~~~~ -j:: - Move cursor one line up. -k:: - Move cursor one line down. -PgUp:: -b:: --:: - Move cursor one page up. -PgDown:: -Space:: - Move cursor one page down. -Home:: - Jump to first line. -End:: - Jump to last line. + +`-------`-------------------------------------------------------------------- +Key Action +----------------------------------------------------------------------------- +j Move cursor one line up. +k Move cursor one line down. +PgUp,\ +-,a Move cursor one page up. +PgDown Space Move cursor one page down. +Home Jump to first line. +End Jump to last line. +----------------------------------------------------------------------------- [[view-scrolling]] Scrolling ~~~~~~~~~ -Insert:: - Scroll view one line up. -Delete:: - Scroll view one line down. -w:: - Scroll view one page up. -s:: - Scroll view one page down. + +`-------`-------------------------------------------------------------------- +Key Action +----------------------------------------------------------------------------- +Insert Scroll view one line up. +Delete Scroll view one line down. +w Scroll view one page up. +s Scroll view one page down. +----------------------------------------------------------------------------- + +[[searching]] +Searching +~~~~~~~~~ + +`-------`-------------------------------------------------------------------- +Key Action +----------------------------------------------------------------------------- +/ Search the view. Opens a prompt for entering search regex to use. +? Search backwards in the view. Also prompts for regex. +n Find next match for the current search regex. +N Find previous match for the current search regex. +----------------------------------------------------------------------------- [[misc-keys]] Misc ~~~~ -Q:: - Quit. -r:: - Redraw screen. -z:: - Stop all background loading. This can be useful if you use - tig in a repository with a long history without limiting + +`-------`-------------------------------------------------------------------- +Key Action +----------------------------------------------------------------------------- +Q Quit. +r Redraw screen. +z Stop all background loading. This can be useful if you use \ + tig in a repository with a long history without limiting \ the revision log. -v:: - Show version. -n:: - Toggle line numbers on/off. -g:: - Toggle revision graph visualization on/off. -':':: - Open prompt. This allows you to specify what git command - to run. Example: - - :log -p +v Show version. +'.' Toggle line numbers on/off. +g Toggle revision graph visualization on/off. +':' Open prompt. This allows you to specify what git command \ + to run. Example `:log -p` +----------------------------------------------------------------------------- [[refspec]] Revision Specification @@ -299,7 +319,7 @@ Revision Specification This section describes various ways to specify what revisions to display or otherwise limit the view to. Tig does not itself parse the described -revision options so refer to the relevant git man pages for futher +revision options so refer to the relevant git man pages for further information. Relevant man pages besides git-log(1) are git-diff(1) and git-rev-list(1).