From bf375279fc1d60ad2e915dc45da1ae1bd00b0e97 Mon Sep 17 00:00:00 2001
From: Lena <126529524+acuteenvy@users.noreply.github.com>
Date: Sun, 5 Nov 2023 18:37:22 +0100
Subject: [PATCH] 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     | 24 ++++++++++++++++++++++++
 pages/common/brew-outdated.md | 17 +++++++++++++++++
 pages/common/brew-search.md   | 24 ++++++++++++++++++++++++
 pages/common/brew-update.md   |  9 +++++++++
 pages/common/brew-upgrade.md  | 16 ++++++++++++++++
 5 files changed, 90 insertions(+)
 create mode 100644 pages/common/brew-list.md
 create mode 100644 pages/common/brew-outdated.md
 create mode 100644 pages/common/brew-search.md
 create mode 100644 pages/common/brew-update.md
 create mode 100644 pages/common/brew-upgrade.md

diff --git a/pages/common/brew-list.md b/pages/common/brew-list.md
new file mode 100644
index 000000000..9b7e48b1f
--- /dev/null
+++ b/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`
diff --git a/pages/common/brew-outdated.md b/pages/common/brew-outdated.md
new file mode 100644
index 000000000..88749f648
--- /dev/null
+++ b/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`
diff --git a/pages/common/brew-search.md b/pages/common/brew-search.md
new file mode 100644
index 000000000..253c8ed99
--- /dev/null
+++ b/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}}`
diff --git a/pages/common/brew-update.md b/pages/common/brew-update.md
new file mode 100644
index 000000000..2aec46016
--- /dev/null
+++ b/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`
diff --git a/pages/common/brew-upgrade.md b/pages/common/brew-upgrade.md
new file mode 100644
index 000000000..a667301a8
--- /dev/null
+++ b/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`