linux-kernel - Re: [PATCH v5] docs: ja_JP: SubmittingPatches: describe the 'Fixes:' tag

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [day] [month] [year] [list]

Message-ID: <cf30e7f5-4241-48ee-bfba-107144e4e9a9@gmail.com>
Date: Thu, 25 Sep 2025 21:03:50 +0900
From: Akira Yokosawa <akiyks@...il.com>
To: Akiyoshi Kurita <weibu@...admin.org>, linux-doc@...r.kernel.org,
 corbet@....net
Cc: linux-kernel@...r.kernel.org,
 Tsugikazu Shibata <shibata@...uxfoundation.org>
Subject: Re: [PATCH v5] docs: ja_JP: SubmittingPatches: describe the 'Fixes:'
 tag

[+CC: Shibata-san]

On 9/25/25 04:24, Akiyoshi Kurita wrote:
> 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@...admin.org>
> ---
> v5:
>  - whole rewrite

This looks good to me.  Thank you!

Reviewed-by: Akira Yokosawa <akiyks@...il.com>

You are lucky in that those four changes related to the Fixes: tag are
pretty much localized in the English version, across the conversion to
reST.  With regards to "Fixes:", ja_JP/SubmittingPatches should be
up-to-date by this change. 

Regards,
Akira

> ---
>  .../translations/ja_JP/SubmittingPatches      | 28 ++++++++++++++++++-
>  1 file changed, 27 insertions(+), 1 deletion(-)
> 
> diff --git a/Documentation/translations/ja_JP/SubmittingPatches b/Documentation/translations/ja_JP/SubmittingPatches
> index 5334db471744..b950347b5993 100644
> --- a/Documentation/translations/ja_JP/SubmittingPatches
> +++ b/Documentation/translations/ja_JP/SubmittingPatches
> @@ -132,6 +132,25 @@ http://savannah.nongnu.org/projects/quilt
>         platform_set_drvdata(), but left the variable "dev" unused,
>         delete it.
>  
> +特定のコミットで導入された不具合を修正する場合（例えば ``git bisect`` で原因となった
> +コミットを特定したときなど）は、コミットの SHA-1 の先頭12文字と1行の要約を添えた
> +「Fixes:」タグを付けてください。この行は75文字を超えても構いませんが、途中で
> +改行せず、必ず1行で記述してください。
> +例:
> +        Fixes: 54a4f0239f2e ("KVM: MMU: make kvm_mmu_zap_page() return the number of pages it actually freed")
> +
> +以下の git の設定を使うと、git log や git show で上記形式を出力するための
> +専用の出力形式を追加できます::
> +
> +        [core]
> +                abbrev = 12
> +        [pretty]
> +                fixes = Fixes: %h (\"%s\")
> +
> +使用例::
> +
> +        $ git log -1 --pretty=fixes 54a4f0239f2e
> +        Fixes: 54a4f0239f2e ("KVM: MMU: make kvm_mmu_zap_page() return the number of pages it actually freed")
>  
>  3) パッチの分割
>  
> @@ -409,7 +428,7 @@ Acked-by: が必ずしもパッチ全体の承認を示しているわけでは
>  このタグはパッチに関心があると思われる人達がそのパッチの議論に含まれていたこと
>  を明文化します。
>  
> -14) Reported-by:, Tested-by:, Reviewed-by: および Suggested-by: の利用
> +14) Reported-by:, Tested-by:, Reviewed-by:, Suggested-by: および Fixes: の利用
>  
>  他の誰かによって報告された問題を修正するパッチであれば、問題報告者という寄与を
>  クレジットするために、Reported-by: タグを追加することを検討してください。
> @@ -465,6 +484,13 @@ Suggested-by: タグは、パッチのアイデアがその人からの提案に
>  クレジットしていけば、望むらくはその人たちが将来別の機会に再度力を貸す気に
>  なってくれるかもしれません。
>  
> +Fixes: タグは、そのパッチが以前のコミットにあった問題を修正することを示します。
> +これは、バグがどこで発生したかを特定しやすくし、バグ修正のレビューに役立ちます。
> +また、このタグはstableカーネルチームが、あなたの修正をどのstableカーネル
> +バージョンに適用すべきか判断する手助けにもなります。パッチによって修正された
> +バグを示すには、この方法が推奨されます。前述の、「2) パッチに対する説明」の
> +セクションを参照してください。
> +
>  15) 標準的なパッチのフォーマット
>  
>  標準的なパッチのサブジェクトは以下のとおりです。