[BUG] Manual control names contain unescaped underscores and fail TeX rendering #12

Open
opened 2026-10-12 12:11:47 +02:00 by erikinkinen · 0 comments
Owner

Summary

Manual control names contain unescaped underscores and fail TeX rendering. Maintained validation cannot reach its intended successful boundary.

Reproduction

Run scripts/build-manual.sh at the linked original documentation revision with the maintained TeX toolchain. The original failing source and current repairs are distinct; failures and true exit statuses are retained.

Expected and actual behavior

The maintained source should compile, discover its original controls and complete the specified checks without warnings. Unescaped underscores in Draining(NOT_FOUND) and READ_METADATA enter ordinary text and make the manual renderer fail. This fatal syntax defect is distinct from previously tracked final-pass typesetting warnings.

Environment and identity

  • Component repository/revision and Integration source graph: original docs source, original Integration graph.
  • Image profile, digest and build/runtime configuration: maintained host validation and selected component workflow; no guest image is claimed by this report.
  • Hardware or VM, architecture, firmware and toolchain versions: x86_64 host with the workflow-selected toolchain; no hardware or firmware-specific cause is inferred.
  • Input/session route and granted authority relevant to reproduction: explicit source graph and local validation inputs; no additional runtime authority is introduced.
  • Last known working revision, if known: not established.

Evidence and prior checks

Escape the literal control names in the maintained TeX sources. The corrected current-source strict manual build exits zero, emits a 2811-page PDF, and records zero final warnings, overfull or underfull diagnostics. Later documentation changes require a fresh build.

Original failing CI job.

Tests and exact-head CI now run in parallel with implementation. A skipped, pending or unrun check is not a pass; independent source work continues while regressions are repaired.

Tracking

Phase completion tracks the full remaining goal. Signed source fixes, coherent dependency adoption and exact validation results will be recorded before closure.

## Summary Manual control names contain unescaped underscores and fail TeX rendering. Maintained validation cannot reach its intended successful boundary. ## Reproduction Run scripts/build-manual.sh at the linked original documentation revision with the maintained TeX toolchain. The original failing source and current repairs are distinct; failures and true exit statuses are retained. ## Expected and actual behavior The maintained source should compile, discover its original controls and complete the specified checks without warnings. Unescaped underscores in Draining(NOT_FOUND) and READ_METADATA enter ordinary text and make the manual renderer fail. This fatal syntax defect is distinct from previously tracked final-pass typesetting warnings. ## Environment and identity - Component repository/revision and Integration source graph: [original docs source](https://git.erikinkinen.fi/erix/docs/commit/e028bfd38e56d47f035f8f6dbc3d5e64bfa15c2d), [original Integration graph](https://git.erikinkinen.fi/erix/integration/commit/a615de2f69c25d4575d0c349757a0017082f988b). - Image profile, digest and build/runtime configuration: maintained host validation and selected component workflow; no guest image is claimed by this report. - Hardware or VM, architecture, firmware and toolchain versions: x86_64 host with the workflow-selected toolchain; no hardware or firmware-specific cause is inferred. - Input/session route and granted authority relevant to reproduction: explicit source graph and local validation inputs; no additional runtime authority is introduced. - Last known working revision, if known: not established. ## Evidence and prior checks Escape the literal control names in the maintained TeX sources. The corrected current-source strict manual build exits zero, emits a 2811-page PDF, and records zero final warnings, overfull or underfull diagnostics. Later documentation changes require a fresh build. [Original failing CI job](https://git.erikinkinen.fi/erix/docs/actions/runs/1571/jobs/0). Tests and exact-head CI now run in parallel with implementation. A skipped, pending or unrun check is not a pass; independent source work continues while regressions are repaired. ## Tracking [Phase completion](https://git.erikinkinen.fi/erix/integration/issues/65) tracks the full remaining goal. Signed source fixes, coherent dependency adoption and exact validation results will be recorded before closure.
erikinkinen added this to the Alpha 1 milestone 2026-10-30 09:33:40 +01:00
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
erix/docs#12
No description provided.