--- a/snpEff_macros.xml	Mon Nov 18 22:15:18 2024 +0000
+++ b/snpEff_macros.xml	Sat Oct 04 17:00:46 2025 +0000
@@ -1,7 +1,19 @@
 <macros>
+  <!-- TOKENS TO BE UPDATED -->
   <token name="@TOOL_VERSION@">5.2</token>
-  <token name="@VERSION_SUFFIX@">0</token>
+  <token name="@VERSION_SUFFIX@">1</token>
   <token name="@SNPEFF_VERSION@">SnpEff5.2</token>
+  <!-- SnpEff versions are usually backwards compatible with a few older database versions.
+  The authoritative place to look up the compatibility scheme is DATABASE_COMPATIBLE_VERSIONS in Config.java of the upstream code.
+  Currently this would be:
+  https://github.com/pcingola/SnpEff/blob/master/src/main/java/org/snpeff/snpEffect/Config.java#L37-L52
+
+  The three following tokens define the list of compatible DB versions for the wrapper (for input validation), a human-readable string (for parameter help/labels) and a regex of the same versions (for filtering of data table records). -->
+  <token name="@COMPATIBLE_DB_VERSIONS@">['SnpEff5.0', 'SnpEff5.1', 'SnpEff5.2']</token>
+  <token name="@COMPATIBLE_DB_VERSIONS_STRING@">SnpEff 5.0 - 5.2</token>
+  <token name="@COMPATIBLE_DB_VERSIONS_REGEX@"><![CDATA[^SnpEff5\.[0-2]$]]></token>
+  <!-- End of TOKENS TO BE UPDATED -->
+
   <xml name="requirement">
       <requirement type="package" version="@TOOL_VERSION@">snpeff</requirement>
       <yield/>