diff --git a/README.md b/README.md
index cc2a8d764..72d4d8787 100644
--- a/README.md
+++ b/README.md
@@ -93,7 +93,7 @@ eza’s options are almost, but not quite, entirely unlike `ls`’s.
 - **--colo[u]r-scale=(field)**: highlight levels of `field` distinctly(all, age, size)
 - **--color-scale-mode=(mode)**: use gradient or fixed colors in --color-scale. valid options are `fixed` or `gradient`
 - **--icons=(when)**: when to display icons (always, auto, never)
-- **--hyperlink**: display entries as hyperlinks
+- **--hyperlink=(when)**: display entries as hyperlinks
 - **-w**, **--width=(columns)**: set screen width in columns
 
 ### Filtering options
diff --git a/man/eza.1.md b/man/eza.1.md
index b427d303f..9d8c08b7c 100644
--- a/man/eza.1.md
+++ b/man/eza.1.md
@@ -106,9 +106,14 @@ The default value is ‘`automatic`’.
 `--no-quotes`
 : Don't quote file names with spaces.
 
-`--hyperlink`
+`--hyperlink=WHEN`
 : Display entries as hyperlinks
 
+Valid settings are ‘`always`’, ‘`automatic`’ (or ‘`auto`’ for short), and ‘`never`’.
+The default value is ‘`automatic`’.
+
+The default behavior (‘`automatic`’ or ‘`auto`’) is to add hyperlink control chars to the output only when the standard output is connected to a real terminal. If the output of `eza` is redirected to a file or piped into another program, hyperlink will not be used. Setting this option to ‘`always`’ causes `eza` to always output hyperlinks, while ‘`never`’ disables the use of hyperlinks.
+
 `-w`, `--width=COLS`
 : Set screen width in columns.
 
diff --git a/src/options/file_name.rs b/src/options/file_name.rs
index 6b32de087..db7ecc98d 100644
--- a/src/options/file_name.rs
+++ b/src/options/file_name.rs
@@ -100,7 +100,7 @@ impl QuoteStyle {
 impl EmbedHyperlinks {
     pub fn deduce(matches: &MatchedFlags<'_>) -> Result<Self, OptionsError> {
         let Some(word) = matches.get(&flags::HYPERLINK)? else {
-            return Ok(Self::Automatic)
+            return Ok(Self::Automatic);
         };
 
         if word == "always" {