From cfd0067eb1cc03f31cbd68bdb600d84d16e0972d Mon Sep 17 00:00:00 2001
From: Refael Ackermann <refack@gmail.com>
Date: Fri, 7 Sep 2018 14:48:55 -0400
Subject: [PATCH] util: doc deprecate legacy inspect signature

Refs: https://github.com/nodejs/node/pull/22751
---
 doc/api/util.md | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/doc/api/util.md b/doc/api/util.md
index 44495e977d13..08ee56be5cbd 100644
--- a/doc/api/util.md
+++ b/doc/api/util.md
@@ -360,6 +360,9 @@ stream.write('With ES6');
 <!-- YAML
 added: v0.3.0
 changes:
+  - version: REPLACEME
+    pr-rul: https://github.com/nodejs/node/pull/22753
+    description: Deprecated legacy signature.
   - version: v10.6.0
     pr-url: https://github.com/nodejs/node/pull/20725
     description: Inspecting linked lists and similar objects is now possible
@@ -384,6 +387,9 @@ changes:
   - version: v6.1.0
     pr-url: https://github.com/nodejs/node/pull/6465
     description: The `showProxy` option is supported now.
+  - version: v0.9.3
+    pr-url: https://github.com/nodejs/node-v0.x-archive/issues/4085
+    description: Take an "options" object as second argument
 -->
 
 * `object` {any} Any JavaScript primitive or `Object`.
@@ -424,6 +430,9 @@ changes:
     example below. **Default:** `true`.
 * Returns: {string} The representation of passed object
 
+Deprecation notice: The legacy function signature that was changed in v0.9.3
+`util.inspect(object, [showHidden], [depth], [colors])` has been deprecated.
+
 The `util.inspect()` method returns a string representation of `object` that is
 intended for debugging. The output of `util.inspect` may change at any time
 and should not be depended upon programmatically. Additional `options` may be