diff --git a/platform/core-api/src/com/intellij/openapi/project/DumbService.java b/platform/core-api/src/com/intellij/openapi/project/DumbService.java
index 26f955de1df6..fb69810fb540 100644
--- a/platform/core-api/src/com/intellij/openapi/project/DumbService.java
+++ b/platform/core-api/src/com/intellij/openapi/project/DumbService.java
@@ -64,8 +64,12 @@ public abstract class DumbService {
   }
 
   /**
-   * Executes the runnable immediately if the project is initialized and there's no dumb mode in progress,
-   * or on AWT Event Dispatch thread after the dumb mode ends.
+   * Executes the runnable as soon as possible on AWT Event Dispatch when:
+   * <ul>
+   *   <li>project is initialized</li>
+   *   <li>and there's no dumb mode in progress</li>
+   * </ul>
+   * This may also happen immediately if these conditions are already met.<p/>
    * Note that it's not guaranteed that the dumb mode won't start again during this runnable execution, it should manage that situation explicitly
    * (e.g. by starting a read action; it's still necessary to check isDumb inside the read action).
    * @param runnable runnable to run
diff --git a/platform/core-api/src/com/intellij/openapi/startup/StartupManager.java b/platform/core-api/src/com/intellij/openapi/startup/StartupManager.java
index d10daf9095a0..f1732829feea 100644
--- a/platform/core-api/src/com/intellij/openapi/startup/StartupManager.java
+++ b/platform/core-api/src/com/intellij/openapi/startup/StartupManager.java
@@ -54,8 +54,8 @@ public abstract class StartupManager {
   public abstract void registerPostStartupActivity(@NotNull Runnable runnable);
 
   /**
-   * Executes the specified runnable immediately if the initialization of the current project
-   * is complete, or registers it as a post-startup activity if the project is being initialized. In the latter case, the runnable will be executed later on AWT thread in a non-modal state.
+   * Executes the specified runnable immediately if invoked from AWT thread and the initialization of the current project
+   * is complete. Otherwise registers it as a post-startup activity. In the latter case, the runnable will be executed later on AWT thread in a non-modal state.
    *
    * @param runnable the activity to execute.
    * @see com.intellij.openapi.application.ModalityState