今日重点:✍️ 写作——一封 4 句话的封面信,把「新增 UAPI + 三个驱动后续支持」 讲得明明白白。Niklas Söderlund 的 Bayer 20/24/28-bit 格式系列(3 帖) 是「UAPI 先行」型系列的写作范本:没有铺垫、没有客套,每句话都承担一个信息职能。
✍️ 真实原文:四句话的封面信
/ sectionHello, This series adds the pixel formats and documentation for the 20-, 24- and 28-bit Bayer formats. This is done in preparation of work on the Renesas R-Car video capture pipeline which will support these pixel formats in multiple drivers. For this reason it is posted as a separate series before the driver work.
逐句拆。第一句 This series adds the pixel formats and documentation for the 20-, 24- and 28-bit Bayer formats.——「本系列新增 XX」。动词 adds 后面跟两个宾语(pixel formats、documentation),一句话交代了补丁的两大块内容。 注意它没说「我为什么需要」,先讲清楚「是什么」,读者三秒进入状态。 第二句 This is done in preparation of work on the Renesas R-Car video capture pipeline which will support these pixel formats in multiple drivers.—— 用 This is done in preparation of work on ...(这是为……工作做准备)把动机锚定 在一个具体的下游工作上:R-Car 采集管线、多个驱动将使用这些格式。 比空泛的「随着高比特 sensor 普及」有力得多——评审能立刻判断影响面。
第三句 For this reason it is posted as a separate series before the driver work.——For this reason 回扣上一句的动机,it is posted as a separate series before the driver work 解释了为什么拆开发: UAPI 先定稿、驱动后跟进。这一句是整个模板的灵魂——它回答了评审必然要问的问题: 「为什么不和驱动一起发?」先答一步,评审就不用问了。
★ 阅读拆点 · 三个可复用句式
adds 的宾语要把补丁的组成部分都露出来——本例把 documentation 和 pixel formats 并列,等于提前告诉评审「文档也在里面,别担心」。 in preparation of(为……做准备)把新接口与真实的下游工作挂钩。有具体下游的提案比抽象需求好过十倍:本例下游是 R-Car 采集管线,评审立即知道谁会受益。 🔗 原文
✨ 辅助彩蛋(阅读)
/ column★ 写作彩蛋 · diffstat 也是正文的一部分
pixfmt-srggb20/24/28.rst),外加 videodev2.h 的 12 行 fourcc 定义与 v4l2-core 的映射表改动。 🔗 原文
✍️ 今日练习
/ column💡 显示答案
Four sentences, three jobs: say what it is, tie it to real work, justify the split.
素材:lore.kernel.org linux-media · Bayer 20/24/28-bit 格式系列封面信(Niklas Söderlund,〔11-16 03:11 北京〕,经 lore git 协议逐字提取)· 内核英语 · 每日一篇