Merge branch 'v0.10'

[platform/upstream/nodejs.git] / doc / api / fs.markdown

diff --git a/doc/api/fs.markdown b/doc/api/fs.markdown
index 8cc1a3f..3a3e4c9 100644 (file)
--- a/doc/api/fs.markdown
+++ b/doc/api/fs.markdown
@@ -345,6 +345,10 @@ Exclusive mode (`O_EXCL`) ensures that `path` is newly created. `fs.open()`
 fails if a file by that name already exists. On POSIX systems, symlinks are
 not followed. Exclusive mode may or may not work with network file systems.
 
+On Linux, positional writes don't work when the file is opened in append mode.
+The kernel ignores the position argument and always appends the data to
+the end of the file.
+
 ## fs.openSync(path, flags, [mode])
 
 Synchronous open(2).
@@ -387,6 +391,10 @@ Note that it is unsafe to use `fs.write` multiple times on the same file
 without waiting for the callback. For this scenario,
 `fs.createWriteStream` is strongly recommended.
 
+On Linux, positional writes don't work when the file is opened in append mode.
+The kernel ignores the position argument and always appends the data to
+the end of the file.
+
 ## fs.writeSync(fd, buffer, offset, length, position)
 
 Synchronous version of `fs.write()`. Returns the number of bytes written.