From 59b4fb72f1ef43bd6fc9717d7f2246152b026f1d Mon Sep 17 00:00:00 2001 From: Rich Trott Date: Tue, 7 Feb 2017 13:08:52 -0800 Subject: [PATCH 1/2] doc: edit maxBuffer/Unicode paragraph for clarity Remove unneeded words from child_process doc. --- doc/api/child_process.md | 15 +++++---------- 1 file changed, 5 insertions(+), 10 deletions(-) diff --git a/doc/api/child_process.md b/doc/api/child_process.md index a9499171f3c921..66540f588d9565 100644 --- a/doc/api/child_process.md +++ b/doc/api/child_process.md @@ -1157,16 +1157,11 @@ to the same value. ## `maxBuffer` and Unicode -It is important to keep in mind that the `maxBuffer` option specifies the -largest number of *octets* allowed on `stdout` or `stderr`. If this value is -exceeded, then the child process is terminated. This particularly impacts -output that includes multibyte character encodings such as UTF-8 or UTF-16. -For instance, the following will output 13 UTF-8 encoded octets to `stdout` -although there are only 4 characters: - -```js -console.log('中文测试'); -``` +The `maxBuffer` option specifies the largest number of *octets* allowed on +`stdout` or `stderr`. If this value is exceeded, then the child process is +terminated. This impacts output that includes multibyte character encodings such +as UTF-8 or UTF-16. For instance, `console.log('中文测试')` will send 13 UTF-8 +encoded octets to `stdout` although there are only 4 characters. [`'error'`]: #child_process_event_error [`'exit'`]: #child_process_event_exit From be1378b26a75404a9583537ac0e8189822778f52 Mon Sep 17 00:00:00 2001 From: Rich Trott Date: Tue, 7 Feb 2017 15:58:16 -0800 Subject: [PATCH 2/2] squash: octets -> bytes --- doc/api/child_process.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/doc/api/child_process.md b/doc/api/child_process.md index 66540f588d9565..7f233f7f245263 100644 --- a/doc/api/child_process.md +++ b/doc/api/child_process.md @@ -1157,11 +1157,11 @@ to the same value. ## `maxBuffer` and Unicode -The `maxBuffer` option specifies the largest number of *octets* allowed on -`stdout` or `stderr`. If this value is exceeded, then the child process is -terminated. This impacts output that includes multibyte character encodings such -as UTF-8 or UTF-16. For instance, `console.log('中文测试')` will send 13 UTF-8 -encoded octets to `stdout` although there are only 4 characters. +The `maxBuffer` option specifies the largest number of bytes allowed on `stdout` +or `stderr`. If this value is exceeded, then the child process is terminated. +This impacts output that includes multibyte character encodings such as UTF-8 or +UTF-16. For instance, `console.log('中文测试')` will send 13 UTF-8 encoded bytes +to `stdout` although there are only 4 characters. [`'error'`]: #child_process_event_error [`'exit'`]: #child_process_event_exit