IO-380 FileUtils.copyInputStreamToFile should document it closes the input source

git-svn-id: https://svn.apache.org/repos/asf/commons/proper/io/trunk@1480284 13f79535-47bb-0310-9956-ffa450edef68

Author: sebbASF

src/main/java/org/apache/commons/io/FileUtils.java

@@ -1497,8 +1497,9 @@ public static void copyURLToFile(final URL source, final File destination,
      * <code>destination</code>. The directories up to <code>destination</code>
      * will be created if they don't already exist. <code>destination</code>
      * will be overwritten if it already exists.
+     * The {@code source} stream is closed.
      *
-     * @param source  the <code>InputStream</code> to copy bytes from, must not be {@code null}
+     * @param source  the <code>InputStream</code> to copy bytes from, must not be {@code null}, will be closed
      * @param destination  the non-directory <code>File</code> to write bytes to
      *  (possibly overwriting), must not be {@code null}
      * @throws IOException if <code>destination</code> is a directory