Remove sugar generation example.

tumbarumba · tumbarumba · commit 218829565787 · 2018-11-05T21:27:16.000Z
diff --git a/docs/tutorial.md b/docs/tutorial.md
@@ -172,57 +172,3 @@ public class NumberTest extends TestCase {
 ```
 
 Even though the `notANumber` method creates a new matcher each time it is called, you should not assume this is the only usage pattern for your matcher. Therefore you should make sure your matcher is stateless, so a single instance can be reused between matches.
-
-### Sugar generation (TBD)
-If you produce more than a few custom matchers it becomes annoying to have to import them all individually. It would be nice to be able to group them together in a single class, so they can be imported using a single static import much like the Hamcrest library matchers. Hamcrest helps out here by providing a way to do this by using a generator.
-
-First, create an XML configuration file listing all the Matcher classes that should be searched for factory methods annotated with the org.hamcrest.Factory annotation. For example:
-
-```
-TBD
-```
-
-Second, run the org.hamcrest.generator.config.XmlConfigurator command-line tool that comes with Hamcrest. This tool takes the XML configuration file and generates a single Java class that includes all the factory methods specified by the XML file. Running it with no arguments will display a usage message. Here's the output for the example.
-
-```java 
-package org.hamcrest.examples.tutorial;
-
-public class Matchers {
-
-  public static org.hamcrest.Matcher is(T param1) { 
-    return org.hamcrest.core.Is.is(param1); 
-  }
-
-  public static org.hamcrest.Matcher is(java.lang.Class param1) { 
-    return org.hamcrest.core.Is.is(param1); 
-  }
-
-  public static org.hamcrest.Matcher is(org.hamcrest.Matcher param1) { 
-    return org.hamcrest.core.Is.is(param1); 
-  }
-
-  public static org.hamcrest.Matcher notANumber() { 
-    return org.hamcrest.examples.tutorial.IsNotANumber.notANumber(); 
-  }
-
-} 
-```
-
-Finally, we can update our test to use the new Matchers class.
-
-```java
-import static org.hamcrest.MatcherAssert.assertThat;
-
-import static org.hamcrest.examples.tutorial.Matchers.*;
-
-import junit.framework.TestCase;
-
-public class CustomSugarNumberTest extends TestCase {
-
-  public void testSquareRootOfMinusOneIsNotANumber() { 
-    assertThat(Math.sqrt(-1), is(notANumber())); 
-  } 
-} 
-```
-
-Notice we are now using the Hamcrest library is matcher imported from our own custom Matchers class.
