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
+5 -5
View File
@@ -1,5 +1,5 @@
/*
* The UI Freshness Contract engine (flare-edge ADR-0004) core, LVGL-free.
* The UI Freshness Contract engine (flare-edge ADR-0004): core, LVGL-free.
* See freshness.h for the contract. LVGL binding lives in freshness_lv.c.
*/
#include "freshness.h"
@@ -13,7 +13,7 @@
/* Max simultaneous live bindings. Bindings belong to visible pages; the whole
* navigable set of a screen is small, so this is generous. A full table drops
* the binding (returns NULL) rather than silently overflowing the LVGL layer
* the binding (returns NULL) rather than silently overflowing: the LVGL layer
* turns that into a visible fault, never a stale value. */
#ifndef FRESH_MAX
#define FRESH_MAX 96
@@ -40,7 +40,7 @@ struct warden_fresh {
/* A fixed table scanned in full: bindings are torn down all at once by
* warden_fresh_reset (like the screen timers), never individually, so a running
* high-water bound would only hide the free-slot arms from tests without saving
* real work the visible set per screen is a handful. */
* real work: the visible set per screen is a handful. */
static struct warden_fresh s_vals[FRESH_MAX];
warden_fresh_render_t warden_fresh_decide(warden_fresh_result_t produced,
@@ -122,7 +122,7 @@ warden_fresh_t *warden_fresh_bind(void *page, warden_fresh_produce_cb produce,
v->used = true;
return v;
}
return NULL; /* table full caller surfaces a fault, never a stale value */
return NULL; /* table full: caller surfaces a fault, never a stale value */
}
void warden_fresh_set_visible(void *page, bool visible)
@@ -175,7 +175,7 @@ uint32_t warden_fresh_count(void)
uint32_t warden_fresh_min_budget_ms(void)
{
/* `seen` not `best == 0` marks "nothing scanned yet", so a legitimate
/* `seen` (not `best == 0`) marks "nothing scanned yet", so a legitimate
* zero-tolerance binding (max_stale_ms == 0, "must be fresh every tick") wins
* the minimum instead of being mistaken for the empty sentinel and widened. */
uint32_t best = 0;