# Release v4.13.0.0

---

## Changes

### CLI
- #430: //css_reference search order
- Various improvements around `css -help` output
- Fixed `css -kill` command

### CSScriptLib
- multiple API points made public to address "#431 Generic type for CompileMethod()" challenges

Author: oleg-shilo

help.txt

@@ -1,4 +1,4 @@
-C# Script execution engine (.NET Core). Version 4.12.0.1.
+C# Script execution engine (.NET Core). Version 4.13.0.0.
 Copyright (C) 2004-2023 Oleg Shilo.
 
 Usage: cscs <switch 1> <switch 2> <file> [params] [//x]
@@ -384,6 +384,15 @@ params	Specifies optional parameters for a script file to be run.
 
 -dir:<directory 1>,<directory N>
     Adds path(s) to the assembly probing directory list.
+    Directory probing order:
+      0: script dir
+      1: current dir
+      2: script host/engine dir
+      3: dirs from cmd args
+      4: dirs from code
+      5: dirs from config
+      6: csscript special dirs, e.g. cache dir
+    The precise runtime order can be discovered by executing the script with the -verbose switch.
     You can use the reserved word 'show' as a directory name to print the configured probing directories.
     (e.g. cscs -dir:C:\MyLibraries myScript.cs; cscs -dir:show).
 
@@ -447,14 +456,19 @@ params	Specifies optional parameters for a script file to be run.
     Prints list of supported commands (arguments) as well as the custom commands defined by user.
     -cmd:x - Prints detailed information of the custom commands defined by user.
 
--list|-ls [<kill|k> | <kill-all|ka>
+-list|-ls [<kill|k> | <kill-all|ka|*>
     Prints list of all currently running scripts.
     If script execution tracking is undesirable you can disable it by setting DisableCSScriptProcessTracking
     environment variable to a non empty value.
      kill|k      - Allow user to select and terminate any running script.
      *           - Terminate all running scripts when 'kill' option is used.
                    (e.g. cscs -list kill * ).
 
+-kill>
+    Terminates all instances of running scripts and CS-Script build services.
+    This command is the easiest way of ensuring no CS-Script files are locked. 
+    E.g. before updating CS-Script installation.
+
 ---------
 
 
@@ -649,22 +663,31 @@ file - name of the script or assembly file implementing precompiler.
 This directive is used to specify the CS-Script precompilers to be loaded and exercised against script at run time
 just before compiling it. Precompilers are typically used to alter the script coder before the execution. Thus
 CS-Script uses built-in precompiler to decorate classless scripts executed with -autoclass switch.
-(see http://www.csscript.net/help/precompilers.html
+(see http://www.csscript.net/help/precompilers.html)
 ------------------------------------
 //css_searchdir <directory>;
 
 Alias - //css_dir
 
 directory - name of the directory to be used for script and assembly probing at run-time.
 
-This directive is used to extend set of search directories (script and assembly probing).
-The directory name can be a wildcard based expression.In such a case all directories matching the pattern will be this
-case all directories will be probed.
+This directive is used to extend the set of search directories (script and assembly probing).
+The directory name can be a wildcard-=based expression. In such a case all directories matching the pattern will be
+this case all directories will be probed.
 The special case when the path ends with '**' is reserved to indicate 'sub directories' case. Examples:
 
     //css_dir packages\ServiceStack*.1.0.21\lib\net40
     //css_dir packages\**
 
+Directory probing order:
+  0: script dir
+  1: current dir
+  2: script host/engine dir
+  3: dirs from cmd args
+  4: dirs from code
+  5: dirs from config
+  6: csscript special dirs, e.g. cache dir
+The precise runtime order can be discovered by executing the script with the -verbose switch.
 ------------------------------------
 //css_winapp
 

src/CSScriptLib/src/CSScriptLib/CSScript.cs

@@ -512,7 +512,7 @@ static public string WrapMethodToAutoClass(string methodCode, bool injectStatic,
         /// <summary>
         /// Returns a script-friendly type name for the provided <see cref="Type"/>.
         /// For non-generic types this is the type's full name. For generic types the
-        /// method constructs a readable generic representation (e.g. "Namespace.TypeName<Arg1, Arg2>")
+        /// method constructs a readable generic representation (e.g. "Namespace.TypeName&lt;Arg1, Arg2&gt;")
         /// by recursively formatting generic type arguments.
         /// </summary>
         /// <param name="type">The <see cref="Type"/> to get the script name for.</param>

src/CSScriptLib/src/CSScriptLib/CSScriptLib.csproj

@@ -15,7 +15,7 @@
     <AllowUnsafeBlocks>true</AllowUnsafeBlocks>
     <SymbolPackageFormat>snupkg</SymbolPackageFormat>
     <GeneratePackageOnBuild>true</GeneratePackageOnBuild>
-    <Version>4.12.0.1</Version>
+    <Version>4.13.0.0</Version>
     <Authors>Oleg Shilo</Authors>
     <Description>CS-Script engine Class Library for .NET 5 (and higher)</Description>
     <Copyright>(C) 2018-2023 Oleg Shilo</Copyright>
@@ -29,26 +29,17 @@
 
 ## Changes
 
-- CS-Script build for .NET 9 is no longer available. The supported version ar now the last two .NET LTS releases: .NET 8 and .NET 10.
-
 ### CLI
-
-- CS-Script ported to .NET 10 
-- Added '-l' option for auto-selecting the latest available .NET Runtime with the call: `css -self-rt -l` 
-- Added support for .NET 10 file-based execution directives: `#:package` and `#r`.
-- Changed the search dir priorities to low local overwrite of the distributed included scrips (libs): `%CSSCRIPT_INC%` is now higher than "%CSSCRIPT_ROOT%/lib`
-- In the `css.exe` status print out is now saying `&lt;not set&gt;` instead of `&lt;not integrated&gt;` for the InstallationDir field. 
-  It's not really about the integration but setting the CSSCRIPT_ROOT envar.
-- Updated `ProjectBuilder.GenerateProjectFor` to include the script engine assembly and global includes (e.g. `global-usings`)
-
+- #430: //css_reference search order
+- Various improvements around `css -help` output
+- Fixed `css -kill` command
 
 ### CSScriptLib
-- #428: Script.Evaluator.Eval() exception
-- Added `/shared` option for CodeDomEvaluator. To dramatically speedup "next" compilation.</PackageReleaseNotes>
+- multiple API points made public to address "#431 Generic type for CompileMethod()" challenges</PackageReleaseNotes>
     <PackageRequireLicenseAcceptance>true</PackageRequireLicenseAcceptance>
-    <AssemblyVersion>4.12.0.1</AssemblyVersion>
-    <FileVersion>4.12.0.1</FileVersion>
-    <PackageVersion>4.12.0.1</PackageVersion>
+    <AssemblyVersion>4.13.0.0</AssemblyVersion>
+    <FileVersion>4.13.0.0</FileVersion>
+    <PackageVersion>4.13.0.0</PackageVersion>
     <PackageLicenseExpression>MIT</PackageLicenseExpression>
     <PackageIcon>css_logo.png</PackageIcon>
     <SignAssembly>True</SignAssembly>

src/chocolatey/cs-script.nuspec

@@ -2,7 +2,7 @@
 <package xmlns="http://schemas.microsoft.com/packaging/2011/08/nuspec.xsd">
   <metadata>
     <id>cs-script</id>
-    <version>4.12.0.1</version>
+    <version>4.13.0.0</version>
     <title>CS-Script</title>
     <authors>Oleg Shilo</authors>
     <owners>Oleg Shilo</owners>
@@ -28,22 +28,13 @@
 
 ## Changes
 
-- CS-Script build for .NET 9 is no longer available. The supported version ar now the last two .NET LTS releases: .NET 8 and .NET 10.
-
 ### CLI
-
-- CS-Script ported to .NET 10 
-- Added '-l' option for auto-selecting the latest available .NET Runtime with the call: `css -self-rt -l` 
-- Added support for .NET 10 file-based execution directives: `#:package` and `#r`.
-- Changed the search dir priorities to low local overwrite of the distributed included scrips (libs): `%CSSCRIPT_INC%` is now higher than "%CSSCRIPT_ROOT%/lib`
-- In the `css.exe` status print out is now saying `&lt;not set&gt;` instead of `&lt;not integrated&gt;` for the InstallationDir field. 
-  It's not really about the integration but setting the CSSCRIPT_ROOT envar.
-- Updated `ProjectBuilder.GenerateProjectFor` to include the script engine assembly and global includes (e.g. `global-usings`)
-
+- #430: //css_reference search order
+- Various improvements around `css -help` output
+- Fixed `css -kill` command
 
 ### CSScriptLib
-- #428: Script.Evaluator.Eval() exception
-- Added `/shared` option for CodeDomEvaluator. To dramatically speedup "next" compilation.</releaseNotes>
+- multiple API points made public to address "#431 Generic type for CompileMethod()" challenges</releaseNotes>
     <copyright>Oleg Shilo</copyright>
     <tags>cs-script C# script dynamic hosting</tags>
     <dependencies>