Github user albertshau commented on a diff in the pull request: https://github.com/apache/twill/pull/3#discussion_r76164602 --- Diff: twill-common/src/main/java/org/apache/twill/filesystem/Location.java --- @@ -53,11 +54,42 @@ * Atomically creates a new, empty file named by this abstract pathname if and only if a file with this name * does not yet exist. * @return {@code true} if the file is successfully create, {@code false} otherwise. - * @throws IOException + * @throws IOException if error encountered during creationg of the file */ boolean createNew() throws IOException; /** + * Atomically creates a new, empty file named by this abstract pathname if and only if a file with this name + * does not yet exist. The newly created file will have permission set based on the given permission settings. + * + * @param permission A permission string. It has to be either a three digits or a nine characters string. + * For the three digits string, it is similar to the UNIX permission numeric representation. --- End diff -- three digits -> three digit
--- If your project is set up for it, you can reply to this email and have your reply appear on GitHub as well. If your project does not have this feature enabled and wishes so, or if the feature is enabled but not working, please contact infrastructure at infrastruct...@apache.org or file a JIRA ticket with INFRA. ---