Merge pull request #15424 from Homebrew/sponsors-maintainers-man-completions

Update manpage and completions.

completions/bash/brew

@@ -1526,9 +1526,11 @@ _brew_migrate() {
   case "${cur}" in
     -*)
       __brewcomp "
+      --cask
       --debug
       --dry-run
       --force
+      --formula
       --help
       --quiet
       --verbose
@@ -1538,6 +1540,7 @@ _brew_migrate() {
     *) ;;
   esac
   __brew_complete_installed_formulae
+  __brew_complete_installed_casks
 }
 
 _brew_missing() {

completions/fish/brew.fish

@@ -1059,13 +1059,16 @@ __fish_brew_complete_arg 'ls; and not __fish_seen_argument -l formula -l formula
 
 
 __fish_brew_complete_cmd 'migrate' 'Migrate renamed packages to new names, where formula are old names of packages'
+__fish_brew_complete_arg 'migrate' -l cask -d 'Only migrate casks'
 __fish_brew_complete_arg 'migrate' -l debug -d 'Display any debugging information'
 __fish_brew_complete_arg 'migrate' -l dry-run -d 'Show what would be migrated, but do not actually migrate anything'
 __fish_brew_complete_arg 'migrate' -l force -d 'Treat installed formula and provided formula as if they are from the same taps and migrate them anyway'
+__fish_brew_complete_arg 'migrate' -l formula -d 'Only migrate formulae'
 __fish_brew_complete_arg 'migrate' -l help -d 'Show this message'
 __fish_brew_complete_arg 'migrate' -l quiet -d 'Make some output more quiet'
 __fish_brew_complete_arg 'migrate' -l verbose -d 'Make some output more verbose'
-__fish_brew_complete_arg 'migrate' -a '(__fish_brew_suggest_formulae_installed)'
+__fish_brew_complete_arg 'migrate; and not __fish_seen_argument -l cask -l casks' -a '(__fish_brew_suggest_formulae_installed)'
+__fish_brew_complete_arg 'migrate; and not __fish_seen_argument -l formula -l formulae' -a '(__fish_brew_suggest_casks_installed)'
 
 
 __fish_brew_complete_cmd 'missing' 'Check the given formula kegs for missing dependencies'

completions/zsh/_brew

@@ -1318,7 +1318,11 @@ _brew_migrate() {
     '--quiet[Make some output more quiet]' \
     '--verbose[Make some output more verbose]' \
     - installed_formula \
-    '*::installed_formula:__brew_installed_formulae'
+    '(--cask)--formula[Only migrate formulae]' \
+    '*::installed_formula:__brew_installed_formulae' \
+    - installed_cask \
+    '(--formula)--cask[Only migrate casks]' \
+    '*::installed_cask:__brew_installed_casks'
 }
 
 # brew missing

docs/Manpage.md

@@ -451,7 +451,7 @@ if no formula or cask is provided.
 * `--cask`:
   Treat all named arguments as casks.
 
-### `migrate` [`--force`] [`--dry-run`] *`installed_formula`* [...]
+### `migrate` [*`options`*] *`installed_formula`*|*`installed_cask`* [...]
 
 Migrate renamed packages to new names, where *`formula`* are old names of
 packages.
@@ -460,6 +460,10 @@ packages.
   Treat installed *`formula`* and provided *`formula`* as if they are from the same taps and migrate them anyway.
 * `-n`, `--dry-run`:
   Show what would be migrated, but do not actually migrate anything.
+* `--formula`:
+  Only migrate formulae.
+* `--cask`:
+  Only migrate casks.
 
 ### `missing` [`--hide=`] [*`formula`* ...]
 

manpages/brew.1

@@ -638,7 +638,7 @@ Treat all named arguments as formulae\.
 \fB\-\-cask\fR
 Treat all named arguments as casks\.
 .
-.SS "\fBmigrate\fR [\fB\-\-force\fR] [\fB\-\-dry\-run\fR] \fIinstalled_formula\fR [\.\.\.]"
+.SS "\fBmigrate\fR [\fIoptions\fR] \fIinstalled_formula\fR|\fIinstalled_cask\fR [\.\.\.]"
 Migrate renamed packages to new names, where \fIformula\fR are old names of packages\.
 .
 .TP
@@ -649,6 +649,14 @@ Treat installed \fIformula\fR and provided \fIformula\fR as if they are from the
 \fB\-n\fR, \fB\-\-dry\-run\fR
 Show what would be migrated, but do not actually migrate anything\.
 .
+.TP
+\fB\-\-formula\fR
+Only migrate formulae\.
+.
+.TP
+\fB\-\-cask\fR
+Only migrate casks\.
+.
 .SS "\fBmissing\fR [\fB\-\-hide=\fR] [\fIformula\fR \.\.\.]"
 Check the given \fIformula\fR kegs for missing dependencies\. If no \fIformula\fR are provided, check all kegs\. Will exit with a non\-zero status if any kegs are found to be missing dependencies\.
 .