@@ -4,8 +4,15 @@
   ~ lexi hale <lexi@hale.su>
   © AGPLv3
   ? Kate/kwrite-compatible syntax definition for the cortav markup format
   > ln cortav.xml $HOME/.local/share/org.kde.syntax-highlighting/syntax/
+  ! NOTE: the Kate syntax engine cannot capture all the syntactic properties
+          of Cortav. we do the best we can, but note the following important
+          discrepancies:
+
+            1) the inline resource syntax allows a wide range of complex
+               brackets pairs such as <!--:[ ]:--!>; the Kate syntax only
+               accounts for the pair { }
 -->
 <language name='Cortav' version='1' kateversion='2.4' section='Markup' extensions='*.ct'>
 	<highlighting>
 		<list name='extension-directives'>