afs-as Public
Go to file
T
Code
Use Git or checkout with SVN using the web URL.
No matching headings.
Probe Workbench
This directory is the in-repo home for ad hoc discovery probes that would
otherwise get scattered under /tmp.
Use it for:
- one-off
clang -Ssource snippets used to discover what Appleclangemits - tiny
.sfiles used to extract exact Appleasencodings - temporary compare/repro artifacts while bringing up a new family
Do not treat this directory as the canonical test corpus.
Promotion rules:
- if a C probe becomes a real tracked regression or dashboard case, move it into
tests/clang_probe/ - if an assembly fixture becomes a real compatibility or writer-parity case,
move it into
tests/corpus/ - once promoted, either remove the workbench copy or keep it only if it still adds discovery value beyond the promoted regression
- when keeping a workbench file, add a short comment at the top explaining what it exposed, what fix or design decision it led to, or why it is still useful
This directory is tracked on purpose. It is the portable notebook for SIMD,
relocation, writer-parity, and clang-output discovery work across machines.
Some probes here may be incomplete or intentionally rough:
- a source may exist only to see what
clang -Semits - an assembly snippet may exist only to pin raw Apple
asencodings - not every file here is expected to build as part of the normal test suite
That is fine. The canonical regression surface still lives under
tests/clang_probe/ and tests/corpus/; this workbench just keeps the
exploration trail durable and close to the codebase.
Suggested header style:
- for C probes:
/* Workbench note: this probe exposed ... and led to ... */
- for assembly probes:
; Workbench note: this probe pinned ... and led to ...