Setup adjustments for new runtime in AssemblyScript template (#420)

* improve runtime setup
* additional notes

Author: MaxGraey

templates/empty_ts/gulpfile.js

@@ -1,13 +1,36 @@
 const gulp = require("gulp");
+/*
+  Runtime variants:
 
+  "--runtime", "full" (default)
+    A proper memory manager and reference-counting based garbage collector, with runtime interfaces
+    being exported to the host for being able to create managed objects externally.
+
+  "--runtime", "half"
+    The same as full but without any exports, i.e. where creating objects externally is not required.
+    This allows the optimizer to eliminate parts of the runtime that are not needed.
+
+  "--runtime", "stub"
+    A minimalist arena memory manager without any means of freeing up memory again, but the same external
+    interface as full. Useful for very short-lived programs or programs with hardly any memory footprint,
+    while keeping the option to switch to full without any further changes. No garbage collection.
+
+  "--runtime", "none"
+    The same as stub but without any exports, for the same reasons as explained in half. Essentially
+    evaporates entirely after optimizations.
+
+    For more information see: https://docs.assemblyscript.org/details/runtime
+*/
 gulp.task("build", callback => {
   const asc = require("assemblyscript/bin/asc");
   asc.main([
     "main.ts",
     "--baseDir", "assembly",
     "--binaryFile", "../out/main.wasm",
     "--sourceMap",
-    "--measure"
+    "--measure",
+    "--runtime", "half",
+    "--optimize"
   ], callback);
 });
 

templates/empty_ts/src/main.js

@@ -5,7 +5,7 @@ WebAssembly.instantiateStreaming(fetch("../out/main.wasm"), {
     }
   },
   env: {
-    abort(msg, file, line, column) {
+    abort(_msg, _file, line, column) {
       console.error("abort called at main.ts:" + line + ":" + column);
     }
   },