tcllab · MichaelMiR01 · Jun 11, 2022 · Jun 23, 2022 · Jul 1, 2022 · Jul 6, 2022
diff --git a/README.md b/README.md
@@ -21,18 +21,23 @@ invoked directly, bypassing the Tcl interpreter.
 
 TSP is written entirely in Tcl, with support libraries written in C and Java.
 
+Changes to original TSP
+* limited Namespace support for proc names and variables (see  [Features](./docs/tsp-lang-features.md))
+* package support with ::tsp::init_package // ::tsp::finalize_package (see  [Features](./docs/tsp-lang-features.md))
+* #tsp::inlinec and #tsp::altTCL directives to include native c-code and alternative tcl-code (see [Compiler Usage](./docs/compiler-usage.md))
+* some bugfixes I ran into 
 
 # Docs
 
-  1. [Introduction](https://github.com/tpoindex/tsp/blob/master/docs/introduction.md)
-  2. [Features](https://github.com/tpoindex/tsp/blob/master/docs/tsp-lang-features.md)
-  3. [Type System](https://github.com/tpoindex/tsp/blob/master/docs/type-system.md)
-  4. [Compiled Commands](https://github.com/tpoindex/tsp/blob/master/docs/compiled-commands.md)
-  5. [Runtime](https://github.com/tpoindex/tsp/blob/master/docs/runtime.md)
-  6. [Compiler Usage](https://github.com/tpoindex/tsp/blob/master/docs/compiler-usage.md)
-  7. [Future Improvements](https://github.com/tpoindex/tsp/blob/master/docs/future-improvements.md)
-  8. [Install](https://github.com/tpoindex/tsp/blob/master/docs/install.md)
-  9. [Misc.](https://github.com/tpoindex/tsp/blob/master/docs/misc.md)
+  1. [Introduction](./docs/introduction.md)
+  2. [Features](./docs/tsp-lang-features.md)
+  3. [Type System](./docs/type-system.md)
+  4. [Compiled Commands](./docs/compiled-commands.md)
+  5. [Runtime](./docs/runtime.md)
+  6. [Compiler Usage](./docs/compiler-usage.md)
+  7. [Future Improvements](./docs/future-improvements.md)
+  8. [Install](./docs/install.md)
+  9. [Misc.](./docs/misc.md)
 
 
 Wiki (Q & A, discussion, other): http://wiki.tcl.tk/Tcl%20Static%20Prime
diff --git a/docs/compiled-commands.md b/docs/compiled-commands.md
diff --git a/docs/compiler-usage.md b/docs/compiler-usage.md
@@ -42,12 +42,14 @@ proc can also be specified with a single underscore **('_')**.
 a convenience for `tsp::log _`
 
 
-### `tsp::printLog` *?outfd? ?proc?*
+### `tsp::printLog` *?outfd? ?proc? ?breakeval?*
 
 `tsp::printLog` prints the compiler log.  Optional outfd specifies a writable file handle, stderr
 is the default.  Optional proc is specified, only that log is returned.  The most recent compiled
 proc can also be specified with a single underscore **('_')**.
 
+**breakeval** defaults to 1, so that TSP returns with an error, if there are any errors in transpilation.
+
 
 ## Annotations
 
@@ -100,7 +102,37 @@ vwait, etc.)
             include tracing on variables and the return values.  This can be useful to 
             isolate variable that may cause conversion errors.  See the Tracing section below.
 
-
+### `#tsp::inlinec`
+`#tsp::inlinec` defines a pure c line, that will be put into the source code directly without changes, so it is possible to e.g. call other c-procs directly (given you know the calling conventions) etc.
+
+### `#tsp::altTCL`
+`#tsp::altTCL` is put into the generated tcl code (use if compilation/loading fails), so you can give alternate TCL versions of inlineC parts
+
+```
+
+#example
+package require tsp
+
+set handle $::tsp::TCC_HANDLE
+$handle cproc t1 {int i} double {;#define a simple c procedure here -- it will be compile as c_t1 later
+    return i*0.5;
+}
+tsp::proc test {} {
+    #tsp::procdef double
+    #tsp::int i
+    #tsp::double l k
+    set k 1.0
+    for {set i 0} {$i<100000} {incr i} {;# $i will be decorated as __i in TSP, $l as __l and so on
+        #tsp::inlinec __l = c_t1(__i);
+        #tsp::altTCL set l [t1 $i]
+        #tsp::inlinec __k = __k+sqrt(__l*__l*0.33);
+        #tsp::altTCL set k [expr {$k+sqrt($l*$l*0.33)}]
+    }
+    return $k
+}
+
+
+```
 
 ## Trace compile type
 

diff --git a/docs/future-improvements.md b/docs/future-improvements.md
diff --git a/docs/install.md b/docs/install.md
diff --git a/docs/introduction.md b/docs/introduction.md
diff --git a/docs/misc.md b/docs/misc.md
diff --git a/docs/outline.md b/docs/outline.md
diff --git a/docs/runtime.md b/docs/runtime.md
diff --git a/docs/tsp-lang-features.md b/docs/tsp-lang-features.md
@@ -50,16 +50,93 @@ a level of additional runtime interpretation.
     lappend foo {*}$s                ;# invalid: expansion syntax not allows
 ```
 
-## Namespace not supported for proc names
+## limited Namespace support for proc names and variables
 
-Currently, procedures can only be defined in the global namespace.
+Procedures can be defined in the global namespace. Namespace qualifiers in the proc name are invalid 
 
 ```
-    tsp::proc ::pkg::foo {} {        ;# invalid: namespace procname not allowed
+    tsp::proc ::pkg::foo {} {        ;# invalid: 
         #tsp::procdef void
     }
 ```
 
+But you can define a project namespace with the variable tsp::PACKAGE_NAMESPACE; if defined, ALL procs will be rewritten to this namespace
+
+```
+set tsp::PACKAGE_NAMESPACE pkg
+    tsp::proc foo {} {        ;# will be rewritten pkg::foo
+        #tsp::procdef void
+        #tsp::var v
+        variable v            ;# will be connected to $pkg::v
+    }
+
+```
+## Package support
+Package support depends on the package tcc4tcl_helper to work, someday it will be integrated here, meanwhile find it here https://github.com/MichaelMiR01/tccide/tree/main/subpackages
+
+Package support (tsp_packagehelper.tcl) introduces two commands
+* ::tsp::init_package {packagename {packagenamespace ""} {packageversion 1.0} {tclversion TCL_VERSION}}
+* ::tsp::finalize_package {{packagedir ""} {compiler none}}
+
+TSP will generate package code in the given packagedir (packagedir defaults to packagename).
+It writes out
+
+* packagename.c
+* packagename.tclprocs.tcl
+* packagename.puretcl.tcl
+* pkgIndex.tcl
+* packagename.dll
+
+compiler can be **intern/memory** or **export**. 
+
+   **intern** (eq memory) will compile to memory and immediatly install the compiled procs
+
+   **export** will build a shared lib (.so//.dll) an write it into the package dir as **packagename.dll // packagename.so**
+
+* packagename.tclprocs.tcl    contains all TSP procs defined as tcl-only and will be sourced, if loading the dll fails
+* packagename.puretcl.tcl     TSP collects all proc definitions between init_package and finalize_package and spits them here. This will be sourced from pkgIndex, so not only tsp and tcc proc are loaded, but tcl procs can also be defined as helpers
+
+```
+#example
+package require tsp
+
+::tsp::init_package tnop 
+
+set handle $tsp::TCC_HANDLE
+$handle cproc cnop {Tcl_Interp* interp } char* {
+    // this is a pure c-function
+     return "cnop";
+}
+::tsp::proc tspnop {} {
+    #this is a transpiled function, its tcl code will go to tnop.tclprocs.tcl
+    #tsp::procdef void
+    puts "tspnop"
+}
+proc tclnop {} {
+    # this is a pure tcl function. its code will go to tnop.puretcl.tcl
+    puts "tclnop "
+}
+::tsp::printLog 
+::tsp::finalize_package tnop export
+```
+
+The exported package can now be loaded with package require packagename.
+
+Furthermore, TSP will try to spit out some compiler directives for tcc/gcc you can use as boilerplate to recompile the sourcecode with an optimizing compiler.
+
+Packages can be enriched with external libraries with the following directives:
+```
+proc ::tsp::add_tclinclude {fname}
+    # load tcls for additional sources, issues a source (fname) command into pkgIndex
+
+proc ::tsp::add_bininclude {fname} 
+    # load_dlls for dlls wich should be loaded into interp, issues a load (fname) command into pkgIndex
+
+proc ::tsp::add_dllinclude {fname}
+    # external dlls wich are dependencies and do not get loaded into interp but linked to your c-code (like jpeg.dll)
+    # tries to copy fname.dll into [pwd], so tcl can find it and dload
+```
+
 ## Limitation on proc name and variable names
 
 Procedure names and variable names inside of procedures must follow strict naming conventions.

diff --git a/docs/tutorial.md b/docs/tutorial.md
diff --git a/docs/type-system.md b/docs/type-system.md
diff --git a/lib/README.md b/lib/README.md
@@ -6,13 +6,20 @@ The following packages are required for use with C/Tcl.
 JTcl does not require any external packages, as the required
 packages 'hyde' and 'parser' are included in the JTcl distribution.
 
-critcl-3.1.15
-    https://github.com/andreas-kupries/critcl/releases
+critcl-3.1.15 is no longer needed for tsp4tcc uses tcc4tcl (tcc 0.9.27)
+
+tcc4tcl (tcc 0.9.27) can be found here     https://github.com/MichaelMiR01/tcc4tcl/releases
+
+Precompiled binaries for tcc4tcl can be found here     https://github.com/MichaelMiR01/tccide/
+
+crtitcl can be found here, just in case    https://github.com/andreas-kupries/critcl/releases
 
 
 tclparser-1.4.1
     Tclparser provides the 'parser' package.  This package is extracted from
     the TclPro open source project.
 
+Precompiled binaries for win32 and linux64 are store in the subdir parser together with a pkgIndex.tcl
+
     Original source:  http://tclpro.cvs.sourceforge.net/viewvc/tclpro/tclparser/ 
     License:  BSD, see tclparser-1.4.1/license.terms