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.
2026-08-31 12:31:27 -06:00
parent 80d9a9539b
commit 42fb386f60
111 changed files with 1261 additions and 1261 deletions
@@ -3,12 +3,12 @@
 # AICSemi AIC8800DC SDIO WiFi+BT driver (WardenOS M5 port).
 #
 # Ported from the vendor 5.10.160 out-of-tree source
-# (flare-edge/sdk/sysdrv/drv_ko/wifi/aic8800dc/) — see
+# (flare-edge/sdk/sysdrv/drv_ko/wifi/aic8800dc/), see
 # warden-sdk/kernel/rv1106-enablement/wifi/PORT-PLAN.md and PORT-PROGRESS.md.
 # Modules (=m), loaded late by /oem/usr/ko/insmod_wifi.sh: the AIC8800 SDIO
 # bring-up is two-stage (bsp downloads firmware, chip re-enumerates, fdrv
 # attaches). Built-in device_initcalls run BEFORE the dw_mmc/SDIO controller
-# probes — initcalls are sequential, so aicbsp_init blocks [3.3-7.5]s while the
+# probes: initcalls are sequential, so aicbsp_init blocks [3.3-7.5]s while the
 # mmc controller only probes at [7.9]s afterward, and the eager bring-up
 # deadlocks (it waits for a card the blocked mmc probe hasn't enumerated).
 # Late module load, after the mmc-pwrseq enumerates the card, is the
@@ -28,7 +28,7 @@ config AIC_FW_PATH
 	default "/oem/usr/ko/aic8800dc_fw"
 	help
 	  Path to the firmware & config files. The driver reads these
-	  directly (not via request_firmware()) — see PORT-PLAN.md §3.8.
+	  directly (not via request_firmware()), see PORT-PLAN.md section 3.8.

 if AIC_WLAN_SUPPORT
 source "drivers/net/wireless/aic8800/aic8800_fdrv/Kconfig"
@@ -2,7 +2,7 @@
 #
 # Link order matters: bsp before fdrv before btlpm, mirroring the working
 # insmod order (insmod_wifi.sh) now that these are built-in (=y) instead of
-# modules — see PORT-PLAN.md §4.5.
+# modules, see PORT-PLAN.md section 4.5.
 obj-$(CONFIG_AIC_WLAN_SUPPORT)      += aic8800_bsp/
 obj-$(CONFIG_AIC8800_WLAN_SUPPORT)  += aic8800_fdrv/
 obj-$(CONFIG_AIC8800_BTLPM_SUPPORT) += aic8800_btlpm/
@@ -1,9 +1,9 @@
 # SPDX-License-Identifier: GPL-2.0-only
 #
-# aic8800_bsp — SDIO bus glue + firmware bootstrap, ported in-tree from the
+# aic8800_bsp: SDIO bus glue + firmware bootstrap, ported in-tree from the
 # vendor out-of-tree Makefile (flare-edge/sdk/sysdrv/drv_ko/wifi/aic8800dc/
 # aic8800_bsp/Makefile). CONFIG_AIC_FW_PATH is now a real Kconfig string
-# symbol (see ../Kconfig) so it needs no -D here — the driver picks it up
+# symbol (see ../Kconfig) so it needs no -D here; the driver picks it up
 # from include/generated/autoconf.h directly (aicsdio.c, aic_bsp_driver.h).
 #
 # Vendor CONFIG_* build-time knobs below are preserved as fixed -D flags
@@ -3,5 +3,5 @@ config AIC8800_BTLPM_SUPPORT
 	default y
 	help
 	  This is support for the aic8800 bluetooth low-power-mode / HCI
-	  wake companion module (aic8800_btlpm). Built-in (y) by default —
+	  wake companion module (aic8800_btlpm). Built-in (y) by default,
 	  see the aic8800 port notes in warden-sdk/kernel/rv1106-enablement/wifi/.
@@ -1,6 +1,6 @@
 # SPDX-License-Identifier: GPL-2.0-only
 #
-# aic8800_btlpm — Bluetooth low-power-mode / HCI wake companion module,
+# aic8800_btlpm: Bluetooth low-power-mode / HCI wake companion module,
 # ported in-tree from the vendor out-of-tree Makefile
 # (flare-edge/sdk/sysdrv/drv_ko/wifi/aic8800dc/aic8800_btlpm/Makefile).
 # lpm.c stays out of the build (CONFIG_SUPPORT_LPM was already off in the
@@ -3,5 +3,5 @@ config AIC8800_WLAN_SUPPORT
 	default y
 	help
 	  This is support for the aic8800 cfg80211 full-MAC wifi driver
-	  (aic8800_fdrv). Built-in (y) by default — see the aic8800 port
+	  (aic8800_fdrv). Built-in (y) by default, see the aic8800 port
 	  notes in warden-sdk/kernel/rv1106-enablement/wifi/.
@@ -1,17 +1,17 @@
 # SPDX-License-Identifier: GPL-2.0-only
 #
-# aic8800_fdrv — the cfg80211 full-MAC driver ("fdrv"), ported in-tree from
+# aic8800_fdrv: the cfg80211 full-MAC driver ("fdrv"), ported in-tree from
 # the vendor out-of-tree Makefile (flare-edge/sdk/sysdrv/drv_ko/wifi/
 # aic8800dc/aic8800_fdrv/Makefile). SDIO-only build (this board has no
-# USB/PCI variant) — usb_host.c and rwnx_pci.c are dropped from the tree
-# entirely (PORT-PLAN.md §4.1 flagged both as candidates to drop "unless a
-# build error proves them referenced elsewhere" — that held for these two).
+# USB/PCI variant): usb_host.c and rwnx_pci.c are dropped from the tree
+# entirely (PORT-PLAN.md section 4.1 flagged both as candidates to drop "unless a
+# build error proves them referenced elsewhere", that held for these two).
 # rwnx_mesh.c was ALSO dropped initially on the same theory but had to be
 # restored: rwnx_tx.c's NL80211_IFTYPE_MESH_POINT switch-case is not
 # preprocessor-gated, so rwnx_mesh.h's types/prototypes are needed to
 # compile even though this board never creates a mesh-type interface.
 # md5.o: fdrv carries its OWN copy (vendor ships md5.c in both aic8800_bsp/ and
-# aic8800_fdrv/). As separate modules each .ko needs its own MD5 — bsp does not
+# aic8800_fdrv/). As separate modules each .ko needs its own MD5: bsp does not
 # EXPORT_SYMBOL(MD5Init/...), so fdrv.ko cannot resolve them from aic8800_bsp.ko
 # (modpost: "MD5Final undefined"). The two copies are byte-identical and live in
 # separate module namespaces, so there is no collision. (When these were briefly