summaryrefslogtreecommitdiff
path: root/docs/shared-libs.md
diff options
context:
space:
mode:
authorGabriel Schneider <[email protected]>2026-11-06 13:21:54 -0300
committerGabriel Schneider <[email protected]>2026-11-06 14:24:59 -0300
commitb7fdfb18ffd199d49a254c1c799bc3415ad45ec2 (patch)
tree9e52b7a09c2e939f6efd4765c3e8d97464437a21 /docs/shared-libs.md
parentc37a700474e8b84cc3c7db8bf550b7c5f18b1871 (diff)
downloadpardes-b7fdfb18ffd199d49a254c1c799bc3415ad45ec2.tar.gz
pardes-b7fdfb18ffd199d49a254c1c799bc3415ad45ec2.zip
kinds #24, the addons as build steps: `zig build image` and `zig build pdf` each build their library and install it in <prefix>/lib/pardes/addons (and ~/.local/lib/pardes/addons with the home install), `zig build addons` both, the default install the binaries alone and -Dmupdf gone, MuPDF compiled only for the pdf step and the tests that depend on its artifact as before (fetched at the first configure, which Zig runs alike for every step); install.typ, building.typ, reference.typ, shared-libs.md, the README and the changelog say so
Co-Authored-By: Claude Fable 5.1 <[email protected]> Claude-Session: https://claude.ai/code/session_016Y9MNAtZenFv4weoMD3cge
Diffstat (limited to 'docs/shared-libs.md')
-rw-r--r--docs/shared-libs.md12
1 files changed, 10 insertions, 2 deletions
diff --git a/docs/shared-libs.md b/docs/shared-libs.md
index 52457bf1..e730efbd 100644
--- a/docs/shared-libs.md
+++ b/docs/shared-libs.md
@@ -21,6 +21,14 @@ a second FreeType (tools/shared_libs_check.zig). It counts static functions
too, and several functions per family, because a release build inlines some
of them.
+## The addons are build steps (2026-11-06)
+
+The default install is the binaries alone: `zig build image`, `zig build
+pdf` (or `zig build addons`, both) builds and installs each library in
+`<prefix>/lib/pardes/addons` (and `~/.local/lib/pardes/addons` with the
+home install). MuPDF is compiled only for a step that needs it (`pdf`, the
+tests); `-Dmupdf` is gone.
+
## PDF panes became an addon (2026-11-06)
`lib/pardes/addons/pdf.so` (addons/pdf/pdf.c and pdf_bridge.c) holds MuPDF,
@@ -107,8 +115,8 @@ Text section: tty 61,369,343 → 61,294,855 bytes (**−74,488**); gui
- **Two JPEG decoders: MuPDF's libjpeg and wuffs.** MuPDF's `DCTDecode` filter
(`filter-dct.c`) is written against libjpeg's streaming source-manager API.
Moving PDFs onto wuffs means a new DCT filter for fitz. Moving image panes
- onto libjpeg instead would leave a `-Dmupdf=false` build with no JPEG
- decoder.
+ onto libjpeg instead would leave a pardes without the PDF addon with no
+ JPEG decoder.
- **MuPDF's fitz image loaders** (`fz_load_png`, `_jpeg`, `_gif`, `_bmp`,
`_tiff`, `_pnm`, `_psd`; 16.7 KiB together). They are compiled because
mupdf.zig builds all of `source/fitz`. They are reachable only through