Rearrange some things

This moves some documentation to a specific docs folder, as well as
creating a new examples folder, and putting the two pieces of example
code into there

1 files changed, 0 insertions, 144 deletions

diff --git a/src/main/java/bjc/rgens/parser/RGrammarTest.java b/src/main/java/bjc/rgens/parser/RGrammarTest.java
deleted file mode 100755
index 605fc5b..0000000
--- a/src/main/java/bjc/rgens/parser/RGrammarTest.java
+++ /dev/null
@@ -1,144 +0,0 @@
-package bjc.rgens.parser;
-
-import static bjc.rgens.parser.RGrammarLogging.error;
-import static bjc.rgens.parser.RGrammarLogging.perf;
-
-import bjc.data.Tree;
-import bjc.data.SimpleTree;
-
-import java.io.IOException;
-
-import java.net.URISyntaxException;
-import java.net.URL;
-
-import java.nio.file.Path;
-import java.nio.file.Paths;
-
-import java.util.Random;
-
-import bjc.rgens.parser.templates.GrammarTemplate;
-
-/**
- * Test for new grammar syntax.
- *
- * @author EVE
- */
-public class RGrammarTest {
-	/**
-	 * Main method.
-	 *
-	 * @param args
-	 * 	Unused CLI args.
-	 */
-	public static void main(String[] args) {
-		URL rsc = RGrammarTest.class.getResource("/server-config-sample.gcfg");
-
-		try {
-			LoadOptions lopts = new LoadOptions();
-
-			// Set up load options
-			lopts.doPerf  = true;
-			lopts.doDebug = false;
-			lopts.doTrace = false;
-
-			lopts.defName = "default";
-
-			/* Load a grammar set. */
-			Path cfgPath = Paths.get(rsc.toURI());
-
-			String        msg     = String.format("INFO: Loading config file %s", cfgPath);
-			Tree<String> errTree = new SimpleTree<>(msg);
-
-			ConfigSet cfgSet = ConfigLoader.fromConfigFile(cfgPath, lopts, errTree);
-
-			System.err.print(errTree);
-
-			for(RGrammarSet gramSet : cfgSet.grammars.values()) {
-				testGrammarSet(gramSet);
-			}
-
-			for(GrammarTemplate template : cfgSet.templates.values()) {
-				testTemplate(template, cfgSet.grammars.get("default"));
-			}
-		} catch (IOException ioex) {
-			ioex.printStackTrace();
-		} catch (URISyntaxException urisex) {
-			urisex.printStackTrace();
-		}
-	}
-
-	private static void testTemplate(GrammarTemplate template, RGrammarSet set) {
-		System.out.printf("Generating for template %s\n", template);
-
-		Random rnd = new Random();
-
-		for(int i = 0; i < 10; i++) {
-			GenerationState state = GenerationState.fromGrammar(rnd, set.exportGrammar);
-
-			template.generate(state);
-
-			String res = state.getContents();
-
-			if(res.length() > 120) {
-				System.out.printf("\t\n\tContents: %s\n\t\n", res);
-			} else {
-				System.out.printf("\tContents: %s\n", res);
-			}
-		}
-	}
-
-	private static void testGrammarSet(RGrammarSet gramSet) {
-		/* Generate rule suggestions for all the grammars in the set. */
-		for (String gramName : gramSet.getGrammars()) {
-			long startSuggTime = System.nanoTime();
-
-			gramSet.getGrammar(gramName).generateSuggestions();
-
-			long endSuggTime = System.nanoTime();
-
-			long suggDur = endSuggTime - startSuggTime;
-
-			perf("Generated rule suggestions for %s in %d ns (%f s)", gramName, suggDur, suggDur / 1000000000.0);
-		}
-
-		System.err.printf("\n\n");
-
-		/* Generate for each exported rule. */
-		for (String exportName : gramSet.getExportedRules()) {
-			/* Where we loaded the rule from. */
-			String loadSrc = gramSet.loadedFrom(gramSet.exportedFrom(exportName));
-
-			System.out.println();
-			System.out.printf("Generating for exported rule '%s' from file '%s'\n", exportName, loadSrc);
-
-			RGrammar grammar = gramSet.getExportSource(exportName);
-			long startGenTime = System.nanoTime();
-			for (int i = 0; i < 100; i++) {
-				try {
-					String res = grammar.generate(exportName);
-					if(exportName.contains("+")) res = res.replaceAll("\\s+", "");
-
-					if(res.length() > 120) {
-						System.out.printf("\t\n\tContents: %s\n\t\n", res);
-					} else {
-						System.out.printf("\tContents: %s\n", res);
-					}
-				} catch (GrammarException gex) {
-					/* Print out errors with generation. */
-					String fmt     = "Exported rule %s from %s failed (loaded from '%s')";
-
-					System.out.printf("ERROR: " + fmt, exportName, grammar.name, loadSrc);
-					System.out.println();
-					System.out.println();
-
-					error(gex, fmt, exportName, grammar.name, loadSrc);
-				}
-			}
-			long endGenTime = System.nanoTime();
-
-			long genDur = endGenTime - startGenTime;
-
-			perf("Generated %s 100 times in %d ns (%f s)", exportName, genDur, genDur / 1000000000.0);
-		}
-	}
-}