diff --git a/doc/api/fs.md b/doc/api/fs.md index 73dcf213e3fe43..3b7cdf33d77fd5 100644 --- a/doc/api/fs.md +++ b/doc/api/fs.md @@ -1268,6 +1268,14 @@ fs.open('', 'a+', (err, fd) => { }); ``` +Some characters (`< > : " / \ | ? *`) are reserved under Windows as documented +by [Naming Files, Paths, and Namespaces][]. Under NTFS, if the filename contains +a colon, Node.js will open a file system stream, as described by +[this MSDN page][MSDN-Using-Streams]. + +Functions based on `fs.open()` exhibit this behavior as well. eg. +`fs.writeFile()`, `fs.readFile()`, etc. + ## fs.openSync(path, flags[, mode])