From 13bb041072df90f6510b157f6bb51f9298ba2953 Mon Sep 17 00:00:00 2001
From: mmcgill <matt.mcgill@gmail.com>
Date: Sun, 6 Jun 2021 18:08:58 -0400
Subject: [PATCH] [java-truffle] mention native images in README

---
 impls/java-truffle/README.md      | 20 ++++++++++++++++++++
 impls/java-truffle/make-native.sh |  8 ++++++++
 2 files changed, 28 insertions(+)
 create mode 100755 impls/java-truffle/make-native.sh

diff --git a/impls/java-truffle/README.md b/impls/java-truffle/README.md
index a4d34f2f..932b7422 100644
--- a/impls/java-truffle/README.md
+++ b/impls/java-truffle/README.md
@@ -677,3 +677,23 @@ It's also worth observing that the Truffle/GraalVM provide _other_ interesting b
 that are not performance-related. I won't cover them here. I think the most interesting
 non-performance benefit is the promise of interoperability with other Truffle languages.
 
+## Bonus: AOT-compiled Mal
+
+GraalVM can ahead-of-time compile Java into a stand-alone executable (with some caveats)
+called a _native image_.
+This works even for Truffle interpreters! With AOT-compiled Mal, we get all the JIT compilation
+goodness of Truffle, _and_ we ditch the need for a Java runtime, **and** we skip the long JVM
+start-up time! A GraalVM native image of our Mal interpreter is well suited for scripts and
+command line applications.
+
+The `make-native.sh` script can be used to compile a native image of any Mal step.
+To run it, though, you'll need some additional
+[prerequisites](https://www.graalvm.org/reference-manual/native-image/#prerequisites).
+
+The `make-native.sh` script
+
+* assumes you've already run `gradle build` to compile all Java classes
+* takes as its only argument a step name, e.g. `step3_env`
+** when no argument is supplied, `stepE_macros` is selected by default
+* produces a `build/${STEP}` native image
+
diff --git a/impls/java-truffle/make-native.sh b/impls/java-truffle/make-native.sh
new file mode 100755
index 00000000..db86494e
--- /dev/null
+++ b/impls/java-truffle/make-native.sh
@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+
+STEP=${1:-stepE_macros}
+
+CP=$(gradle -q --console plain printClasspath)
+native-image --macro:truffle --no-fallback --initialize-at-build-time \
+	-H:+TruffleCheckBlackListedMethods \
+	-cp "$CP" truffle.mal.$STEP build/$STEP