diff --git a/src/jdk.zipfs/share/classes/module-info.java b/src/jdk.zipfs/share/classes/module-info.java
index db7ae3eec81..0716fdf8266 100644
--- a/src/jdk.zipfs/share/classes/module-info.java
+++ b/src/jdk.zipfs/share/classes/module-info.java
@@ -149,12 +149,52 @@ import java.util.Set;
*
*
*
+ * accessMode |
+ * {@link java.lang.String} |
+ * null/unset |
+ *
+ * A value defining the desired access mode of the file system.
+ * ZIP file systems can be created to allow for read-write or
+ * read-only access.
+ *
+ * -
+ * If no value is set, the file system is created as read-write
+ * if possible. Use {@link java.nio.file.FileSystem#isReadOnly()
+ * isReadOnly()} to determine the actual access mode.
+ *
+ * -
+ * If the value is {@code "readOnly"}, the file system is created
+ * read-only, and {@link java.nio.file.FileSystem#isReadOnly()
+ * isReadOnly()} will always return {@code true}. Creating a
+ * read-only file system requires the underlying ZIP file to
+ * already exist.
+ *
+ * -
+ * If the value is {@code "readWrite"}, the file system is created
+ * read-write, and {@link java.nio.file.FileSystem#isReadOnly()
+ * isReadOnly()} will always return {@code false}. If a writable file
+ * system cannot be created, an {@code IOException} will be thrown
+ * when creating the ZIP file system.
+ *
+ * -
+ * Any other values will cause an {@code IllegalArgumentException}
+ * to be thrown when creating the ZIP file system.
+ *
+ *
+ * The {@code accessMode} property has no effect on reported POSIX file
+ * permissions (in cases where POSIX support is enabled).
+ * |
+ *
+ *
* create |
* {@link java.lang.String} or {@link java.lang.Boolean} |
* false |
*
* If the value is {@code true}, the ZIP file system provider creates a
- * new ZIP or JAR file if it does not exist.
+ * new ZIP or JAR file if it does not exist. Specifying the {@code create}
+ * property as {@code true} with the {@code accessMode} as {@code "readOnly"}
+ * will cause an {@code IllegalArgumentException} to be thrown when creating
+ * the ZIP file system.
* |
*
*
@@ -266,47 +306,6 @@ import java.util.Set;
*
*
*
- *
- * accessMode |
- * {@link java.lang.String} |
- * null/unset |
- *
- * A value defining the desired access mode of the file system.
- * ZIP file systems can be created to allow for read-write or
- * read-only access.
- *
- * -
- * If no value is set, the file system is created as read-write
- * if possible. Use {@link java.nio.file.FileSystem#isReadOnly()
- * isReadOnly()} to determine the actual access mode.
- *
- * -
- * If the value is {@code "readOnly"}, the file system is created
- * read-only, and {@link java.nio.file.FileSystem#isReadOnly()
- * isReadOnly()} will always return {@code true}. Creating a
- * read-only file system requires the underlying ZIP file to
- * already exist.
- * Specifying the {@code create} property as {@code true} with the
- * {@code accessMode} as {@code readOnly} will cause an {@code
- * IllegalArgumentException} to be thrown when creating the ZIP file
- * system.
- *
- * -
- * If the value is {@code "readWrite"}, the file system is created
- * read-write, and {@link java.nio.file.FileSystem#isReadOnly()
- * isReadOnly()} will always return {@code false}. If a writable file
- * system cannot be created, an {@code IOException} will be thrown
- * when creating the ZIP file system.
- *
- * -
- * Any other values will cause an {@code IllegalArgumentException}
- * to be thrown when creating the ZIP file system.
- *
- *
- * The {@code accessMode} property has no effect on reported POSIX file
- * permissions (in cases where POSIX support is enabled).
- * |
- *
*
*
*