openSUSE:KDE 补丁注释策略
应用于 KDE 和 Qt 包的补丁必须采用正确的补丁格式,这意味着文件名以 .patch 结尾,并且具有适当的注释。
补丁是来自/用于上游还是仅用于下游,由 .spec 文件指示。 前面的 "# PATCH-(FIX|FEATURE)-OPENSUSE" 或 "# PATCH-(FIX|FEATURE)-UPSTREAM" 是指示器。 这样的注释表明所有后续补丁都是相同类型。
下游补丁应在所有上游补丁之后应用,以避免冲突。 这部分包含在 .spec 文件中,以便更轻松地排序和分组。
补丁注释
KDE 和 Qt 包中的每个补丁或差异都需要一个注释头,由以下标题组成。 格式应完全一致,以便进行脚本分析。 避免 ':' 周围的额外空格,大小写不应区分。
Subject: <one line summary of the patch>
一行摘要说明补丁的作用。 如果需要更多信息,可以将其放在补丁注释中的任何其他非格式化行中。
From: Full Name (<email address>, optional)
编写补丁的人员。
References: boo#123456, kde#1337 References: fate#123456
相关的错误报告(如果适用)。 对于上游报告,包含的 BUG/CCBUG 行就足够了。
如果主题行不足以完全解释补丁的内容,则可以在标题后添加任意长度的描述。