1.1 --- a/samples/composition/src-api2.0-compat/api/Arithmetica.java	Sat Jun 14 09:58:03 2008 +0200
     1.2 +++ b/samples/composition/src-api2.0-compat/api/Arithmetica.java	Sat Jun 14 09:58:05 2008 +0200
     1.3 @@ -50,5 +50,5 @@
     1.4      private int sumRange2(int from, int to) {
     1.5          return (from + to) * (to - from + 1) / 2;
     1.6      }
     1.7 +}
     1.8  // END: design.composition.arith2.0.compat
     1.9 -}

     2.1 --- a/samples/composition/src-api2.0-enum/api/Arithmetica.java	Sat Jun 14 09:58:03 2008 +0200
     2.2 +++ b/samples/composition/src-api2.0-enum/api/Arithmetica.java	Sat Jun 14 09:58:05 2008 +0200
     2.3 @@ -29,7 +29,7 @@
     2.4                  throw new IllegalStateException();
     2.5          }
     2.6      }
     2.7 -// END: design.composition.arith2.0.enum
     2.8 +// FINISH: design.composition.arith2.0.enum
     2.9      
    2.10      public int sumTwo(int one, int second) {
    2.11          return one + second;

     3.1 --- a/samples/composition/src-api2.0-property/api/Arithmetica.java	Sat Jun 14 09:58:03 2008 +0200
     3.2 +++ b/samples/composition/src-api2.0-property/api/Arithmetica.java	Sat Jun 14 09:58:05 2008 +0200
     3.3 @@ -43,5 +43,5 @@
     3.4      private int sumRange2(int from, int to) {
     3.5          return (from + to) * (to - from + 1) / 2;
     3.6      }
     3.7 +}
     3.8  // END: design.composition.arith2.0.property
     3.9 -}

     4.1 --- a/samples/deadlock/test/org/apidesign/deadlock/startuplock/CLIHandlerBlockingTest.java	Sat Jun 14 09:58:03 2008 +0200
     4.2 +++ b/samples/deadlock/test/org/apidesign/deadlock/startuplock/CLIHandlerBlockingTest.java	Sat Jun 14 09:58:05 2008 +0200
     4.3 @@ -52,5 +52,5 @@
     4.4          public void close() throws SecurityException {
     4.5          }
     4.6      } // end of H
     4.7 +}
     4.8  // END: test.capture.logs
     4.9 -}
    4.10 \ No newline at end of file

     5.1 --- a/samples/delegatingwriter/test/org/apidesign/delegatingwriter/BufferedWriterOnCDImageTest.java	Sat Jun 14 09:58:03 2008 +0200
     5.2 +++ b/samples/delegatingwriter/test/org/apidesign/delegatingwriter/BufferedWriterOnCDImageTest.java	Sat Jun 14 09:58:05 2008 +0200
     5.3 @@ -82,7 +82,7 @@
     5.4          public int length() {
     5.5              return end - start;
     5.6          }
     5.7 -// END: writer.bigseq
     5.8 +// FINISH: writer.bigseq
     5.9  
    5.10          public char charAt(int index) {
    5.11              int ch = index % ('Z' - 'A' + 1);

     6.1 --- a/samples/delegatingwriter/test/org/apidesign/delegatingwriter/CountingWriter.java	Sat Jun 14 09:58:03 2008 +0200
     6.2 +++ b/samples/delegatingwriter/test/org/apidesign/delegatingwriter/CountingWriter.java	Sat Jun 14 09:58:05 2008 +0200
     6.3 @@ -27,7 +27,7 @@
     6.4          counter += csq.length();
     6.5          return this;
     6.6      }
     6.7 -// END: writer.CountingWriter
     6.8 +// FINISH: writer.CountingWriter
     6.9  
    6.10      @Override
    6.11      public Writer append(CharSequence csq, int start, int end) throws IOException {

     7.1 --- a/samples/delegatingwriter/test/org/apidesign/delegatingwriter/CryptoWriter.java	Sat Jun 14 09:58:03 2008 +0200
     7.2 +++ b/samples/delegatingwriter/test/org/apidesign/delegatingwriter/CryptoWriter.java	Sat Jun 14 09:58:05 2008 +0200
     7.3 @@ -62,7 +62,7 @@
     7.4          }
     7.5          return (char)(c + 1);
     7.6      }
     7.7 -// END: writer.CryptoWriter
     7.8 +// FINISH: writer.CryptoWriter
     7.9  
    7.10      /* delegates to write(cbuf, 0, cbuf.length)
    7.11      public void write(char[] cbuf) throws IOException {

     8.1 --- a/samples/differentreturntype/src-api1.0/api/API.java	Sat Jun 14 09:58:03 2008 +0200
     8.2 +++ b/samples/differentreturntype/src-api1.0/api/API.java	Sat Jun 14 09:58:05 2008 +0200
     8.3 @@ -5,7 +5,7 @@
     8.4  public abstract class API {
     8.5  // BEGIN: theory.binary.differentreturntype.api
     8.6      public static Icon getIcon() {
     8.7 +        return null; // compute something
     8.8 +    }
     8.9  // END: theory.binary.differentreturntype.api
    8.10 -        return null;
    8.11 -    }
    8.12  }

     9.1 --- a/samples/differentreturntype/src-api2.0/api/API.java	Sat Jun 14 09:58:03 2008 +0200
     9.2 +++ b/samples/differentreturntype/src-api2.0/api/API.java	Sat Jun 14 09:58:05 2008 +0200
     9.3 @@ -5,7 +5,7 @@
     9.4  public abstract class API {
     9.5  // BEGIN: theory.binary.differentreturntype.api2
     9.6      public static ImageIcon getIcon() {
     9.7 -// END: theory.binary.differentreturntype.api2
     9.8          return null;
     9.9      }
    9.10 +// END: theory.binary.differentreturntype.api2
    9.11  }

    10.1 --- a/samples/insertsuperclass/src-api2.0/api/HelloClass.java	Sat Jun 14 09:58:03 2008 +0200
    10.2 +++ b/samples/insertsuperclass/src-api2.0/api/HelloClass.java	Sat Jun 14 09:58:05 2008 +0200
    10.3 @@ -2,6 +2,6 @@
    10.4  
    10.5  // BEGIN: design.insert.superclass2
    10.6  public abstract class HelloClass extends SimpleHelloClass {
    10.7 -// END: design.insert.superclass2
    10.8 +// FINISH: design.insert.superclass2
    10.9      public abstract String sayHelloTo(String who);
   10.10  }

    11.1 --- a/samples/javabeans/test/org/apidesign/javabeans/use/toomany/MyHighlightsContainer.java	Sat Jun 14 09:58:03 2008 +0200
    11.2 +++ b/samples/javabeans/test/org/apidesign/javabeans/use/toomany/MyHighlightsContainer.java	Sat Jun 14 09:58:05 2008 +0200
    11.3 @@ -25,5 +25,5 @@
    11.4      public HighlightsSequence getHighlights(int start, int end) {
    11.5          return null; // implement
    11.6      }
    11.7 +}
    11.8  // END: javabeans.with.MyHighlightsContainer
    11.9 -}
   11.10 \ No newline at end of file

    12.1 --- a/samples/messagedigest/src-new-api/org/apidesign/spi/security/Digestor.java	Sat Jun 14 09:58:03 2008 +0200
    12.2 +++ b/samples/messagedigest/src-new-api/org/apidesign/spi/security/Digestor.java	Sat Jun 14 09:58:05 2008 +0200
    12.3 @@ -17,7 +17,7 @@
    12.4     protected abstract Data create(String algorithm); 
    12.5     protected abstract void update(Data data, ByteBuffer input);
    12.6     
    12.7 -// END: day.end.bridges.Digestor   
    12.8 +// FINISH: day.end.bridges.Digestor   
    12.9     
   12.10     
   12.11     static {

    13.1 --- a/samples/primitiveconstants/src-impl/impl/Impl.java	Sat Jun 14 09:58:03 2008 +0200
    13.2 +++ b/samples/primitiveconstants/src-impl/impl/Impl.java	Sat Jun 14 09:58:05 2008 +0200
    13.3 @@ -8,7 +8,7 @@
    13.4            throw new IllegalStateException("Wrong API version error!");
    13.5          }
    13.6      }
    13.7 -// END: theory.binary.constants.impl
    13.8 +// FINISH: theory.binary.constants.impl
    13.9      
   13.10      public static void main(String[] args) {
   13.11          System.err.println("main expects version: " + API.VERSION);

    14.1 --- a/samples/privilegedcreator/test/accessprotectedmethod/MyDocument.java	Sat Jun 14 09:58:03 2008 +0200
    14.2 +++ b/samples/privilegedcreator/test/accessprotectedmethod/MyDocument.java	Sat Jun 14 09:58:05 2008 +0200
    14.3 @@ -11,7 +11,7 @@
    14.4      final void writeLockAccess() {
    14.5          writeLock();
    14.6      }
    14.7 -// END: public.accessor
    14.8 +// FINISH: public.accessor
    14.9  
   14.10      @Override
   14.11      public Element getDefaultRootElement() {