Merge pull request #6997 from sj26/reinstall-interactive

brew reinstall --interactive
Homebrew · Feb 6, 2020 · f144f63 · f144f63
2 parents 2555e43 + 8cd0177
commit f144f63
Show file tree

Hide file tree

Showing 4 changed files with 20 additions and 0 deletions.
diff --git a/Library/Homebrew/cmd/reinstall.rb b/Library/Homebrew/cmd/reinstall.rb
@@ -26,6 +26,10 @@ def reinstall_args
                           "or a shell inside the temporary build directory."
       switch "-s", "--build-from-source",
              description: "Compile <formula> from source even if a bottle is available."
+      switch "-i", "--interactive",
+             description: "Download and patch <formula>, then open a shell. This allows the user to "\
+                          "run `./configure --help` and otherwise determine how to turn the software "\
+                          "package into a Homebrew package."
       switch "--force-bottle",
              description: "Install from a bottle if it exists for the current or newest version of "\
                           "macOS, even if it would not normally be used for installation."

diff --git a/Library/Homebrew/cmd/upgrade.rb b/Library/Homebrew/cmd/upgrade.rb
@@ -28,6 +28,10 @@ def upgrade_args
                           "or a shell inside the temporary build directory."
       switch "-s", "--build-from-source",
              description: "Compile <formula> from source even if a bottle is available."
+      switch "-i", "--interactive",
+             description: "Download and patch <formula>, then open a shell. This allows the user to "\
+                          "run `./configure --help` and otherwise determine how to turn the software "\
+                          "package into a Homebrew package."
       switch "--force-bottle",
              description: "Install from a bottle if it exists for the current or newest version of "\
                           "macOS, even if it would not normally be used for installation."

diff --git a/docs/Manpage.md b/docs/Manpage.md
@@ -403,6 +403,8 @@ the reinstalled formulae or, every 30 days, for all formulae.
   If brewing fails, open an interactive debugging session with access to IRB or a shell inside the temporary build directory.
 * `-s`, `--build-from-source`:
   Compile *`formula`* from source even if a bottle is available.
+* `-i`, `--interactive`:
+  Download and patch *`formula`*, then open a shell. This allows the user to run `./configure --help` and otherwise determine how to turn the software package into a Homebrew package.
 * `--force-bottle`:
   Install from a bottle if it exists for the current or newest version of macOS, even if it would not normally be used for installation.
 * `--keep-tmp`:
@@ -582,6 +584,8 @@ the upgraded formulae or, every 30 days, for all formulae.
   If brewing fails, open an interactive debugging session with access to IRB or a shell inside the temporary build directory.
 * `-s`, `--build-from-source`:
   Compile *`formula`* from source even if a bottle is available.
+* `-i`, `--interactive`:
+  Download and patch *`formula`*, then open a shell. This allows the user to run `./configure --help` and otherwise determine how to turn the software package into a Homebrew package.
 * `--force-bottle`:
   Install from a bottle if it exists for the current or newest version of macOS, even if it would not normally be used for installation.
 * `--fetch-HEAD`:

diff --git a/manpages/brew.1 b/manpages/brew.1
@@ -518,6 +518,10 @@ If brewing fails, open an interactive debugging session with access to IRB or a
 Compile \fIformula\fR from source even if a bottle is available\.
 .
 .TP
+\fB\-i\fR, \fB\-\-interactive\fR
+Download and patch \fIformula\fR, then open a shell\. This allows the user to run \fB\./configure \-\-help\fR and otherwise determine how to turn the software package into a Homebrew package\.
+.
+.TP
 \fB\-\-force\-bottle\fR
 Install from a bottle if it exists for the current or newest version of macOS, even if it would not normally be used for installation\.
 .
@@ -722,6 +726,10 @@ If brewing fails, open an interactive debugging session with access to IRB or a
 Compile \fIformula\fR from source even if a bottle is available\.
 .
 .TP
+\fB\-i\fR, \fB\-\-interactive\fR
+Download and patch \fIformula\fR, then open a shell\. This allows the user to run \fB\./configure \-\-help\fR and otherwise determine how to turn the software package into a Homebrew package\.
+.
+.TP
 \fB\-\-force\-bottle\fR
 Install from a bottle if it exists for the current or newest version of macOS, even if it would not normally be used for installation\.
 .