Default to the optimized -O3 build; DEBUG=1 for a debug build

Bare 'make -C com' now builds -O3 (optimize.env default flip); the install guides drop OPTIMIZE=1 and document DEBUG=1 for an AddressSanitizer build.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-07-18 20:03:40 +02:00
parent 2ba7ceee7a
commit 2024f8059d
3 changed files with 27 additions and 18 deletions

View File

@@ -88,14 +88,16 @@ If `python3-config` is missing, install your distribution's `python3-dev`
Build the shared library, the SKS components, and the three commands with a
single command: `make -C com` builds its prerequisites in `mac/` and `sks/`
first, then the commands. `OPTIMIZE=1` selects an optimized `-O3` build (what
you want to install and run); without it you get a slower `-O0` debug build
with AddressSanitizer, intended for development:
first, then the commands. The build is optimized (`-O3`) by default — the build
you want to install and run:
```bash
make -C com -j OPTIMIZE=1 # lib/libklammertext.so + sks/*.so + bin/{ktext,kdesc,kdiag}
make -C com -j # lib/libklammertext.so + sks/*.so + bin/{ktext,kdesc,kdiag}
```
(For a slower `-O0` debug build with AddressSanitizer, intended for development,
prefix `DEBUG=1`: `DEBUG=1 make -C com -j`.)
Verify the build:
```bash
@@ -243,7 +245,7 @@ To update an existing source installation to the latest version:
```bash
cd $KLAMMERTEXT_HOME
git pull
make -C com -j OPTIMIZE=1 # rebuild library, SKS components, and commands
make -C com -j # rebuild library, SKS components, and commands (optimized)
```
The TeX Live tree only needs rebuilding if the SKS's package requirements