diff --git a/core/src/main/java/hudson/FilePath.java b/core/src/main/java/hudson/FilePath.java
index 80dec77b0d53..00d453f794d4 100644
--- a/core/src/main/java/hudson/FilePath.java
+++ b/core/src/main/java/hudson/FilePath.java
@@ -963,9 +963,10 @@ private final class Unpack extends MasterToSlaveFileCallable<Void> {
     }
 
     /**
-     * Reads the URL on the current VM, and writes all the data to this {@link FilePath}
-     * (this is different from resolving URL remotely.)
-     *
+     * Reads the URL on the current VM, and streams the data to this file using the Remoting channel.
+     * <p>This is different from resolving URL remotely.
+     * If you instead wished to open an HTTP(S) URL on the remote side,
+     * prefer <a href="http://javadoc.jenkins.io/plugin/apache-httpcomponents-client-4-api/io/jenkins/plugins/httpclient/RobustHTTPClient.html#copyFromRemotely-hudson.FilePath-java.net.URL-hudson.model.TaskListener-">{@code RobustHTTPClient.copyFromRemotely}</a>.
      * @since 1.293
      */
     public void copyFrom(URL url) throws IOException, InterruptedException {
diff --git a/core/src/main/java/jenkins/util/VirtualFile.java b/core/src/main/java/jenkins/util/VirtualFile.java
index b8491df1309f..3db7461a93e1 100644
--- a/core/src/main/java/jenkins/util/VirtualFile.java
+++ b/core/src/main/java/jenkins/util/VirtualFile.java
@@ -337,8 +337,7 @@ public <V> V run(Callable<V,IOException> callable) throws IOException {
      * Optionally obtains a URL which may be used to retrieve file contents from any process on any node.
      * For example, given cloud storage this might produce a permalink to the file.
      * <p>Only {@code http} and {@code https} protocols are permitted.
-     * It is recommended to use the {@code RobustHTTPClient.downloadFile} utility method
-     * from the {@code apache-httpcomponents-client-4-api} plugin to work with these URLs.
+     * It is recommended to use <a href="http://javadoc.jenkins.io/plugin/apache-httpcomponents-client-4-api/io/jenkins/plugins/httpclient/RobustHTTPClient.html#downloadFile-java.io.File-java.net.URL-hudson.model.TaskListener-">{@code RobustHTTPClient.downloadFile}</a> to work with these URLs.
      * <p>This is only meaningful for {@link #isFile}:
      * no ZIP etc. archiving protocol is defined to allow bulk access to directory trees.
      * <p>Any necessary authentication must be encoded somehow into the URL itself;