summaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'README.md')
-rw-r--r--README.md24
1 files changed, 12 insertions, 12 deletions
diff --git a/README.md b/README.md
index 006d67a..88b1d93 100644
--- a/README.md
+++ b/README.md
@@ -28,9 +28,10 @@ needs to provide](#what-an-app-needs-to-provide).
on the host itself. `make` itself is already in FreeBSD base (bmake), so
it's the one build tool Skiff never asks you to install. Watch for
versioned port names (`go125`, `python312`, ...) - FreeBSD installs the
- literal versioned binary, not a bare `go`/`python3`, so symlink a default
- into the base image's `/usr/local/bin` if a Makefile invokes the
- unversioned name.
+ literal versioned binary, not a bare `go`/`python3`. Check for an
+ unversioned meta-port first (`go` itself is one - see [ZFS
+ layout](#zfs-layout)); only symlink a default by hand if no meta-port
+ exists for what you need.
- The build step needs real outbound network access from inside the jail
(module/package downloads) - see the `--ip` note under [First
deploy](#first-deploy).
@@ -63,17 +64,16 @@ wants `/dev/null` and `/dev/random`.) Now install whatever your apps'
Makefiles actually need to build:
```
-# pkg -c /skiff/base install -y go125
+# pkg -c /skiff/base install -y go
```
-Watch for versioned port names - FreeBSD installs `go125` as literally
-`go125`, not `go`, so a Makefile invoking the bare command needs a default
-symlinked in:
-
-```
-# ln -sf go125 /skiff/base/usr/local/bin/go
-# ln -sf gofmt125 /skiff/base/usr/local/bin/gofmt
-```
+FreeBSD's versioned language ports (`go125`, `python312`, ...) install as
+that literal binary name, not a bare `go`/`python3` - a Makefile invoking
+the unversioned command needs one. Check for an unversioned meta-port
+first: `go` is exactly that - it depends on whichever `goNNN` is current
+and installs the `go`/`gofmt` symlinks itself (`pkg install -y go`, not
+`go125` directly, is the whole fix). If no meta-port exists for what you
+need, symlink a default into `/usr/local/bin` by hand instead.
Unmount devfs and snapshot once the image can actually build and run apps: