fix(core): a doc line starting with > read as a markdown blockquote and failed clippy
apple / swift (pull_request) Successful in 2m12s
apple / distribute (pull_request) Skipped
apple / screenshots (pull_request) Skipped
ci / bun-nix (pull_request) Successful in 40s
ci / rust (pull_request) Failing after 4m9s
ci / web (pull_request) Successful in 1m19s
windows-client / client (x64, , x86_64-pc-windows-msvc, C:\t) (pull_request) Successful in 6m54s
ci / rust-arm64 (pull_request) Successful in 6m39s
ci / docs-site (pull_request) Successful in 6m36s
windows-client / client (arm64, --no-default-features, aarch64-pc-windows-msvc, C:\t-a64) (pull_request) Successful in 3m5s
android / android (pull_request) Successful in 9m43s

`--all-targets` clippy treats `/// >24 kHz` as the start of a quote block and then
rejects the unmarked lines that continue it. I added that test and gated it on tests and
fmt but not clippy, so it would have reached CI red. Reworded rather than escaped —
the sentence reads better without the symbol anyway.
This commit is contained in:
2026-08-16 12:55:20 +02:00
parent 47c9162433
commit e6476eddcf
+2 -2
View File
@@ -389,8 +389,8 @@ mod tests {
/// the encoder sees it, and that is the entire reason this second plane exists. So the plane
/// has to be shown to carry one.
///
/// This is the SOFTWARE half of `design/hi-res-audio.md` §13.2. The full check is "play a
/// >24 kHz tone on the host and confirm it arrives", and its other half — that the host's
/// This is the SOFTWARE half of `design/hi-res-audio.md` §13.2. The full check is "play an
/// ultrasonic tone on the host and confirm it arrives", and its other half — that the host's
/// CAPTURE did not silently resample on the way in — cannot be tested here, because that is
/// WASAPI autoconvert and PipeWire's resampler, which need a host and an interface. What this
/// proves is the part that is ours: once a 30 kHz tone is in the pipeline, the `0xD3` payload