Minor formatting tweaks made while reading diffs.

src/main/java/com/samskivert/mustache/Mustache.java

@@ -413,7 +413,7 @@ public class Mustache {
     private Mustache () {} // no instantiateski
 
     protected static Template.Segment[] trim (Template.Segment[] segs, boolean top) {
-        // Trim modifies segs! It's return is not a copy!
+        // trim() modifies segs! Its return is not a copy!
         // now that we have all of our segments, we make a pass through them to trim whitespace
         // from section tags which stand alone on their lines
         assert segs != null;
@@ -440,8 +440,7 @@ public class Mustache {
                     block._standaloneEnd = true;
                 }
             }
-            // we have to indent partials if there is space before
+            // we have to indent partials if there is space before they are also standalone...
-            // they are also standalone...
             else if (seg instanceof IncludedTemplateSegment) {
                 IncludedTemplateSegment include = (IncludedTemplateSegment) seg;
                 if (prev != null && prevBlank && nextBlank) {
@@ -452,10 +451,7 @@ public class Mustache {
                         segs[ii] = include;
                     }
                     //segs[ii-1] = prev.trimTrailBlank();
-                    /*
+                    /* We trim the end because partials follow standalone just like blocks */
-                     * We trim the end because partials
-                     * follow standalone just like blocks
-                     */
                     if (next != null) {
                         segs[ii+1] = next.trimLeadBlank();
                     }
@@ -481,10 +477,9 @@ public class Mustache {
      * @return cloned segments if changed
      */
     static Template.Segment[] indentSegs (Template.Segment[] _segs, String indent, boolean _first, boolean _last) {
-        // unlike trim this method clones the segments if they have changed
+        // unlike trim this method clones the segments if they have changed so the return value must
-        // so the return value must be handled
+        // be handled; a simple identity check on the return can be used to determine if there is
-        // a simple identity check on the return can be used to determine
+        // change
-        // if there is change
         if (indent.equals("")) {
             return _segs;
         }
@@ -492,11 +487,9 @@ public class Mustache {
         Template.Segment[] copySegs = new Template.Segment[length];
         boolean changed = false;
         for (int i = 0; i < _segs.length; i++) {
-            
             Template.Segment seg = _segs[i];
             Template.Segment pseg = (i > 0) ? _segs[i-1] : null;
             Template.Segment nseg = (i < length - 1) ? _segs[i+1] : null;
-            
             Template.Segment copy;
             if (seg instanceof BlockSegment) {
                 BlockSegment bs = (BlockSegment) seg;
@@ -557,14 +550,12 @@ public class Mustache {
             }
             else if (seg instanceof IncludedTemplateSegment) {
                 /*
-                 * If we are standalone then we rely on the indentation
+                 * If we are standalone then we rely on the indentation already present before the
-                 * already present before the partial tag.
+                 * partial tag.
                  * [  WS ]{{> partial }}[\n]
                  *
-                 * That is partial tags do not have the trailing blank
+                 * That is partial tags do not have the trailing blank removed during the trim
-                 * removed during the trim process.
+                 * process. This avoids needlessley creating StringSegment tags.
-                 * 
-                 * This avoids needlessley creating StringSegment tags.
                  */
                 if (seg.isStandalone()) {
                     boolean last;
@@ -1005,10 +996,10 @@ public class Mustache {
             if (first) {
                 sb.append(indent);
             }
-            for (int i = 0; i < length; i++) {
+            for (int ii = 0; ii < length; ii++) {
-                char c = input.charAt(i);
+                char c = input.charAt(ii);
                 sb.append(c);
-                if (c == '\n'  &&  ( last || i != length - 1) ) {
+                if (c == '\n' && (last || ii != length - 1)) {
                     sb.append(indent);
                 }
             }

src/main/java/com/samskivert/mustache/Template.java

@@ -166,13 +166,8 @@ public class Template {
     }
 
     protected Template indent(String indent) {
-        /*
+        // What we want to do here is rebuild this partial template but indented.
-         * What we want to do here is rebuild this partial template
+        // If identing does not change anything we return the original template.
-         * but indented.
-         * 
-         * If identing does not change anything we return
-         * the original template.
-         */
         if (indent.equals("")) {
             return this;
         }
@@ -397,30 +392,24 @@ public class Template {
     /** A template is broken into segments. */
     protected static abstract class Segment {
         abstract void execute (Template tmpl, Context ctx, Writer out);
-
         abstract void decompile (Mustache.Delims delims, StringBuilder into);
-
         abstract void visit (Mustache.Visitor visitor);
+
         /**
          * Recursively indent by the parameter indent.
-         * @param indent should be space characters that are not \n
+         * @param indent should be space characters that are not {@code \n}.
-         * @param first append indent to the first line (regardless if it has a \n or not)
+         * @param first append indent to the first line (regardless if it has a {@code \n} or not).
-         * @param last append indent on the last \n that has no text after it
+         * @param last append indent on the last {@code \n} that has no text after it.
-         * @return newly crated segment or the same segment if nothing changed.
+         * @return a newly created segment or the same segment if nothing changed.
          */
         abstract Segment indent (String indent, boolean first, boolean last);
+
         /**
-         * Whether or not the segment is standalone.
+         * Whether or not the segment is standalone. The definition of standalone is defined by the
-         * For blocks this is based on the closing tag.
+         * mustache spec. String and variable tags are never standalone. For blocks this is based on
-         * Once Trim is called standalone tags are determined so
+         * the closing tag. Once {@code trim} is called, standalone tags are determined so that
-         * that proper (re)indentation will work without reparsing
+         * proper (re)indentation will work without reparsing the template.
-         * the template.
+         * @return true if the tag is standalone.
-         * 
-         * String and variable tags are never standalone.
-         * 
-         * The definition of standalone is defined by the mustache spec.
-         * 
-         * @return true if the tag is standalone
          */
         abstract boolean isStandalone ();
 

src/test/java/com/samskivert/mustache/PartialThreadSafeTest.java

@@ -1,3 +1,7 @@
+//
+// JMustache - A Java implementation of the Mustache templating language
+// http://github.com/samskivert/jmustache/blob/master/LICENSE
+
 package com.samskivert.mustache;
 
 import static org.junit.Assert.assertEquals;
@@ -25,7 +29,6 @@ public class PartialThreadSafeTest {
         long t = System.currentTimeMillis();
         AtomicInteger loadCount = new AtomicInteger();
         TemplateLoader loader = new TemplateLoader() {
-
             @Override
             public Reader getTemplate(String name) throws Exception {
                 if ("partial".equals(name)) {
@@ -63,7 +66,5 @@ public class PartialThreadSafeTest {
         assertEquals(1, loadCount.get());
         System.out.println(loadCount);
         System.out.println(System.currentTimeMillis() - t);
-
     }
-
 }

src/test/java/com/samskivert/mustache/SharedTests.java

@@ -229,7 +229,6 @@ public abstract class SharedTests
         } catch (UnsupportedOperationException uoe) {} // expected
     }
 
-    
     Map<String,String> partials = new LinkedHashMap<>();
 
     @SafeVarargs

src/test/java/com/samskivert/mustache/specs/CustomSpecTest.java

@@ -20,5 +20,4 @@ public class CustomSpecTest extends SpecTest {
         };
         return SpecTest.data("/custom/specs/", groups);
     }
-
 }

src/test/java/com/samskivert/mustache/specs/OfficialSpecTest.java

@@ -25,5 +25,4 @@ public class OfficialSpecTest extends SpecTest {
         };
         return SpecTest.data("/specs/specs/", groups);
     }
-    
 }

src/test/java/com/samskivert/mustache/specs/SpecTest.java

@@ -67,7 +67,6 @@ public abstract class SpecTest {
        s = s.replace('\t', '\u21E5');
        s = s.replace("\n", "\u21B5\n");
        s = s.replace("\u240D", "\u240D\n");
-
        return s;
     }
 
@@ -75,7 +74,6 @@ public abstract class SpecTest {
         return (text == null) ? null : text.replace("\r", "\\r").replace("\n", "\\n");
     }
 
-    
     public static Collection<Object[]> data (String specPath, String[] groups) {
         List<Object[]> tuples = new ArrayList<>();
         int i = 0;
@@ -112,5 +110,4 @@ public abstract class SpecTest {
             throw err;
         }
     }
-
 }