[IO-804] FileUtils.forceMkdirParent api doc is likely incorrect

Author: garydgregory

src/changes/changes.xml

@@ -65,6 +65,9 @@ The <action> type attribute can be add,update,fix,remove.
       <action dev="ggregory" type="fix" issue="IO-799" due-to="Jeroen van der Vegt, Gary Gregory">
         ReaderInputStream.read() throws an exception instead of returning -1 when called again after returning -1.
       </action>
+      <action dev="ggregory" type="fix" issue="IO-804" due-to="Elliotte Rusty Harold, Gary Gregory">
+        FileUtils.forceMkdirParent() Javadoc is likely incorrect.
+      </action>
       <!-- UPDATE -->
     </release>    
     <release version="2.13.0" date="2023-06-03" description="Java 8 required.">

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

@@ -1381,16 +1381,15 @@ public static void forceMkdir(final File directory) throws IOException {
     }
 
     /**
-     * Calls {@link File#mkdirs()} and throws an {@link IOException} on failure.
+     * Creates all directories for a File object, including any necessary but nonexistent parent directories. If the parent directory already exists or is null,
+     * nothing happens.
      * <p>
-     * Creates all directories for a File object, including any necessary but nonexistent parent directories. If the {@code directory} already exists or is
-     * null, nothing happens.
+     * Calls {@link File#mkdirs()} for the parent of @{code file}.
      * </p>
      *
      * @param file file with parents to create, must not be {@code null}.
      * @throws NullPointerException if the file is {@code null}.
      * @throws IOException          if the directory was not created along with all its parent directories.
-     * @throws IOException          if the given file object is not a directory.
      * @throws SecurityException    See {@link File#mkdirs()}.
      * @see File#mkdirs()
      * @since 2.5