configure-git.rst

 1Configuring Git
 2===============
 3
 4This chapter describes maintainer level git configuration.
 5
 6Tagged branches used in pull requests (see
 7Documentation/maintainer/pull-requests.rst) should be signed with the
 8developers public GPG key. Signed tags can be created by passing
 9``-u <key-id>`` to ``git tag``. However, since you would *usually* use the same
10key for the project, you can set it in the configuration and use the ``-s``
11flag. To set the default ``key-id`` use::
12
13	git config user.signingkey "keyname"
14
15Alternatively, edit your ``.git/config`` or ``~/.gitconfig`` file by hand::
16
17	[user]
18		name = Jane Developer
19		email = jd@domain.org
20		signingkey = jd@domain.org
21
22You may need to tell ``git`` to use ``gpg2``::
23
24	[gpg]
25		program = /path/to/gpg2
26
27You may also like to tell ``gpg`` which ``tty`` to use (add to your shell
28rc file)::
29
30	export GPG_TTY=$(tty)