docs: correct the layout block, and note what a copy leaves behind

README's layout predated the BIOS/UEFI split. moving-to-linux.md now
says what is gitignored and therefore absent from a clone: dist/ holds
61 MB of upstream tarballs, so copy it or let the build re-fetch them --
make ports verifies each against a known SHA-256 either way.
This commit is contained in:
Nexoniarz 2026-08-09 17:25:42 +02:00
commit dbb88064c1
4 changed files with 58 additions and 1 deletions

View file

@ -18,6 +18,19 @@ git log --oneline | head -3 # should show the same commits
git status # should be clean
```
### What is not in the repo
`build/`, `sysroot/` and `dist/` are all gitignored, so `rsync -a` of the
working tree carries them but a `git clone` would not. Two are worth thinking
about:
- **`dist/`** holds the upstream tarballs — musl, toybox, mksh, the DOOM WADs,
`usb.ids`. 61 MB of other people's release artefacts. Copy it to save the
download, or let the build fetch them again; `make ports` calls `curl` and
verifies each against a known SHA-256, so a re-download is safe either way.
Without a network connection, copy it.
- **`sysroot/`** is assembled by the build.
`build/` and `sysroot/` are ignored and do not need copying — `make` rebuilds
them. **One exception**: `sysroot/bin/` holds musl, toybox and mksh, which
cannot be built on Windows and so were staged there once. On Linux they *can*