diff --git a/kdevplatform/language/backgroundparser/backgroundparser.h b/kdevplatform/language/backgroundparser/backgroundparser.h
--- a/kdevplatform/language/backgroundparser/backgroundparser.h
+++ b/kdevplatform/language/backgroundparser/backgroundparser.h
@@ -143,11 +143,15 @@
 
     /**
      * Suspends execution of the background parser
+     *
+     * NOTE: Only the Core should call this
      */
     void suspend();
 
     /**
      * Resumes execution of the background parser
+     *
+     * NOTE: Only the Core should call this
      */
     void resume();