--- a/AbstractSyntaxHighlighter.st	Sat Oct 21 13:33:04 2017 +0200
+++ b/AbstractSyntaxHighlighter.st	Sat Oct 21 13:42:51 2017 +0200
@@ -47,6 +47,12 @@
     called by the parser whenever an interesting syntactic construct is encountered.
     These methods are no-ops in the Parser class, but redefined here to update
     the colorization of sourceText.
+
+    Caveat:
+        used to be a smalltalk syntax highlighter and therefore (wrongly) subclassed Parser.
+        However, over time, much functionality was added, which is of use for other languages also
+        and this class will therefore be changed to use composition and have parsing delegated.
+        to be independent of the language and to not inherit stuff, which is not needed.
 "
 ! !