Update documentation of brew install syntax to match its actual behav…

[VonUniGE]

…ior.

• [OK] Have you followed the guidelines in our Contributing document?
• [OK] Have you checked to ensure there aren't other open Pull Requests for the same change?
• [OK] Have you added an explanation of what your changes do and why you'd like us to include them?

---

As stated in issue #1699, the documentation doesn't reflect the actual behavior of brew install. When using brew install, install options given by brew options can be added after the formula. For example, I can install ffmpeg with chromaprint support with brew install ffmpeg --with-chromaprint. Currently the documentation, doesn't reflect this. This patch update the documentation (man page, markdown, and brew help install) to match the actual behavior.

[MikeMcQuaid]

I don't think [install-options] is sufficiently explanatory here. @EricFromCanada, any thoughts?

[VonUniGE]

A line could be added after

If --build-bottle is passed, prepare the formula for eventual bottling during installation.

which can be

install-options specific to a package can be listed with brew option formulae.

[EricFromCanada]

Should be [<options> ...] to indicate that these items are optional (square brackets), are a placeholder rather than a literal command (angle brackets), can be multiply specified (ellipsis), and hint at the use of brew options <formulae> to list which are available.

A suitable explanatory line might be Installation options specific to <formula> may be appended to the command, and can be listed with `brew options` <formula>.

[MikeMcQuaid]

@VonUniGE Looks good but you need to run brew man and commit the changes.

[MikeMcQuaid]

Thanks for your contribution to Homebrew @VonUniGE and for the help @EricFromCanada! Without people like you submitting PRs we couldn't run this project. You both rock!