From a77c58dec08586de5761224025a0cbd38fd9d167 Mon Sep 17 00:00:00 2001 From: Adam Vandenberg Date: Fri, 16 May 2014 11:14:58 -0700 Subject: [PATCH] more explicit documentation for brew info --json=v1 --- Library/Contributions/manpages/brew.1.md | 4 ++++ share/man/man1/brew.1 | 3 +++ 2 files changed, 7 insertions(+) diff --git a/Library/Contributions/manpages/brew.1.md b/Library/Contributions/manpages/brew.1.md index 21b8399171..9177fffc26 100644 --- a/Library/Contributions/manpages/brew.1.md +++ b/Library/Contributions/manpages/brew.1.md @@ -167,6 +167,10 @@ Note that these flags should only appear after a command. Pass `--all` to get information on all formulae, or `--installed` to get information on all installed formulae. + If a single formula is specified, a single JSON object is displayed. + If multiple formulae are specified, or `--installed` or `--all` are used, + a JSON array is displayed, even if the array would only contain one object. + * `install [--debug] [--env=] [--ignore-dependencies] [--only-dependencies] [--cc=] [--build-from-source] [--devel|--HEAD]` : Install . diff --git a/share/man/man1/brew.1 b/share/man/man1/brew.1 index 0632160d6b..de976b5e45 100644 --- a/share/man/man1/brew.1 +++ b/share/man/man1/brew.1 @@ -183,6 +183,9 @@ Print a JSON representation of \fIformula\fR\. Currently the only accepted value .IP Pass \fB\-\-all\fR to get information on all formulae, or \fB\-\-installed\fR to get information on all installed formulae\. . +.IP +If a single formula is specified, a single JSON object is displayed\. If multiple formulae are specified, or \fB\-\-installed\fR or \fB\-\-all\fR are used, a JSON array is displayed, even if the array would only contain one object\. +. .TP \fBinstall [\-\-debug] [\-\-env=] [\-\-ignore\-dependencies] [\-\-only\-dependencies] [\-\-cc=] [\-\-build\-from\-source] [\-\-devel|\-\-HEAD]\fR \fIformula\fR Install \fIformula\fR\.