Images in plain text and the terminal; bounded build parallelism (from dev 16f82cc887af)

- @image under txt and ansi is a picture in characters, in five styles
  (Image_txt_style: halfblock the default, shade, ascii, quadrant,
  braille), sized to the terminal's width less a margin when ktext runs
  in one, every cell in its own colours under ansi; a figure's caption
  is centred under it and no txt caption is ruled off any more.
- The build compiles as many files at once as the machine has cores
  (JOBS; make -C com JOBS=1 for a small machine): the sub-makes' bare -j
  meant unlimited parallelism and exhausted 8 GB machines. The three
  install pages say "make -C com".

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
This commit is contained in:
ackandClaude Fable 5.1 committed 2026-09-30 16:13:23 +02:00
1 parent d14da90bbf
commit ed7bedf5a7
13 files changed
+335 -41

No files matched your search

+3 -3
View File
@@ -106,11 +106,11 @@ first, then the commands. The build is optimized (`-O3`) by default — the buil
you want to install and run:
```bash
make -C com -j # lib/libklammertext.so + sks/*.so + bin/{ktext,kdesc,kdiag}
make -C com # 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`.)
prefix `DEBUG=1`: `DEBUG=1 make -C com`.)
Verify the build:
@@ -320,7 +320,7 @@ To update an existing source installation to the latest version:
```bash
cd $KLAMMERTEXT_HOME
git pull
make -C com -j # rebuild library, SKS components, and commands (optimized)
make -C com # rebuild library, SKS components, and commands (optimized)
```
The TeX Live tree only needs rebuilding if the SKS's package requirements
+3 -3
View File
@@ -86,12 +86,12 @@ then the commands:
```sh
cd "$KLAMMERTEXT_HOME"
make -C com -j # optimized (-O3) by default; libklammertext.so + sks/*.so + bin/{ktext,kdesc,kdiag}
make -C com # optimized (-O3) by default; libklammertext.so + sks/*.so + bin/{ktext,kdesc,kdiag}
ktext -s '@eval 1 + 1 @' -d # smoke test — prints 2
```
(For a debug build with AddressSanitizer, intended for development, prefix
`DEBUG=1`: `DEBUG=1 make -C com -j`.)
`DEBUG=1`: `DEBUG=1 make -C com`.)
For a document smoke test, create a small file and render it to HTML:
@@ -208,7 +208,7 @@ To update an existing source installation to the latest version:
```sh
cd "$KLAMMERTEXT_HOME"
git pull
make -C com -j # rebuild library, SKS components, and commands (optimized)
make -C com # rebuild library, SKS components, and commands (optimized)
```
Rebuild the TeX Live tree only if the SKS's package requirements changed (rare);
+7 -7
View File
@@ -138,13 +138,13 @@ sets `PYTHON=python`. Nothing is edited by hand.
In the UCRT64 shell, in the repository:
```bash
make -C com -j
make -C com
```
`-j` compiles in parallel; on a machine with 8 GB of memory or less the
optimizing compiler may run out of memory and report `out of memory
allocating`. If so, run `make -C com` without `-j`: slower, and it
finishes.
The build compiles as many files at once as the machine has cores. On a
machine with 8 GB of memory or less the optimizing compiler may run out
of memory and report `out of memory allocating`; if so, `make -C com
JOBS=2`, or `JOBS=1`: slower, and it finishes.
This builds the library (`klammertext.dll`), the Standard Klammer Set's
components and the three commands (`ktext.exe`, `kdesc.exe`, `kdiag.exe`)
@@ -311,7 +311,7 @@ In the UCRT64 shell:
```bash
cd $KLAMMERTEXT_HOME
git pull
make -C com -j
make -C com
```
@@ -379,7 +379,7 @@ installed one may not. Install it from
https://aka.ms/vs/17/release/vc_redist.x64.exe and try the import again.
**"klammertext.dll was not found" or "libstdc++-6.dll was not found".**
`bin\` is not on the `Path`, or the build did not finish: `make -C com -j`
`bin\` is not on the `Path`, or the build did not finish: `make -C com`
places the library and the runtime DLLs in `bin\` beside the commands.
**"The shell Klammertext runs sh commands with on Windows is missing".**