![Tobin C. Harding](/assets/img/avatar_default.png)
There is currently very little documentation in the kernel on maintainer level tasks. In particular there are no documents on creating pull requests to submit to Linus. Quoting Greg Kroah-Hartman on LKML: Anyway, this actually came up at the kernel summit / maintainer meeting a few weeks ago, in that "how do I make a good pull request to Linus" is something we need to document. Here's what I do, and it seems to work well, so maybe we should turn it into the start of the documentation for how to do it. (quote references: kernel summit, Europe 2017) Create a new kernel documentation book 'how to be a maintainer' (suggested by Jonathan Corbet). Add chapters on 'configuring git' and 'creating a pull request'. Most of the content was written by Linus Torvalds and Greg Kroah-Hartman in discussion on LKML. This is stated at the start of one of the chapters and the original email thread is referenced in 'pull-requests.rst'. Signed-off-by: Tobin C. Harding <me@tobin.cc> Reviewed-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org> Reviewed-by: Mauro Carvalho Chehab <mchehab@s-opensource.com> Signed-off-by: Jonathan Corbet <corbet@lwn.net>
35 lines
820 B
ReStructuredText
35 lines
820 B
ReStructuredText
.. _configuregit:
|
|
|
|
Configure Git
|
|
=============
|
|
|
|
This chapter describes maintainer level git configuration.
|
|
|
|
Tagged branches used in :ref:`Documentation/maintainer/pull-requests.rst
|
|
<pullrequests>` should be signed with the developers public GPG key. Signed
|
|
tags can be created by passing the ``-u`` flag to ``git tag``. However,
|
|
since you would *usually* use the same key for the same project, you can
|
|
set it once with
|
|
::
|
|
|
|
git config user.signingkey "keyname"
|
|
|
|
Alternatively, edit your ``.git/config`` or ``~/.gitconfig`` file by hand:
|
|
::
|
|
|
|
[user]
|
|
name = Jane Developer
|
|
email = jd@domain.org
|
|
signingkey = jd@domain.org
|
|
|
|
You may need to tell ``git`` to use ``gpg2``
|
|
::
|
|
|
|
[gpg]
|
|
program = /path/to/gpg2
|
|
|
|
You may also like to tell ``gpg`` which ``tty`` to use (add to your shell rc file)
|
|
::
|
|
|
|
export GPG_TTY=$(tty)
|