linux_dsm_epyc7002/Documentation/maintainer/configure-git.rst

.. _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)
doc: add maintainer book 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> 2017-12-04 06:27:29 +07:00			`.. _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)`