Skip to content

Docs: say where prumo does what existing tools do - #9

Merged
kevinraymond merged 1 commit into
mainfrom
docs-prior-art
Nov 13, 2026
Merged

kevinraymond merged 1 commit into
mainfrom
docs-prior-art

Conversation

@kevinraymond

Copy link
Copy Markdown
Owner

Docs only. Nothing in src/, tex/, tests/ or fixtures/ changes.

What changed

  • README: Origin says most of the pieces exist in other tools. Related tools adds SaTeX, DEPP and pdffonts, then a "Same idea as existing tools" list and a "What differs" list. A new Built on section credits what prumo stands on. The byte-identical paragraph says what the test does. "Experiments, not guesses" is now "Experiments".
  • docs/02-prior-art.md: the same list at the top, new rows (SaTeX, DEPP, Joseph Wright's depreader.lua, texdepend and texdeps, the TeX.SE per-page timer, tlmgr search --json), and the tex-live thread under demand signals. The gaps are dated facts, and the verdicts are gone.
  • docs/06-unused-packages.md: the same pass, and a paragraph on the same idea. Also "judgement" → "judgment".
  • CLAUDE.md: texprof is its own engine, not pdfTeX. "Don't reinvent" adds SaTeX, texfindpkg, DEPP and mylatexformat.
  • docs/08-open-questions.md: a new section, 13 to 18, recorded with no defaults.
  • docs/STATUS.md: this session's note. The v0.2.0 section is rolled into one line, and its two open questions carry over.

What I checked

  • TeX.SE per-page timing (210139). Asked 2014-11-02. Robert's accepted answer (211572, 2014-11-10) prints \pdfelapsedtime and calls \pdfresettimer in \AtBeginDocument and \AtBeginShipout, one timer: line per page. The answer notes that the asynchronous output routine charges a page with material from the pages around it. A 2020 answer (558409) does the same on LuaLaTeX with os.clock().
  • SaTeX. github.com/gigalasr/satex-analyzer is a fork made 2026-09-26 at 0.1.0, with no releases. The original, EagleoutIce/satex-analyzer (Florian Sihler, Rust, MIT), released 0.2.2 on 2026-11-12 and is on crates.io, so the docs cite it. Its README says "work in progress" and that it "does not typeset the document", and --timings is "a per-phase timing breakdown" that measures "the run itself". The four lints exist under those names: preamble-cost (P003), unused-package (P006), missing-dependency (C031) and unused-dependency (P005). The dependency file is DEPP's DEPENDS.txt.
  • SaTeX, run. 0.2.2 (sha256 checked) on TeX Live 2026, on copies of the biblatex and basic fixtures. The first run builds a kernel cache from latex.ltx (55 s). --timings gave biblatex.sty 1,098 ms, SaTeX's own interpretation. preamble-cost suggested mylatexformat. unused-package had no note for xcolor on the basic fixture.
  • tex-live thread. The thread is 050431 to 050441, not 050433 to 050437. Joseph Wright started it (050431, 2024-04-24) after TeX.SE 716306, and 050433 is his reply to Marei Peischl. Norbert Preining's tlmgr search --file reply is 050436, and in 050440 he added tlmgr search --json, which works on TeX Live 2026. Markus Kohm pointed at texliveonfly (050437). What came of it: Joseph's script as TeX.SE answer 716373, tlmgr search --json, and DEPP, Marei's Island of TeX project, public at 0.4. CTAN's package list has nothing from the script.
  • Byte-identical. probe_leaves_the_pdf_byte_identical builds each fixture twice in one directory, with SOURCE_DATE_EPOCH=0 and FORCE_SOURCE_DATE=1, and compares the whole PDF. Eight fixtures, seven of them on all three engines. It passes in the prumo-tex image today (25.8 s). CLAUDE.md rule 3 says "modulo /CreationDate and ID", which allows more than the test checks. I left rule 3 alone.
  • ltcmdhooks. The kernel implements the generic cmd hooks by patching the command (\__hook_patch_command:Nnn in TeX Live 2026's latex.ltx).
  • In TeX Live. texprof (hitex), texfindpkg, mkjobtexmf, texliveonfly, mylatexformat and latexmk are all in the TeX Live 2026 tlpdb.
  • pdffonts. 26.07.0, run on the basic fixture's PDF.

Not run

  • DEPP. I read its source (0.4, main at bae14f2) but did not run it.
  • texdepend and texdeps. From their CTAN entries only.

DEPP, texdepend and texdeps are new in this review.

The README's Related tools now names the tool for each thing prumo does that another tool
already does, and then says what differs. It adds SaTeX, DEPP and pdffonts, and a Built on
list. docs/02-prior-art.md has the same list, rows for SaTeX, DEPP, Joseph Wright's script,
texdepend, texdeps and the TeX.SE per-page timer, and the tex-live thread of April 2024.
Its gaps are dated facts now, without verdicts, and docs/06 got the same pass.

The README says what the byte-identical test does. CLAUDE.md no longer calls texprof
pdfTeX. docs/08 records the candidates from the review, with no defaults.
@kevinraymond
kevinraymond merged commit 904b587 into main Nov 13, 2026
4 checks passed
@kevinraymond
kevinraymond deleted the docs-prior-art branch November 13, 2026 10:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant