diff --git a/kotlin-native/HACKING.md b/kotlin-native/HACKING.md index 220cd7a2410..3991a91b6a8 100644 --- a/kotlin-native/HACKING.md +++ b/kotlin-native/HACKING.md @@ -87,7 +87,8 @@ To run blackbox compiler tests use: | `compilerClasspath` | The full path to the Kotlin/Native compiler classpath. If not specified, then the classpath is deduced as `${nativeHome}/konan/lib/kotlin-native-compiler-embeddable.jar`

This property allows to override the compiler itself preserving the rest of the distribution, and this way to test various backward compatibility cases. | | `target` | The name of the Kotlin/Native target under test | | `mode` | * `ONE_STAGE_MULTI_MODULE` : Compile each test file as one or many modules (depending on MODULE directives declared in the file). Produce a KLIB per each module except the last one. Finally, produce an executable file by compiling the latest module with all other KLIBs passed as -library
* `TWO_STAGE_MULTI_MODULE` (default): Compile each test file as one or many modules (depending on MODULE directives declared in the file). Produce a KLIB per each module. Finally, produce an executable file by passing the latest KLIB as -Xinclude and all other KLIBs as -library. | -| `forceStandalone ` | `false` or `true`: Whether to force running all tests with `// KIND: REGULAR` as if they were be with `// KIND: STANDALONE` | +| `forceStandalone ` | If `true` then all tests with `// KIND: REGULAR` inside test data file are executed as if they were be with `// KIND: STANDALONE`. The default is `false`. | +| `compileOnly ` | If `true` then tests are fully compiled to the executable binary, but not executed afterwards. The default is `false`. | | `optimizationMode` | Compiler optimization mode: `DEBUG` (default), `OPT`, `NO` | | `memoryModel` | The memory model: `DEFAULT` (default) or `EXPERIMENTAL` | | `useThreadStateChecker` | Is thread state checker `DISABLED` (default) or `ENABLED`?

Note: Thread state checker can be enabled only in combination with `optimizationMode=DEBUG` and `memoryModel=EXPERIMENTAL`. |