[BUG] Native manual key table stops TeX rendering #26

Open
opened 2026-10-24 08:41:03 +02:00 by erikinkinen · 0 comments
Owner

Summary

The native manual chapter's key table stops the technical manual build. It uses longtable and booktabs commands that the maintained document preamble does not load.

Reproduction

Open the manual job in Docs CI1739, built from db3a0fbba6. The maintained manual build reaches manual/9-command-line-tools/29-native-manuals.tex:55 and fails at the table declaration. The complete original job log is retained; no rerun is needed to observe this failure.

Expected and actual behavior

The chapter should render its input/action table with the supported manual primitives. Instead, TeX reports Environment longtable undefined at \begin{longtable} and stops. The same table also uses \toprule, \midrule, \endhead and \bottomrule, so replacing only the environment would leave unsupported commands behind.

Environment and identity

  • Repository: Docs, revision db3a0fbba6.
  • Route: the maintained Docker manual CI job and its selected TeX tools.
  • Input: the native manual chapter and manual/main.tex preamble; no guest image or runtime authority is involved.
  • Last working chapter revision has not been established.

Evidence and prior checks

The original manual job50486 log is complete. Current source still contains the same table, and manual/main.tex does not load longtable or booktabs. The same run's Markdown job passes; that does not establish successful rendering. No publisher or timeout cause is inferred.

Tracking

Related review: Docs PR4.

  • Express the complete key table using supported manual primitives without adding undeclared package requirements.
  • Render the changed chapter in the complete warning-free manual and retain the original failure separately.
  • Preserve the key bindings, native input behavior and surrounding manual content.
## Summary The native manual chapter's key table stops the technical manual build. It uses longtable and booktabs commands that the maintained document preamble does not load. ## Reproduction Open the manual job in [Docs CI1739](https://git.erikinkinen.fi/erix/docs/actions/runs/1739/jobs/0), built from db3a0fbba6dd61113aa3d15ea3a44217f3ce5251. The maintained manual build reaches manual/9-command-line-tools/29-native-manuals.tex:55 and fails at the table declaration. The complete original job log is retained; no rerun is needed to observe this failure. ## Expected and actual behavior The chapter should render its input/action table with the supported manual primitives. Instead, TeX reports `Environment longtable undefined` at `\begin{longtable}` and stops. The same table also uses `\toprule`, `\midrule`, `\endhead` and `\bottomrule`, so replacing only the environment would leave unsupported commands behind. ## Environment and identity - Repository: Docs, revision db3a0fbba6dd61113aa3d15ea3a44217f3ce5251. - Route: the maintained Docker manual CI job and its selected TeX tools. - Input: the native manual chapter and manual/main.tex preamble; no guest image or runtime authority is involved. - Last working chapter revision has not been established. ## Evidence and prior checks The original manual job50486 log is complete. Current source still contains the same table, and manual/main.tex does not load longtable or booktabs. The same run's Markdown job passes; that does not establish successful rendering. No publisher or timeout cause is inferred. ## Tracking Related review: [Docs PR4](https://git.erikinkinen.fi/erix/docs/pulls/4). - [ ] Express the complete key table using supported manual primitives without adding undeclared package requirements. - [ ] Render the changed chapter in the complete warning-free manual and retain the original failure separately. - [ ] Preserve the key bindings, native input behavior and surrounding manual content.
erikinkinen added this to the Alpha 1 milestone 2026-10-30 09:33:41 +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#26
No description provided.