From e4a8d56a0b01733d02a6c3371dee3cdbb0a73a45 Mon Sep 17 00:00:00 2001
From: kibertoad <iselwin@gmail.com>
Date: Wed, 6 Jul 2016 15:12:58 +0300
Subject: [PATCH 1/5] refs #7560 Clarify "fs.readFile", "fs.appendFile",
 "fs.writeFile" documentation regarding closing.

---
 doc/api/fs.md | 12 +++++++++---
 1 file changed, 9 insertions(+), 3 deletions(-)

diff --git a/doc/api/fs.md b/doc/api/fs.md
index 022fa0d2cf2732..448fd629ce0c64 100644
--- a/doc/api/fs.md
+++ b/doc/api/fs.md
@@ -378,7 +378,9 @@ fs.appendFile('message.txt', 'data to append', 'utf8', callback);
 
 Any specified file descriptor has to have been opened for appending.
 
-_Note: Specified file descriptors will not be closed automatically._
+_Note: If a file descriptor is specified as the 'file', it will not be closed automatically._
+
+_Note: If a filename is specified as the 'file', internally opened file descriptor will be closed automatically._
 
 ## fs.appendFileSync(file, data[, options])
 <!-- YAML
@@ -1130,7 +1132,9 @@ fs.readFile('/etc/passwd', 'utf8', callback);
 
 Any specified file descriptor has to support reading.
 
-_Note: Specified file descriptors will not be closed automatically._
+_Note: If a file descriptor is specified as the 'file', it will not be closed automatically._
+
+_Note: If a filename is specified as the 'file', internally opened file descriptor will be closed automatically._
 
 ## fs.readFileSync(file[, options])
 <!-- YAML
@@ -1662,7 +1666,9 @@ Note that it is unsafe to use `fs.writeFile` multiple times on the same file
 without waiting for the callback. For this scenario,
 `fs.createWriteStream` is strongly recommended.
 
-_Note: Specified file descriptors will not be closed automatically._
+_Note: If a file descriptor is specified as the 'file', it will not be closed automatically._
+
+_Note: If a filename is specified as the 'file', internally opened file descriptor will be closed automatically._
 
 ## fs.writeFileSync(file, data[, options])
 <!-- YAML

From a851058b4e07e8dd95646901dccaf6eccb08c0f2 Mon Sep 17 00:00:00 2001
From: kibertoad <iselwin@gmail.com>
Date: Wed, 6 Jul 2016 17:06:46 +0300
Subject: [PATCH 2/5] refs #7560 Use backticks instead of single quotes.

---
 doc/api/fs.md | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/doc/api/fs.md b/doc/api/fs.md
index 448fd629ce0c64..0bd2913725b656 100644
--- a/doc/api/fs.md
+++ b/doc/api/fs.md
@@ -378,9 +378,9 @@ fs.appendFile('message.txt', 'data to append', 'utf8', callback);
 
 Any specified file descriptor has to have been opened for appending.
 
-_Note: If a file descriptor is specified as the 'file', it will not be closed automatically._
+_Note: If a file descriptor is specified as the `file`, it will not be closed automatically._
 
-_Note: If a filename is specified as the 'file', internally opened file descriptor will be closed automatically._
+_Note: If a filename is specified as the `file`, internally opened file descriptor will be closed automatically._
 
 ## fs.appendFileSync(file, data[, options])
 <!-- YAML
@@ -1132,9 +1132,9 @@ fs.readFile('/etc/passwd', 'utf8', callback);
 
 Any specified file descriptor has to support reading.
 
-_Note: If a file descriptor is specified as the 'file', it will not be closed automatically._
+_Note: If a file descriptor is specified as the `file`, it will not be closed automatically._
 
-_Note: If a filename is specified as the 'file', internally opened file descriptor will be closed automatically._
+_Note: If a filename is specified as the `file`, internally opened file descriptor will be closed automatically._
 
 ## fs.readFileSync(file[, options])
 <!-- YAML
@@ -1666,9 +1666,9 @@ Note that it is unsafe to use `fs.writeFile` multiple times on the same file
 without waiting for the callback. For this scenario,
 `fs.createWriteStream` is strongly recommended.
 
-_Note: If a file descriptor is specified as the 'file', it will not be closed automatically._
+_Note: If a file descriptor is specified as the `file`, it will not be closed automatically._
 
-_Note: If a filename is specified as the 'file', internally opened file descriptor will be closed automatically._
+_Note: If a filename is specified as the `file`, internally opened file descriptor will be closed automatically._
 
 ## fs.writeFileSync(file, data[, options])
 <!-- YAML

From 40a57503907e4092004b69f229287a8e209dd078 Mon Sep 17 00:00:00 2001
From: kibertoad <iselwin@gmail.com>
Date: Wed, 6 Jul 2016 19:44:49 +0300
Subject: [PATCH 3/5] refs #7560 Merge two notes, wrap at 80 symbols.

---
 doc/api/fs.md | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/doc/api/fs.md b/doc/api/fs.md
index 0bd2913725b656..f2bcb6d64aa8a0 100644
--- a/doc/api/fs.md
+++ b/doc/api/fs.md
@@ -378,9 +378,9 @@ fs.appendFile('message.txt', 'data to append', 'utf8', callback);
 
 Any specified file descriptor has to have been opened for appending.
 
-_Note: If a file descriptor is specified as the `file`, it will not be closed automatically._
-
-_Note: If a filename is specified as the `file`, internally opened file descriptor will be closed automatically._
+_Note: If a file descriptor is specified as the `file`, it will not be closed 
+automatically. If a filename is specified as the `file`, internally opened 
+file descriptor will be closed automatically._
 
 ## fs.appendFileSync(file, data[, options])
 <!-- YAML
@@ -1132,9 +1132,9 @@ fs.readFile('/etc/passwd', 'utf8', callback);
 
 Any specified file descriptor has to support reading.
 
-_Note: If a file descriptor is specified as the `file`, it will not be closed automatically._
-
-_Note: If a filename is specified as the `file`, internally opened file descriptor will be closed automatically._
+_Note: If a file descriptor is specified as the `file`, it will not be closed 
+automatically. If a filename is specified as the `file`, internally opened 
+file descriptor will be closed automatically._
 
 ## fs.readFileSync(file[, options])
 <!-- YAML
@@ -1666,9 +1666,9 @@ Note that it is unsafe to use `fs.writeFile` multiple times on the same file
 without waiting for the callback. For this scenario,
 `fs.createWriteStream` is strongly recommended.
 
-_Note: If a file descriptor is specified as the `file`, it will not be closed automatically._
-
-_Note: If a filename is specified as the `file`, internally opened file descriptor will be closed automatically._
+_Note: If a file descriptor is specified as the `file`, it will not be closed 
+automatically. If a filename is specified as the `file`, internally opened 
+file descriptor will be closed automatically._
 
 ## fs.writeFileSync(file, data[, options])
 <!-- YAML

From 7e617e06ffc89590a2347fc7720487eb72360283 Mon Sep 17 00:00:00 2001
From: kibertoad <iselwin@gmail.com>
Date: Sun, 10 Jul 2016 01:40:17 +0300
Subject: [PATCH 4/5] refs #7560 Add missing "the".

---
 doc/api/fs.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/doc/api/fs.md b/doc/api/fs.md
index f2bcb6d64aa8a0..d60603d9f8800b 100644
--- a/doc/api/fs.md
+++ b/doc/api/fs.md
@@ -379,7 +379,7 @@ fs.appendFile('message.txt', 'data to append', 'utf8', callback);
 Any specified file descriptor has to have been opened for appending.
 
 _Note: If a file descriptor is specified as the `file`, it will not be closed 
-automatically. If a filename is specified as the `file`, internally opened 
+automatically. If a filename is specified as the `file`, the internally opened 
 file descriptor will be closed automatically._
 
 ## fs.appendFileSync(file, data[, options])
@@ -1133,7 +1133,7 @@ fs.readFile('/etc/passwd', 'utf8', callback);
 Any specified file descriptor has to support reading.
 
 _Note: If a file descriptor is specified as the `file`, it will not be closed 
-automatically. If a filename is specified as the `file`, internally opened 
+automatically. If a filename is specified as the `file`, the internally opened 
 file descriptor will be closed automatically._
 
 ## fs.readFileSync(file[, options])
@@ -1667,7 +1667,7 @@ without waiting for the callback. For this scenario,
 `fs.createWriteStream` is strongly recommended.
 
 _Note: If a file descriptor is specified as the `file`, it will not be closed 
-automatically. If a filename is specified as the `file`, internally opened 
+automatically. If a filename is specified as the `file`, the internally opened 
 file descriptor will be closed automatically._
 
 ## fs.writeFileSync(file, data[, options])

From b5baaa26548f855131ec3fb46713f7a4e164612d Mon Sep 17 00:00:00 2001
From: kibertoad <iselwin@gmail.com>
Date: Mon, 18 Jul 2016 02:33:47 +0300
Subject: [PATCH 5/5] refs #7560 Removed excessive detail about internal
 implementation.

---
 doc/api/fs.md | 9 +++------
 1 file changed, 3 insertions(+), 6 deletions(-)

diff --git a/doc/api/fs.md b/doc/api/fs.md
index d60603d9f8800b..5fce6c5c63cbe4 100644
--- a/doc/api/fs.md
+++ b/doc/api/fs.md
@@ -379,8 +379,7 @@ fs.appendFile('message.txt', 'data to append', 'utf8', callback);
 Any specified file descriptor has to have been opened for appending.
 
 _Note: If a file descriptor is specified as the `file`, it will not be closed 
-automatically. If a filename is specified as the `file`, the internally opened 
-file descriptor will be closed automatically._
+automatically._
 
 ## fs.appendFileSync(file, data[, options])
 <!-- YAML
@@ -1133,8 +1132,7 @@ fs.readFile('/etc/passwd', 'utf8', callback);
 Any specified file descriptor has to support reading.
 
 _Note: If a file descriptor is specified as the `file`, it will not be closed 
-automatically. If a filename is specified as the `file`, the internally opened 
-file descriptor will be closed automatically._
+automatically._
 
 ## fs.readFileSync(file[, options])
 <!-- YAML
@@ -1667,8 +1665,7 @@ without waiting for the callback. For this scenario,
 `fs.createWriteStream` is strongly recommended.
 
 _Note: If a file descriptor is specified as the `file`, it will not be closed 
-automatically. If a filename is specified as the `file`, the internally opened 
-file descriptor will be closed automatically._
+automatically._
 
 ## fs.writeFileSync(file, data[, options])
 <!-- YAML