Fixing a documentation

lwasylow · lwasylow · commit 39377379eaed · 2022-04-07T13:00:02.000+01:00
diff --git a/docs/userguide/running-unit-tests.md b/docs/userguide/running-unit-tests.md
@@ -45,10 +45,8 @@ The **functions** can only be used in SELECT statements. They execute the specif
 ## ut.run procedures
 
 The examples below illustrate different ways and options to invoke `ut.run` procedures.
-As part of the syntax you can use a wildcard character `*` to call test by part of his name or to call few tests that match a call.
-Schema name is still mandatory and cannot contain a wildcard character whether is a suitepath or object.
-
-
+You can use a wildcard character `*` to call tests by part of their name or to call tests that are located on paths matched by part of path string.
+Schema name cannot contain a wildcard character whether is in a suitepath call or call by object name.
 
 ```sql
 alter session set current_schema=hr;
@@ -142,7 +140,7 @@ begin
   ut.run('hr.test*');
 end;
 ```
-Executes all tests from schema _hr_ starting with name _test_.
+Executes all tests in schema `hr` located in packages starting with name `test`.
 
 ```sql
 set serveroutput on
diff --git a/source/core/types/ut_path_item.tpb b/source/core/types/ut_path_item.tpb
@@ -39,4 +39,4 @@ create or replace type body ut_path_item as
     return;
   end;  
 end;
-/
+/
diff --git a/source/core/types/ut_path_item.tps b/source/core/types/ut_path_item.tps
@@ -23,4 +23,4 @@ create or replace type ut_path_item as object (
   constructor function ut_path_item(self in out nocopy ut_path_item, schema_name varchar2, suite_path varchar2) return self as result,
   constructor function ut_path_item(self in out nocopy ut_path_item, schema_name varchar2, object_name varchar2,procedure_name varchar2,suite_path varchar2) return self as result
 )
-/
+/
diff --git a/source/core/ut_suite_cache_manager.pkb b/source/core/ut_suite_cache_manager.pkb
@@ -258,8 +258,10 @@ create or replace package body ut_suite_cache_manager is
     We will sort a suites in hierarchical structure.
     Sorting from bottom to top so when we consolidate
     we will go in proper order.
-    For random seed we will add an extra sort that can be null
-    TODO: Verify object owner join
+    For random seed we will add an extra sort that can be null.
+    The object owner is irrelevant on joing via path as we already
+    resolved a list of test we want to use so as long they share a suitepath
+    they are correct.
   */
   procedure sort_and_randomize_tests(
     a_suite_rows in out ut_suite_cache_rows,

-Original file line number
+Diff line change
     return;
   end;
 end;
 -/
 +/
Original file line number	Diff line number	Diff line change
`@@ -23,4 +23,4 @@ create or replace type ut_path_item as object (`
`23`	`23`	`constructor function ut_path_item(self in out nocopy ut_path_item, schema_name varchar2, suite_path varchar2) return self as result,`
`24`	`24`	`constructor function ut_path_item(self in out nocopy ut_path_item, schema_name varchar2, object_name varchar2,procedure_name varchar2,suite_path varchar2) return self as result`
`25`	`25`	`)`
`26`		`-/`
	`26`	`+/`