brew-{update,upgrade,list,outdated,search}: add page (#11389)

* brew-update: add page

* brew-upgrade: add page

* brew-list: add page

* brew-outdated: add page

* brew-search: add page

pages/common/brew-list.md

@@ -0,0 +1,24 @@
+# brew list
+
+> List installed formulae/casks or their files.
+> More information: <https://docs.brew.sh/Manpage#list-ls-options-installed_formulainstalled_cask->.
+
+- List all installed formulae and casks:
+
+`brew list`
+
+- List files belonging to an installed formula:
+
+`brew list {{formula}}`
+
+- List artifacts of a cask:
+
+`brew list {{cask}}`
+
+- List only formulae:
+
+`brew list --formula`
+
+- List only casks:
+
+`brew list --cask`

pages/common/brew-outdated.md

@@ -0,0 +1,17 @@
+# brew outdated
+
+> List outdated casks and formulae.
+> To upgrade everything, use `brew upgrade`.
+> More information: <https://docs.brew.sh/Manpage#outdated-options-formulacask->.
+
+- List all outdated casks and formulae:
+
+`brew outdated`
+
+- List only outdated formulae:
+
+`brew outdated --formula`
+
+- List only outdated casks:
+
+`brew outdated --cask`

pages/common/brew-search.md

@@ -0,0 +1,24 @@
+# brew search
+
+> Search for casks and formulae.
+> More information: <https://docs.brew.sh/Manpage#search--s-options-textregex->.
+
+- Search for casks and formulae using a keyword:
+
+`brew search {{keyword}}`
+
+- Search for casks and formulae using a regular expression:
+
+`brew search /{{regular_expression}}/`
+
+- Enable searching through descriptions:
+
+`brew search --desc {{keyword}}`
+
+- Only search for formulae:
+
+`brew search --formula {{keyword}}`
+
+- Only search for casks:
+
+`brew search --cask {{keyword}}`

pages/common/brew-update.md

@@ -0,0 +1,9 @@
+# brew update
+
+> Fetch the newest version of Homebrew and all formulae from GitHub using `git` and perform any necessary migrations.
+> To upgrade all installed formulae, use `brew upgrade`.
+> More information: <https://docs.brew.sh/Manpage#update-options>.
+
+- Fetch the newest version of Homebrew and all formulae:
+
+`brew update`

pages/common/brew-upgrade.md

@@ -0,0 +1,16 @@
+# brew upgrade
+
+> Upgrade outdated formulae and casks.
+> More information: <https://docs.brew.sh/Manpage#upgrade-options-outdated_formulaoutdated_cask->.
+
+- Upgrade all outdated casks and formulae:
+
+`brew upgrade`
+
+- Upgrade a specific formula/cask:
+
+`brew upgrade {{formula|cask}}`
+
+- Print what would be upgraded, but don't actually upgrade anything:
+
+`brew upgrade --dry-run`