요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
Configuring Git
===============
This chapter describes maintainer level git configuration.
Tagged branches used in pull requests (see
Documentation/maintainer/pull-requests.rst) should be signed with the
developers public GPG key. Signed tags can be created by passing
``-u <key-id>`` to ``git tag``. However, since you would *usually* use the same
key for the project, you can set it in the configuration and use the ``-s``
flag. To set the default ``key-id`` use::
git config user.signingkey "keyname"
Alternatively, edit your ``.git/config`` or ``~/.gitconfig`` file by hand::
[user]
name = Jane Developer
email = [email protected]
signingkey = [email protected]
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)
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
Maintainer용 Git·GPG 설정
1-30이 장은 maintainer 수준에서 필요한 Git 설정을 설명합니다. Pull request에 사용하는 tagged branch는 개발자의 public GPG key로 서명해야 합니다. 관련 pull request 절차는 `Documentation/maintainer/pull-requests.rst`를 참고합니다.
Signed tag는 `git tag`에 `-u <key-id>`를 넘겨 만들 수 있습니다. 프로젝트에서 대개 같은 key를 사용하므로 `user.signingkey`를 기본값으로 저장한 뒤 `-s` flag만 사용하는 편이 간단합니다.
명령으로는 `git config user.signingkey "keyname"`을 실행합니다. 또는 repository별 `.git/config`나 사용자 전체 `~/.gitconfig`의 `[user]` section에 `name`, `email`, `signingkey`를 직접 기록할 수 있습니다.
환경에 따라 Git이 `gpg2` executable을 사용하도록 `[gpg] program = /path/to/gpg2`를 설정해야 할 수 있습니다. GPG가 올바른 terminal에서 passphrase를 요청하도록 shell rc file에 `export GPG_TTY=$(tty)`를 추가할 수도 있습니다.
기본 signing key, GPG program, terminal을 순서대로 고정합니다.
Pull request용 tag를 만들기 전에 확인할 설정 순서입니다.
Configuring Git
===============
This chapter describes maintainer level git configuration.
Tagged branches used in pull requests (see
Documentation/maintainer/pull-requests.rst) should be signed with the
developers public GPG key. Signed tags can be created by passing
``-u <key-id>`` to ``git tag``. However, since you would *usually* use the same
key for the project, you can set it in the configuration and use the ``-s``
flag. To set the default ``key-id`` use::
git config user.signingkey "keyname"
Alternatively, edit your ``.git/config`` or ``~/.gitconfig`` file by hand::
[user]
name = Jane Developer
email = [email protected]
signingkey = [email protected]
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)
요약·해설
configure-git.rst:1-30Maintainer는 pull request에 쓰는 tagged branch를 자신의 public GPG key로 서명해야 합니다.
`user.signingkey`, `gpg.program`, `GPG_TTY`를 설정하면 반복되는 key 선택과 terminal prompt 문제를 줄일 수 있습니다.