john/cell
1
0
Fork 0
Code Issues 31 Pull Requests Actions Packages Projects Releases 2 Wiki Activity

updated docs for dylib paths

Browse Source
This commit is contained in:
John Alanbrook
2026-02-18 20:30:54 -06:00
parent e2c26737f4
commit 777474ab4f
9 changed files with 115 additions and 72 deletions
Download Patch File Download Diff File Expand all files Collapse all files

15
docs/cli.md
View File

@@ -53,7 +53,7 @@ For local paths, the package is symlinked into the shop rather than copied. Chan
### pit build
Build C modules for a package. Compiles each C file into a per-file dynamic library and installs them to `~/.pit/lib/<pkg>/<stem>.dylib`. C files in `src/` directories are compiled as support objects and linked into the module dylibs.
Build C modules for a package. Compiles each C file into a per-file dynamic library stored in the content-addressed build cache at `~/.cell/build/<hash>`. A per-package manifest is written so the runtime can find dylibs by package name. C files in `src/` directories are compiled as support objects and linked into the module dylibs. Files that previously failed to compile are skipped automatically (cached failure markers); they are retried when the source or compiler flags change.
```bash
pit build # build all packages
@@ -174,7 +174,7 @@ Output includes median, mean, standard deviation, and percentiles for each bench
## Shop Commands
These commands operate on the global shop (`~/.pit/`) or system-level state.
These commands operate on the global shop (`~/.cell/`) or system-level state.
### pit install
@@ -430,7 +430,7 @@ pit qbe <file.cm>
Compile a source file to a native dynamic library.
```bash
pit compile <file.cm> # outputs .dylib to .cell/lib/
pit compile <file.cm> # outputs .dylib to ~/.cell/build/
pit compile <file.ce>
```
@@ -555,15 +555,12 @@ pit install /Users/john/work/mylib
## Configuration
ƿit stores its data in `~/.pit/`:
ƿit stores its data in `~/.cell/`:
```
~/.pit/
~/.cell/
├── packages/ # installed package sources
├── lib/ # installed per-file dylibs and mach (persistent)
│ ├── core/ # core package: .dylib and .mach files
│ └── <pkg>/ # per-package subdirectories
├── build/ # ephemeral build cache (safe to delete)
├── build/ # content-addressed cache (bytecode, dylibs, manifests)
├── cache/ # downloaded archives
├── lock.toml # installed package versions
└── link.toml # local development links