From b687f17bd62fbfffd328ef5d1b1d38ea95b29bef Mon Sep 17 00:00:00 2001
From: Natanael Log <natte.log@gmail.com>
Date: Sat, 1 Jul 2017 15:10:36 +0200
Subject: [PATCH 1/2] doc, util, console: clarify ambiguous docs

Add clarification to the documentation on util.format() and console.log()
regarding how excessive arguments are treated when the first argument is
a non-format string compared to when it is not a string at all.

Fixes: https://github.com/nodejs/node/issues/13908
---
 doc/api/console.md | 4 +---
 doc/api/util.md    | 9 ++++++++-
 2 files changed, 9 insertions(+), 4 deletions(-)

diff --git a/doc/api/console.md b/doc/api/console.md
index 3411d3ce0afba2..4939ed77bef1b8 100644
--- a/doc/api/console.md
+++ b/doc/api/console.md
@@ -246,9 +246,7 @@ console.log('count:', count);
 // Prints: count: 5, to stdout
 ```
 
-If formatting elements (e.g. `%d`) are not found in the first string then
-[`util.inspect()`][] is called on each argument and the resulting string
-values are concatenated. See [`util.format()`][] for more information.
+See [`util.format()`][] for more information.
 
 ### console.time(label)
 <!-- YAML
diff --git a/doc/api/util.md b/doc/api/util.md
index 0669330795840d..ea0e955de4e06a 100644
--- a/doc/api/util.md
+++ b/doc/api/util.md
@@ -186,7 +186,14 @@ returned string, each delimited by a space.
 util.format('%s:%s', 'foo', 'bar', 'baz'); // 'foo:bar baz'
 ```
 
-If the first argument is not a format string then `util.format()` returns
+Any non-object and non-symbol excessive argument will **not** have
+`util.inspect()` called on them.
+
+```js
+util.format('%s', 'foo', () => true); // 'foo () => true'
+```
+
+If the first argument is not a string then `util.format()` returns
 a string that is the concatenation of all arguments separated by spaces.
 Each argument is converted to a string using `util.inspect()`.
 

From 5f01b7b0e22bd7573e1a7a4671d4bd75bfba5c43 Mon Sep 17 00:00:00 2001
From: Natanael Log <natte.log@gmail.com>
Date: Sat, 1 Jul 2017 16:27:47 +0200
Subject: [PATCH 2/2] doc: combine mentions on excessive arguments

Rephrased how excessive arguments to the format string are concatenated.

Fixes: https://github.com/nodejs/node/issues/13908
---
 doc/api/util.md | 16 +++++-----------
 1 file changed, 5 insertions(+), 11 deletions(-)

diff --git a/doc/api/util.md b/doc/api/util.md
index ea0e955de4e06a..b299a6740936e3 100644
--- a/doc/api/util.md
+++ b/doc/api/util.md
@@ -177,22 +177,16 @@ util.format('%s:%s', 'foo');
 // Returns: 'foo:%s'
 ```
 
-If there are more arguments passed to the `util.format()` method than the
-number of placeholders, the extra arguments are coerced into strings (for
-objects and symbols, `util.inspect()` is used) then concatenated to the
-returned string, each delimited by a space.
+If there are more arguments passed to the `util.format()` method than the number
+of placeholders, the extra arguments are coerced into strings then concatenated
+to the returned string, each delimited by a space. Excessive arguments whose
+`typeof` is `'object'` or `'symbol'` (except `null`) will be transformed by
+`util.inspect()`.
 
 ```js
 util.format('%s:%s', 'foo', 'bar', 'baz'); // 'foo:bar baz'
 ```
 
-Any non-object and non-symbol excessive argument will **not** have
-`util.inspect()` called on them.
-
-```js
-util.format('%s', 'foo', () => true); // 'foo () => true'
-```
-
 If the first argument is not a string then `util.format()` returns
 a string that is the concatenation of all arguments separated by spaces.
 Each argument is converted to a string using `util.inspect()`.