[PATCH v2] docs: ja_JP: SubmittingPatches: document the 'Fixes:' tag (+example)

Akiyoshi Kurita posted 1 patch 4 days, 5 hours ago
Documentation/translations/ja_JP/SubmittingPatches | 12 ++++++++++++
1 file changed, 12 insertions(+)
[PATCH v2] docs: ja_JP: SubmittingPatches: document the 'Fixes:' tag (+example)
Posted by Akiyoshi Kurita 4 days, 5 hours ago
Sync the ja_JP translation with parts of:
  - 8401aa1f5997 ("Documentation/SubmittingPatches: describe the Fixes: tag")
  - 5b5bbb8cc51be ("docs: process: Add an example for creating a fixes tag")

Link: https://lore.kernel.org/all/20250905032729.2284883-1-weibu@redadmin.org/
Signed-off-by: Akiyoshi Kurita <weibu@redadmin.org>

---
v2:
  - Add explanatory paragraphs from 8401aa1f5997 (purpose + stable note)
  - Keep example and pretty-format from 5b5bbb8cc51be
 Documentation/translations/ja_JP/SubmittingPatches | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/Documentation/translations/ja_JP/SubmittingPatches b/Documentation/translations/ja_JP/SubmittingPatches
index 28ad83171252..a05829427591 100644
--- a/Documentation/translations/ja_JP/SubmittingPatches
+++ b/Documentation/translations/ja_JP/SubmittingPatches
@@ -154,6 +154,18 @@ http://savannah.nongnu.org/projects/quilt
         $ git log -1 --pretty=fixes 54a4f0239f2e
         Fixes: 54a4f0239f2e ("KVM: MMU: make kvm_mmu_zap_page() return the number of pages it actually freed")
 
+
+「Fixes:」タグは、そのパッチが過去のコミットに起因する問題を修正していることを示します。
+このタグはバグの起源を特定しやすくし、バグ修正のレビューに役立ちます。
+また、このタグはどの安定版(stable)カーネルがあなたの修正を取り込むべきかを判断する際に、
+stable カーネルチームを支援します。パッチによって修正されるバグを示すための推奨される方法です。
+詳細は :ref:`describe_changes` を参照してください。
+
+注意: 「Fixes:」タグを付けても、stable カーネルの運用ルールの手続きを迂回するものではなく、
+stable の候補となるすべてのパッチに「Cc: stable@vger.kernel.org」を付けるという要件が
+置き換えられるわけではありません。詳しくは Documentation/process/stable-kernel-rules.rst を参照してください。
+
+
 3) パッチの分割
 
 意味のあるひとまとまりごとに変更を個々のパッチファイルに分けてください。
-- 
2.47.3
Re: [PATCH v2] docs: ja_JP: SubmittingPatches: document the 'Fixes:' tag (+example)
Posted by Akira Yokosawa 4 days, 1 hour ago
Hi,

On Fri,  5 Sep 2025 20:14:03 +0900, Akiyoshi Kurita wrote:
> Sync the ja_JP translation with parts of:
>   - 8401aa1f5997 ("Documentation/SubmittingPatches: describe the Fixes: tag")
>   - 5b5bbb8cc51be ("docs: process: Add an example for creating a fixes tag")

Consistent SHA-1 hash length would look nicer.

> 
> Link: https://lore.kernel.org/all/20250905032729.2284883-1-weibu@redadmin.org/

This link to v1 needs to be under the "---" below.

Wait, do you mean this patch is supposed to be applied on top of v1?

> Signed-off-by: Akiyoshi Kurita <weibu@redadmin.org>
> 
> ---
> v2:
>   - Add explanatory paragraphs from 8401aa1f5997 (purpose + stable note)
>   - Keep example and pretty-format from 5b5bbb8cc51be
>  Documentation/translations/ja_JP/SubmittingPatches | 12 ++++++++++++
>  1 file changed, 12 insertions(+)
> 

I think I need to be more clear on what I am expecting.
I'll send a follow-up comment early next week.

Have a nice weekend!

Thanks,
Akira
Re: [PATCH v2] docs: ja_JP: SubmittingPatches: document the 'Fixes:' tag (+example)
Posted by weibu@redadmin.org 4 days ago
Hi Akira-san,

Thank you very much for your review and detailed feedback.

I will update the Fixes: example to use a consistent 12-character SHA-1 
hash.

I will also move the Link: line under the --- separator, as per 
convention.

To clarify: v2 was intended as a full replacement of v1, not something 
to be applied on top of it. I’ll make that explicit in the changelog 
section for v3.

I’ll prepare and send a v3 patch early next week with these corrections.

Thanks again for your guidance, and have a good weekend.

Best regards,
Akiyoshi Kurita

2025-09-06 00:14 に Akira Yokosawa さんは書きました:
> Hi,
> 
> On Fri,  5 Sep 2025 20:14:03 +0900, Akiyoshi Kurita wrote:
>> Sync the ja_JP translation with parts of:
>>   - 8401aa1f5997 ("Documentation/SubmittingPatches: describe the 
>> Fixes: tag")
>>   - 5b5bbb8cc51be ("docs: process: Add an example for creating a fixes 
>> tag")
> 
> Consistent SHA-1 hash length would look nicer.
> 
>> 
>> Link: 
>> https://lore.kernel.org/all/20250905032729.2284883-1-weibu@redadmin.org/
> 
> This link to v1 needs to be under the "---" below.
> 
> Wait, do you mean this patch is supposed to be applied on top of v1?
> 
>> Signed-off-by: Akiyoshi Kurita <weibu@redadmin.org>
>> 
>> ---
>> v2:
>>   - Add explanatory paragraphs from 8401aa1f5997 (purpose + stable 
>> note)
>>   - Keep example and pretty-format from 5b5bbb8cc51be
>>  Documentation/translations/ja_JP/SubmittingPatches | 12 ++++++++++++
>>  1 file changed, 12 insertions(+)
>> 
> 
> I think I need to be more clear on what I am expecting.
> I'll send a follow-up comment early next week.
> 
> Have a nice weekend!
> 
> Thanks,
> Akira