diff --git a/platform/code-style-api/src/com/intellij/openapi/editor/LanguageLineWrapPositionStrategy.java b/platform/code-style-api/src/com/intellij/openapi/editor/LanguageLineWrapPositionStrategy.java
index 83b711524eda..0601e7dd7886 100644
--- a/platform/code-style-api/src/com/intellij/openapi/editor/LanguageLineWrapPositionStrategy.java
+++ b/platform/code-style-api/src/com/intellij/openapi/editor/LanguageLineWrapPositionStrategy.java
@@ -13,6 +13,12 @@ import org.jetbrains.annotations.NotNull;
 
 /**
  * Exposes {@link LineWrapPositionStrategy} implementations to their clients.
+ * <p>
+ * Using this extension, you can specify the line wrapping strategy only for those editors
+ * that are bound to some PSI file with the language.
+ * If you need to specify the strategy for the editor that is not bound to the PSI file,
+ * please use {@link com.intellij.openapi.editor.impl.softwrap.mapping.SoftWrapApplianceManager#setLineWrapPositionStrategy(LineWrapPositionStrategy) SoftWrapApplianceManager#setLineWrapPositionStrategy}
+ * </p>
  */
 public final class LanguageLineWrapPositionStrategy extends LanguageExtension<LineWrapPositionStrategy> {
 
@@ -26,6 +32,7 @@ public final class LanguageLineWrapPositionStrategy extends LanguageExtension<Li
 
   /**
    * Asks to get wrap position strategy to use for the document managed by the given editor.
+   * The strategy is determined based on the editor's PSI file language.
    *
    * @param editor    editor that manages document which text should be processed by wrap position strategy
    * @return          line wrap position strategy to use for the lines from the document managed by the given editor
diff --git a/platform/platform-impl/src/com/intellij/openapi/editor/impl/softwrap/mapping/SoftWrapApplianceManager.java b/platform/platform-impl/src/com/intellij/openapi/editor/impl/softwrap/mapping/SoftWrapApplianceManager.java
index 8547be90ec3c..128069990a4d 100644
--- a/platform/platform-impl/src/com/intellij/openapi/editor/impl/softwrap/mapping/SoftWrapApplianceManager.java
+++ b/platform/platform-impl/src/com/intellij/openapi/editor/impl/softwrap/mapping/SoftWrapApplianceManager.java
@@ -469,6 +469,7 @@ public final class SoftWrapApplianceManager implements Dumpable {
    * By default, line wrap strategy depends on the editor's file language
    * and can be provided using {@link LanguageLineWrapPositionStrategy}.
    * This method can be used to specify the strategy for the Editor that is not bound to any particular file.
+   * Note that the strategy set using this method takes precedence over one provided using {@link LanguageLineWrapPositionStrategy}.
    */
   public void setLineWrapPositionStrategy(@NotNull LineWrapPositionStrategy strategy) {
     myLineWrapPositionStrategy = strategy;