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:
1 parent
d14da90bbf
commit
ed7bedf5a7
13 files changed
+335
-41
No files matched your search
@@ -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
|
||||
|
||||
@@ -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);
|
||||
|
||||
@@ -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".**
|
||||
|
||||
Reference in new issue
Block a user