From 227111c84a2945087abb4395daf63c7b23ba5bab Mon Sep 17 00:00:00 2001 From: Gabriel Schneider Date: Fri, 6 Nov 2026 22:36:07 -0300 Subject: kinds #47, MuPDF and FreeType lazy: Zig 0.17's configure is handed the -D options and never the steps asked for (the configurer's argv, and the configure cache keyed on it), so no step can fetch for itself; the guard is `-Dpdf`, on by itself once MuPDF is fetched (std.Build.package_map's `available`) and off Linux, which asks `b.lazyDependency` for MuPDF, and FreeType (with the zlib and libpng it brings) is lazy too and asked by it or a window: a fresh checkout's `zig build -Dplatform=tui` fetches none of them, and without `-Dpdf` the pdf, addons, static, mupdf-check, pdf-harness and bench steps say to add it; building.typ, install.typ and shared-libs.md say so Co-Authored-By: Claude Fable 5.1 Claude-Session: https://claude.ai/code/session_016Y9MNAtZenFv4weoMD3cge --- docs/typ/install.typ | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) (limited to 'docs/typ/install.typ') diff --git a/docs/typ/install.typ b/docs/typ/install.typ index 28ed67c8..9b23669f 100644 --- a/docs/typ/install.typ +++ b/docs/typ/install.typ @@ -22,9 +22,10 @@ With Zig 0.17 (the build fetches everything else; once that is downloaded, a first build from a clean cache took 62 seconds on 16 cores): #cmd("# pardes, in a terminal\nzig build -Dplatform=tui --prefix ~/.local") #cmd("# pardes-gui, its own window\nzig build -Dplatform=gui --prefix ~/.local") -#cmd("# the image and PDF addons (or `zig build image pdf`)\nzig build addons -Dplatform=tui --prefix ~/.local") +#cmd("# the image and PDF addons (or `zig build image pdf`)\nzig build addons -Dpdf -Dplatform=tui --prefix ~/.local") Then run `pardes` or `pardes FILE`. The addons are steps of their own: `lib/pardes/addons/image.so`, the image addon, and -`lib/pardes/addons/pdf.so`, the PDF addon (over MuPDF), which pardes +`lib/pardes/addons/pdf.so`, the PDF addon (over MuPDF, which `-Dpdf` +fetches the first time and every build after takes as fetched), which pardes loads at start from its prefix; a pardes without them (a downloaded binary alone) shows image files and PDFs as text. -- cgit v1.3