diff --git a/completions/fish/brew.fish b/completions/fish/brew.fish
index 19315ec5af..dcae08cec4 100644
--- a/completions/fish/brew.fish
+++ b/completions/fish/brew.fish
@@ -1517,7 +1517,7 @@ __fish_brew_complete_arg 'tap' -l eval-all -d 'Evaluate all the formulae, casks
 __fish_brew_complete_arg 'tap' -l force -d 'Force install core taps even under API mode'
 __fish_brew_complete_arg 'tap' -l help -d 'Show this message'
 __fish_brew_complete_arg 'tap' -l quiet -d 'Make some output more quiet'
-__fish_brew_complete_arg 'tap' -l repair -d 'Migrate tapped formulae from symlink-based to directory-based structure'
+__fish_brew_complete_arg 'tap' -l repair -d 'Add missing symlinks to tap manpages and shell completions. Correct git remote refs for any taps where upstream HEAD branch has been renamed'
 __fish_brew_complete_arg 'tap' -l verbose -d 'Make some output more verbose'
 __fish_brew_complete_arg 'tap' -a '(__fish_brew_suggest_taps_installed)'
 
diff --git a/completions/zsh/_brew b/completions/zsh/_brew
index e831b857eb..f78bc3d240 100644
--- a/completions/zsh/_brew
+++ b/completions/zsh/_brew
@@ -1882,7 +1882,7 @@ _brew_tap() {
     '--force[Force install core taps even under API mode]' \
     '--help[Show this message]' \
     '--quiet[Make some output more quiet]' \
-    '--repair[Migrate tapped formulae from symlink-based to directory-based structure]' \
+    '--repair[Add missing symlinks to tap manpages and shell completions. Correct git remote refs for any taps where upstream HEAD branch has been renamed]' \
     '--verbose[Make some output more verbose]' \
     - tap \
     '*::tap:__brew_any_tap'
diff --git a/docs/Manpage.md b/docs/Manpage.md
index 56f10a2526..90845cdc27 100644
--- a/docs/Manpage.md
+++ b/docs/Manpage.md
@@ -1230,7 +1230,8 @@ HTTPS, e.g. SSH, git, HTTP, FTP(S), rsync.
 
 `--repair`
 
-: Migrate tapped formulae from symlink-based to directory-based structure.
+: Add missing symlinks to tap manpages and shell completions. Correct git remote
+  refs for any taps where upstream HEAD branch has been renamed.
 
 `--eval-all`
 
diff --git a/manpages/brew.1 b/manpages/brew.1
index 31a39d69a2..07d4b5b539 100644
--- a/manpages/brew.1
+++ b/manpages/brew.1
@@ -1,5 +1,5 @@
 .\" generated by kramdown
-.TH "BREW" "1" "January 2025" "Homebrew"
+.TH "BREW" "1" "February 2025" "Homebrew"
 .SH NAME
 brew \- The Missing Package Manager for macOS (or Linux)
 .SH "SYNOPSIS"
@@ -771,7 +771,7 @@ With \fIURL\fP specified, tap a formula repository from anywhere, using any tran
 Install or change a tap with a custom remote\. Useful for mirrors\.
 .TP
 \fB\-\-repair\fP
-Migrate tapped formulae from symlink\-based to directory\-based structure\.
+Add missing symlinks to tap manpages and shell completions\. Correct git remote refs for any taps where upstream HEAD branch has been renamed\.
 .TP
 \fB\-\-eval\-all\fP
 Evaluate all the formulae, casks and aliases in the new tap to check validity\. Implied if \fB$HOMEBREW_EVAL_ALL\fP is set\.