doc: `fs.*File()` also accept encoding strings
authorRich Trott <rtrott@gmail.com>
Wed, 27 May 2015 03:11:38 +0000 (20:11 -0700)
committerJeremiah Senkpiel <fishrock123@rocketmail.com>
Wed, 27 May 2015 19:53:14 +0000 (15:53 -0400)
Fixes: https://github.com/nodejs/io.js/issues/1797
PR-URL: https://github.com/nodejs/io.js/pull/1806
Reviewed-By: fishrock123@rocketmail.com
doc/api/fs.markdown

index 92f34db..3b85d78 100644 (file)
@@ -455,7 +455,7 @@ Synchronous version of `fs.read`. Returns the number of `bytesRead`.
 ## fs.readFile(filename[, options], callback)
 
 * `filename` {String}
-* `options` {Object}
+* `options` {Object | String}
   * `encoding` {String | Null} default = `null`
   * `flag` {String} default = `'r'`
 * `callback` {Function}
@@ -472,6 +472,10 @@ contents of the file.
 
 If no encoding is specified, then the raw buffer is returned.
 
+If `options` is a string, then it specifies the encoding. Example:
+
+    fs.readFile('/etc/passwd', 'utf8', callback);
+
 
 ## fs.readFileSync(filename[, options])
 
@@ -485,7 +489,7 @@ string. Otherwise it returns a buffer.
 
 * `filename` {String}
 * `data` {String | Buffer}
-* `options` {Object}
+* `options` {Object | String}
   * `encoding` {String | Null} default = `'utf8'`
   * `mode` {Number} default = `0o666`
   * `flag` {String} default = `'w'`
@@ -504,6 +508,10 @@ Example:
       console.log('It\'s saved!');
     });
 
+If `options` is a string, then it specifies the encoding. Example:
+
+    fs.writeFile('message.txt', 'Hello io.js', 'utf8', callback);
+
 ## fs.writeFileSync(filename, data[, options])
 
 The synchronous version of `fs.writeFile`.
@@ -512,7 +520,7 @@ The synchronous version of `fs.writeFile`.
 
 * `filename` {String}
 * `data` {String | Buffer}
-* `options` {Object}
+* `options` {Object | String}
   * `encoding` {String | Null} default = `'utf8'`
   * `mode` {Number} default = `0o666`
   * `flag` {String} default = `'a'`
@@ -528,6 +536,10 @@ Example:
       console.log('The "data to append" was appended to file!');
     });
 
+If `options` is a string, then it specifies the encoding. Example:
+
+    fs.appendFile('message.txt', 'data to append', 'utf8', callback);
+
 ## fs.appendFileSync(filename, data[, options])
 
 The synchronous version of `fs.appendFile`.