From 8b3bf82d1d83708eb49da4b95760dc2cc9215ba2 Mon Sep 17 00:00:00 2001 From: Kevin Raymond Date: Tue, 10 Nov 2026 13:35:49 -0600 Subject: [PATCH 1/2] Docs: trim the vision and M6 --- docs/01-vision.md | 4 ++-- docs/07-phases.md | 1 - 2 files changed, 2 insertions(+), 3 deletions(-) diff --git a/docs/01-vision.md b/docs/01-vision.md index d53310b..9725287 100644 --- a/docs/01-vision.md +++ b/docs/01-vision.md @@ -39,8 +39,8 @@ probe adds no typesetting and no dependencies beyond the LaTeX kernel. with 7 GB of TeX Live they never asked for. - Package authors who want to know what their package costs. -It is a small audience, but it is the audience that writes TUGboat articles and answers TeX.SE -questions. One good "a flame chart of my LaTeX build" screenshot does the marketing. +It is a small audience, but it is the one that writes the TUGboat articles and answers other +people's questions. One good "a flame chart of my LaTeX build" screenshot does the marketing. ## Non-goals diff --git a/docs/07-phases.md b/docs/07-phases.md index 15f7a05..634562e 100644 --- a/docs/07-phases.md +++ b/docs/07-phases.md @@ -87,7 +87,6 @@ with florilegium as the corpus (real-world gate). **Demo:** the before/after siz and `docker/prumo.cmd` run it as a command), then crates.io, GitHub release binaries (Linux x86_64/aarch64, macOS, Windows), CTAN upload of `prumo.sty` alone (so people can use the probe without the CLI). -- Blog post + TeX.SE answer on "how do I find which package makes my compile slow". **Accept:** a stranger installs it from the README and gets a report on their own document in under five minutes. From 8b44a808f38f5f75e0cb4abe7473f21933b19b71 Mon Sep 17 00:00:00 2001 From: Kevin Raymond Date: Tue, 10 Nov 2026 13:40:21 -0600 Subject: [PATCH 2/2] Docs: trim STATUS --- docs/STATUS.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/docs/STATUS.md b/docs/STATUS.md index 2187bf3..80a4019 100644 --- a/docs/STATUS.md +++ b/docs/STATUS.md @@ -54,8 +54,8 @@ can check it. - `bench.py` has three modes: the phases (as before), `--overhead` (builds with and without the probe in turns, plus per-package times from the probed records) and `--whatif`. `charts.py` draws four SVG charts, light and dark, from the JSON. Color means phase in - all of them, the palette checked with the dataviz validator, the gray included after you - could not tell startup from body. + all of them, and every pair of colors, the gray included, is checked with the dataviz + validator. - The probe costs 7 ms on the one-line document and under 6% everywhere. On the paper, LuaLaTeX's extra preamble time is biblatex (+151 ms) and fontspec's LuaTeX code (67 ms). - On the corpus, the precompiled preamble works on two of the six pdfLaTeX @@ -93,8 +93,8 @@ is corrected; CLAUDE.md still says "pdfTeX only". ### whatif -- `prumo whatif main.tex [--try preamble,draft,externalize] [--runs 5] [--shell-escape]`, - from the brief. Each experiment rebuilds its own copy of the directory with one change. +- `prumo whatif main.tex [--try preamble,draft,externalize] [--runs 5] [--shell-escape]`. + Each experiment rebuilds its own copy of the directory with one change. The timed builds run without the probe: a warm-up each, then the baseline and the variants in turns. Medians are compared. A difference no larger than the larger spread (2 ms at least, the polling resolution) is "within noise". The output is compared by page count, @@ -106,15 +106,15 @@ is corrected; CLAUDE.md still says "pdfTeX only". - `preamble` works on pdfTeX (the fixture goes from 244 to 91 ms). XeTeX and LuaTeX fail, and the row gives the error (finding 60). `doctor` has a mylatexformat row and the TeX image installs it. -- `externalize`: the brief's command line made every picture build typeset the whole - document (finding 61). The system call now carries the hook and names the engine. The text +- `externalize`: turned on from the command line alone, the external library made every + picture build typeset the whole document (finding 61). The system call now carries the hook and names the engine. The text is identical on all three engines, and ten pictures went from 944 to 138 ms. Without `--shell-escape` it is refused when asked for and not run by default. The table and the README mark it experimental. - New fixture `whatif`, eight claims, all tested. `make_artifacts.sh whatif` regenerates one fixture now. The fixture turned up finding 62: `doctor --check-log` now tells an existence check from a read. -- My choices: `--runs` is at least 2. The comparison uses the last run's PDF. Logs go to +- Defaults: `--runs` is at least 2. The comparison uses the last run's PDF. Logs go to `//whatif//`. With `--shell-escape` the probed run is `--build " -shell-escape"`, so `time` rebuilds afterwards. No `--latexmk` or `--build`, since their wall time is several passes. @@ -129,7 +129,7 @@ is corrected; CLAUDE.md still says "pdfTeX only". - LuaLaTeX font definitions per page: the `luaotfload.patch_font` hypothesis is wrong for `\addfontfeature`, so nothing shipped (finding 57). -**Blocked:** nothing. **Needs me:** the announcement post, when you want it. +**Blocked:** nothing. **Open questions:** should the LuaTeX font count go in after all, through `font.nextid()`? Should `compare` default to three runs, so it reports a median?