Merge branch 'dg/bswap-msvc'
[git] / Documentation / config / user.txt
1 user.name::
2 user.email::
3 author.name::
4 author.email::
5 committer.name::
6 committer.email::
7         The `user.name` and `user.email` variables determine what ends
8         up in the `author` and `committer` field of commit
9         objects.
10         If you need the `author` or `committer` to be different, the
11         `author.name`, `author.email`, `committer.name` or
12         `committer.email` variables can be set.
13         Also, all of these can be overridden by the `GIT_AUTHOR_NAME`,
14         `GIT_AUTHOR_EMAIL`, `GIT_COMMITTER_NAME`,
15         `GIT_COMMITTER_EMAIL` and `EMAIL` environment variables.
16 +
17 Note that the `name` forms of these variables conventionally refer to
18 some form of a personal name.  See linkgit:git-commit[1] and the
19 environment variables section of linkgit:git[1] for more information on
20 these settings and the `credential.username` option if you're looking
21 for authentication credentials instead.
22
23 user.useConfigOnly::
24         Instruct Git to avoid trying to guess defaults for `user.email`
25         and `user.name`, and instead retrieve the values only from the
26         configuration. For example, if you have multiple email addresses
27         and would like to use a different one for each repository, then
28         with this configuration option set to `true` in the global config
29         along with a name, Git will prompt you to set up an email before
30         making new commits in a newly cloned repository.
31         Defaults to `false`.
32
33 user.signingKey::
34         If linkgit:git-tag[1] or linkgit:git-commit[1] is not selecting the
35         key you want it to automatically when creating a signed tag or
36         commit, you can override the default selection with this variable.
37         This option is passed unchanged to gpg's --local-user parameter,
38         so you may specify a key using any method that gpg supports.