X-Git-Url: https://git.distorted.org.uk/~mdw/tig/blobdiff_plain/598b9e7dd703a55d1ae60d553680b41f359b8176..b6607e7e796f5b58d64211c022d3e1af6159bdaa:/tig.1.txt diff --git a/tig.1.txt b/tig.1.txt index ea85954..7b1c779 100644 --- a/tig.1.txt +++ b/tig.1.txt @@ -1,4 +1,4 @@ -TIG(1) +tig(1) ====== NAME @@ -55,8 +55,10 @@ OPTIONS \--:: End of tig(1) options. Useful when specifying command options for the main view. Example: - - $ tig -- --since=1.month ++ +---------------------------------------------------------------------------- +$ tig -- --since=1.month +----------------------------------------------------------------------------- log:: Open log view using the given git log options. @@ -73,11 +75,57 @@ show:: 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 +----------------------------------------------------------------------------- + +EXAMPLES +-------- + +Display the current branch: +----------------------------------------------------------------------------- +$ tig +----------------------------------------------------------------------------- + +Display one or more specific branches: +----------------------------------------------------------------------------- +$ tig test master +----------------------------------------------------------------------------- + +Display all branches: +----------------------------------------------------------------------------- +$ tig -- --all +----------------------------------------------------------------------------- + +Display differences between two branches: +----------------------------------------------------------------------------- +$ tig test..master +----------------------------------------------------------------------------- - $ tig tag-1.0..HEAD +Display changes for a single file: +----------------------------------------------------------------------------- +$ tig -- README +----------------------------------------------------------------------------- + +Display revisions between two dates for a specific file: +----------------------------------------------------------------------------- +$ tig -- --after "2004-01-01" --before="2006-05-16" -- README +----------------------------------------------------------------------------- ENVIRONMENT VARIABLES --------------------- + +In addition to environment variables used by git (e.g. GIT_DIR), tig defines +the following: + +TIGRC_USER:: + Path of the user configuration file (defaults to `~/.tigrc`). + +TIGRC_SYSTEM:: + Path of the system wide configuration file (defaults to + `{sysconfdir}/tigrc`). + TIG_LS_REMOTE:: Set command for retrieving all repository references. The command should output data in the same format as git-ls-remote(1). @@ -112,9 +160,12 @@ FILES '~/.tigrc':: User configuration file. See gitlink:tigrc[5] for examples. -'.git/config':: +'{sysconfdir}/tigrc':: + System wide configuration file. + +'$GIT_DIR/config':: Repository config file. Read on start-up with the help of - git-repo-config(1). + git-config(1). include::BUGS[]