1804 Commits

Author SHA1 Message Date
Carlo Cabrera
6214ce3024
Update documentation on deprecating and disabling formulae
This is based on the discussion at Homebrew/homebrew-core#91368.

A few reasons why we don't want to deprecate formulae that have
dependents:

1. This results in displaying warning messages to (at least some) users
   that they can't do anything about.
2. `test-bot` does not test deprecated formulae, so we risk breaking
   dependent formulae when one of its dependencies is not tested.
3. It is much harder to commit to a disable date for formulae with
   dependents because we don't know when we'll be able to wean
   dependents off of a deprecated formula.

I think it's important to have a disable date in mind when we deprecate
formulae. Otherwise, we might end up leaving formulae deprecated
indefinitely. This is bad because it teaches users to not take
deprecation warnings seriously.
2022-01-16 00:43:41 +08:00
BrewTestBot
305ab9b3c4
Update maintainers, manpage and completions.
Autogenerated by the [update-man-completions](https://github.com/Homebrew/brew/blob/HEAD/.github/workflows/update-man-completions.yml) workflow.
2022-01-13 10:37:47 +00:00
Mike McQuaid
af6d995de8
dev-cmd/bump: add switch to open pull requests.
This enables the simplification of
https://github.com/Homebrew/actions/blob/master/bump-formulae/main.rb
and exposing this workflow to more Homebrew users.
2022-01-12 17:31:55 +00:00
dependabot[bot]
5b0282fa07
build(deps): bump ffi from 1.15.4 to 1.15.5 in /docs
Bumps [ffi](https://github.com/ffi/ffi) from 1.15.4 to 1.15.5.
- [Release notes](https://github.com/ffi/ffi/releases)
- [Changelog](https://github.com/ffi/ffi/blob/master/CHANGELOG.md)
- [Commits](https://github.com/ffi/ffi/compare/v1.15.4...v1.15.5)

---
updated-dependencies:
- dependency-name: ffi
  dependency-type: indirect
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
2022-01-11 02:42:41 +00:00
Bo Anderson
b89ca839f7
Merge pull request #12694 from Homebrew/dependabot/bundler/docs/chef-utils-17.9.26
build(deps): bump chef-utils from 17.9.18 to 17.9.26 in /docs
2022-01-11 02:42:01 +00:00
Bo Anderson
7c01cfd93b
Merge pull request #12695 from Homebrew/dependabot/bundler/docs/nokogiri-1.13.0
build(deps): bump nokogiri from 1.12.5 to 1.13.0 in /docs
2022-01-11 02:40:13 +00:00
dependabot[bot]
7bb519dc74
build(deps): bump faraday from 1.8.0 to 1.9.3 in /docs
Bumps [faraday](https://github.com/lostisland/faraday) from 1.8.0 to 1.9.3.
- [Release notes](https://github.com/lostisland/faraday/releases)
- [Changelog](https://github.com/lostisland/faraday/blob/main/CHANGELOG.md)
- [Commits](https://github.com/lostisland/faraday/compare/v1.8.0...v1.9.3)

---
updated-dependencies:
- dependency-name: faraday
  dependency-type: indirect
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
2022-01-10 18:03:47 +00:00
dependabot[bot]
7a18d59ce3
build(deps): bump nokogiri from 1.12.5 to 1.13.0 in /docs
Bumps [nokogiri](https://github.com/sparklemotion/nokogiri) from 1.12.5 to 1.13.0.
- [Release notes](https://github.com/sparklemotion/nokogiri/releases)
- [Changelog](https://github.com/sparklemotion/nokogiri/blob/main/CHANGELOG.md)
- [Commits](https://github.com/sparklemotion/nokogiri/compare/v1.12.5...v1.13.0)

---
updated-dependencies:
- dependency-name: nokogiri
  dependency-type: indirect
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
2022-01-10 18:02:08 +00:00
dependabot[bot]
9dc7182e86
build(deps): bump chef-utils from 17.9.18 to 17.9.26 in /docs
Bumps [chef-utils](https://github.com/chef/chef) from 17.9.18 to 17.9.26.
- [Release notes](https://github.com/chef/chef/releases)
- [Changelog](https://github.com/chef/chef/blob/main/CHANGELOG.md)
- [Commits](https://github.com/chef/chef/compare/v17.9.18...v17.9.26)

---
updated-dependencies:
- dependency-name: chef-utils
  dependency-type: indirect
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
2022-01-10 18:02:00 +00:00
Miccal Matthews
7fc2159fcd
Merge pull request #12618 from SMillerDev/chore/docs/add_cask_docs
docs: document how to add/update casks
2022-01-09 08:18:05 +08:00
Sean Molenaar
33b8e0faa0 docs: integrate suggested changes 2022-01-08 11:30:51 +02:00
BrewTestBot
2b6a129fb4
Update maintainers, manpage and completions.
Autogenerated by the [update-man-completions](https://github.com/Homebrew/brew/blob/HEAD/.github/workflows/update-man-completions.yml) workflow.
2022-01-06 15:32:07 +00:00
dependabot[bot]
1b8afa2e8c
build(deps-dev): bump github-pages from 222 to 223 in /docs
Bumps [github-pages](https://github.com/github/pages-gem) from 222 to 223.
- [Release notes](https://github.com/github/pages-gem/releases)
- [Commits](https://github.com/github/pages-gem/compare/v222...v223)

---
updated-dependencies:
- dependency-name: github-pages
  dependency-type: direct:development
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
2022-01-03 18:03:18 +00:00
neutric
f426f1f51f cmd/cleanup.rb: description style tweak 2021-12-31 03:24:34 +01:00
BrewTestBot
de1390b36d
Update maintainers, manpage and completions.
Autogenerated by the [update-man-completions](https://github.com/Homebrew/brew/blob/HEAD/.github/workflows/update-man-completions.yml) workflow.
2021-12-29 13:34:43 +00:00
Bo Anderson
09e4f54090
Merge pull request #12634 from Homebrew/dependabot/bundler/docs/chef-utils-17.9.18
build(deps): bump chef-utils from 17.8.25 to 17.9.18 in /docs
2021-12-27 19:55:05 +00:00
dependabot[bot]
f299dcef2e
build(deps): bump chef-utils from 17.8.25 to 17.9.18 in /docs
Bumps [chef-utils](https://github.com/chef/chef) from 17.8.25 to 17.9.18.
- [Release notes](https://github.com/chef/chef/releases)
- [Changelog](https://github.com/chef/chef/blob/main/CHANGELOG.md)
- [Commits](https://github.com/chef/chef/compare/v17.8.25...v17.9.18)

---
updated-dependencies:
- dependency-name: chef-utils
  dependency-type: indirect
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
2021-12-27 18:02:31 +00:00
dependabot[bot]
a6f9806f95
build(deps): bump zeitwerk from 2.5.1 to 2.5.2 in /docs
Bumps [zeitwerk](https://github.com/fxn/zeitwerk) from 2.5.1 to 2.5.2.
- [Release notes](https://github.com/fxn/zeitwerk/releases)
- [Changelog](https://github.com/fxn/zeitwerk/blob/main/CHANGELOG.md)
- [Commits](https://github.com/fxn/zeitwerk/compare/v2.5.1...v2.5.2)

---
updated-dependencies:
- dependency-name: zeitwerk
  dependency-type: indirect
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
2021-12-27 18:01:50 +00:00
neutric
07e813a3b3
docs/Common-Issues.md: fix variable notation 2021-12-27 03:06:37 +01:00
Sean Molenaar
7111f848fb
docs: incorporate suggestions
Co-authored-by: Rylan Polster <rslpolster@gmail.com>
Co-authored-by: Bevan Kay <bevanjkay@gmail.com>
2021-12-23 09:47:20 +01:00
Sean Molenaar
bc1d38761f
docs: document how to add/update casks 2021-12-22 19:48:12 +01:00
Sean Molenaar
820e8303df
docs: add common cask issues 2021-12-22 17:20:24 +01:00
Mike McQuaid
30aacda559
Merge pull request #12594 from Homebrew/dependabot/bundler/docs/activesupport-6.0.4.4
build(deps): bump activesupport from 6.0.4.1 to 6.0.4.4 in /docs
2021-12-21 09:48:19 +00:00
Mike McQuaid
417289acc2
Merge pull request #12592 from Homebrew/dependabot/bundler/docs/minitest-5.15.0
build(deps): bump minitest from 5.14.4 to 5.15.0 in /docs
2021-12-21 09:48:07 +00:00
dependabot[bot]
29dcd9f2f3
build(deps): bump activesupport from 6.0.4.1 to 6.0.4.4 in /docs
Bumps [activesupport](https://github.com/rails/rails) from 6.0.4.1 to 6.0.4.4.
- [Release notes](https://github.com/rails/rails/releases)
- [Changelog](https://github.com/rails/rails/blob/v7.0.0/activesupport/CHANGELOG.md)
- [Commits](https://github.com/rails/rails/compare/v6.0.4.1...v6.0.4.4)

---
updated-dependencies:
- dependency-name: activesupport
  dependency-type: indirect
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
2021-12-20 18:03:28 +00:00
dependabot[bot]
696c682c43
build(deps): bump minitest from 5.14.4 to 5.15.0 in /docs
Bumps [minitest](https://github.com/seattlerb/minitest) from 5.14.4 to 5.15.0.
- [Release notes](https://github.com/seattlerb/minitest/releases)
- [Changelog](https://github.com/seattlerb/minitest/blob/master/History.rdoc)
- [Commits](https://github.com/seattlerb/minitest/compare/v5.14.4...v5.15.0)

---
updated-dependencies:
- dependency-name: minitest
  dependency-type: indirect
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
2021-12-20 18:02:37 +00:00
dependabot[bot]
93b7e791ca
build(deps-dev): bump html-proofer from 3.19.2 to 3.19.3 in /docs
Bumps [html-proofer](https://github.com/gjtorikian/html-proofer) from 3.19.2 to 3.19.3.
- [Release notes](https://github.com/gjtorikian/html-proofer/releases)
- [Changelog](https://github.com/gjtorikian/html-proofer/blob/main/CHANGELOG.md)
- [Commits](https://github.com/gjtorikian/html-proofer/compare/v3.19.2...v3.19.3)

---
updated-dependencies:
- dependency-name: html-proofer
  dependency-type: direct:development
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
2021-12-20 18:02:30 +00:00
Bo Anderson
a09e85ff11
docs/Releases: note to remember to delete disabled arguments 2021-12-17 02:02:45 +00:00
Bo Anderson
6e37c67fba
Fix disabled args appearing in documentation. 2021-12-17 02:02:45 +00:00
BrewTestBot
3b0d71f7a2
Update maintainers, manpage and completions.
Autogenerated by the [update-man-completions](https://github.com/Homebrew/brew/blob/HEAD/.github/workflows/update-man-completions.yml) workflow.
2021-12-17 00:06:05 +00:00
BrewTestBot
f60975f3b6
Update maintainers, manpage and completions.
Autogenerated by the [update-man-completions](https://github.com/Homebrew/brew/blob/HEAD/.github/workflows/update-man-completions.yml) workflow.
2021-12-15 00:06:34 +00:00
BrewTestBot
926786d5de
Update maintainers, manpage and completions.
Autogenerated by the [update-man-completions](https://github.com/Homebrew/brew/blob/HEAD/.github/workflows/update-man-completions.yml) workflow.
2021-12-09 14:47:39 +00:00
Bo Anderson
31ffe8037a
Merge pull request #12531 from Bo98/docs-xcode
docs/Xcode: fix CLT method name
2021-12-07 16:40:03 +00:00
Mike McQuaid
ac74f15f0d
Remove some SFC references.
We're moving to OpenCollective currently.
2021-12-07 15:48:37 +00:00
Bo Anderson
2aa382fc88
docs/Xcode: fix CLT method name 2021-12-07 14:43:48 +00:00
EricFromCanada
a237699936
Update Troubleshooting.md 2021-12-02 22:59:01 -05:00
EricFromCanada
b71644e735
Update Shell-Completion.md 2021-12-02 22:59:00 -05:00
EricFromCanada
cb9db80157
Update Installation.md 2021-12-02 22:59:00 -05:00
EricFromCanada
b41ed744c1
Update Homebrew-on-Linux.md 2021-12-02 22:59:00 -05:00
EricFromCanada
02cb1a14cb
Update FAQ.md 2021-12-02 22:59:00 -05:00
EricFromCanada
2e3bc0b4a3
Update Common-Issues.md 2021-12-02 22:58:56 -05:00
EricFromCanada
77efcdf8fb
Add & remove line breaks 2021-12-02 22:58:31 -05:00
EricFromCanada
45bf8b0118
docs: add mdl for Markdown linting
Run with `mdl -c docs/.mdlrc docs/*.md`.
2021-12-02 22:58:31 -05:00
Bo Anderson
7f393712ed
Merge pull request #12483 from Bo98/versions-abi-stability
docs/Versions: require ABI stability
2021-12-02 02:08:54 +00:00
Mike McQuaid
e119bdc571
Merge pull request #12477 from MikeMcQuaid/env_hints
Output environment variable hints.
2021-11-26 13:46:27 +00:00
Bo Anderson
323a180d26
Update docs/Versions.md
Co-authored-by: Mike McQuaid <mike@mikemcquaid.com>
2021-11-26 13:30:28 +00:00
Mike McQuaid
6913c7c84e
Output environment variable hints.
Output hints for disabling automatic `brew update`, `brew cleanup` and
`brew upgrade`/`brew reinstall` of dependents. Also provide a
`HOMEBREW_NO_ENV_HINTS` to disable this messaging.
2021-11-26 13:14:10 +00:00
Bo Anderson
2b9784864d
docs/Versions: require ABI stability 2021-11-26 13:05:08 +00:00
Carlo Cabrera
bf3b12656d
FAQ: document HOMEBREW_NO_CLEANUP_FORMULAE 2021-11-26 18:11:35 +08:00
Mike McQuaid
11c5f8f05a
Improve discovery of some environment variables
There's a few bits of functionality that Homebrew has changed over the
years, makes sense as a sensible default but some people find really
annoying:

- automatically running `brew update`
- automatically running `brew cleanup`
- automatically upgrading outdated dependents
- automatically reinstalling broken dependents

For each of these: let's improve the documentation of the commands
whose behaviour is changed and the environment variables themselves.
2021-11-25 09:10:59 +00:00