Structure, readme.

Signed-off-by: mmazas <[email protected]>

.github/workflows/maven.yml

@@ -1,8 +1,8 @@
 # This workflow will build a Java project with Maven
 # For more information see: https://help.github.com/actions/language-and-framework-guides/building-and-testing-java-with-maven
 #
-# Copyright (c) 2020-2024, Sreeni Viswanadha <[email protected]>.
-# Copyright (c) 2024, Marc Mazas <[email protected]>.
+# Copyright (c) 2020-2025, Sreeni Viswanadha <[email protected]>.
+# Copyright (c) 2024-2025, Marc Mazas <[email protected]>.
 # All rights reserved.
 # 
 # Redistribution and use in source and binary forms, with or without

LICENSE

@@ -1,8 +1,8 @@
 BSD 3-Clause License
 
 Copyright (c) 2020-2021, javacc
-Copyright (c) 2020-2024, Sreeni Viswanadha <[email protected]>.
-Copyright (c) 2024, Marc Mazas <[email protected]>.
+Copyright (c) 2020-2025, Sreeni Viswanadha <[email protected]>.
+Copyright (c) 2024-2025, Marc Mazas <[email protected]>.
 All rights reserved.
 
 Redistribution and use in source and binary forms, with or without

pom.xml

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!--
-Copyright (c) 2020-2024, Sreeni Viswanadha <[email protected]>.
-Copyright (c) 2024, Marc Mazas <[email protected]>.
+Copyright (c) 2020-2025, Sreeni Viswanadha <[email protected]>.
+Copyright (c) 2024-2025, Marc Mazas <[email protected]>.
 All rights reserved.
 
 Redistribution and use in source and binary forms, with or without
@@ -93,7 +93,8 @@ THE POSSIBILITY OF SUCH DAMAGE.
     <module>../javacc-8-java</module>
     <module>../javacc-8-cpp</module>
     <module>../javacc-8-csharp</module>
-    <module>../javacc-8-js</module>
+    <!-- still not fully functional -->
+    <!--    <module>../javacc-8-js</module>-->
   </modules>
 
   <scm>
@@ -404,7 +405,7 @@ THE POSSIBILITY OF SUCH DAMAGE.
   <build>
     <pluginManagement>
       <plugins>
-      <!-- TODO reorder & comment -->
+        <!-- TODO reorder & comment -->
         <plugin>
           <!-- copies the project artifacts to the user's local repository; usually implicit -->
           <groupId>org.apache.maven.plugins</groupId>
@@ -486,13 +487,6 @@ THE POSSIBILITY OF SUCH DAMAGE.
           <version>2.7</version>
         </plugin>
 -->
-        <plugin>
-          <groupId>com.github.maven-nar</groupId>
-          <artifactId>nar-maven-plugin</artifactId>
-          <version>3.10.1</version>
-          <!-- snapshot not published on sonatype snapshot repo!-->
-          <!--          <version>3.10.2-SNAPSHOT</version>-->
-        </plugin>
         <plugin>
           <groupId>org.javacc.plugin</groupId>
           <artifactId>javacc-maven-plugin</artifactId>
@@ -559,6 +553,14 @@ THE POSSIBILITY OF SUCH DAMAGE.
               <!--              <goal>select-jdk-toolchain</goal>-->
             </goals>
           </execution>
+          <execution>
+            <!--can be used to generate the toolchains.xml to stdout with: 
+                mvn org.apache.maven.plugins:maven-toolchains-plugin:generate-jdk-toolchains-xml  -->
+            <id>generate-tc</id>
+            <goals>
+              <goal>generate-jdk-toolchains-xml</goal>
+            </goals>
+          </execution>
         </executions>
         <configuration>
           <toolchains>
@@ -588,18 +590,6 @@ THE POSSIBILITY OF SUCH DAMAGE.
         <artifactId>exec-maven-plugin</artifactId>
       </plugin>
 
-      <plugin>
-        <groupId>com.github.maven-nar</groupId>
-        <artifactId>nar-maven-plugin</artifactId>
-        <executions>
-          <execution>
-            <configuration>
-              <commandLogLevel>3</commandLogLevel>
-            </configuration>
-          </execution>
-        </executions>
-      </plugin>
-
       <plugin>
         <groupId>org.apache.maven.plugins</groupId>
         <artifactId>maven-surefire-plugin</artifactId>
@@ -630,6 +620,7 @@ THE POSSIBILITY OF SUCH DAMAGE.
   <reporting>
     <plugins>
 
+      <!-- don't know what this is for -->
       <plugin>
         <groupId>org.javacc.plugin</groupId>
         <artifactId>javacc-maven-plugin</artifactId>

rulesets/java/maven-pmd-plugin-default.xml

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!--
-Copyright (c) 2020-2024, Sreeni Viswanadha <[email protected]>.
-Copyright (c) 2024, Marc Mazas <[email protected]>.
+Copyright (c) 2020-2025, Sreeni Viswanadha <[email protected]>.
+Copyright (c) 2024-2025, Marc Mazas <[email protected]>.
 All rights reserved.
 
 Redistribution and use in source and binary forms, with or without

tests/cpp/TestTokenManagerUsesParser/pom.xml

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!--
-Copyright (c) 2020-2024, Sreeni Viswanadha <[email protected]>.
-Copyright (c) 2024, Marc Mazas <[email protected]>.
+Copyright (c) 2020-2025, Sreeni Viswanadha <[email protected]>.
+Copyright (c) 2024-2025, Marc Mazas <[email protected]>.
 All rights reserved.
 
 Redistribution and use in source and binary forms, with or without

tests/cpp/TestTokenManagerUsesParser2/pom.xml

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!--
-Copyright (c) 2020-2024, Sreeni Viswanadha <[email protected]>.
-Copyright (c) 2024, Marc Mazas <[email protected]>.
+Copyright (c) 2020-2025, Sreeni Viswanadha <[email protected]>.
+Copyright (c) 2024-2025, Marc Mazas <[email protected]>.
 All rights reserved.
 
 Redistribution and use in source and binary forms, with or without

tests/cpp/build.xml

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!--
-Copyright (c) 2006-2024, Sreeni Viswanadha <[email protected]>.
-Copyright (c) 2024, Marc Mazas <[email protected]>.
+Copyright (c) 2006-2025, Sreeni Viswanadha <[email protected]>.
+Copyright (c) 2024-2025, Marc Mazas <[email protected]>.
 Copyright (c) 2006, Sun Microsystems, Inc.
 All rights reserved.
 

tests/cpp/exceptions/build.xml

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!--
-Copyright (c) 2008-2024, Sreeni Viswanadha <[email protected]>.
-Copyright (c) 2024, Marc Mazas <[email protected]>.
+Copyright (c) 2008-2025, Sreeni Viswanadha <[email protected]>.
+Copyright (c) 2024-2025, Marc Mazas <[email protected]>.
 Copyright (c) 2008, Paul Cager
 All rights reserved.
 

tests/cpp/exceptions/pom.xml

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!--
-Copyright (c) 2020-2024, Sreeni Viswanadha <[email protected]>.
-Copyright (c) 2024, Marc Mazas <[email protected]>.
+Copyright (c) 2020-2025, Sreeni Viswanadha <[email protected]>.
+Copyright (c) 2024-2025, Marc Mazas <[email protected]>.
 All rights reserved.
 
 Redistribution and use in source and binary forms, with or without

tests/cpp/imports/build.xml

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!--
-Copyright (c) 2007-2024, Sreeni Viswanadha <[email protected]>.
-Copyright (c) 2024, Marc Mazas <[email protected]>.
+Copyright (c) 2007-2025, Sreeni Viswanadha <[email protected]>.
+Copyright (c) 2024-2025, Marc Mazas <[email protected]>.
 Copyright (c) 2007, Paul Cager
 All rights reserved.
 

tests/cpp/imports/pom.xml

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!--
-Copyright (c) 2020-2024, Sreeni Viswanadha <[email protected]>.
-Copyright (c) 2024, Marc Mazas <[email protected]>.
+Copyright (c) 2020-2025, Sreeni Viswanadha <[email protected]>.
+Copyright (c) 2024-2025, Marc Mazas <[email protected]>.
 All rights reserved.
 
 Redistribution and use in source and binary forms, with or without

tests/cpp/javaFileGeneration/build.xml

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!--
-Copyright (c) 2007-2024, Sreeni Viswanadha <[email protected]>.
-Copyright (c) 2024, Marc Mazas <[email protected]>.
+Copyright (c) 2007-2025, Sreeni Viswanadha <[email protected]>.
+Copyright (c) 2024-2025, Marc Mazas <[email protected]>.
 Copyright (c) 2007, Paul Cager
 All rights reserved.
 

tests/cpp/javaFileGeneration/pom.xml

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!--
-Copyright (c) 2020-2024, Sreeni Viswanadha <[email protected]>.
-Copyright (c) 2024, Marc Mazas <[email protected]>.
+Copyright (c) 2020-2025, Sreeni Viswanadha <[email protected]>.
+Copyright (c) 2024-2025, Marc Mazas <[email protected]>.
 All rights reserved.
 
 Redistribution and use in source and binary forms, with or without

tests/cpp/javaFiles/build.xml

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!--
-Copyright (c) 2007-2024, Sreeni Viswanadha <[email protected]>.
-Copyright (c) 2024, Marc Mazas <[email protected]>.
+Copyright (c) 2007-2025, Sreeni Viswanadha <[email protected]>.
+Copyright (c) 2024-2025, Marc Mazas <[email protected]>.
 Copyright (c) 2007, Paul Cager
 All rights reserved.
 

tests/cpp/javaFiles/pom.xml

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!--
-Copyright (c) 2020-2024, Sreeni Viswanadha <[email protected]>.
-Copyright (c) 2024, Marc Mazas <[email protected]>.
+Copyright (c) 2020-2025, Sreeni Viswanadha <[email protected]>.
+Copyright (c) 2024-2025, Marc Mazas <[email protected]>.
 All rights reserved.
 
 Redistribution and use in source and binary forms, with or without

tests/cpp/javacodeLA/build.xml

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!--
-Copyright (c) 2007-2024, Sreeni Viswanadha <[email protected]>.
-Copyright (c) 2024, Marc Mazas <[email protected]>.
+Copyright (c) 2007-2025, Sreeni Viswanadha <[email protected]>.
+Copyright (c) 2024-2025, Marc Mazas <[email protected]>.
 Copyright (c) 2007, Paul Cager
 All rights reserved.
 

tests/cpp/javacodeLA/pom.xml

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!--
-Copyright (c) 2020-2024, Sreeni Viswanadha <[email protected]>.
-Copyright (c) 2024, Marc Mazas <[email protected]>.
+Copyright (c) 2020-2025, Sreeni Viswanadha <[email protected]>.
+Copyright (c) 2024-2025, Marc Mazas <[email protected]>.
 All rights reserved.
 
 Redistribution and use in source and binary forms, with or without

tests/cpp/lineNumbers/build.xml

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!--
-Copyright (c) 2006-2024, Sreeni Viswanadha <[email protected]>.
-Copyright (c) 2024, Marc Mazas <[email protected]>.
+Copyright (c) 2006-2025, Sreeni Viswanadha <[email protected]>.
+Copyright (c) 2024-2025, Marc Mazas <[email protected]>.
 Copyright (c) 2006, Sun Microsystems, Inc.
 All rights reserved.
 

tests/cpp/lineNumbers/pom.xml

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!--
-Copyright (c) 2020-2024, Sreeni Viswanadha <[email protected]>.
-Copyright (c) 2024, Marc Mazas <[email protected]>.
+Copyright (c) 2020-2025, Sreeni Viswanadha <[email protected]>.
+Copyright (c) 2024-2025, Marc Mazas <[email protected]>.
 All rights reserved.
 
 Redistribution and use in source and binary forms, with or without

tests/cpp/lom/build.xml

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!--
-Copyright (c) 2007-2024, Sreeni Viswanadha <[email protected]>.
-Copyright (c) 2024, Marc Mazas <[email protected]>.
+Copyright (c) 2007-2025, Sreeni Viswanadha <[email protected]>.
+Copyright (c) 2024-2025, Marc Mazas <[email protected]>.
 Copyright (c) 2007, Paul Cager
 All rights reserved.
 

tests/cpp/lom/pom.xml

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!--
-Copyright (c) 2020-2024, Sreeni Viswanadha <[email protected]>.
-Copyright (c) 2024, Marc Mazas <[email protected]>.
+Copyright (c) 2020-2025, Sreeni Viswanadha <[email protected]>.
+Copyright (c) 2024-2025, Marc Mazas <[email protected]>.
 All rights reserved.
 
 Redistribution and use in source and binary forms, with or without

tests/cpp/newToken/build.xml

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!--
-Copyright (c) 2007-2024, Sreeni Viswanadha <[email protected]>.
-Copyright (c) 2024, Marc Mazas <[email protected]>.
+Copyright (c) 2007-2025, Sreeni Viswanadha <[email protected]>.
+Copyright (c) 2024-2025, Marc Mazas <[email protected]>.
 Copyright (c) 2007, Paul Cager
 All rights reserved.
 

tests/cpp/newToken/pom.xml

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!--
-Copyright (c) 2020-2024, Sreeni Viswanadha <[email protected]>.
-Copyright (c) 2024, Marc Mazas <[email protected]>.
+Copyright (c) 2020-2025, Sreeni Viswanadha <[email protected]>.
+Copyright (c) 2024-2025, Marc Mazas <[email protected]>.
 All rights reserved.
 
 Redistribution and use in source and binary forms, with or without

tests/cpp/pom.xml

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!--
-Copyright (c) 2020-2024, Sreeni Viswanadha <[email protected]>.
-Copyright (c) 2024, Marc Mazas <[email protected]>.
+Copyright (c) 2020-2025, Sreeni Viswanadha <[email protected]>.
+Copyright (c) 2024-2025, Marc Mazas <[email protected]>.
 All rights reserved.
 
 Redistribution and use in source and binary forms, with or without

tests/java/exceptions/pom.xml

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!--
-Copyright (c) 2020-2024, Sreeni Viswanadha <[email protected]>.
-Copyright (c) 2024, Marc Mazas <[email protected]>.
+Copyright (c) 2020-2025, Sreeni Viswanadha <[email protected]>.
+Copyright (c) 2024-2025, Marc Mazas <[email protected]>.
 All rights reserved.
 
 Redistribution and use in source and binary forms, with or without

tests/java/pom.xml

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!--
-Copyright (c) 2020-2024, Sreeni Viswanadha <[email protected]>.
-Copyright (c) 2024, Marc Mazas <[email protected]>.
+Copyright (c) 2020-2025, Sreeni Viswanadha <[email protected]>.
+Copyright (c) 2024-2025, Marc Mazas <[email protected]>.
 All rights reserved.
 
 Redistribution and use in source and binary forms, with or without

tests/pom.xml

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!--
-Copyright (c) 2020-2024, Sreeni Viswanadha <[email protected]>.
-Copyright (c) 2024, Marc Mazas <[email protected]>.
+Copyright (c) 2020-2025, Sreeni Viswanadha <[email protected]>.
+Copyright (c) 2024-2025, Marc Mazas <[email protected]>.
 All rights reserved.
 
 Redistribution and use in source and binary forms, with or without