Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux
1
fork

Configure Feed

Select the types of activity you want to include in your feed.

docs: ja_JP: SubmittingPatches: describe the 'Fixes:' tag

Sync the ja_JP translation with the following upstream commits:

commit 8401aa1f5997 ("Documentation/SubmittingPatches: describe the Fixes: tag")
commit 19c3fe285cba ("docs: Explicitly state that the 'Fixes:' tag shouldn't split lines")
commit 5b5bbb8cc51b ("docs: process: Add an example for creating a fixes tag")
commit 6356f18f09dc ("Align git commit ID abbreviation guidelines and checks")

The mix of plain text and reST markup for ``git bisect`` is intentional to
align with the eventual reST conversion.

Signed-off-by: Akiyoshi Kurita <weibu@redadmin.org>
Reviewed-by: Akira Yokosawa <akiyks@gmail.com>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
Message-ID: <20250924192426.2743495-1-weibu@redadmin.org>

authored by

Akiyoshi Kurita and committed by
Jonathan Corbet
3a2ddc5f f9e51009

+27 -1
+27 -1
Documentation/translations/ja_JP/SubmittingPatches
··· 132 132 platform_set_drvdata(), but left the variable "dev" unused, 133 133 delete it. 134 134 135 + 特定のコミットで導入された不具合を修正する場合(例えば ``git bisect`` で原因となった 136 + コミットを特定したときなど)は、コミットの SHA-1 の先頭12文字と1行の要約を添えた 137 + 「Fixes:」タグを付けてください。この行は75文字を超えても構いませんが、途中で 138 + 改行せず、必ず1行で記述してください。 139 + 例: 140 + Fixes: 54a4f0239f2e ("KVM: MMU: make kvm_mmu_zap_page() return the number of pages it actually freed") 141 + 142 + 以下の git の設定を使うと、git log や git show で上記形式を出力するための 143 + 専用の出力形式を追加できます:: 144 + 145 + [core] 146 + abbrev = 12 147 + [pretty] 148 + fixes = Fixes: %h (\"%s\") 149 + 150 + 使用例:: 151 + 152 + $ git log -1 --pretty=fixes 54a4f0239f2e 153 + Fixes: 54a4f0239f2e ("KVM: MMU: make kvm_mmu_zap_page() return the number of pages it actually freed") 135 154 136 155 3) パッチの分割 137 156 ··· 428 409 このタグはパッチに関心があると思われる人達がそのパッチの議論に含まれていたこと 429 410 を明文化します。 430 411 431 - 14) Reported-by:, Tested-by:, Reviewed-by: および Suggested-by: の利用 412 + 14) Reported-by:, Tested-by:, Reviewed-by:, Suggested-by: および Fixes: の利用 432 413 433 414 他の誰かによって報告された問題を修正するパッチであれば、問題報告者という寄与を 434 415 クレジットするために、Reported-by: タグを追加することを検討してください。 ··· 483 464 タグをつけないように注意してください。とはいえ、アイデアの提供者をこつこつ 484 465 クレジットしていけば、望むらくはその人たちが将来別の機会に再度力を貸す気に 485 466 なってくれるかもしれません。 467 + 468 + Fixes: タグは、そのパッチが以前のコミットにあった問題を修正することを示します。 469 + これは、バグがどこで発生したかを特定しやすくし、バグ修正のレビューに役立ちます。 470 + また、このタグはstableカーネルチームが、あなたの修正をどのstableカーネル 471 + バージョンに適用すべきか判断する手助けにもなります。パッチによって修正された 472 + バグを示すには、この方法が推奨されます。前述の、「2) パッチに対する説明」の 473 + セクションを参照してください。 486 474 487 475 15) 標準的なパッチのフォーマット 488 476