From acc9a7ca8554bc2413dee2d6d0f407b3a59c628c Mon Sep 17 00:00:00 2001 From: Andrew Janke Date: Sun, 10 Apr 2016 22:53:56 -0400 Subject: brew test, install, update-test: add --keep-tmp option Also enables sandbox for --interactive and --debug use of install and test, using automatic retention. Closes #66. Signed-off-by: Andrew Janke --- share/doc/homebrew/brew.1.html | 10 ++++++++-- share/man/man1/brew.1 | 10 ++++++++-- 2 files changed, 16 insertions(+), 4 deletions(-) (limited to 'share') diff --git a/share/doc/homebrew/brew.1.html b/share/doc/homebrew/brew.1.html index 1988ce253..682e33d62 100644 --- a/share/doc/homebrew/brew.1.html +++ b/share/doc/homebrew/brew.1.html @@ -155,7 +155,7 @@ information on all installed formulae.

See the docs for examples of using the JSON: https://github.com/Homebrew/brew/blob/master/share/doc/homebrew/Querying-Brew.md

-
install [--debug] [--env=std|super] [--ignore-dependencies] [--only-dependencies] [--cc=compiler] [--build-from-source|--force-bottle] [--devel|--HEAD] formula

Install formula.

+
install [--debug] [--env=std|super] [--ignore-dependencies] [--only-dependencies] [--cc=compiler] [--build-from-source|--force-bottle] [--devel|--HEAD] [--keep-tmp] formula

Install formula.

formula is usually the name of the formula to install, but it can be specified several different ways. See SPECIFYING FORMULAE.

@@ -191,6 +191,9 @@ for the current version of OS X, even if custom options are given.

If --HEAD is passed, and formula defines it, install the HEAD version, aka master, trunk, unstable.

+

If --keep-tmp is passed, the temporary files created for the test are +not deleted.

+

To install a newer version of HEAD use brew rm <foo> && brew install --HEAD <foo>.

install --interactive [--git] formula

Download and patch formula, then open a shell. This allows the user to @@ -321,7 +324,7 @@ for version is v1.

tap-pin tap

Pin tap, prioritizing its formulae over core when formula names are supplied by the user. See also tap-unpin.

tap-unpin tap

Unpin tap so its formulae are no longer prioritized. See also tap-pin.

-
test [--devel|--HEAD] [--debug] formula

A few formulae provide a test method. brew test formula runs this +

test [--devel|--HEAD] [--debug] [--keep-tmp] formula

A few formulae provide a test method. brew test formula runs this test method. There is no standard output or return code, but it should generally indicate to the user if something is wrong with the installed formula.

@@ -332,6 +335,9 @@ formula.

If --debug is passed and the test fails, an interactive debugger will be launched with access to IRB or a shell inside the temporary test directory.

+

If --keep-tmp is passed, the temporary files created for the test are +not deleted.

+

Example: brew install jruby && brew test jruby

uninstall, rm, remove [--force] formula

Uninstall formula.

diff --git a/share/man/man1/brew.1 b/share/man/man1/brew.1 index 897ba2acd..be2540ff4 100644 --- a/share/man/man1/brew.1 +++ b/share/man/man1/brew.1 @@ -214,7 +214,7 @@ Pass \fB\-\-all\fR to get information on all formulae, or \fB\-\-installed\fR to See the docs for examples of using the JSON: \fIhttps://github\.com/Homebrew/brew/blob/master/share/doc/homebrew/Querying\-Brew\.md\fR . .TP -\fBinstall\fR [\fB\-\-debug\fR] [\fB\-\-env=\fR\fIstd\fR|\fIsuper\fR] [\fB\-\-ignore\-dependencies\fR] [\fB\-\-only\-dependencies\fR] [\fB\-\-cc=\fR\fIcompiler\fR] [\fB\-\-build\-from\-source\fR|\fB\-\-force\-bottle\fR] [\fB\-\-devel\fR|\fB\-\-HEAD\fR] \fIformula\fR +\fBinstall\fR [\fB\-\-debug\fR] [\fB\-\-env=\fR\fIstd\fR|\fIsuper\fR] [\fB\-\-ignore\-dependencies\fR] [\fB\-\-only\-dependencies\fR] [\fB\-\-cc=\fR\fIcompiler\fR] [\fB\-\-build\-from\-source\fR|\fB\-\-force\-bottle\fR] [\fB\-\-devel\fR|\fB\-\-HEAD\fR] [\fB\-\-keep\-tmp\fR] \fIformula\fR Install \fIformula\fR\. . .IP @@ -251,6 +251,9 @@ If \fB\-\-devel\fR is passed, and \fIformula\fR defines it, install the developm If \fB\-\-HEAD\fR is passed, and \fIformula\fR defines it, install the HEAD version, aka master, trunk, unstable\. . .IP +If \fB\-\-keep\-tmp\fR is passed, the temporary files created for the test are not deleted\. +. +.IP To install a newer version of HEAD use \fBbrew rm && brew install \-\-HEAD \fR\. . .TP @@ -449,7 +452,7 @@ Pin \fItap\fR, prioritizing its formulae over core when formula names are suppli Unpin \fItap\fR so its formulae are no longer prioritized\. See also \fBtap\-pin\fR\. . .TP -\fBtest\fR [\fB\-\-devel\fR|\fB\-\-HEAD\fR] [\fB\-\-debug\fR] \fIformula\fR +\fBtest\fR [\fB\-\-devel\fR|\fB\-\-HEAD\fR] [\fB\-\-debug\fR] [\fB\-\-keep\-tmp\fR] \fIformula\fR A few formulae provide a test method\. \fBbrew test\fR \fIformula\fR runs this test method\. There is no standard output or return code, but it should generally indicate to the user if something is wrong with the installed formula\. . .IP @@ -459,6 +462,9 @@ To test the development or head version of a formula, use \fB\-\-devel\fR or \fB If \fB\-\-debug\fR is passed and the test fails, an interactive debugger will be launched with access to IRB or a shell inside the temporary test directory\. . .IP +If \fB\-\-keep\-tmp\fR is passed, the temporary files created for the test are not deleted\. +. +.IP Example: \fBbrew install jruby && brew test jruby\fR . .TP -- cgit v1.2.3