diff --git a/src/plugins/cmakeprojectmanager/cmakehighlighter.h b/src/plugins/cmakeprojectmanager/cmakehighlighter.h
index ff3b6c6db85..dce5acf0579 100644
--- a/src/plugins/cmakeprojectmanager/cmakehighlighter.h
+++ b/src/plugins/cmakeprojectmanager/cmakehighlighter.h
@@ -37,6 +37,9 @@
 namespace CMakeProjectManager {
 namespace Internal {
 
+/* This is a simple syntax highlighter for CMake files.
+ * It highlights variables, commands, strings and comments.
+ * Multi-line strings and variables inside strings are also recognized. */
 class CMakeHighlighter : public QSyntaxHighlighter
 {
     Q_OBJECT