From 6a380e6bb7d994c16999d2b90de3bca650633178 Mon Sep 17 00:00:00 2001
From: graalvm bot <graalvmbot@users.noreply.github.com>
Date: Mon, 27 Nov 2023 08:38:14 +0000
Subject: [PATCH] Publishing documentation for version 0.9.29-SNAPSHOT

---
 0.9.29-SNAPSHOT/gradle-plugin-quickstart.html | 141 +--------
 .../member-search-index.zip                   | Bin 4110 -> 4110 bytes
 .../package-search-index.zip                  | Bin 283 -> 283 bytes
 .../type-search-index.zip                     | Bin 775 -> 775 bytes
 .../member-search-index.zip                   | Bin 2417 -> 2417 bytes
 .../package-search-index.zip                  | Bin 269 -> 269 bytes
 .../native-maven-plugin/type-search-index.zip | Bin 513 -> 513 bytes
 0.9.29-SNAPSHOT/maven-plugin-quickstart.html  | 274 ++++++++----------
 8 files changed, 135 insertions(+), 280 deletions(-)

diff --git a/0.9.29-SNAPSHOT/gradle-plugin-quickstart.html b/0.9.29-SNAPSHOT/gradle-plugin-quickstart.html
index ff2815daa..997df6a14 100644
--- a/0.9.29-SNAPSHOT/gradle-plugin-quickstart.html
+++ b/0.9.29-SNAPSHOT/gradle-plugin-quickstart.html
@@ -455,13 +455,8 @@ <h1>Getting Started with Gradle Plugin for GraalVM Native Image</h1>
 <ul class="sectlevel1">
 <li><a href="#_prepare_a_demo_application">Prepare a Demo Application</a></li>
 <li><a href="#build-a-native-executable-with-resources-autodetection">Build a Native Executable with Resources Autodetection</a></li>
-<li><a href="#build-a-native-executable-detecting-resources-with-the-agent">Build a Native Executable by Detecting Resources with the Agent</a>
-<ul class="sectlevel2">
-<li><a href="#_plugin_customization">Plugin Customization</a></li>
-</ul>
-</li>
-<li><a href="#_add_junit_testing">Add JUnit Testing</a></li>
-<li><a href="#_run_tests_with_the_agent">Run Tests with the Agent</a>
+<li><a href="#build-a-native-executable-detecting-resources-with-the-agent">Build a Native Executable by Detecting Resources with the Agent</a></li>
+<li><a href="#_add_junit_testing">Add JUnit Testing</a>
 <ul class="sectlevel2">
 <li><a href="#_summary">Summary</a></li>
 </ul>
@@ -476,7 +471,7 @@ <h1>Getting Started with Gradle Plugin for GraalVM Native Image</h1>
 <p>This guide shows how to get started with the <a href="gradle-plugin.html">Gradle plugin for GraalVM Native Image</a> and build a native executable for a Java application.</p>
 </div>
 <div class="paragraph">
-<p>You will create a sample application, enable the plugin, add support for dynamic features, run JUnit tests, and build a native executable.</p>
+<p>You will create a sample application, enable the plugin, add support for dynamic features, build a native executable, and run JUnit tests.</p>
 </div>
 <div class="paragraph">
 <p>Two ways of building a native executable using the plugin will be demonstrated:</p>
@@ -611,7 +606,7 @@ <h2 id="_prepare_a_demo_application"><a class="anchor" href="#_prepare_a_demo_ap
 </div>
 </li>
 <li>
-<p>Delete the <em>fortune/src/test/java</em> directory, you will add tests in a later stage.</p>
+<p>Delete the <em>fortune/src/test/java</em> directory (you will add tests in a later stage).</p>
 </li>
 <li>
 <p>Copy and paste the following file,
@@ -674,9 +669,6 @@ <h2 id="_prepare_a_demo_application"><a class="anchor" href="#_prepare_a_demo_ap
 <div class="listingblock multi-language-sample">
 <div class="content">
 <pre class="highlightjs highlight"><code data-lang="groovy" class="language-groovy hljs">plugins {
-  // ...
-
-  // Apply GraalVM Native Image plugin
   id 'org.graalvm.buildtools.native' version '0.9.29-SNAPSHOT'
 }</code></pre>
 </div>
@@ -684,9 +676,6 @@ <h2 id="_prepare_a_demo_application"><a class="anchor" href="#_prepare_a_demo_ap
 <div class="listingblock multi-language-sample">
 <div class="content">
 <pre class="highlightjs highlight"><code data-lang="kotlin" class="language-kotlin hljs">plugins {
-  // ...
-
-  // Apply GraalVM Native Image plugin
   id("org.graalvm.buildtools.native") version "0.9.29-SNAPSHOT"
 }</code></pre>
 </div>
@@ -719,7 +708,6 @@ <h2 id="build-a-native-executable-with-resources-autodetection"><a class="anchor
     binaries.all {
         resources.autodetect()
     }
-    toolchainDetection = false
 }</code></pre>
 </div>
 </div>
@@ -729,51 +717,10 @@ <h2 id="build-a-native-executable-with-resources-autodetection"><a class="anchor
     binaries.all {
         resources.autodetect()
     }
-    toolchainDetection.set(false)
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Another thing to note here: the plugin may not be able to properly detect the GraalVM installation, because of limitations in Gradle.
-If you want to use Oracle GraalVM, or a particular version of GraalVM and Java, you need to explicitly tell this in plugin&#8217;s configuration.
-For example:</p>
-</div>
-<div class="listingblock multi-language-sample">
-<div class="content">
-<pre class="highlightjs highlight"><code data-lang="groovy" class="language-groovy hljs">graalvmNative {
-    binaries {
-        main {
-            javaLauncher = javaToolchains.launcherFor {
-                languageVersion = JavaLanguageVersion.of(11)
-                vendor = JvmVendorSpec.matching("Oracle GraalVM")
-            }
-        }
-    }
 }</code></pre>
 </div>
 </div>
-<div class="listingblock multi-language-sample">
-<div class="content">
-<pre class="highlightjs highlight"><code data-lang="kotlin" class="language-kotlin hljs">graalvmNative {
-    binaries {
-        main {
-            javaLauncher = javaToolchains.launcherFor {
-                languageVersion = JavaLanguageVersion.of(11)
-                vendor = JvmVendorSpec.matching("Oracle GraalVM")
-            }
-        }
-    }
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The workaround to this is to disable toolchain detection with this command <code>toolchainDetection = false</code>.</p>
-</div>
 </li>
-</ol>
-</div>
-<div class="olist arabic">
-<ol class="arabic" start="2">
 <li>
 <p>Compile the project and build a native executable at one step:</p>
 <div class="listingblock">
@@ -792,12 +739,12 @@ <h2 id="build-a-native-executable-with-resources-autodetection"><a class="anchor
 <pre class="highlightjs highlight"><code data-lang="shell" class="language-shell hljs">./fortune/build/native/nativeCompile/fortune</code></pre>
 </div>
 </div>
-</li>
-</ol>
-</div>
 <div class="paragraph">
 <p>The application starts and prints a random quote.</p>
 </div>
+</li>
+</ol>
+</div>
 <div class="paragraph">
 <p>Configuring the <code>graalvmNative</code> plugin to automatically detect resources (<code>resources.autodetect()</code>) to be included in a binary is one way to make this example work.
 Using <code>resources.autodetect()</code> works because the application uses resources (<em>fortunes.json</em>) which are directly available in the <code>src/main/resources</code> location.</p>
@@ -874,43 +821,6 @@ <h2 id="build-a-native-executable-detecting-resources-with-the-agent"><a class="
 </li>
 </ol>
 </div>
-<div class="paragraph">
-<p>To see the benefits of running your application as a native executable, <code>time</code> how long it takes and compare the results with running as a Java application.</p>
-</div>
-<div class="sect2">
-<h3 id="_plugin_customization"><a class="anchor" href="#_plugin_customization"></a>Plugin Customization</h3>
-<div class="paragraph">
-<p>You can customize the plugin. For example, change the name of the native executable and pass additional parameters to the plugin in the <em>build.gradle</em> file, as follows:</p>
-</div>
-<div class="listingblock multi-language-sample">
-<div class="content">
-<pre class="highlightjs highlight"><code data-lang="groovy" class="language-groovy hljs">graalvmNative {
-    binaries {
-        main {
-            imageName.set('fortuneteller')
-            buildArgs.add('--verbose')
-        }
-    }
-}</code></pre>
-</div>
-</div>
-<div class="listingblock multi-language-sample">
-<div class="content">
-<pre class="highlightjs highlight"><code data-lang="kotlin" class="language-kotlin hljs">graalvmNative {
-    binaries {
-        main {
-            imageName.set("fortuneteller")
-            buildArgs.add("--verbose")
-        }
-    }
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The native executable then will be called <code>fortuneteller</code>.
-Notice how you can pass additional arguments to the <code>native-image</code> tool using the <code>buildArgs.add</code> syntax.</p>
-</div>
-</div>
 </div>
 </div>
 <div class="sect1">
@@ -976,39 +886,6 @@ <h2 id="_add_junit_testing"><a class="anchor" href="#_add_junit_testing"></a>Add
 }</code></pre>
 </div>
 </div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_run_tests_with_the_agent"><a class="anchor" href="#_run_tests_with_the_agent"></a>Run Tests with the Agent</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>If you need to test collecting metadata with the agent, add the <code>-Pagent</code> option to the <code>test</code> and <code>nativeTest</code> task invocations:</p>
-</div>
-<div class="olist arabic">
-<ol class="arabic">
-<li>
-<p>Run the tests on the JVM with the agent:</p>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code data-lang="shell" class="language-shell hljs">./gradlew -Pagent test</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>It runs your application on the JVM with the agent, collects the metadata and uses it for testing on <code>native-image</code>.
-The generated configuration files (containing the metadata) can be found in the <em>${buildDir}/native/agent-output/${taskName}</em> directory.
-In this case, the plugin also substitutes <code>{output_dir}</code> in the agent options to point to this directory.</p>
-</div>
-</li>
-<li>
-<p>Build a native executable using the metadata collected by the agent:</p>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code data-lang="shell" class="language-shell hljs">./gradlew -Pagent nativeTest</code></pre>
-</div>
-</div>
-</li>
-</ol>
-</div>
 <div class="sect2">
 <h3 id="_summary"><a class="anchor" href="#_summary"></a>Summary</h3>
 <div class="paragraph">
@@ -1017,10 +894,6 @@ <h3 id="_summary"><a class="anchor" href="#_summary"></a>Summary</h3>
 <a href="https://graalvm.github.io/native-build-tools/latest/gradle-plugin.html">plugin
 reference documentation</a>.</p>
 </div>
-<div class="paragraph">
-<p>Note that if your application does not call any classes dynamically at run time, the execution with the agent is needless.
-Your workflow, in that case, is just <code>./gradlew nativeRun</code>.</p>
-</div>
 </div>
 </div>
 </div>
diff --git a/0.9.29-SNAPSHOT/javadocs/native-gradle-plugin/member-search-index.zip b/0.9.29-SNAPSHOT/javadocs/native-gradle-plugin/member-search-index.zip
index 481d698e2741726d8b4022087a784d82e1e5ccca..766fbe155e1460ee0bb51b180827cd852112c674 100644
GIT binary patch
delta 30
kcmeBE=u_Yg@MdNaVc_84U^w7Xy^(h#KQoY?e30K40B<=6X8-^I

delta 30
kcmeBE=u_Yg@MdNaVc_84U~o#S*vPw)pBYF`KFIG20A|+*sQ>@~

diff --git a/0.9.29-SNAPSHOT/javadocs/native-gradle-plugin/package-search-index.zip b/0.9.29-SNAPSHOT/javadocs/native-gradle-plugin/package-search-index.zip
index cce95c6b848a01a033bc2b9c1f5c54fa1e96a05f..f65a170fe66ee25280c39cce8d70eb61ba04e061 100644
GIT binary patch
delta 28
hcmbQuG@FSxz?+#xgn@&DgW-Tn^+evi%pmHl9{^oT2p#|c

delta 28
hcmbQuG@FSxz?+#xgn@&DgTX1SVj}NeW)OAO4**sM2VejI

diff --git a/0.9.29-SNAPSHOT/javadocs/native-gradle-plugin/type-search-index.zip b/0.9.29-SNAPSHOT/javadocs/native-gradle-plugin/type-search-index.zip
index 0dc3b931df19738cf228bb0d95f12a319876f64c..4000d066afb193c82aba8f3a6f1c40f9de6d05c0 100644
GIT binary patch
delta 30
kcmZo?YiHvP@MdNaVc_84U^w7Xy^(hf6El#Wyobpf0B0cw{{R30

delta 30
kcmZo?YiHvP@MdNaVc_84U~o#S*vPwvi5W;w-oxY#0A9ZbK>z>%

diff --git a/0.9.29-SNAPSHOT/javadocs/native-maven-plugin/member-search-index.zip b/0.9.29-SNAPSHOT/javadocs/native-maven-plugin/member-search-index.zip
index b6a868ca9645c41a7d8ca8ffe4078159a70bcd1d..0b6a839b05dfb1d29551fc413520dc259cb81861 100644
GIT binary patch
delta 30
kcmew;^iha6z?+#xgn@&DgW-Tn^+sM1PG%rIS%uRV0D4>p%K!iX

delta 30
kcmew;^iha6z?+#xgn@&DgTX1SVk55zCo_<qtitIF0CD;U4FCWD

diff --git a/0.9.29-SNAPSHOT/javadocs/native-maven-plugin/package-search-index.zip b/0.9.29-SNAPSHOT/javadocs/native-maven-plugin/package-search-index.zip
index a5b3c3dbea6b063df87a6f488ef4392692de662c..444a2ca394bc712f5fab52daaeb3ff2490219342 100644
GIT binary patch
delta 28
hcmeBW>Sf{$@MdNaVc_84U^w7XJ&|`kGl<&n2LM^i2j&0(

delta 28
hcmeBW>Sf{$@MdNaVc_84U~o#Sn8>@H8AR>(0{~Kn2Pgml

diff --git a/0.9.29-SNAPSHOT/javadocs/native-maven-plugin/type-search-index.zip b/0.9.29-SNAPSHOT/javadocs/native-maven-plugin/type-search-index.zip
index 1d1ec279a8f95608be501553cd554a56e427e647..779d27620f020a088ecda37856a915941b9c6ab2 100644
GIT binary patch
delta 30
kcmZo<X=LFI@MdNaVc_84U^w7Xy^(hrBQubmyp7Qt0A&0J;Q#;t

delta 30
kcmZo<X=LFI@MdNaVc_84U~o#S*vPw#kr_x&-p1$+09={}BLDyZ

diff --git a/0.9.29-SNAPSHOT/maven-plugin-quickstart.html b/0.9.29-SNAPSHOT/maven-plugin-quickstart.html
index f3712a6dd..b85e1a11d 100644
--- a/0.9.29-SNAPSHOT/maven-plugin-quickstart.html
+++ b/0.9.29-SNAPSHOT/maven-plugin-quickstart.html
@@ -454,12 +454,7 @@ <h1>Getting Started with Maven Plugin for GraalVM Native Image</h1>
 <div id="toctitle">Table of Contents</div>
 <ul class="sectlevel1">
 <li><a href="#_prepare_a_demo_application">Prepare a Demo Application</a></li>
-<li><a href="#_build_a_native_executable">Build a Native Executable</a></li>
-<li><a href="#_add_junit_testing">Add JUnit Testing</a>
-<ul class="sectlevel2">
-<li><a href="#_summary">Summary</a></li>
-</ul>
-</li>
+<li><a href="#_build_a_native_executable_by_detecting_resources_with_the_agent">Build a Native Executable by Detecting Resources with the Agent</a></li>
 </ul>
 </div>
 </div>
@@ -470,7 +465,7 @@ <h1>Getting Started with Maven Plugin for GraalVM Native Image</h1>
 <p>This guide shows how to get started with the <a href="maven-plugin.html">Maven plugin for GraalVM Native Image</a> and build a native executable for a Java application.</p>
 </div>
 <div class="paragraph">
-<p>You will create a sample application, enable the plugin, add support for dynamic features, run JUnit tests, and build a native executable.</p>
+<p>You will create a sample application, enable the plugin, add support for dynamic features, build a native executable, and run JUnit tests.</p>
 </div>
 <div class="exampleblock">
 <div class="content">
@@ -502,7 +497,7 @@ <h2 id="_prepare_a_demo_application"><a class="anchor" href="#_prepare_a_demo_ap
 <div class="olist arabic">
 <ol class="arabic">
 <li>
-<p>Create a new Java project with <strong>Maven</strong> in your favorite IDE, called <em>Fortune</em> and make sure to choose
+<p>Create a new Java project with <strong>Maven</strong> in your favorite IDE, called <em>Fortune</em>, in the package named <em>demo</em>. Make sure to choose
 <a href="https://mvnrepository.com/artifact/org.junit.jupiter/junit-jupiter">JUnit Jupiter</a> as the test engine. The <em>pom.xml</em> file
 should look similar to the following.</p>
 <div class="listingblock">
@@ -530,7 +525,7 @@ <h2 id="_prepare_a_demo_application"><a class="anchor" href="#_prepare_a_demo_ap
 </div>
 </li>
 <li>
-<p>Create a package, named <em>demo</em>, and add the <em>Fortune.java</em> (<em>src/main/java/demo/Fortune.java</em>) class.</p>
+<p>Create the <em>Fortune.java</em> (<em>src/main/java/demo/Fortune.java</em>) class.</p>
 <div class="listingblock">
 <div class="content">
 <pre class="highlightjs highlight"><code data-lang="java" class="language-java hljs">package demo;
@@ -632,16 +627,16 @@ <h2 id="_prepare_a_demo_application"><a class="anchor" href="#_prepare_a_demo_ap
 </div>
 </li>
 <li>
-<p>Add explicit <a href="https://mvnrepository.com/artifact/com.fasterxml.jackson.core/jackson-databind">FasterXML Jackson</a>
+<p>Add the <a href="https://mvnrepository.com/artifact/com.fasterxml.jackson.core/jackson-databind">FasterXML Jackson</a>
 dependency that provide functionality to read and write JSON, data bindings (used in the demo application). Open the
 <em>pom.xml</em> file (a Maven configuration file), and insert the following in the <code>&lt;dependencies&gt;</code> section:</p>
 <div class="listingblock">
 <div class="content">
-<pre class="highlightjs highlight"><code data-lang="xml" class="language-xml hljs">        &lt;dependency&gt;
-            &lt;groupId&gt;com.fasterxml.jackson.core&lt;/groupId&gt;
-            &lt;artifactId&gt;jackson-databind&lt;/artifactId&gt;
-            &lt;version&gt;2.16.0&lt;/version&gt;
-        &lt;/dependency&gt;</code></pre>
+<pre class="highlightjs highlight"><code data-lang="xml" class="language-xml hljs">&lt;dependency&gt;
+    &lt;groupId&gt;com.fasterxml.jackson.core&lt;/groupId&gt;
+    &lt;artifactId&gt;jackson-databind&lt;/artifactId&gt;
+    &lt;version&gt;2.16.0&lt;/version&gt;
+&lt;/dependency&gt;</code></pre>
 </div>
 </div>
 <div class="paragraph">
@@ -649,19 +644,19 @@ <h2 id="_prepare_a_demo_application"><a class="anchor" href="#_prepare_a_demo_ap
 </div>
 <div class="listingblock">
 <div class="content">
-<pre class="highlightjs highlight"><code data-lang="xml" class="language-xml hljs">    &lt;dependencies&gt;
-        &lt;dependency&gt;
-            &lt;groupId&gt;com.fasterxml.jackson.core&lt;/groupId&gt;
-            &lt;artifactId&gt;jackson-databind&lt;/artifactId&gt;
-            &lt;version&gt;2.16.0&lt;/version&gt;
-        &lt;/dependency&gt;
-        &lt;dependency&gt;
-            &lt;groupId&gt;org.junit.jupiter&lt;/groupId&gt;
-            &lt;artifactId&gt;junit-jupiter&lt;/artifactId&gt;
-            &lt;version&gt;5.10.1&lt;/version&gt;
-            &lt;scope&gt;test&lt;/scope&gt;
-        &lt;/dependency&gt;
-    &lt;/dependencies&gt;</code></pre>
+<pre class="highlightjs highlight"><code data-lang="xml" class="language-xml hljs">&lt;dependencies&gt;
+    &lt;dependency&gt;
+        &lt;groupId&gt;com.fasterxml.jackson.core&lt;/groupId&gt;
+        &lt;artifactId&gt;jackson-databind&lt;/artifactId&gt;
+        &lt;version&gt;2.16.0&lt;/version&gt;
+    &lt;/dependency&gt;
+    &lt;dependency&gt;
+        &lt;groupId&gt;org.junit.jupiter&lt;/groupId&gt;
+        &lt;artifactId&gt;junit-jupiter&lt;/artifactId&gt;
+        &lt;version&gt;5.10.1&lt;/version&gt;
+        &lt;scope&gt;test&lt;/scope&gt;
+    &lt;/dependency&gt;
+&lt;/dependencies&gt;</code></pre>
 </div>
 </div>
 </li>
@@ -762,8 +757,7 @@ <h2 id="_prepare_a_demo_application"><a class="anchor" href="#_prepare_a_demo_ap
 </div>
 </li>
 <li>
-<p>Register the Maven plugin for GraalVM Native Image, <code>native-maven-plugin</code>, in the profile called <code>native</code> by adding
-the following to the <em>pom.xml</em> file:</p>
+<p>Register the Maven plugin for GraalVM Native Image, <code>native-maven-plugin</code>, within a Maven profile, <code>native</code>, by adding the following to the <em>pom.xml</em> file:</p>
 <div class="listingblock">
 <div class="content">
 <pre class="highlightjs highlight"><code data-lang="xml" class="language-xml hljs">    &lt;profiles&gt;
@@ -802,94 +796,92 @@ <h2 id="_prepare_a_demo_application"><a class="anchor" href="#_prepare_a_demo_ap
 </div>
 </div>
 <div class="paragraph">
-<p>It pulls the latest plugin version. Replace <code>${native.maven.plugin.version}</code> with a specific version if you prefer.
-The plugin discovers which JAR files it needs to pass to the <code>native-image</code> builder and what the executable main class
-should be. With this plugin you can already build a native executable directly with Maven by running
-<code>mvn -Pnative package</code> (if your application does not call any methods reflectively at run time).</p>
+<p>It pulls the latest plugin version.
+Replace <code>${native.maven.plugin.version}</code> with a specific version if you prefer.
+The plugin discovers which JAR files it needs to pass to the <code>native-image</code> builder and what the executable main class should be.
+With this plugin you can already build a native executable directly with Maven by running <code>mvn -Pnative package</code> (if your application does not call any methods reflectively at run time).</p>
+</div>
+</li>
+</ol>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_build_a_native_executable_by_detecting_resources_with_the_agent"><a class="anchor" href="#_build_a_native_executable_by_detecting_resources_with_the_agent"></a>Build a Native Executable by Detecting Resources with the Agent</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>&lt;&lt;&lt;&lt;&lt;&lt;&lt; HEAD
+This demo application and requires metadata before building a native executable.
+You do not have to configure anything manually: the plugin can generate the required configuration for you by injecting the <a href="https://graalvm.github.io/native-build-tools/latest/maven-plugin.html#agent-support">tracing agent</a> at package time.</p>
 </div>
+<div class="exampleblock">
+<div class="content">
 <div class="paragraph">
-<p>This demo application is a little more complicated than <code>HelloWorld</code>, and requires metadata before building a native
-executable. You do not have to configure anything manually as the plugin can generate the required metadata for you by
-injecting the <a href="https://graalvm.github.io/native-build-tools/latest/maven-plugin.html#agent-support">tracing agent</a> at
-package time. The agent is disabled by default, and can be enabled in project&#8217;s <em>pom.xml</em> file or via the command line.</p>
+<p>This demo application requires metadata before building a native executable. You do not have to configure anything manually: the plugin can generate the required configuration for you by injecting the <a href="https://graalvm.github.io/native-build-tools/latest/maven-plugin.html#agent-support">tracing agent</a> at package time.
+&gt;&gt;&gt;&gt;&gt;&gt;&gt; 24e5db3b (Remove extra word)
+The agent is disabled by default, and can be enabled in project&#8217;s <em>pom.xml</em> file or via the command line.</p>
 </div>
-<div class="ulist">
-<ul>
+<div class="olist arabic">
+<ol class="arabic">
 <li>
-<p>To enable the agent via the <em>pom.xml</em> file, specify <code>&lt;enabled&gt;true&lt;/enabled&gt;</code> in the <code>native-maven-plugin</code> plugin
-configuration:</p>
+<p>To enable the agent via the <em>pom.xml</em> file, specify <code>&lt;enabled&gt;true&lt;/enabled&gt;</code> in the <code>native-maven-plugin</code> plugin configuration:</p>
 <div class="listingblock">
 <div class="content">
-<pre class="highlightjs highlight"><code data-lang="xml" class="language-xml hljs">                        &lt;configuration&gt;
-                            &lt;fallback&gt;false&lt;/fallback&gt;
-                            &lt;agent&gt;
-                                &lt;enabled&gt;true&lt;/enabled&gt;
-                            &lt;/agent&gt;
-                        &lt;/configuration&gt;</code></pre>
+<pre class="highlightjs highlight"><code data-lang="xml" class="language-xml hljs">&lt;configuration&gt;
+    &lt;fallback&gt;false&lt;/fallback&gt;
+    &lt;agent&gt;
+        &lt;enabled&gt;true&lt;/enabled&gt;
+    &lt;/agent&gt;
+&lt;/configuration&gt;</code></pre>
 </div>
 </div>
-</li>
-<li>
-<p>To enable the agent via the command line, pass the <code>-Dagent=true</code> option when running Maven.</p>
 <div class="paragraph">
-<p>So your next step is to run with the agent.</p>
-</div>
-</li>
-</ul>
+<p>To enable the agent via the command line, pass the <code>-Dagent=true</code> option when running Maven.</p>
 </div>
 </li>
 <li>
-<p>Before running with the agent, register a separate Mojo execution in the <code>native</code> profile which allows forking the
-Java process. It is required to run your application with the agent.</p>
+<p>Before running with the agent, register a separate Mojo execution in the <code>native</code> profile which allows forking the Java process.
+It is required to run your application with the agent.</p>
 <div class="listingblock">
 <div class="content">
-<pre class="highlightjs highlight"><code data-lang="xml" class="language-xml hljs">                    &lt;plugin&gt;
-                        &lt;groupId&gt;org.codehaus.mojo&lt;/groupId&gt;
-                        &lt;artifactId&gt;exec-maven-plugin&lt;/artifactId&gt;
-                        &lt;version&gt;3.1.1&lt;/version&gt;
-                        &lt;executions&gt;
-                            &lt;execution&gt;
-                                &lt;id&gt;java-agent&lt;/id&gt;
-                                &lt;goals&gt;
-                                    &lt;goal&gt;exec&lt;/goal&gt;
-                                &lt;/goals&gt;
-                                &lt;configuration&gt;
-                                    &lt;executable&gt;java&lt;/executable&gt;
-                                    &lt;workingDirectory&gt;${project.build.directory}&lt;/workingDirectory&gt;
-                                    &lt;arguments&gt;
-                                        &lt;argument&gt;-classpath&lt;/argument&gt;
-                                        &lt;classpath/&gt;
-                                        &lt;argument&gt;${mainClass}&lt;/argument&gt;
-                                    &lt;/arguments&gt;
-                                &lt;/configuration&gt;
-                            &lt;/execution&gt;
-                            &lt;execution&gt;
-                                &lt;id&gt;native&lt;/id&gt;
-                                &lt;goals&gt;
-                                    &lt;goal&gt;exec&lt;/goal&gt;
-                                &lt;/goals&gt;
-                                &lt;configuration&gt;
-                                    &lt;executable&gt;${project.build.directory}/${imageName}&lt;/executable&gt;
-                                    &lt;workingDirectory&gt;${project.build.directory}&lt;/workingDirectory&gt;
-                                &lt;/configuration&gt;
-                            &lt;/execution&gt;
-                        &lt;/executions&gt;
-                    &lt;/plugin&gt;</code></pre>
+<pre class="highlightjs highlight"><code data-lang="xml" class="language-xml hljs">&lt;plugin&gt;
+    &lt;groupId&gt;org.codehaus.mojo&lt;/groupId&gt;
+    &lt;artifactId&gt;exec-maven-plugin&lt;/artifactId&gt;
+    &lt;version&gt;3.1.1&lt;/version&gt;
+    &lt;executions&gt;
+        &lt;execution&gt;
+            &lt;id&gt;java-agent&lt;/id&gt;
+            &lt;goals&gt;
+                &lt;goal&gt;exec&lt;/goal&gt;
+            &lt;/goals&gt;
+            &lt;configuration&gt;
+                &lt;executable&gt;java&lt;/executable&gt;
+                &lt;workingDirectory&gt;${project.build.directory}&lt;/workingDirectory&gt;
+                &lt;arguments&gt;
+                    &lt;argument&gt;-classpath&lt;/argument&gt;
+                    &lt;classpath/&gt;
+                    &lt;argument&gt;${mainClass}&lt;/argument&gt;
+                &lt;/arguments&gt;
+            &lt;/configuration&gt;
+        &lt;/execution&gt;
+        &lt;execution&gt;
+            &lt;id&gt;native&lt;/id&gt;
+            &lt;goals&gt;
+                &lt;goal&gt;exec&lt;/goal&gt;
+            &lt;/goals&gt;
+            &lt;configuration&gt;
+                &lt;executable&gt;${project.build.directory}/${imageName}&lt;/executable&gt;
+                &lt;workingDirectory&gt;${project.build.directory}&lt;/workingDirectory&gt;
+            &lt;/configuration&gt;
+        &lt;/execution&gt;
+    &lt;/executions&gt;
+&lt;/plugin&gt;</code></pre>
 </div>
 </div>
 <div class="paragraph">
-<p>Now you are all set to to build a native executable from a Java application the plugin.</p>
+<p>Now you are all set to to build a native executable.</p>
 </div>
 </li>
-</ol>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_build_a_native_executable"><a class="anchor" href="#_build_a_native_executable"></a>Build a Native Executable</h2>
-<div class="sectionbody">
-<div class="olist arabic">
-<ol class="arabic">
 <li>
 <p>Compile the project on the JVM to create a runnable JAR with all dependencies.
 Open a terminal window and, from the root application directory, run:</p>
@@ -919,8 +911,7 @@ <h2 id="_build_a_native_executable"><a class="anchor" href="#_build_a_native_exe
 </div>
 </div>
 <div class="paragraph">
-<p>When the command completes a native executable, <em>fortune</em>, is created in the <em>target</em> directory of the project and
-ready for use.</p>
+<p>When the command completes, a native executable, <em>fortune</em>, is created in the <em>target</em> directory of the project and ready for use.</p>
 </div>
 <div class="paragraph">
 <p>The executable&#8217;s name is derived from the artifact ID, but you can specify any custom name in <code>native-maven-plugin</code>
@@ -928,13 +919,13 @@ <h2 id="_build_a_native_executable"><a class="anchor" href="#_build_a_native_exe
 </div>
 <div class="listingblock">
 <div class="content">
-<pre class="highlightjs highlight"><code data-lang="xml" class="language-xml hljs">                        &lt;configuration&gt;
-                            &lt;fallback&gt;false&lt;/fallback&gt;
-                            &lt;imageName&gt;fortuneteller&lt;/imageName&gt;
-                            &lt;agent&gt;
-                                &lt;enabled&gt;true&lt;/enabled&gt;
-                            &lt;/agent&gt;
-                        &lt;/configuration&gt;</code></pre>
+<pre class="highlightjs highlight"><code data-lang="xml" class="language-xml hljs">&lt;configuration&gt;
+    &lt;imageName&gt;fortuneteller&lt;/imageName&gt;
+    &lt;fallback&gt;false&lt;/fallback&gt;
+    &lt;agent&gt;
+        &lt;enabled&gt;true&lt;/enabled&gt;
+    &lt;/agent&gt;
+&lt;/configuration&gt;</code></pre>
 </div>
 </div>
 </li>
@@ -945,23 +936,15 @@ <h2 id="_build_a_native_executable"><a class="anchor" href="#_build_a_native_exe
 <pre class="highlightjs highlight"><code data-lang="shell" class="language-shell hljs">./target/fortune</code></pre>
 </div>
 </div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code data-lang="shell" class="language-shell hljs">mvn -Pnative exec:exec@native</code></pre>
-</div>
+<div class="paragraph">
+<p>The application starts and prints a random quote.</p>
 </div>
 </li>
 </ol>
 </div>
 <div class="paragraph">
-<p>To see the benefits of running your application as a native executable, <code>time</code> how long it takes and compare the results
-with running on the JVM.</p>
-</div>
-</div>
+<p>== Add JUnit Testing</p>
 </div>
-<div class="sect1">
-<h2 id="_add_junit_testing"><a class="anchor" href="#_add_junit_testing"></a>Add JUnit Testing</h2>
-<div class="sectionbody">
 <div class="paragraph">
 <p>The Maven plugin for GraalVM Native Image can run
 <a href="https://junit.org/junit5/docs/current/user-guide/">JUnit Platform</a> tests on a native executable.
@@ -974,33 +957,35 @@ <h2 id="_add_junit_testing"><a class="anchor" href="#_add_junit_testing"></a>Add
 <div class="olist arabic">
 <ol class="arabic">
 <li>
-<p>Enable extensions in the plugin&#8217;s configuration,
-<code>&lt;extensions&gt;true&lt;/extensions&gt;</code>:</p>
+<p>Enable extensions in the plugin&#8217;s configuration, <code>&lt;extensions&gt;true&lt;/extensions&gt;</code>:</p>
 <div class="listingblock">
 <div class="content">
-<pre class="highlightjs highlight"><code data-lang="xml" class="language-xml hljs">                    &lt;plugin&gt;
-                        &lt;groupId&gt;org.graalvm.buildtools&lt;/groupId&gt;
-                        &lt;artifactId&gt;native-maven-plugin&lt;/artifactId&gt;
-                        &lt;version&gt;${native.maven.plugin.version}&lt;/version&gt;
-                        &lt;extensions&gt;true&lt;/extensions&gt;</code></pre>
+<pre class="highlightjs highlight"><code data-lang="xml" class="language-xml hljs">&lt;plugin&gt;
+    &lt;groupId&gt;org.graalvm.buildtools&lt;/groupId&gt;
+    &lt;artifactId&gt;native-maven-plugin&lt;/artifactId&gt;
+    &lt;version&gt;${native.maven.plugin.version}&lt;/version&gt;
+    &lt;extensions&gt;true&lt;/extensions&gt;
+    ...
+&lt;/plugin&gt;</code></pre>
 </div>
 </div>
 </li>
 <li>
-<p>Add an explicit dependency on the <code>junit-platform-launcher</code> artifact to the dependencies section of your native
-profile configuration as in the following example:</p>
+<p>Add an explicit dependency on the <code>junit-platform-launcher</code> artifact in the dependencies section of your native profile configuration as in the following example:</p>
 <div class="listingblock">
 <div class="content">
-<pre class="highlightjs highlight"><code data-lang="xml" class="language-xml hljs">        &lt;profile&gt;
-            &lt;id&gt;native&lt;/id&gt;
-            &lt;dependencies&gt;
-                &lt;dependency&gt;
-                    &lt;groupId&gt;org.junit.platform&lt;/groupId&gt;
-                    &lt;artifactId&gt;junit-platform-launcher&lt;/artifactId&gt;
-                    &lt;version&gt;1.10.0&lt;/version&gt;
-                    &lt;scope&gt;test&lt;/scope&gt;
-                &lt;/dependency&gt;
-            &lt;/dependencies&gt;</code></pre>
+<pre class="highlightjs highlight"><code data-lang="xml" class="language-xml hljs">&lt;profile&gt;
+    &lt;id&gt;native&lt;/id&gt;
+    &lt;dependencies&gt;
+        &lt;dependency&gt;
+            &lt;groupId&gt;org.junit.platform&lt;/groupId&gt;
+            &lt;artifactId&gt;junit-platform-launcher&lt;/artifactId&gt;
+            &lt;version&gt;1.10.0&lt;/version&gt;
+            &lt;scope&gt;test&lt;/scope&gt;
+        &lt;/dependency&gt;
+    &lt;/dependencies&gt;
+    ...
+&lt;/profile&gt;</code></pre>
 </div>
 </div>
 </li>
@@ -1028,28 +1013,25 @@ <h2 id="_add_junit_testing"><a class="anchor" href="#_add_junit_testing"></a>Add
 </div>
 </li>
 <li>
-<p>Run native tests:</p>
+<p>Run JUnit tests:</p>
 <div class="listingblock">
 <div class="content">
 <pre class="highlightjs highlight"><code data-lang="shell" class="language-shell hljs">mvn -Pnative -Dagent test</code></pre>
 </div>
 </div>
 <div class="paragraph">
-<p>Run <code>-Pnative</code> profile will then build and run native tests. Include the <code>-Dagent</code> is this is not enabled in the
-<em>pom.xml</em> file.</p>
+<p>The <code>-Pnative</code> profile will then build and run JUnit tests.</p>
 </div>
 </li>
 </ol>
 </div>
-<div class="sect2">
-<h3 id="_summary"><a class="anchor" href="#_summary"></a>Summary</h3>
+<div class="paragraph">
+<p>=== Summary</p>
+</div>
 <div class="paragraph">
 <p>The Maven plugin for GraalVM Native Image adds support for building and testing native executables using <a href="https://maven.apache.org/">Apache Maven™</a>.
 The plugin has many features, described in the <a href="maven-plugin.html">plugin reference documentation</a>.</p>
 </div>
-<div class="paragraph">
-<p>Note that if your application does not call any classes dynamically at run time, the execution with the agent is needless.
-Your workflow, in that case, is just <code>mvn clean -Pnative package</code>.</p>
 </div>
 </div>
 </div>