diff --git a/doc/api/fs.md b/doc/api/fs.md index 8e6df978af6dd7..46b61f00127e0a 100644 --- a/doc/api/fs.md +++ b/doc/api/fs.md @@ -1587,6 +1587,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])