Merge pull request #17598 from Homebrew/sponsors-maintainers-man-comp…

…letions
Homebrew · Jun 30, 2024 · 88d0609 · 88d0609
2 parents ab2b3d5 + 60c42e8
commit 88d0609
Show file tree

Hide file tree

Showing 5 changed files with 11 additions and 0 deletions.
diff --git a/completions/bash/brew b/completions/bash/brew
@@ -962,6 +962,7 @@ _brew_extract() {
       __brewcomp "
       --debug
       --force
+      --git-revision
       --help
       --quiet
       --verbose

diff --git a/completions/fish/brew.fish b/completions/fish/brew.fish
@@ -699,6 +699,7 @@ __fish_brew_complete_arg 'environment' -a '(__fish_brew_suggest_formulae_all)'
 __fish_brew_complete_cmd 'extract' 'Look through repository history to find the most recent version of formula and create a copy in tap'
 __fish_brew_complete_arg 'extract' -l debug -d 'Display any debugging information'
 __fish_brew_complete_arg 'extract' -l force -d 'Overwrite the destination formula if it already exists'
+__fish_brew_complete_arg 'extract' -l git-revision -d 'Search for the specified version of formula starting at revision instead of HEAD'
 __fish_brew_complete_arg 'extract' -l help -d 'Show this message'
 __fish_brew_complete_arg 'extract' -l quiet -d 'Make some output more quiet'
 __fish_brew_complete_arg 'extract' -l verbose -d 'Make some output more verbose'

diff --git a/completions/zsh/_brew b/completions/zsh/_brew
@@ -885,6 +885,7 @@ _brew_extract() {
   _arguments \
     '--debug[Display any debugging information]' \
     '--force[Overwrite the destination formula if it already exists]' \
+    '--git-revision[Search for the specified version of formula starting at revision instead of HEAD]' \
     '--help[Show this message]' \
     '--quiet[Make some output more quiet]' \
     '--verbose[Make some output more verbose]' \

diff --git a/docs/Manpage.md b/docs/Manpage.md
@@ -2188,6 +2188,11 @@ not installed yet, attempt to install/clone the tap before continuing. To
 extract a formula from a tap that is not `homebrew/core` use its fully-qualified
 form of *`user`*`/`*`repo`*`/`*`formula`*.
 
+`--git-revision`
+
+: Search for the specified *`version`* of *`formula`* starting at *`revision`*
+  instead of HEAD.
+
 `--version`
 
 : Extract the specified *`version`* of *`formula`* instead of the most recent.

diff --git a/manpages/brew.1 b/manpages/brew.1
@@ -1389,6 +1389,9 @@ Print the file path to be edited, without opening an editor\.
 .SS "\fBextract\fP \fR[\fB\-\-version=\fP] \fR[\fB\-\-force\fP] \fIformula\fP \fItap\fP"
 Look through repository history to find the most recent version of \fIformula\fP and create a copy in \fItap\fP\&\. Specifically, the command will create the new formula file at \fItap\fP\fB/Formula/\fP\fIformula\fP\fB@\fP\fIversion\fP\fB\&\.rb\fP\&\. If the tap is not installed yet, attempt to install/clone the tap before continuing\. To extract a formula from a tap that is not \fBhomebrew/core\fP use its fully\-qualified form of \fIuser\fP\fB/\fP\fIrepo\fP\fB/\fP\fIformula\fP\&\.
 .TP
+\fB\-\-git\-revision\fP
+Search for the specified \fIversion\fP of \fIformula\fP starting at \fIrevision\fP instead of HEAD\.
+.TP
 \fB\-\-version\fP
 Extract the specified \fIversion\fP of \fIformula\fP instead of the most recent\.
 .TP