From 230745c8d07eb04970679c61e4399cbf100060a1 Mon Sep 17 00:00:00 2001
From: Bartosz Sosnowski <bartosz@janeasystems.com>
Date: Fri, 26 May 2017 12:30:46 +0200
Subject: [PATCH 1/2] win, doc: document per-drive current working dir

Add note to fs.md and path.md about Windows using per-drive current
working directory.

Fixes: https://github.com/nodejs/node/issues/9378
---
 doc/api/fs.md   | 7 +++++++
 doc/api/path.md | 6 ++++++
 2 files changed, 13 insertions(+)

diff --git a/doc/api/fs.md b/doc/api/fs.md
index 9ee328e6523218..c962168a71465e 100644
--- a/doc/api/fs.md
+++ b/doc/api/fs.md
@@ -94,6 +94,12 @@ Error: EISDIR: illegal operation on a directory, read
     <stack trace.>
 ```
 
+*Note:* On Windows Node follows the concept of per-drive working directory.
+This behavior can be observed when using a drive path without backslash, e.g.
+`fs.readdirSync('c:\\')` can potentially return different result than
+`fs.readdirSync('c:')`. For more information see
+[this MSDN page][MSDN-Rel-Path].
+
 ## WHATWG URL object support
 <!-- YAML
 added: v7.6.0
@@ -2835,6 +2841,7 @@ The following constants are meant for use with the [`fs.Stats`][] object's
 [FS Constants]: #fs_fs_constants_1
 [MDN-Date-getTime]: https://developer.mozilla.org/en/JavaScript/Reference/Global_Objects/Date/getTime
 [MDN-Date]: https://developer.mozilla.org/en/JavaScript/Reference/Global_Objects/Date
+[MSDN-Rel-Path]: https://msdn.microsoft.com/en-us/library/windows/desktop/aa365247.aspx#fully_qualified_vs._relative_paths
 [Readable Stream]: stream.html#stream_class_stream_readable
 [Writable Stream]: stream.html#stream_class_stream_writable
 [inode]: https://en.wikipedia.org/wiki/Inode
diff --git a/doc/api/path.md b/doc/api/path.md
index cf096ef9851475..6546f6f5b58dbc 100644
--- a/doc/api/path.md
+++ b/doc/api/path.md
@@ -54,6 +54,11 @@ path.posix.basename('/tmp/myfile.html');
 // Returns: 'myfile.html'
 ```
 
+*Note:* On Windows Node follows the concept of per-drive working directory.
+This behavior can be observed when using a drive path without backslash, e.g.
+`path.resolve('c:\\')` can potentially return different result than
+`path.resolve('c:')`. For more information see [this MSDN page][MSDN-Rel-Path].
+
 ## path.basename(path[, ext])
 <!-- YAML
 added: v0.1.25
@@ -550,3 +555,4 @@ of the `path` methods.
 [`path.posix`]: #path_path_posix
 [`path.sep`]: #path_path_sep
 [`path.win32`]: #path_path_win32
+[MSDN-Rel-Path]: https://msdn.microsoft.com/en-us/library/windows/desktop/aa365247.aspx#fully_qualified_vs._relative_paths

From e655d7ecb8a52706309aa75b7bf908a5d3f90c22 Mon Sep 17 00:00:00 2001
From: Bartosz Sosnowski <bartosz@janeasystems.com>
Date: Thu, 1 Jun 2017 10:45:15 +0200
Subject: [PATCH 2/2] fixup: nits

---
 doc/api/fs.md   | 8 ++++----
 doc/api/path.md | 9 +++++----
 2 files changed, 9 insertions(+), 8 deletions(-)

diff --git a/doc/api/fs.md b/doc/api/fs.md
index c962168a71465e..f146918c7421ca 100644
--- a/doc/api/fs.md
+++ b/doc/api/fs.md
@@ -94,10 +94,10 @@ Error: EISDIR: illegal operation on a directory, read
     <stack trace.>
 ```
 
-*Note:* On Windows Node follows the concept of per-drive working directory.
-This behavior can be observed when using a drive path without backslash, e.g.
-`fs.readdirSync('c:\\')` can potentially return different result than
-`fs.readdirSync('c:')`. For more information see
+*Note:* On Windows Node.js follows the concept of per-drive working directory.
+This behavior can be observed when using a drive path without a backslash. For
+example `fs.readdirSync('c:\\')` can potentially return a different result than
+`fs.readdirSync('c:')`. For more information, see
 [this MSDN page][MSDN-Rel-Path].
 
 ## WHATWG URL object support
diff --git a/doc/api/path.md b/doc/api/path.md
index 6546f6f5b58dbc..0bc6c88ded3b24 100644
--- a/doc/api/path.md
+++ b/doc/api/path.md
@@ -54,10 +54,11 @@ path.posix.basename('/tmp/myfile.html');
 // Returns: 'myfile.html'
 ```
 
-*Note:* On Windows Node follows the concept of per-drive working directory.
-This behavior can be observed when using a drive path without backslash, e.g.
-`path.resolve('c:\\')` can potentially return different result than
-`path.resolve('c:')`. For more information see [this MSDN page][MSDN-Rel-Path].
+*Note:* On Windows Node.js follows the concept of per-drive working directory.
+This behavior can be observed when using a drive path without a backslash. For
+example `path.resolve('c:\\')` can potentially return a different result than
+`path.resolve('c:')`. For more information, see
+[this MSDN page][MSDN-Rel-Path].
 
 ## path.basename(path[, ext])
 <!-- YAML