nodejs
diff --git a/Collapse file
‎doc/api/fs.markdown‎
Copy file name to clipboardExpand all lines: doc/api/fs.markdown
+12Lines changed: 12 additions & 0 deletions
Display the source diff
Display the rich diff b/Collapse file
‎doc/api/fs.markdown‎
Copy file name to clipboardExpand all lines: doc/api/fs.markdown
+12Lines changed: 12 additions & 0 deletions
Display the source diff
Display the rich diff
@@ -94,6 +94,18 @@ Error: EISDIR, read
     <etc.>
 ```
 
+## Buffer API
+
+`fs` functions support passing and receiving paths as both strings
+and Buffers. The latter is intended to make it possible to work with
+filesystems that allow for non-UTF-8 filenames. For most typical
+uses, working with paths as Buffers will be unnecessary, as the string
+API converts to and from UTF-8 automatically.
+
+*Note* that on certain file systems (such as NTFS and HFS+) filenames
+will always be encoded as UTF-8. On such file systems, passing
+non-UTF-8 encoded Buffers to `fs` functions will not work as expected.
+
 ## Class: fs.FSWatcher
 
 Objects returned from `fs.watch()` are of this type.