diff --git a/docs/src/api/class-tracing.md b/docs/src/api/class-tracing.md
index 21a26e387b..a789159415 100644
--- a/docs/src/api/class-tracing.md
+++ b/docs/src/api/class-tracing.md
@@ -140,7 +140,8 @@ Whether to include source files for trace actions.
 - `sources` <[boolean]>
 
 Whether to include source files for trace actions. List of the directories with source code for the application
-must be provided via `PLAYWRIGHT_JAVA_SRC` environment variable.
+must be provided via `PLAYWRIGHT_JAVA_SRC` environment variable (the paths should be separated by ';' on Windows
+and by ':' on other platforms).
 
 ### option: Tracing.start.title
 - `title` <[string]>
diff --git a/docs/src/inspector.md b/docs/src/inspector.md
index b82bb6577f..0857840a7c 100644
--- a/docs/src/inspector.md
+++ b/docs/src/inspector.md
@@ -31,17 +31,20 @@ configures Playwright for debugging and opens the inspector.
   ```
 
   ```bash bash-flavor=bash lang=java
-  PWDEBUG=1 PLAYWRIGHT_JAVA_SRC=<java src root> mvn test
+  # Source directories in the list are separated by : on macos and linux and by ; on win.
+  PWDEBUG=1 PLAYWRIGHT_JAVA_SRC=<java source dirs> mvn test
   ```
 
   ```bash bash-flavor=batch lang=java
-  set PLAYWRIGHT_JAVA_SRC=<java src root>
+  # Source directories in the list are separated by : on macos and linux and by ; on win.
+  set PLAYWRIGHT_JAVA_SRC=<java source dirs>
   set PWDEBUG=1
   mvn test
   ```
 
   ```bash bash-flavor=powershell lang=java
-  $env:PLAYWRIGHT_JAVA_SRC="<java src root>"
+  # Source directories in the list are separated by : on macos and linux and by ; on win.
+  $env:PLAYWRIGHT_JAVA_SRC="<java source dirs>"
   $env:PWDEBUG=1
   mvn test
   ```