From de0749bd8060a95ede9f6c8df505b15269798d4e Mon Sep 17 00:00:00 2001
From: Marco Ippolito <marcoippolito54@gmail.com>
Date: Mon, 26 Dec 2022 16:08:59 +0100
Subject: [PATCH] http: added more doc

---
 doc/api/cli.md  | 3 ++-
 doc/api/http.md | 4 ++++
 2 files changed, 6 insertions(+), 1 deletion(-)

diff --git a/doc/api/cli.md b/doc/api/cli.md
index d3609e04ab1252..19ec885fc64771 100644
--- a/doc/api/cli.md
+++ b/doc/api/cli.md
@@ -460,6 +460,7 @@ Enable experimental WebAssembly module support.
 
 Enable experimental joining of the field line values of
 multiple `Authorization` headers in a request.
+The values are joined together with `, `.
 
 ### `--force-context-aware`
 
@@ -1878,6 +1879,7 @@ Node.js options that are allowed are:
 * `--enable-source-maps`
 * `--experimental-abortcontroller`
 * `--experimental-import-meta-resolve`
+* `--experimental-join-authorization-headers`
 * `--experimental-json-modules`
 * `--experimental-loader`
 * `--experimental-modules`
@@ -1889,7 +1891,6 @@ Node.js options that are allowed are:
 * `--experimental-vm-modules`
 * `--experimental-wasi-unstable-preview1`
 * `--experimental-wasm-modules`
-* `--experimental-join-authorization-headers`
 * `--force-context-aware`
 * `--force-fips`
 * `--force-node-api-uncaught-exceptions-policy`
diff --git a/doc/api/http.md b/doc/api/http.md
index 37bb05b53a8872..c8e6b5e4716291 100644
--- a/doc/api/http.md
+++ b/doc/api/http.md
@@ -2454,6 +2454,9 @@ header name:
 * `set-cookie` is always an array. Duplicates are added to the array.
 * For duplicate `cookie` headers, the values are joined together with `; `.
 * For all other headers, the values are joined together with `, `.
+* To enable joining the value of duplicate `authorization` header,
+  use the experimental command line flag `--experimental-join-authorization-headers`.
+  See [`--experimental-join-authorization-headers`][] for more information.
 
 ### `message.headersDistinct`
 
@@ -3731,6 +3734,7 @@ Set the maximum number of idle HTTP parsers. **Default:** `1000`.
 [`'request'`]: #event-request
 [`'response'`]: #event-response
 [`'upgrade'`]: #event-upgrade
+[`--experimental-join-authorization-headers`]: cli.md#--experimental-join-authorization-headers
 [`--insecure-http-parser`]: cli.md#--insecure-http-parser
 [`--max-http-header-size`]: cli.md#--max-http-header-sizesize
 [`Agent`]: #class-httpagent