doc: mention that mode is ignored if file exists

jasnell · jasnell · commit 1b027eedb931 · 2015-06-26T07:54:05.000-07:00
per: #6847 Reviewed-By: James M Snell <jasnell@gmail.com> PR-URL: #25565
diff --git a/doc/api/fs.markdown b/doc/api/fs.markdown
@@ -797,6 +797,9 @@ there's no file descriptor leak.  If `autoClose` is set to true (default
 behavior), on `error` or `end` the file descriptor will be closed
 automatically.
 
+`mode` sets the file mode (permission and sticky bits), but only if the
+file was created.
+
 An example to read the last 10 bytes of a file which is 100 bytes long:
 
     fs.createReadStream('sample.txt', {start: 90, end: 99});
