doc: explicitly document highWaterMark option

eps1lon · MylesBorins · commit b16e6d29f180 · 2017-12-19T15:19:41.000-05:00
PR-URL: #17049 Reviewed-By: Luigi Pinca <luigipinca@gmail.com> Reviewed-By: Anna Henningsen <anna@addaleax.net>
diff --git a/doc/api/fs.md b/doc/api/fs.md
@@ -589,6 +589,7 @@ added: v0.1.31
   * `autoClose` {boolean}
   * `start` {integer}
   * `end` {integer}
+  * `highWaterMark` {integer}
 
 Returns a new [`ReadStream`][] object. (See [Readable Stream][]).
 
@@ -604,7 +605,8 @@ const defaults = {
   encoding: null,
   fd: null,
   mode: 0o666,
-  autoClose: true
+  autoClose: true,
+  highWaterMark: 64 * 1024
 };
 ```
 
