These are the ones that are auto-installed without tapping and it makes
sense to make them more prominent in our documentation as we've
offloaded various functionality over the years to each of them.

This option is used to test updating between tags.

As requested in #1199 this updates the documentation accordingly for
that change.

Add some missed changes. I'll add a CI check for this at a future point.

Not quite a mass replacement as I've used OS X and Mac OS X where
describing specific older versions and added compatibility methods
for things in the DSL.

Also, flag those that we never want to be in a manpage.

Add --full-name option to brew deps command,
which displays the full name of dependencies.

This option does more than just print warnings so let's make a more
generic description with a more specific example.

Closes #716.

- Inconsistent or unneeded indentation
- Missing or superfluous empty lines
- Missing or wrongly formatted arguments in command summary
- Missing punctuation

And arguments can be passed through to it.

Tweak produced out of conversation in
https://github.com/Homebrew/brew-evolution/pull/8.

Add a `brew update --force` to side-step all of the clever optimisations
we have to detect if an update is unnecessary. That means if those
optimisations go wrong in future we can tell people just to run this
single command.

This would have been a useful workaround for the issue fixed in 985c672b.

Roll this out to everyone (not just developers) and document the
environment variables used for configuration.

Rather than nudge people to run `--strict` and then ignore some of the
results sometimes (e.g. GitHub repository notability) instead add a
dedicated `--new-formula` option that implies this is a one-time
advisory check.

If set, this environment variable instructs Homebrew to use the given URL as a
download mirror (e.g. an Artifactory instance) for bottles and binaries.

Closes #387.

Signed-off-by: Mike McQuaid <mike@mikemcquaid.com>

Amend 468ebc5e by regenerating the
man page and its HTML version according to the changes in #443.

This commit adds a --tap option to the create command such that a user
could create a formula in a specified tap instead of the core.

* audit.rb: require https for ftpmirror.gnu.org

The situation is similar to other mirror redirectors: the server
may subsequently redirect to an insecure url. But it's a step.

* manpage: update HOMEBREW_NO_INSECURE_REDIRECT section

Closes #362.

Signed-off-by: Xu Cheng <xucheng@me.com>

* cleanup: accept cache as an argument.

* config: move default HOMEBREW_CACHE to ~/Library.

* brew.1: document new default Homebrew cache.

* update-report: migrate legacy Homebrew cache.

Amends 132ada2b until we properly figure
out a way of documenting built-in aliases (or not doing that) across all
commands that currently have aliases. See #270 for full discussion.

* Include --desc in brew search help text.
* Update brew search --desc text in README.
* Remove mention of alias in brew search help text to avoid any
  confusion.

Obvious copy/paste failure in acc9a7ca.