Zander671/river
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

docs: update PACKAGING.md for Zig 0.11

Browse Source
This commit is contained in:
Isaac Freund 2023-10-25 12:16:50 +02:00
parent 3fa44d8509
commit 0729b9122b
No known key found for this signature in database
GPG Key ID: 86DED400DDFD7A11
1 changed files with 12 additions and 11 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

23
PACKAGING.md
View File

@ -66,18 +66,19 @@ in the first place. For greatest effect, both may be used.
- Enable compiler optimizations: - Enable compiler optimizations:
- `-Drelease-safe`: Keep all assertions and runtime safety checks active. - `-Doptimize=ReleaseSafe`: Optimize for execution speed,
keep all assertions and runtime safety checks active.
- `-Drelease-fast`: Optimize for execution speed, disable all assertions - `-Doptimize=ReleaseFast`: Optimize for execution speed,
and runtime safety checks. disable all assertions and runtime safety checks.
- `-Drelease-small`: Optimize for binary size, disable all assertions and - `-Doptimize=ReleaseSmall`: Optimize for binary size,
runtime safety checks. disable all assertions and runtime safety checks.
Please use `-Drelease-safe` when building river for general use. CPU execution Please use `-Doptimize=ReleaseSafe` when building river for general
speed is not the performance bottleneck for river, the GPU is. Additionally, use. CPU execution speed is not the performance bottleneck for river, the
the increased safety is more than worth the binary size trade-off in my GPU is. Additionally, the increased safety is more than worth the binary
opinion. size trade-off in my opinion.
## Build prefix and DESTDIR ## Build prefix and DESTDIR
@ -114,7 +115,7 @@ a convention.
Build for the host architecture and libc ABI: Build for the host architecture and libc ABI:
```bash ```bash
DESTDIR=/foo/bar zig build -Drelease-safe -Dcpu=baseline \ DESTDIR=/foo/bar zig build -Doptimize=ReleaseSafe -Dcpu=baseline \
-Dstrip -Dpie --prefix /usr install -Dstrip -Dpie --prefix /usr install
``` ```
@ -133,7 +134,7 @@ DESTDIR="/foo/bar" zig build \
--sysroot "${XBPS_CROSS_BASE}" \ --sysroot "${XBPS_CROSS_BASE}" \
--libc xbps_zig_libc.txt \ --libc xbps_zig_libc.txt \
-Dtarget=aarch64-linux-musl -Dcpu=baseline \ -Dtarget=aarch64-linux-musl -Dcpu=baseline \
-Drelease-safe -Dstrip -Dpie \ -Doptimize=ReleaseSafe -Dstrip -Dpie \
--prefix /usr install --prefix /usr install
``` ```