From 8d8d235019220ad939375e231e5e05488c587e77 Mon Sep 17 00:00:00 2001 From: Caleb Xu Date: Mon, 30 Jul 2018 18:45:24 -0400 Subject: [PATCH] Bring up manpages and docs to match new changes --- docs/Manpage.md | 9 +++++---- manpages/brew.1 | 6 +++--- 2 files changed, 8 insertions(+), 7 deletions(-) diff --git a/docs/Manpage.md b/docs/Manpage.md index b4268f7096..87f0cc4ef0 100644 --- a/docs/Manpage.md +++ b/docs/Manpage.md @@ -790,17 +790,18 @@ With `--verbose` or `-v`, many commands print extra debugging information. Note * `edit` `formula`: Open `formula` in the editor. - * `extract` [`--force`] [`--stdout`] `formula` `version` [`tap`]: + * `extract` [`--force`] `formula` `--tap=``tap` [`--version=``version`]: Looks through repository history to find the `version` of `formula` and creates a copy in `tap`/Formula/`formula`@`version`.rb. If the tap is not installed yet, attempts to install/clone the tap before continuing. + A tap must be passed through `--tap` in order for `extract` to work. If `--force` is passed, the file at the destination will be overwritten if it already exists. Otherwise, existing files will be preserved. - If `--stdout` is passed, the file will be written to stdout on the - terminal instead of written to a file. A `tap` cannot be passed when - using `--stdout`. + If an argument is passed through `--version`, `version` of `formula` + will be extracted and placed in the destination tap. Otherwise, the most + recent version that can be found will be used. * `formula` `formula`: Display the path where `formula` is located. diff --git a/manpages/brew.1 b/manpages/brew.1 index 3c75e869e1..d0f4606210 100644 --- a/manpages/brew.1 +++ b/manpages/brew.1 @@ -727,14 +727,14 @@ Open all of Homebrew for editing\. Open \fIformula\fR in the editor\. . .TP -\fBextract\fR [\fB\-\-force\fR] [\fB\-\-stdout\fR] \fIformula\fR \fIversion\fR [\fItap\fR] -Looks through repository history to find the \fIversion\fR of \fIformula\fR and creates a copy in \fItap\fR/Formula/\fIformula\fR@\fIversion\fR\.rb\. If the tap is not installed yet, attempts to install/clone the tap before continuing\. +\fBextract\fR [\fB\-\-force\fR] \fIformula\fR \fB\-\-tap=\fR\fItap\fR [\fB\-\-version=\fR\fIversion\fR] +Looks through repository history to find the \fIversion\fR of \fIformula\fR and creates a copy in \fItap\fR/Formula/\fIformula\fR@\fIversion\fR\.rb\. If the tap is not installed yet, attempts to install/clone the tap before continuing\. A tap must be passed through \fB\-\-tap\fR in order for \fBextract\fR to work\. . .IP If \fB\-\-force\fR is passed, the file at the destination will be overwritten if it already exists\. Otherwise, existing files will be preserved\. . .IP -If \fB\-\-stdout\fR is passed, the file will be written to stdout on the terminal instead of written to a file\. A \fItap\fR cannot be passed when using \fB\-\-stdout\fR\. +If an argument is passed through \fB\-\-version\fR, \fIversion\fR of \fIformula\fR will be extracted and placed in the destination tap\. Otherwise, the most recent version that can be found will be used\. . .TP \fBformula\fR \fIformula\fR