Documented examples build

Author: ethauvin

examples/src/bld/java/com/example/ExampleBuild.java

@@ -40,13 +40,16 @@ public ExampleBuild() {
                 .include(dependency("org.junit.jupiter", "junit-jupiter", version(5, 10, 1)))
                 .include(dependency("org.junit.platform", "junit-platform-console-standalone", version(1, 10, 1)));
 
+        // Include the Kotlin source directory when creating or publishing sources Java Archives
         jarSourcesOperation().sourceDirectories(new File(srcMainDirectory(), "kotlin"));
     }
 
     public static void main(String[] args) {
         var level = Level.ALL;
         var logger = Logger.getLogger("rife.bld.extension");
         var consoleHandler = new ConsoleHandler();
+
+        // Enable detailed logging for the Kotlin extension
         consoleHandler.setLevel(level);
         logger.addHandler(consoleHandler);
         logger.setLevel(level);
@@ -56,7 +59,9 @@ public static void main(String[] args) {
     }
 
     @BuildCommand(summary = "Compile the Kotlin project")
+    @Override
     public void compile() throws IOException {
+        // The source code located in src/main/kotlin and src/test/kotlin will be compiled
         new CompileKotlinOperation()
                 .fromProject(this)
                 .compileOptions(
@@ -72,6 +77,7 @@ public void dokkaGfm() throws ExitStatusException, IOException, InterruptedExcep
         new DokkaOperation()
                 .fromProject(this)
                 .loggingLevel(LoggingLevel.INFO)
+                // Create build/dokka/gfm
                 .outputDir(Path.of(buildDirectory().getAbsolutePath(), "dokka", "gfm").toFile())
                 .outputFormat(OutputFormat.MARKDOWN)
                 .execute();
@@ -82,16 +88,19 @@ public void dokkaHtml() throws ExitStatusException, IOException, InterruptedExce
         new DokkaOperation()
                 .fromProject(this)
                 .loggingLevel(LoggingLevel.INFO)
+                // Create build/dokka/html
                 .outputDir(Path.of(buildDirectory().getAbsolutePath(), "dokka", "html").toFile())
                 .outputFormat(OutputFormat.HTML)
                 .execute();
     }
 
     @BuildCommand(summary = "Generates Javadoc for the project")
+    @Override
     public void javadoc() throws ExitStatusException, IOException, InterruptedException {
         new DokkaOperation()
                 .fromProject(this)
                 .loggingLevel(LoggingLevel.INFO)
+                // Create build/javadoc
                 .outputDir(new File(buildDirectory(), "javadoc"))
                 .outputFormat(OutputFormat.JAVADOC)
                 .execute();