mirror of
https://github.com/git/git
synced 2024-08-24 02:11:08 +00:00
4e0ce4dfea
Some distributors customize the fallback pager and editor used by git commands when the user has not indicated a preference via the core.editor/core.pager configuration or GIT_EDITOR, GIT_PAGER, VISUAL, EDITOR, and PAGER environment variables, and git's build system provides DEFAULT_PAGER and DEFAULT_EDITOR makefile settings to help them with that (see v1.6.6-rc0~24, 2009-11-20). Unfortunately those compile-time settings do not affect the documentation, so the uninitiated user who tries to understand git by reading the git-var(1) manpage can easily be confused when git falls back to 'nano' and 'more' instead of 'vi' and 'less'. Even if the distributor patches the distributed docs to reflect the new default, the user may read the official documentation from the git-htmldocs repository online and be confused in the same way. Add a few words stating that the defaults are customizable at compile time to make the behavior crystal clear. Reported-by: Rodrigo Silva (MestreLion) <linux@rodrigosilva.com> Signed-off-by: Jonathan Nieder <jrnieder@gmail.com> Signed-off-by: Junio C Hamano <gitster@pobox.com>
74 lines
1.8 KiB
Plaintext
74 lines
1.8 KiB
Plaintext
git-var(1)
|
|
==========
|
|
|
|
NAME
|
|
----
|
|
git-var - Show a git logical variable
|
|
|
|
|
|
SYNOPSIS
|
|
--------
|
|
[verse]
|
|
'git var' ( -l | <variable> )
|
|
|
|
DESCRIPTION
|
|
-----------
|
|
Prints a git logical variable.
|
|
|
|
OPTIONS
|
|
-------
|
|
-l::
|
|
Cause the logical variables to be listed. In addition, all the
|
|
variables of the git configuration file .git/config are listed
|
|
as well. (However, the configuration variables listing functionality
|
|
is deprecated in favor of `git config -l`.)
|
|
|
|
EXAMPLE
|
|
--------
|
|
$ git var GIT_AUTHOR_IDENT
|
|
Eric W. Biederman <ebiederm@lnxi.com> 1121223278 -0600
|
|
|
|
|
|
VARIABLES
|
|
----------
|
|
GIT_AUTHOR_IDENT::
|
|
The author of a piece of code.
|
|
|
|
GIT_COMMITTER_IDENT::
|
|
The person who put a piece of code into git.
|
|
|
|
GIT_EDITOR::
|
|
Text editor for use by git commands. The value is meant to be
|
|
interpreted by the shell when it is used. Examples: `~/bin/vi`,
|
|
`$SOME_ENVIRONMENT_VARIABLE`, `"C:\Program Files\Vim\gvim.exe"
|
|
--nofork`. The order of preference is the `$GIT_EDITOR`
|
|
environment variable, then `core.editor` configuration, then
|
|
`$VISUAL`, then `$EDITOR`, and then the default chosen at compile
|
|
time, which is usually 'vi'.
|
|
|
|
GIT_PAGER::
|
|
Text viewer for use by git commands (e.g., 'less'). The value
|
|
is meant to be interpreted by the shell. The order of preference
|
|
is the `$GIT_PAGER` environment variable, then `core.pager`
|
|
configuration, then `$PAGER`, and then the default chosen at
|
|
compile time (usually 'less').
|
|
|
|
Diagnostics
|
|
-----------
|
|
You don't exist. Go away!::
|
|
The passwd(5) gecos field couldn't be read
|
|
Your parents must have hated you!::
|
|
The passwd(5) gecos field is longer than a giant static buffer.
|
|
Your sysadmin must hate you!::
|
|
The passwd(5) name field is longer than a giant static buffer.
|
|
|
|
SEE ALSO
|
|
--------
|
|
linkgit:git-commit-tree[1]
|
|
linkgit:git-tag[1]
|
|
linkgit:git-config[1]
|
|
|
|
GIT
|
|
---
|
|
Part of the linkgit:git[1] suite
|