doc,tls: mark parseCertString() as deprecated

XadillaX · XadillaX · commit 1cb3e566ffdf · 2017-07-23T15:53:52.000+08:00
`tls.parseCertString()` was made public by mistack. So mark it as deprecated. Refs: #14193 Refs: af80e7b#diff-cc32376ce1eaf679ec2298cd483f15c7R188
diff --git a/doc/api/deprecations.md b/doc/api/deprecations.md
@@ -630,6 +630,29 @@ Type: Runtime
 
 *Note*: change was made while `async_hooks` was an experimental API.
 
+<a id="DEP00XX"></a>
+### DEP00XX: tls.parseCertString()
+
+Type: Documentation-only
+
+`tls.parseCertString()` is a trivial parsing helper that was made public by
+mistake. This function can usually be replaced with
+
+```js
+const querystring = require('querystring');
+querystring.parse(str, '\n', '=')`;
+```
+
+*Note*: This function is not completely equivalent to `querystring.parse()`. One
+notable difference is that `querystring.parse()` does URLDecoding, e.g.:
+
+```js
+> querystring.parse("%E5%A5%BD=1", "\n", "=");
+{ '好': '1' }
+> tls.parseCertString("%E5%A5%BD=1");
+{ '%E5%A5%BD': '1' }
+```
+
 [`Buffer.allocUnsafeSlow(size)`]: buffer.html#buffer_class_method_buffer_allocunsafeslow_size
 [`Buffer.from(array)`]: buffer.html#buffer_class_method_buffer_from_array
 [`Buffer.from(buffer)`]: buffer.html#buffer_class_method_buffer_from_buffer
