From b66f94499b6f97af9f806e66cd2ca6a444718bce Mon Sep 17 00:00:00 2001 From: argszero Date: Mon, 12 Oct 2026 17:58:53 +0800 Subject: [PATCH] docs(deploy_gate): drop the stale count from the include_sites comment MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The `include_sites` doc comment justified masking comments with a count: **只在代码位置认定站点**：注释里的（本仓 8 处）与字符串正文里的同名字面量都不算。 That 8 was right when written and is 20 today. Measured against the walked corpus (`src/`, which is what `rust_sources()` walks), counting the bare `include_str!` / `include_bytes!` tokens on comment lines: - `0cd878c^` (the tree the author measured) -> 8 - today -> 20 It grew because every gate that documents this construct adds comment mentions of it — the same commit even carries the quantity twice, and its sibling carrier deliberately went vague ("本仓十余行") where this one wrote an exact number. So drop the number instead of refreshing it: refresh it and the next doc mention rots it again. The claim itself survives, and the sibling at the positive-control assertion still carries the magnitude. Gates: cargo test 557/0, cargo fmt --check, cargo clippy --all-targets -D warnings. --- src/deploy_gate.rs | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/deploy_gate.rs b/src/deploy_gate.rs index 4f9ed1a..4feceea 100644 --- a/src/deploy_gate.rs +++ b/src/deploy_gate.rs @@ -982,7 +982,7 @@ fn rust_sources() -> Vec<(String, String)> { /// `include_str!` / `include_bytes!` 的站点：`(行号, 字节偏移, 目标字面量)`。 /// -/// **只在代码位置认定站点**：注释里的（本仓 8 处）与字符串正文里的同名字面量都不算。 +/// **只在代码位置认定站点**：注释里的与字符串正文里的同名字面量都不算。 /// 后者不是假想 —— 本文件自己的测试夹具就是字符串里的 `include_str!("…")`：R84 实测， /// 「按行截断 `//`」的旧写法把它们读成站点，还读出 `…CHANGELOG.md\` 这种带反斜杠的目标。 fn include_sites(src: &str) -> Vec<(usize, usize, String)> {