今日重点:🔍 标题解析——祈使句、动词、限定语、前缀,前几期都拆过了。 今天看一个反直觉的现象:昨天有三条封面标题没有动词,照样成立; 而它们罩着的子补丁,一条名词短语都没有,全员祈使句开头。 结论先给:封面回答「这堆补丁合起来讲什么」,子补丁回答「这一个补丁干什么」——两套语法,各管各的。
📖 今日标题(真实清单,逐字引用)
/ section[PATCH v3 0/3] Dongwoon DW9800K update patchset [PATCH v3 1/3] dt-bindings: media: i2c: dw9800: Redocument DW9800K [PATCH v3 2/3] media: i2c: dw9719: Update DW9800K driver [PATCH v3 3/3] arm64: dts: qcom: qcm6490-fairphone-fp5: Fix DW9800K support
[PATCH 0/5] SM8350 GPU: memory bandwidth vote and speed bins [PATCH 1/5] arm64: dts: qcom: sm8350: Vote the GPU memory bandwidth [PATCH 2/5] dt-bindings: nvmem: qfprom: Add SM8350 compatible [PATCH 3/5] nvmem: qfprom: Add the SM8350 keepout regions [PATCH 4/5] drm/msm/adreno: Add speedbins for A660 GPU [PATCH 5/5] arm64: dts: qcom: sm8350: Add the GPU speed bins
[PATCH 0/3] Add offsetofp() and offsetofendp() for pointer arithmetic [PATCH 0/3] dma-buf: dma-fence: Remove dma_fence_init64() [PATCH 0/3] i2c: omap: add support for DMA [PATCH v6 0/6] drm/msm: Decouple IFPC disable and sysprof
[PATCH v4 0/2] nova-core: add initial support for gpu timer (v4) [PATCH v4 2/2] gpu: nova-core: add support for GPU timer block. (v4)
出处:以上标题逐字取自 2026-11-05 投递到 linux-media / dri-devel 的真实邮件(本地雷达 2026-11-06 抓取, 时间已从 UTC 换算为北京时间)。每条引用都附该邮件本身的 lore 链接,点开即可对照原文。
🔍 封面写主题,补丁写动作
/ column ① 封面不写动词,合法:三条名词短语封面 昨天三条封面是名词短语,一个动词都没有:
Dongwoon DW9800K update patchset〔11-05 18:29 北京〕——「DW9800K 更新补丁集」,纯名词。 封面原文
DRM device registration fixes〔11-05 07:06 北京〕——「DRM 设备注册修复」,fix 的名词形。 封面原文
SM8350 GPU: memory bandwidth vote and speed bins〔11-05 21:30 北京〕——「带宽投票与频率分档」,两个名词并列。 封面原文
为什么不写动词也成立?封面回答的不是「干了什么」,而是「这一堆合起来讲什么」。 SM8350 封面正文第一句就挑明了:Two things are missing for the SM8350 GPU in mainline. (主线里 SM8350 这颗 GPU 还缺两样东西。)一个标题装两件事,没有单个动词罩得住——名词短语正好。
Dongwoon DW9800K update patchset〔11-05 18:29 北京〕——「DW9800K 更新补丁集」,纯名词。 封面原文
DRM device registration fixes〔11-05 07:06 北京〕——「DRM 设备注册修复」,fix 的名词形。 封面原文
SM8350 GPU: memory bandwidth vote and speed bins〔11-05 21:30 北京〕——「带宽投票与频率分档」,两个名词并列。 封面原文
为什么不写动词也成立?封面回答的不是「干了什么」,而是「这一堆合起来讲什么」。 SM8350 封面正文第一句就挑明了:Two things are missing for the SM8350 GPU in mainline. (主线里 SM8350 这颗 GPU 还缺两样东西。)一个标题装两件事,没有单个动词罩得住——名词短语正好。
② 子补丁必须写动作:三条系列全员祈使句 名词封面底下,子补丁一条名词短语都没有。DW9800K 三条:Redocument / Update / Fix(重文档化 / 更新 / 修复);SM8350 五条:Vote / Add / Add / Add / Add;DRM 注册修复两条: Set dev->registered back to false… / Remove drm_dev_unregister()…。 patch 1/2 原文
单条补丁回答「这一个补丁干什么」,必须祈使句动词开头——这条规则没有任何例外。 读陌生系列时把这点用起来:封面只给话题,分工要看子标题的动词。SM8350 封面读不出 patch 1 干什么, 看到 Vote the GPU memory bandwidth 才知道第一条是设备树里给 DDR 带宽投票。 patch 1/5 原文
单条补丁回答「这一个补丁干什么」,必须祈使句动词开头——这条规则没有任何例外。 读陌生系列时把这点用起来:封面只给话题,分工要看子标题的动词。SM8350 封面读不出 patch 1 干什么, 看到 Vote the GPU memory bandwidth 才知道第一条是设备树里给 DDR 带宽投票。 patch 1/5 原文
③ 什么时候封面也用祈使句:整个系列只有一个动作 反例就在同一天,四个封面全是祈使句:
Add offsetofp() and offsetofendp() for pointer arithmetic〔11-06 01:17 北京〕——整个系列就是「加一对宏」。 封面原文
dma-buf: dma-fence: Remove dma_fence_init64()〔11-05 19:39 北京〕——整个系列就是「删一个 API」。 封面原文
i2c: omap: add support for DMA〔11-06 04:07 北京〕——整个系列就是「加 DMA 支持」。 封面原文
drm/msm: Decouple IFPC disable and sysprof〔11-06 00:42 北京〕——整个系列就是「解耦两件事」。 封面原文
规律:一个动作贯穿全部补丁时,封面就是那个动作本身。判断法:子补丁的动词各不相同 (Redocument / Update / Fix)→ 封面写主题;子补丁是同一动作的不同落点(offsetofp 系列的 Add / Use / Use)→ 封面直接用那个动词。
Add offsetofp() and offsetofendp() for pointer arithmetic〔11-06 01:17 北京〕——整个系列就是「加一对宏」。 封面原文
dma-buf: dma-fence: Remove dma_fence_init64()〔11-05 19:39 北京〕——整个系列就是「删一个 API」。 封面原文
i2c: omap: add support for DMA〔11-06 04:07 北京〕——整个系列就是「加 DMA 支持」。 封面原文
drm/msm: Decouple IFPC disable and sysprof〔11-06 00:42 北京〕——整个系列就是「解耦两件事」。 封面原文
规律:一个动作贯穿全部补丁时,封面就是那个动作本身。判断法:子补丁的动词各不相同 (Redocument / Update / Fix)→ 封面写主题;子补丁是同一动作的不同落点(offsetofp 系列的 Add / Use / Use)→ 封面直接用那个动词。
④ 反模式:标题尾巴挂 (v4)、句点——元信息别混进正文 nova-core 这条系列〔11-05 11:07 北京〕是个现成的反面教材:封面写 add initial support for gpu timer (v4)——方括号 [PATCH v4] 已经声明了版本号, 标题尾巴再挂一个 (v4) 是冗余;patch 2/2 连句点都带上了:…add support for GPU timer block. (v4)。 封面原文 patch 2/2 原文
内核标题的默契:元信息归方括号管,标题本体是一个干净的祈使句,结尾不加句点。 对照 dma-fence 封面的 Remove dma_fence_init64()——动词、对象、括号,到此为止。
内核标题的默契:元信息归方括号管,标题本体是一个干净的祈使句,结尾不加句点。 对照 dma-fence 封面的 Remove dma_fence_init64()——动词、对象、括号,到此为止。
⑤ 三步读法,两步写法 读陌生系列:1. 看 x/y——0/N 是封面,名词短语或祈使句都可能;非 0 是补丁,必须祈使句。 2. 封面是名词短语时别指望它说分工,去扫子标题的动词。3. 封面是祈使句时,可以把那个动词当成整个系列的承诺。
写自己系列:1. 先数系列里有几个动作——一个动作,封面用祈使句;多个动作,封面用名词短语概括主题,动作留给子补丁。 2. 版本号、句点、补丁数全归方括号,标题本体一个字都不多带。
写自己系列:1. 先数系列里有几个动作——一个动作,封面用祈使句;多个动作,封面用名词短语概括主题,动作留给子补丁。 2. 版本号、句点、补丁数全归方括号,标题本体一个字都不多带。
✨ 辅助彩蛋:一句话说清哪条补丁能单飞
/ section★ This fix stands alone and can be taken on its own.
拆解 stand alone 独立成立、不依赖别的东西;be taken on its own 可单独被(维护者)收下—— take 在这里不是「拿」,是「接受、合入」。两个短语连用是刻意强调:先陈述代码上独立,再明说流程上可单走。 前文 (patch 1) 这种括注指代,也是封面正文分配任务的惯例写法。
语境翻译 这个修复独立成立,可以单独合入。(前半句:第一,GPU 从不为 DDR 带宽投票——说的是 patch 1。)
怎么用 封面里给维护者递「拆分合入」的梯子时用,等于说「这条不等其他补丁,你看着顺眼就先收」。 比 This patch is independent 多一层流程含义:不只是代码无依赖,还包括合入顺序自由。
和你相关 多条补丁捆绑时主动标注哪条能单飞,是降低维护者心理负担的地道做法——今天这条封面正好同时是「封面写主题」的教科书。
🔗 原文
✍️ 今日练习
/ column✍️ 场景:你是 SM8350 GPU 系列的作者,要写封面标题。三个候选: A.「SM8350 GPU: Vote the GPU memory bandwidth and add speed bins」 B.「SM8350 GPU: memory bandwidth vote and speed bins」 C.「SM8350 GPU: fixes」。 ① 真实封面用了哪种形态?A 输在哪? ② C 犯了哪两个错(提示:一个关于信息量,一个关于事实)? ③ 给 patch 1(只改 arch/arm64/boot/dts/qcom/sm8350.dtsi,加 GPU 的 DDR 带宽投票)写子补丁标题——前缀按设备树惯例,动词开头。
💡 显示答案
① 真实封面是 B(名词短语)。这个系列有两个不同动作——投票带宽、读 speed bins——A 把两个动词硬塞进一个祈使句, 读者看完仍不知道五个补丁怎么分工,还误以为这是「一个动作」;名词短语只承诺主题,分工交给子标题。 ② C 两个错:一,fixes 太泛——不说修什么、落在哪个范围;二,与事实不符——带宽投票是补缺失的功能,不是修复缺陷。 ③ arm64: dts: qcom: sm8350: Vote the GPU memory bandwidth——这正是真实 patch 1 的标题,逐字照抄即可: 前缀走 arm64 设备树惯例(arch→dts→厂商→芯片),动词 Vote 开头,宾语点明投的是哪条带宽。
📖 原文:Demeter Barna (5):
arm64: dts: qcom: sm8350: Vote the GPU memory bandwidth
dt-bindings: nvmem: qfprom: Add SM8350 compatible
nvmem: qfprom: Add the SM8350 keepout regions
drm/msm/adreno: Add speedbins for A660 GPU
arm64: dts: qcom: sm8350: Add the GPU speed bins
📎 原文引用 每日一句:The cover names the topic; each patch names its action.
仿写示范