summaryrefslogtreecommitdiffstats
path: root/CONTRIBUTION.md
diff options
context:
space:
mode:
authorJay Kwak <82421531+jkwak-work@users.noreply.github.com>2024-07-12 03:59:08 -0700
committerGitHub <noreply@github.com>2024-07-12 18:59:08 +0800
commit1c86ccb3795ee69f740f2c1ec5aa6fc3c019cf27 (patch)
treec44f81fae8bc4cf894e310401257c94cf5590c56 /CONTRIBUTION.md
parent24f8999c892a9c4d108616c08d714e8dea562707 (diff)
Update CONTRIBUTION.md for path to slang-test.exe (#4619)
The path to slang-test.exe has been changed recently and it needs to be updated on the document.
Diffstat (limited to 'CONTRIBUTION.md')
-rw-r--r--CONTRIBUTION.md6
1 files changed, 4 insertions, 2 deletions
diff --git a/CONTRIBUTION.md b/CONTRIBUTION.md
index 1ad5641aa..b043d9607 100644
--- a/CONTRIBUTION.md
+++ b/CONTRIBUTION.md
@@ -111,6 +111,8 @@ Make your changes and ensure to follow our [Design Decisions](docs/design/README
### Testing
Test your changes thoroughly to ensure they do not introduce new issues. This is done by building and running a "slang-test" from the repository root directory. For more details about "slang-test", please refer to a [Documentation on testing](tools/slang-test/README.md).
+> Note: slang-test is meant to launch from the root of the repository. It uses a hard-coded directory name "tests/" that is expected to exist in the current working directory.
+
> Note: One of the options for `slang-test.exe` is `-api`, and it takes an additional keyword to specify which API to test. When the option is `-api all-cpu`, as an example, it means it tests all APIs except CPU. The minus sign (-) after `all` means "exclude" and you can "include" with plus sign (+) like `-api gl+dx11`.
If you are familiar with Workflow/Actions in github, you can check [Our Workflows](.github/workflows). "Test Slang" section in [ci.yml](.github/workflows/ci.yml) is where "slang-test" runs.
@@ -125,7 +127,7 @@ For a quick reference, follow the instructions below.
```
1. Run slang-test with multiple threads. This may take 10 minutes or less depending on the performance of your computer.
```
- C:\git\slang> bin\windows-x64\release\slang-test.exe -use-test-server -server-count 8
+ C:\git\slang> build\Release\bin\slang-test.exe -use-test-server -server-count 8
```
> Note: if you increase `-server-count` more than 16, you may find some of tests randomly fail. This is a known issue on the graphics driver side.
1. Check whether the test is finished as expected.
@@ -138,7 +140,7 @@ For a quick reference, follow the instructions below.
```
1. Run slang-test with multiple threads. This may take 10 minutes or less depending on the performance of your computer.
```
- $ ./bin/linux-x64/release/slang-test -use-test-server -server-count 8
+ $ ./build/Release/bin/slang-test -use-test-server -server-count 8
```
1. Check whether the test is finished as expected.