http: added more doc

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`

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