Add original documentation back to test definitions

antlr4-testgen-maven-plugin/resources/org/antlr4/runtime/test/templates/LeftRecursion/DirectCallToLeftRecursiveRule.stg

@@ -1,3 +1,9 @@
+/**
+ * This is a regression test for "Support direct calls to left-recursive
+ * rules".
+ * https://github.com/antlr/antlr4/issues/161
+ */
+
 TestType() ::= "Parser"
 
 Options ::= [

antlr4-testgen-maven-plugin/resources/org/antlr4/runtime/test/templates/LexerErrors/LexerExecDFA.stg

@@ -1,3 +1,8 @@
+/**
+ * This is a regression test for #45 "NullPointerException in LexerATNSimulator.execDFA".
+ * https://github.com/antlr/antlr4/issues/46
+ */
+
 TestType() ::= "Lexer"
 
 Options ::= [

antlr4-testgen-maven-plugin/resources/org/antlr4/runtime/test/templates/ParserErrors/ContextListGetters.stg

@@ -1,3 +1,8 @@
+/**
+ * Regression test for "Getter for context is not a list when it should be".
+ * https://github.com/antlr/antlr4/issues/19
+ */
+
 TestType() ::= "Parser"
 
 Options ::= [

antlr4-testgen-maven-plugin/resources/org/antlr4/runtime/test/templates/ParserErrors/InvalidATNStateRemoval.stg

@@ -1,3 +1,12 @@
+/**
+ * This is a regression test for #45 "NullPointerException in ATNConfig.hashCode".
+ * https://github.com/antlr/antlr4/issues/45
+ * <p/>
+ * The original cause of this issue was an error in the tool's ATN state optimization,
+ * which is now detected early in {@link ATNSerializer} by ensuring that all
+ * serialized transitions point to states which were not removed.
+ */
+
 TestType() ::= "Parser"
 
 Options ::= [

antlr4-testgen-maven-plugin/resources/org/antlr4/runtime/test/templates/ParserErrors/InvalidEmptyInput.stg

@@ -1,3 +1,8 @@
+/**
+ * This is a regression test for #6 "NullPointerException in getMissingSymbol".
+ * https://github.com/antlr/antlr4/issues/6
+ */
+
 TestType() ::= "Parser"
 
 Options ::= [

antlr4-testgen-maven-plugin/resources/org/antlr4/runtime/test/templates/ParserExec/AorAPlus.stg

@@ -1,3 +1,5 @@
+// force complex decision
+
 TestType() ::= "Parser"
 
 Options ::= [

antlr4-testgen-maven-plugin/resources/org/antlr4/runtime/test/templates/ParserExec/AorAStar.stg

@@ -1,3 +1,5 @@
+// force complex decision
+
 TestType() ::= "Parser"
 
 Options ::= [

antlr4-testgen-maven-plugin/resources/org/antlr4/runtime/test/templates/ParserExec/LabelAliasingAcrossLabeledAlternatives.stg

@@ -1,3 +1,9 @@
+/**
+ * This is a regression test for antlr/antlr4#195 "label 'label' type
+ * mismatch with previous definition: TOKEN_LABEL!=RULE_LABEL"
+ * https://github.com/antlr/antlr4/issues/195
+ */
+
 TestType() ::= "Parser"
 
 Options ::= [

antlr4-testgen-maven-plugin/resources/org/antlr4/runtime/test/templates/ParserExec/ListLabelForClosureContext.stg

@@ -1,3 +1,9 @@
+/**
+ * This is a regression test for antlr/antlr4#299 "Repeating subtree not
+ * accessible in visitor".
+ * https://github.com/antlr/antlr4/issues/299
+ */
+
 TestType() ::= "Parser"
 
 Options ::= [

antlr4-testgen-maven-plugin/resources/org/antlr4/runtime/test/templates/ParserExec/ListLabelsOnSet.stg

@@ -1,3 +1,9 @@
+/**
+ * This is a regression test for #270 "Fix operator += applied to a set of
+ * tokens".
+ * https://github.com/antlr/antlr4/issues/270
+ */
+
 TestType() ::= "Parser"
 
 Options ::= [

antlr4-testgen-maven-plugin/resources/org/antlr4/runtime/test/templates/ParserExec/Optional.stg

@@ -1,3 +1,8 @@
+/**
+ * This test is meant to detect regressions of bug antlr/antlr4#41.
+ * https://github.com/antlr/antlr4/issues/41
+ */
+
 TestType() ::= "Parser"
 
 Options ::= [

antlr4-testgen-maven-plugin/resources/org/antlr4/runtime/test/templates/ParserExec/PredicatedIfIfElse.stg

@@ -1,3 +1,8 @@
+/**
+ * This test is meant to test the expected solution to antlr/antlr4#42.
+ * https://github.com/antlr/antlr4/issues/42
+ */
+
 TestType() ::= "Parser"
 
 Options ::= [

antlr4-testgen-maven-plugin/resources/org/antlr4/runtime/test/templates/ParserExec/PredictionIssue334.stg

@@ -1,3 +1,9 @@
+/**
+ * This is a regression test for antlr/antlr4#334 "BailErrorStrategy: bails
+ * out on proper input".
+ * https://github.com/antlr/antlr4/issues/334
+ */
+
 TestType() ::= "Parser"
 
 Options ::= [

antlr4-testgen-maven-plugin/resources/org/antlr4/runtime/test/templates/SemPredEvalParser/ActionHidesPreds.stg

@@ -1,3 +1,5 @@
+// can't see preds, resolves to first alt found (1 in this case)
+
 TestType() ::= "Parser"
 
 Options ::= [

antlr4-testgen-maven-plugin/resources/org/antlr4/runtime/test/templates/SemPredEvalParser/AtomWithClosureInTranslatedLRRule.stg

@@ -1,3 +1,9 @@
+/**
+ * This is a regression test for antlr/antlr4#196
+ * "element+ in expression grammar doesn't parse properly"
+ * https://github.com/antlr/antlr4/issues/196
+ */
+
 TestType() ::= "Parser"
 
 Options ::= [