brew: update page; brew-*: add page; brew-cask: remove page (#11376)

pages/common/brew-autoremove.md

@@ -0,0 +1,12 @@
+# brew autoremove
+
+> Remove unused formulae previously installed as dependencies.
+> More information: <https://docs.brew.sh/Manpage#autoremove---dry-run>.
+
+- Remove all unused formulae:
+
+`brew autoremove`
+
+- Print what would be removed, but don't actually remove anything:
+
+`brew autoremove --dry-run`

pages/common/brew-cask.md

@@ -1,37 +0,0 @@
-# brew --cask
-
-> CLI workflow for the administration of macOS applications distributed as binaries.
-> This command was previously called `brew cask`, it has been deprecated in favor of the `brew --cask` flag.
-> More information: <https://github.com/Homebrew/homebrew-cask>.
-
-- Search for formulas and casks:
-
-`brew search {{text}}`
-
-- Install a cask:
-
-`brew install --cask {{cask_name}}`
-
-- List all installed casks:
-
-`brew list --cask`
-
-- List installed casks that have newer versions available:
-
-`brew outdated --cask`
-
-- Upgrade an installed cask (if no cask name is given, all installed casks are upgraded):
-
-`brew upgrade --cask {{cask_name}}`
-
-- Uninstall a cask:
-
-`brew uninstall --cask {{cask_name}}`
-
-- Uninstall a cask and remove related settings and files:
-
-`brew zap --cask {{cask_name}}`
-
-- Display information about a given cask:
-
-`brew info --cask {{cask_name}}`

pages/common/brew-install.md

@@ -0,0 +1,16 @@
+# brew install
+
+> Install a Homebrew formula or cask.
+> More information: <https://docs.brew.sh/Manpage#install-options-formulacask->.
+
+- Install a formula/cask:
+
+`brew install {{formula|cask}}`
+
+- Build and install a formula from source (dependencies will still be installed from bottles):
+
+`brew install --build-from-source {{formula}}`
+
+- Download the manifest, print what would be installed but don't actually install anything:
+
+`brew install --dry-run {{formula|cask}}`

pages/common/brew-uninstall.md

@@ -0,0 +1,13 @@
+# brew uninstall
+
+> Uninstall a Homebrew formula/cask.
+> Use `brew autoremove` to remove unused dependencies afterwards.
+> More information: <https://docs.brew.sh/Manpage#uninstall-remove-rm-options-installed_formulainstalled_cask->.
+
+- Uninstall a formula/cask:
+
+`brew uninstall {{formula|cask}}`
+
+- Uninstall a cask and remove all associated files:
+
+`brew uninstall --zap {{cask}}`

pages/common/brew.md

@@ -1,7 +1,8 @@
 # brew
 
-> Package manager for macOS and Linux.
-> More information: <https://brew.sh>.
+> Homebrew - a package manager for macOS and Linux.
+> Some subcommands such as `install` have their own usage documentation.
+> More information: <https://docs.brew.sh/Manpage>.
 
 - Install the latest stable version of a formula or cask (use `--devel` for development versions):
 
@@ -23,7 +24,7 @@
 
 `brew outdated`
 
-- Search for available formulae (i.e. packages) and casks (i.e. native packages):
+- Search for available formulae (i.e. packages) and casks (i.e. native macOS `.app` packages):
 
 `brew search {{text}}`