--- old/src/jdk.zipfs/share/classes/module-info.java	2019-02-08 16:06:14.360100900 +0100
+++ new/src/jdk.zipfs/share/classes/module-info.java	2019-02-08 16:06:13.419132100 +0100
@@ -41,6 +41,31 @@
  *
  * The URI {@link java.net.URI#getScheme scheme} that identifies the ZIP file system is {@code jar}.
  *
+ * <h3>Posix Support</h3>
+ *
+ * File systems created by the Zip file system provider have a built in support
+ * for POSIX permissions. It is possible to query a Path object inside a Zip
+ * file for the attribute {@code storedPermissions}. The value of the attribute
+ * will be of type {@link java.util.Set}&lt;
+ * {@link java.nio.file.attribute.PosixFilePermission}&gt;. As POSIX permission
+ * information is optional for a Zip entry, the attribute value will be
+ * {@code null} in case no permission information exists in the Zip file.
+ *
+ * For extended POSIX support, allowing to use
+ * {@link java.nio.file.attribute.PosixFileAttributeView} and taking advantage
+ * of {@link java.nio.file.Files#setPosixFilePermissions} or
+ * {@link java.nio.file.Files#getPosixFilePermissions}, it is possible to create
+ * a Zip file system with the property {@code posix} set to {@code true}
+ * In that case, certain defaults apply. The owner of a file will be set to a
+ * UserPrincipal with its name set to the value of
+ * {@code System.getProperty("user.name")}. The group will have the name
+ * {@code &lt;zipfs_default&gt;}. The default for POSIX permissions, in case
+ * no data is associated with the zip file entry, will be a Set containing
+ * {@link java.nio.file.attribute.PosixFilePermission#OWNER_READ},
+ * {@link java.nio.file.attribute.PosixFilePermission#OWNER_WRITE} and
+ * {@link java.nio.file.attribute.PosixFilePermission#GROUP_READ}.
+ * It is possible to override the defaults using the properties specified below.
+ *
  * <h3>Zip File System Properties</h3>
  *
  * The following properties may be specified when creating a Zip
@@ -79,6 +104,45 @@
  *       names of the entries in the Zip or JAR file.
  *   </td>
  * </tr>
+ * <tr>
+ *   <td scope="row">posix</td>
+ *   <td>java.lang.Boolean</td>
+ *   <td>false</td>
+ *   <td>
+ *       If the value is {@code true}, the created Zip file system will support
+ *       the {@link java.nio.file.attribute.PosixFileAttributeView}.
+ *   </td>
+ * </tr>
+ * <tr>
+ *   <td scope="row">defaultOwner</td>
+ *   <td>java.nio.file.attribute.UserPrincipal</td>
+ *   <td>A user principal with its name set to the value of System property
+ *       "{@code user.name}"</td>
+ *   <td>
+ *       This value will override the default value for owner, in case the Zip
+ *       file system is created with option {@code posix=true}.
+ *   </td>
+ * </tr>
+ * <tr>
+ *   <td scope="row">defaultGroup</td>
+ *   <td>java.nio.file.attribute.GroupPrincipal</td>
+ *   <td>A group principal with its name set to {@code &lt;zipfs_default&gt;}</td>
+ *   <td>
+ *       This value will override the default value for group, in case the Zip
+ *       file system is created with option {@code posix=true}.
+ *   </td>
+ * </tr>
+ * <tr>
+ *   <td scope="row">defaultPermissions</td>
+ *   <td>java.util.Set<java.nio.file.attribute.PosixPermission></td>
+ *   <td>A set of {@code PosixFilePermission#OWNER_READ},
+ *       {@code PosixFilePermission#OWNER_WRITE} and
+ *       {@code PosixFilePermission#GROUP_READ}</td>
+ *   <td>
+ *       This value will override the default value for permissions, in case the Zip
+ *       file system is created with option {@code posix=true}.
+ *   </td>
+ * </tr>
  * </tbody>
  * </table>
  *