From 2e0039ac6b8f2f96c8f0d5ab73f8c6970fd95bad Mon Sep 17 00:00:00 2001
From: Adeel <adeelbm@outlook.com>
Date: Thu, 9 Apr 2020 22:11:35 +0300
Subject: [PATCH] Add note about building PAL tests in docs

---
 .../testing/coreclr/unix-test-instructions.md | 33 ++++++++++---------
 1 file changed, 17 insertions(+), 16 deletions(-)

diff --git a/docs/workflow/testing/coreclr/unix-test-instructions.md b/docs/workflow/testing/coreclr/unix-test-instructions.md
index 2ba333c640daa5..ff7bd956de2ec1 100644
--- a/docs/workflow/testing/coreclr/unix-test-instructions.md
+++ b/docs/workflow/testing/coreclr/unix-test-instructions.md
@@ -32,8 +32,8 @@ During development there are many instances where building an individual test is
 
 ## Building an Individual Test
 
-```
-/path/to/runtime/dotnet.sh msbuild src/coreclr/tests/src/path-to-proj-file /p:TargetOS=<TargetOS> /p:Configuration=<BuildType>
+```sh
+./dotnet.sh msbuild src/coreclr/tests/src/path-to-proj-file /p:TargetOS=<TargetOS> /p:Configuration=<BuildType>
 ```
 
 ## Running Tests
@@ -43,14 +43,14 @@ The following instructions assume that on the Unix machine:
 
 `src/coreclr/build-test.sh` will have set up the `Core_Root` directory correctly after the test build.
 
-```bash
-~/runtime$ ./src/coreclr/tests/runtest.sh x64 checked
+```sh
+./src/coreclr/tests/runtest.sh x64 checked
 ```
 
 Please use the following command for help.
 
-```
-~/runtime$ ./src/coreclr/tests/runtest.sh -h
+```sh
+./src/coreclr/tests/runtest.sh -h
 ```
 
 ### Unsupported and temporarily disabled tests
@@ -58,14 +58,14 @@ Please use the following command for help.
 Unsupported tests outside of Windows have two annotations in their csproj to
 ignore them when run.
 
-```
+```xml
 <TestUnsupportedOutsideWindows>true</TestUnsupportedOutsideWindows>
 ```
 
 This will write in the bash target to skip the test by returning a passing value if run outside Windows.
 
 In addition:
-```
+```xml
 <DisableProjectBuild Condition="'$(TargetsUnix)' == 'true'">true</DisableProjectBuild>
 ```
 
@@ -74,16 +74,17 @@ Is used to disable the build, that way if building on Unix cycles are saved buil
 PAL tests
 ---------
 
-Build CoreCLR on the Unix machine.
+Build CoreCLR with PAL tests on the Unix machine:
 
-Run tests:
-
-```
-~/runtime$ src/coreclr/src/pal/tests/palsuite/runpaltests.sh ~/runtime/artifacts/obj/coreclr/Linux.x64.Debug
+```sh
+./src/coreclr/build-runtime.sh -skipgenerateversion -nopgooptimize \
+    -cmakeargs -DCLR_CMAKE_BUILD_TESTS=1
 ```
 
-Test results will go into:
+Run tests:
 
+```sh
+./src/coreclr/src/pal/tests/palsuite/runpaltests.sh $(pwd)/artifacts/obj/coreclr/$(uname).x64.Debug
 ```
-/tmp/PalTestOutput/default/pal_tests.xml
-```
+
+Test results will go into: `/tmp/PalTestOutput/default/pal_tests.xml`