Repository navigation
Docs: say where prumo does what existing tools do - #9
Merged
Merged
Conversation
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.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Docs only. Nothing in
src/,tex/,tests/orfixtures/changes.What changed
docs/02-prior-art.md: the same list at the top, new rows (SaTeX, DEPP, Joseph Wright'sdepreader.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".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
\pdfelapsedtimeand calls\pdfresettimerin\AtBeginDocumentand\AtBeginShipout, onetimer: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 withos.clock().--timingsis "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) andunused-dependency(P005). The dependency file is DEPP'sDEPENDS.txt.latex.ltx(55 s).--timingsgavebiblatex.sty1,098 ms, SaTeX's own interpretation.preamble-costsuggested mylatexformat.unused-packagehad no note for xcolor on the basic fixture.tlmgr search --filereply is 050436, and in 050440 he addedtlmgr 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.probe_leaves_the_pdf_byte_identicalbuilds each fixture twice in one directory, withSOURCE_DATE_EPOCH=0andFORCE_SOURCE_DATE=1, and compares the whole PDF. Eight fixtures, seven of them on all three engines. It passes in theprumo-teximage 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.cmdhooks by patching the command (\__hook_patch_command:Nnnin TeX Live 2026'slatex.ltx).hitex), texfindpkg, mkjobtexmf, texliveonfly, mylatexformat and latexmk are all in the TeX Live 2026 tlpdb.Not run
mainat bae14f2) but did not run it.DEPP, texdepend and texdeps are new in this review.