FileSystem Javadocs correct?

[Kevin Clarke]

Hi,

In the Javadocs for FileSystem is says mkdirs(path, handler) will fail if the directory already exists:

http://vertx.io/docs/apidocs/io/vertx/core/file/FileSystem.html#mkdirs-java.lang.String-io.vertx.core.Handler-

It looks like FileSystem's mkdirs is done under the covers by Files.createDirectories:

https://github.com/eclipse/vert.x/blob/master/src/main/java/io/vertx/core/file/impl/FileSystemImpl.java#L631

Files.createDirectories' Javadocs say, though: "Unlike the createDirectory method, an exception is not thrown if the directory could not be created because it already exists."

https://docs.oracle.com/javase/8/docs/api/java/nio/file/Files.html#createDirectories-java.nio.file.Path-java.nio.file.attribute.FileAttribute...-

I think the VertX FileSystem Javadocs should say that mkdirs(path, handler) will fail if the directory exists but is not a directory?

Thanks,

Kevin