kit

commit 6d58111015601dfee004536777e545c663079046
parent 45f7a80c6a18a62218cfd7492ec39295a6650cb9
Author: Ryan Sepassi <rsepassi@gmail.com>
Date:   Tue, 16 Jun 2026 13:57:08 -0700

port.mk: document DEPTH=coarse test-cross knob

Catch the parametrization docs up to the committed coarse amalgamation
cross-test lane: DEPTH now spans coarse|smoke|full for test-cross
(smoke|full for test-selfhost), and DEPTH=coarse is the compile/link-only
spelling alongside the RUN=0 execution knob.

Diffstat:
M
mk/port.mk
 | 
7
++++---

1 file changed, 4 insertions(+), 3 deletions(-)
diff --git a/mk/port.mk b/mk/port.mk
@@ -7,10 +7,10 @@
 #   kit-cross      build a runnable kit binary for a target (clang or kit)
 #   provision      the network + VM setup (separate from running)
 #
-# Parametrized uniformly:
+# Parametrized surface:
 #   TARGET    support-set selector (default all): all | <os> | linux-<libc> |
 #             <token> | a,b,c  (see scripts/hosted.sh expand)
-#   DEPTH     smoke (default) | full
+#   DEPTH     test-cross: coarse | smoke (default) | full; test-selfhost: smoke | full
 #   KIT_VM    1 (default; include freebsd/windows) | 0 (drop them)
 #   RUN       1 (default; execute linked smoke/full artifacts) | 0 (build/link only)
 #   CROSS_CC  kit (default) | clang   — kit-cross toolchain backend
@@ -18,7 +18,8 @@
 #
 # Examples:
 #   make test-cross                          # smoke across the whole support set
-#   make test-cross RUN=0                    # compile/link across the set, no execution
+#   make test-cross DEPTH=coarse             # compile/link across the set, no execution
+#   make test-cross RUN=0                    # same, via the execution knob
 #   make test-cross TARGET=linux-glibc-x64 DEPTH=full
 #   make test-cross TARGET=freestanding      # all 4 bare-metal arches
 #   make test-selfhost TARGET=freebsd-aa64