diff --git a/core/src/main/java/jenkins/model/Jenkins.java b/core/src/main/java/jenkins/model/Jenkins.java
index <HASH>..<HASH> 100755
--- a/core/src/main/java/jenkins/model/Jenkins.java
+++ b/core/src/main/java/jenkins/model/Jenkins.java
@@ -1767,8 +1767,10 @@ public class Jenkins extends AbstractCIBase implements ModifiableItemGroup<TopLe
      * correctly, especially when a migration is involved), but the downside
      * is that unless you are processing a request, this method doesn't work.
      *
-     * Please note that this will not work in all cases if Jenkins is running behind a reverse proxy.
-     * In this case, only the user-configured value from getRootUrl is correct.
+     * Please note that this will not work in all cases if Jenkins is running behind a
+     * reverse proxy (namely when user has switched off ProxyPreserveHost, which is
+     * default setup) and you should use getRootUrl if you want to be sure you reflect
+     * user setup.
      * See https://wiki.jenkins-ci.org/display/JENKINS/Running+Jenkins+behind+Apache
      *
      * @since 1.263
changed text a bit after some discussion with vjuranek