From 2f9868e5a8c937b2eb9f533c6e714a979d01bebc Mon Sep 17 00:00:00 2001
From: Yagiz Nizipli <yagiz@nizipli.com>
Date: Tue, 19 Sep 2023 16:18:28 -0400
Subject: [PATCH] doc: doc-only deprecate `util.toUSVString`

---
 doc/api/deprecations.md | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/doc/api/deprecations.md b/doc/api/deprecations.md
index 8b9c9e59adc7b5..ae4268e3809d11 100644
--- a/doc/api/deprecations.md
+++ b/doc/api/deprecations.md
@@ -3400,6 +3400,20 @@ Type: Runtime
 Calling [`util.promisify`][] on a function that returns a <Promise> will ignore
 the result of said promise, which can lead to unhandled promise rejections.
 
+### DEP0175: `util.toUSVString`
+
+<!-- YAML
+changes:
+  - version: REPLACEME
+    pr-url: https://github.com/nodejs/node/pull/47342
+    description: Documentation-only deprecation.
+-->
+
+Type: Documentation-only
+
+It is recommended to use [`String.prototype.toWellFormed`][] for better
+performance.
+
 [NIST SP 800-38D]: https://nvlpubs.nist.gov/nistpubs/Legacy/SP/nistspecialpublication800-38d.pdf
 [RFC 6066]: https://tools.ietf.org/html/rfc6066#section-3
 [RFC 8247 Section 2.4]: https://www.rfc-editor.org/rfc/rfc8247#section-2.4
@@ -3422,6 +3436,7 @@ the result of said promise, which can lead to unhandled promise rejections.
 [`Server.getConnections()`]: net.md#servergetconnectionscallback
 [`Server.listen({fd: <number>})`]: net.md#serverlistenhandle-backlog-callback
 [`SlowBuffer`]: buffer.md#class-slowbuffer
+[`String.prototype.toWellFormed`]: https://chromestatus.com/feature/5200195346759680
 [`WriteStream.open()`]: fs.md#class-fswritestream
 [`assert.CallTracker`]: assert.md#class-assertcalltracker
 [`assert`]: assert.md