Update README.md with better MacOS build instructions
This commit is contained in:
parent
ab298fd662
commit
980411f42d
1 changed files with 26 additions and 6 deletions
32
README.md
32
README.md
|
@ -7,16 +7,26 @@ https://github.com/neurocyte/flow/assets/1552770/97aae817-c209-4c08-bc65-0a0bf1f
|
||||||
|
|
||||||
# Building
|
# Building
|
||||||
|
|
||||||
Build with the provided zig wrapper:
|
Make sure your system meets the requirements listed below.
|
||||||
|
|
||||||
|
Flow tracks zig master most of the time. Build with:
|
||||||
|
|
||||||
|
```shell
|
||||||
|
zig build -Doptimize=ReleaseFast
|
||||||
|
```
|
||||||
|
|
||||||
|
Sometime zig master may introduce breaking changes and Flow may take a few days to
|
||||||
|
catch up. In that case there is a simple zig wrapper script provided that will download
|
||||||
|
and build with the last known compatible version of zig. The version is stored in
|
||||||
|
`build.zig.version`.
|
||||||
|
|
||||||
|
Build with the zig wrapper:
|
||||||
```shell
|
```shell
|
||||||
./zig build -Doptimize=ReleaseFast
|
./zig build -Doptimize=ReleaseFast
|
||||||
```
|
```
|
||||||
|
|
||||||
The zig wrapper just fetches a known good version of zig nightly and places it
|
The zig wrapper places the downloaded zig compiler in the `.cache` directory and does
|
||||||
in the .cache directory. Or use your own version of zig. Be sure to use a version
|
not touch your system. It requires `bash`, `curl` and `jq` to run.
|
||||||
at least as high as the version used be the zig wrapper. It's stored in `build.zig.version`.
|
|
||||||
|
|
||||||
Also, make sure your system meets the requirements listed below.
|
|
||||||
|
|
||||||
Run with:
|
Run with:
|
||||||
```shell
|
```shell
|
||||||
|
@ -27,6 +37,16 @@ Place it in your path for convenient access.
|
||||||
|
|
||||||
See --help for full command line.
|
See --help for full command line.
|
||||||
|
|
||||||
|
## MacOS
|
||||||
|
|
||||||
|
On MacOS you will need to link Flow against a MacOS build of notcurses 3.0.9. This
|
||||||
|
is easiest with `brew`:
|
||||||
|
|
||||||
|
```shell
|
||||||
|
brew install notcurses
|
||||||
|
zig build -Duse_system_notcurses=true --search-prefix /usr/local
|
||||||
|
```
|
||||||
|
|
||||||
# Terminal configuration
|
# Terminal configuration
|
||||||
|
|
||||||
Kitty, Ghostty and most other terminals have default keybindings that conflict
|
Kitty, Ghostty and most other terminals have default keybindings that conflict
|
||||||
|
|
Loading…
Add table
Reference in a new issue