今日重点:🔤 标题解析——内核邮件里最快的信息是标题。会读标题的人扫一眼就知道 「这个系列动哪个子系统、是加功能还是修 bug、大概多大」。今天从 11-11 的真实窗口里挑 六条不同体裁的标题,拆开看它们的语法骨架。
🔤 六个真实标题
/ section[PATCH v6 00/11] Add Rust PCI SR-IOV support
[PATCH net v5 0/8] psp, tls: don't send offloaded contents in cleartext
[PATCH v17 00/17] netfs, iov_iter: Use a chain of bio_vec arrays instead of folio_queue
[GIT PULL FOR 7.5] AMS-OSRAM Mira220 and Mira016 drivers
[PATCH 00/12] userfaultfd: assorted fixes (part 1)
[PATCH v8 00/10] drm: writeback: clean up writeback connector initialization
先看方括号。[PATCH v6 00/11] 三段各有含义: PATCH 是体裁(RFC / RESEND / GIT PULL 同理)、v6 是第几版 (没有 vN 就是首版)、00/11 说明它是 11 帖系列的封面信 (单发补丁不写 M/N)。第 4 条 [GIT PULL FOR 7.5] 是维护者给 Linus 的拉取请求—— 方括号里的内容决定这封信该由谁处理。
再看冒号前的 scope。psp, tls: 两个子系统并列; netfs, iov_iter: 同理;drm: writeback: 是层级式(子系统: 子模块); userfaultfd: 单模块。scope 的规矩是「谁要改,就写谁」—— 评审靠它决定要不要点开。
最后看动词。六条标题的动词各有讲究:Add Rust PCI SR-IOV support (加新功能,Add 打头)、don't send offloaded contents in cleartext (否定祈使,直接点出要禁止的错误行为)、Use a chain of bio_vec arrays instead of folio_queue(X instead of Y 是最强的重构标题模板: 一句话讲清新旧)、assorted fixes(修复集:承认没有单一主题)、 clean up writeback connector initialization(清理类,clean up)。
★ 阅读拆点 · 四个可复用的标题模板
Add support for X、Introduce X。判断标准:Add 后面跟的是名词短语(功能名),不是句子——标题不是语法练习,是索引。 don't send offloaded contents in cleartext——修复类标题的强形态:不描述改了什么,直接说不许发生什么。读者立刻知道这是安全/正确性修复。 Use a chain of bio_vec arrays instead of folio_queue——新旧对照一应俱全,评审不用点开就看懂动机。任何「换实现」的系列都该套这个模板。 userfaultfd: assorted fixes (part 1)——诚实声明「这是杂项集合」。看起来弱,其实是优点:不假装有主线,评审也按单条判断。(part 1) 还预告了后续。 [GIT PULL FOR 7.5] + 一句话内容(AMS-OSRAM Mira220 and Mira016 drivers)。FOR 版本号说明目标窗口——合并窗口期间每天几十封都是这个形状。 🔗 原文
✨ 辅助彩蛋(写作)
/ column★ 写作彩蛋 · 从标题反推一封好封面信
Add Rust PCI SR-IOV support,封面信就得回答「支持到什么程度、还差什么」;标题写 assorted fixes,封面信就逐条列清楚。 This series adds <X>. / This series fixes <Y>.——封面信第一句与标题同构,是评审最舒服的开场(我们精读过的 qda 封面信就是 This series adds QDA...)。 🔗 原文
✍️ 今日练习
/ column💡 显示答案
Read the brackets, the scope, the verb — a kernel title is a data structure, not a sentence.
素材:lore.kernel.org 11-11 窗口(Rust SR-IOV / psp / netfs / Mira220 pull / userfaultfd / writeback)· 内核英语 · 每日一篇