show-headers.md: mention bold headers and --no-styled-output

Mentioned-by: Sollace on github
Fixes #21495
Closes #21497

diff --git a/.github/scripts/pyspelling.words b/.github/scripts/pyspelling.words
index 0c986f14c6c2b967fd60ba470bd2ff719a6aea47..7d9f6ffb36c5540a773fa7af9ce0f2d5481f8319 100644 (file)
--- a/.github/scripts/pyspelling.words
+++ b/.github/scripts/pyspelling.words
@@ -896,6 +896,7 @@ trustless
 Tse
 Tsujikawa
 TTL
+tty
 tvOS
 txt
 typedef

diff --git a/docs/cmdline-opts/show-headers.md b/docs/cmdline-opts/show-headers.md
index d733784ac22d39f731a2b0b91fbbb2a8dedc8712..40c5ae790bec5b62ebc963f77639f674356131b7 100644 (file)
--- a/docs/cmdline-opts/show-headers.md
+++ b/docs/cmdline-opts/show-headers.md
@@ -24,6 +24,12 @@ non-HTTP protocols, the "headers" are other server communication.
 This option makes the response headers get saved in the same stream/output as
 the data. --dump-header exists to save headers in a separate stream.
 
+When HTTP headers are output to a tty, curl may use escape codes to make the
+header field names appear in bold and URLs in `Location:` headers be
+especially marked as such. Disable the use of terminal escape codes with
+--no-styled-output. (This means using the --styled-output option with a
+`--no-` prefix to disable it.)
+
 To view the request headers, consider the --verbose option.
 
 Prior to 7.75.0 curl did not print the headers if --fail was used in