# HG changeset patch
# User Michael Van De Vanter  <michael.van.de.vanter@oracle.com>
# Date 1449699125 28800
# Node ID 66f79c26f8977bb7eb246b70d90b39385f846be7
# Parent  be8a3334434d9ad18352be5c1e2d1f59ea1b12cd# Parent  bbe2598ae2bc22199ffb15dcdcc30914bf2dab01
Merge

diff -r be8a3334434d -r 66f79c26f897 truffle/com.oracle.truffle.api/src/com/oracle/truffle/api/instrument/package-info.java
--- a/truffle/com.oracle.truffle.api/src/com/oracle/truffle/api/instrument/package-info.java	Tue Dec 08 11:33:21 2015 -0800
+++ b/truffle/com.oracle.truffle.api/src/com/oracle/truffle/api/instrument/package-info.java	Wed Dec 09 14:12:05 2015 -0800
@@ -23,6 +23,12 @@
  * questions.
  */
 
+/*
+ @ApiInfo(
+ group="Obsolete soon"
+ )
+ */
+
 /**
  * <h4>Truffle {@linkplain com.oracle.truffle.api.instrument.Instrumenter Instrumentation}: access to execution events for Debuggers and other tools.</h4>
  * <p>
diff -r be8a3334434d -r 66f79c26f897 truffle/overview.html
--- a/truffle/overview.html	Tue Dec 08 11:33:21 2015 -0800
+++ b/truffle/overview.html	Wed Dec 09 14:12:05 2015 -0800
@@ -41,11 +41,42 @@
 on top of 
 <a target="_blank" href="http://openjdk.java.net/projects/graal/">Graal</a>
 virtual machine.
+
+<h4>Learning Truffle</h4>
+
 <p>
-Our typicial sample language is called the <em>SimpleLanguage</em>.
+Our typical sample language is called the <em>SimpleLanguage</em>.
 A good entry point for exploring <em>SimpleLanguage</em> is the
 <a target="_blank" href="https://github.com/graalvm/Truffle/blob/master/truffle/com.oracle.truffle.sl/src/com/oracle/truffle/sl/SLLanguage.java">SLLanguage</a>
 class.
+</p>
+
+<p>
+    There is an excellent tutorial <em>Add Graal JIT Compilation to Your JVM Language</em>
+    written by Stefan Marr which gives real example of turning an existing language
+    into <em>Truffle</em> based one:
+</p>
+<ul>
+    <li>Step 1: 
+        <a target="golo" href="http://stefan-marr.de/2015/11/add-graal-jit-compilation-to-your-jvm-language-in-5-easy-steps-step-1/">Setting a Goal and Choosing a Benchmark</a>
+    </li>
+    <li>Step 2: 
+        <a target="golo" href="http://stefan-marr.de/2015/11/add-graal-jit-compilation-to-your-jvm-language-in-5-easy-steps-step-2/">Adding Bits Operations</a>
+    </li>
+    <li>Step 3: 
+        <a target="golo" href="http://stefan-marr.de/2015/11/add-graal-jit-compilation-to-your-jvm-language-in-5-easy-steps-step-3/">Interpreting a Simple Fibonacci Function</a>
+    </li>
+    <li>Step 4: 
+        <a target="golo" href="http://stefan-marr.de/2015/12/add-graal-jit-compilation-to-your-jvm-language-in-5-easy-steps-step-4/">Complete Support for Mandelbrot</a>
+    </li>
+    <li>Step 5: 
+        <a target="golo" href="http://stefan-marr.de/2015/12/add-graal-jit-compilation-to-your-jvm-language-in-5-easy-steps-step-5/">Optimizing the Interpreter for Compilation</a>
+    </li>
+</ul>
+<p>
+    The posts cover not only basics, and API usage, but also description
+    of available tools for analyzing the performance and optimizing it.
+</p>
 
 <h4>Other References</h4>