From d8caacde9593afbb6aefc73283ea1486ef733373 Mon Sep 17 00:00:00 2001 From: James Cuzella Date: Wed, 3 Jul 2019 14:37:46 -0600 Subject: [PATCH] Update FAQ entry: Homebrew automatic `brew cleanup` behavior change --- docs/FAQ.md | 20 ++++++++++++++++++-- 1 file changed, 18 insertions(+), 2 deletions(-) diff --git a/docs/FAQ.md b/docs/FAQ.md index e5cb158893..9dfe0211d8 100644 --- a/docs/FAQ.md +++ b/docs/FAQ.md @@ -29,8 +29,14 @@ To allow that formulae to update again: Note that pinned, outdated formulae that another formula depends on need to be upgraded when required as we do not allow formulae to be built against non-latest versions. ## How do I uninstall old versions of a formula? -By default, Homebrew does not uninstall old versions of a formula, so -over time you will accumulate old versions. To remove them, simply use: +Before `v1.9.0`, Homebrew did not uninstall old versions of a formula, so +over time you will accumulate old versions. +After `v1.9.0`, Homebrew introduced optional automatic cleanup via +the `HOMEBREW_INSTALL_CLEANUP` environment variable. +After `v2.0.0`, Homebrew's default behavior changed to automatically +uninstall old versions of a formula every 30 days. + +To remove them manually, simply use: brew cleanup @@ -42,6 +48,16 @@ or to see what would be cleaned up: brew cleanup -n +or to __enable__ automatic `brew cleanup` for Homebrew `>= v1.9.0`, `<= 2.0.0`: + + # Add this line to your ~/.bashrc or ~/.bash_profile + export HOMEBREW_INSTALL_CLEANUP=1 + +or to __disable__ automatic `brew cleanup` for Homebrew `>= v2.0.0`: + + # Add this line to your ~/.bashrc or ~/.bash_profile + export HOMEBREW_NO_INSTALL_CLEANUP=1 + ## How do I uninstall Homebrew? To uninstall Homebrew, paste the command below in a terminal prompt.