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