diff --git a/javadoc/xdocs/properties.xml b/javadoc/xdocs/properties.xml
index b113230a..3373b231 100644
--- a/javadoc/xdocs/properties.xml
+++ b/javadoc/xdocs/properties.xml
@@ -189,8 +189,9 @@ tag1.scope=all
 tag2.name=task
 tag2.description=Task:
 tag2.enabled=false
-tag2.scope=all
-            ]]></source>
+tag2.scope=all]]></source>
+            <strong>Note</strong>: Due to a bug in the jexl expression evaluator,
+            custom tag names defined by this property cannot contain dashes.
           </td>
         </tr>
         <tr>