Configurable paths (config.sh + generated env), vendored speech.h, merge docs

README.md

@@ -35,10 +35,29 @@ Manual steps, if needed:
     setup/setup-prefix.sh          # prefix + SAPI4 runtime + MSTTS voices
     setup/setup-flextalk.sh        # Flextalk extraction + registry
     # host build:
-    winegcc -m32 -O2 -o build/sapi4host-winlib host/sapi4host.c -I../reference \
+    winegcc -m32 -O2 -o build/sapi4host-winlib host/sapi4host.c -Ithird_party \
         -lole32 -luser32 -ladvapi32
     i686-w64-mingw32-gcc -O2 -static -o build/sapi4host.exe host/sapi4host.c \
-        -I../reference -lole32 -luser32 -ladvapi32 -luuid
+        -Ithird_party -lole32 -luser32 -ladvapi32 -luuid
+
+## Configuration
+
+`setup/install.sh` writes `setup/microslopsam.env` (generated, gitignored) with absolute
+paths. Environment variables take precedence over the file, so anything can be relocated
+without editing scripts:
+
+| Variable | Default | Meaning |
+| --- | --- | --- |
+| `MICROSLOP_ROOT` | repo root | project root |
+| `MICROSLOP_BUILD` | `$MICROSLOP_ROOT/build` | host binaries, samples |
+| `MICROSLOP_PREFIX` | `~/.wine-microslopsam` | wine prefix (exported as `WINEPREFIX`) |
+| `MICROSLOP_ASSETS` | `../Microsoft-Sam-Mary-Mike-TruVoice-WSAPI4` | SAPI4/MSTTS payloads |
+| `MICROSLOP_FLEXTALK_DIR` | `../flextalk` | Flextalk archive/extraction |
+| `MICROSLOP_SPEECH_H_DIR` | `$MICROSLOP_ROOT/third_party` | `speech.h` include dir (vendored) |
+| `MICROSLOP_DISPLAY` | `:77` | Xvfb display used for Wine |
+| `MICROSLOP_WINE`, `MICROSLOP_XVFB`, `MICROSLOP_PYTHON`, `MICROSLOP_FFMPEG` | tool names | tool overrides |
+
+Refresh the file after moving the tree: `MICROSLOP_UPDATE_ENV=1 setup/install.sh`.
 
 ## Usage
 
@@ -96,8 +115,9 @@ wrapper, so the WebUI does not need to implement them. See `docs/TTS-DESIGN.md`.
 
 ## Reference material (not in this repo)
 
-- `../reference/speech.h` — SAPI4 SDK header
+- `third_party/speech.h` — SAPI4 SDK header (vendored, so the build is standalone)
 - `../reference/SAPI4-CLI`, `../reference/TETYYS-SAPI4` — host examples
+- `../reference/NetTTS` — VOX parser reference for `setup/vox_parser.py`
 - `../Microsoft-Sam-Mary-Mike-TruVoice-WSAPI4` — installers/payloads
 - `../flextalk` — Flextalk installer archive + extraction
 - `/mnt/ghidra/decomp/{msttssyn.dll,speech.dll}/` — decompiled corpora