docs: ASCII typography and style normalization across all repo text

Replace every em dash with real punctuation (rewrites, not hyphen swaps)
in docs, code comments, scripts, configs, and the port records; convert
en dashes, curly quotes, ellipsis glyphs, arrows, and section signs to
ASCII; drop machine-writing tell phrases from living docs. ADR titles
now use a colon. The M2 bring-up DTS model string carried an em dash
into the patch series and its record echoes; fixed at both, and the full
series re-verified to apply cleanly onto pristine 6.18.46. One comment
in freshness.h deliberately names the em dash glyph the UI renders as
the unknown mark; that is data, kept as prose naming it.

Verified: cargo tests (sim, config-lint, rs485-bridge), shellcheck,
both driver MC/DC harnesses, patches-apply.
This commit is contained in:
BFE Engineering
2026-08-31 12:31:27 -06:00
parent 80d9a9539b
commit 42fb386f60
111 changed files with 1261 additions and 1261 deletions
+4 -4
View File
@@ -2,11 +2,11 @@
//!
//! A faithful software port of `flare-edge/hpmcu/watchdog/main.c`'s poll loop:
//! it reads the Linux-owned mailbox words (magic + heartbeat counter), writes the
//! MCU-owned state word, and fires (records a CRU reset) on the same deadlines
//! MCU-owned state word, and fires (records a CRU reset) on the same deadlines:
//! boot-grace if userspace never arms it, heartbeat-timeout if a live heartbeat
//! stops. Because it runs on a [`MemBus`], the *same* flared arm/beat protocol can
//! be driven against it in a host unit test, with a virtual clock, in
//! microseconds the validation that was missing when a boot-loaded build of this
//! microseconds: the validation that was missing when a boot-loaded build of this
//! firmware had to be tested by flashing a panel.
//!
//! Deadlines are modelled in whole seconds (the firmware's cycle math exists only
@@ -215,7 +215,7 @@ mod tests {
fn flared_arms_within_boot_grace_no_boot_loop() {
// The exact safety property the boot-loaded watchdog needs: on a healthy
// boot, flared comes up well before the 300s boot grace, arms the MCU, and
// keeps beating so it transitions BOOT -> ARMED and never fires. (A
// keeps beating, so it transitions BOOT -> ARMED and never fires. (A
// failure here would be the boot-loop we must never ship.)
let bus = SimBus::new();
let mut m = mcu(&bus);
@@ -247,7 +247,7 @@ mod tests {
let bus = SimBus::new();
let mut m = mcu(&bus);
let mut counter = 0u32;
// Beat through t=600 (inclusive) the last heartbeat lands at 600s.
// Beat through t=600 (inclusive): the last heartbeat lands at 600s.
for now in (0..=600).step_by(5) {
counter += 1;
arm_beat(&bus, counter);