From cd3e2b940208c6f9f68d6ae74b10d86019761c3f Mon Sep 17 00:00:00 2001
From: Jonas Gassenmeyer <gassenmj@gmail.com>
Date: Fri, 7 Jul 2023 14:17:00 +0200
Subject: [PATCH 1/2] fix(doc): Update running-unit-tests.md - remove example

---
 docs/userguide/running-unit-tests.md | 10 +---------
 1 file changed, 1 insertion(+), 9 deletions(-)

diff --git a/docs/userguide/running-unit-tests.md b/docs/userguide/running-unit-tests.md
index 282e07d09..447b5eb54 100644
--- a/docs/userguide/running-unit-tests.md
+++ b/docs/userguide/running-unit-tests.md
@@ -120,14 +120,6 @@ end;
 ```
 Executes all tests from package _hr.test_apply_bonus_ and all tests from schema _cust_.
 
-```sql linenums="1"
-set serveroutput on
-begin
-  ut.run(ut_varchar2_list('hr.test_apply_bonus,cust)');
-end;
-```
-
-Executes all tests from package _hr.test_apply_bonus_ and all tests from schema _cust_.
 
 ```sql linenums="1"
 set serveroutput on
@@ -566,4 +558,4 @@ Example call with characterset provided:
 begin
   ut.run('hr.test_apply_bonus', ut_junit_reporter(), a_client_character_set => 'Windows-1251');
 end;
-``` 
\ No newline at end of file
+``` 

From fc8c520bfb569cee737193c7db81c7efec07a20b Mon Sep 17 00:00:00 2001
From: Jonas Gassenmeyer <gassenmj@gmail.com>
Date: Mon, 10 Jul 2023 08:12:46 +0200
Subject: [PATCH 2/2] fix(doc): Update running-unit-tests.md add comments

---
 docs/userguide/running-unit-tests.md | 13 +++++++++++--
 1 file changed, 11 insertions(+), 2 deletions(-)

diff --git a/docs/userguide/running-unit-tests.md b/docs/userguide/running-unit-tests.md
index e35001a52..fde0330c9 100644
--- a/docs/userguide/running-unit-tests.md
+++ b/docs/userguide/running-unit-tests.md
@@ -118,7 +118,16 @@ begin
   ut.run(ut_varchar2_list('hr.test_apply_bonus','cust'));
 end;
 ```
-Executes all tests from package _hr.test_apply_bonus_ and all tests from schema _cust_.
+Executes all tests from package _hr.test_apply_bonus_ and all tests from schema _cust_ (passing individual items to be executed as elements of the ut_varchar2_list table type).
+
+
+```sql linenums="1"
+set serveroutput on
+begin
+  ut.run(ut_varchar2_list('hr.test_apply_bonus,cust'));
+end;
+```
+Executes all tests from package _hr.test_apply_bonus_ and all tests from schema _cust_ (passing all items as a comma-separated-list of values into a single element of the ut_varchar2_list table type).
 
 
 ```sql linenums="1"
@@ -128,7 +137,7 @@ begin
 end;
 ```
 
-Executes all tests from package _hr.test_apply_bonus_ and all tests from schema _cust_.
+Executes all tests from package _hr.test_apply_bonus_ and all tests from schema _cust_ (no explicit ut_varchar2_list table type).
 
 Using a list of items to execute allows you to execute a fine-grained set of tests.