Remind people to use the encoding

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

Author: sebbASF

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

@@ -1761,7 +1761,7 @@ public static String readFileToString(final File file, final String encoding) th
      * @return the file contents, never {@code null}
      * @throws IOException in case of an I/O error
      * @since 1.3.1
-     * @deprecated 2.5 use {@link #readFileToString(File, Charset)} instead
+     * @deprecated 2.5 use {@link #readFileToString(File, Charset)} instead (and specify the appropriate encoding)
      */
     @Deprecated
     public static String readFileToString(final File file) throws IOException {
@@ -1822,7 +1822,7 @@ public static List<String> readLines(final File file, final String encoding) thr
      * @return the list of Strings representing each line in the file, never {@code null}
      * @throws IOException in case of an I/O error
      * @since 1.3
-     * @deprecated 2.5 use {@link #readLines(File, Charset)} instead
+     * @deprecated 2.5 use {@link #readLines(File, Charset)} instead (and specify the appropriate encoding)
      */
     @Deprecated
     public static List<String> readLines(final File file) throws IOException {
@@ -1969,7 +1969,7 @@ public static void writeStringToFile(final File file, final String data, final S
      * @param file the file to write
      * @param data the content to write to the file
      * @throws IOException in case of an I/O error
-     * @deprecated 2.5 use {@link #writeStringToFile(File, String, Charset)} instead
+     * @deprecated 2.5 use {@link #writeStringToFile(File, String, Charset)} instead (and specify the appropriate encoding)
      */
     @Deprecated
     public static void writeStringToFile(final File file, final String data) throws IOException {
@@ -1985,7 +1985,7 @@ public static void writeStringToFile(final File file, final String data) throws
      *               end of the file rather than overwriting
      * @throws IOException in case of an I/O error
      * @since 2.1
-     * @deprecated 2.5 use {@link #writeStringToFile(File, String, Charset, boolean)} instead
+     * @deprecated 2.5 use {@link #writeStringToFile(File, String, Charset, boolean)} instead (and specify the appropriate encoding)
      */
     @Deprecated
     public static void writeStringToFile(final File file, final String data, final boolean append) throws IOException {
@@ -1999,7 +1999,7 @@ public static void writeStringToFile(final File file, final String data, final b
      * @param data the content to write to the file
      * @throws IOException in case of an I/O error
      * @since 2.0
-     * @deprecated 2.5 use {@link #write(File, CharSequence, Charset)} instead
+     * @deprecated 2.5 use {@link #write(File, CharSequence, Charset)} instead (and specify the appropriate encoding)
      */
     @Deprecated
     public static void write(final File file, final CharSequence data) throws IOException {
@@ -2015,7 +2015,7 @@ public static void write(final File file, final CharSequence data) throws IOExce
      *               end of the file rather than overwriting
      * @throws IOException in case of an I/O error
      * @since 2.1
-     * @deprecated 2.5 use {@link #write(File, CharSequence, Charset, boolean)} instead
+     * @deprecated 2.5 use {@link #write(File, CharSequence, Charset, boolean)} instead (and specify the appropriate encoding)
      */
     @Deprecated
     public static void write(final File file, final CharSequence data, final boolean append) throws IOException {