mirror of
https://github.com/git/git.git
synced 2024-10-31 14:27:54 +01:00
8587ead78a
When we pull the user's name from the GECOS field of the passwd file (or generate an email address based on their username and hostname), we put the result into a static buffer. While it's extremely unlikely that anybody ever hit these limits (after all, in such a case their parents must have hated them), we still had to deal with the error cases in our code. Converting these static buffers to strbufs lets us simplify the code and drop some error messages from the documentation that have confused some users. The conversion is mostly mechanical: replace string copies with strbuf equivalents, and access the strbuf.buf directly. There are a few exceptions: - copy_gecos and copy_email are the big winners in code reduction (since they no longer have to manage the string length manually) - git_ident_config wants to replace old versions of the default name (e.g., if we read the config multiple times), so it must reset+add to the strbuf instead of just adding Note that there is still one length limitation: the gethostname interface requires us to provide a static buffer, so we arbitrarily choose 1024 bytes for the hostname. Signed-off-by: Jeff King <peff@peff.net> Signed-off-by: Junio C Hamano <gitster@pobox.com>
75 lines
1.9 KiB
Text
75 lines
1.9 KiB
Text
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'.
|
|
ifdef::git-default-editor[]
|
|
The build you are using chose '{git-default-editor}' as the default.
|
|
endif::git-default-editor[]
|
|
|
|
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').
|
|
ifdef::git-default-pager[]
|
|
The build you are using chose '{git-default-pager}' as the default.
|
|
endif::git-default-pager[]
|
|
|
|
Diagnostics
|
|
-----------
|
|
You don't exist. Go away!::
|
|
The passwd(5) gecos field couldn't be read
|
|
|
|
SEE ALSO
|
|
--------
|
|
linkgit:git-commit-tree[1]
|
|
linkgit:git-tag[1]
|
|
linkgit:git-config[1]
|
|
|
|
GIT
|
|
---
|
|
Part of the linkgit:git[1] suite
|