diff --git a/pages/linux/brew.md b/pages/linux/brew.md
index 6feb7e763a..1f2bb19034 100644
--- a/pages/linux/brew.md
+++ b/pages/linux/brew.md
@@ -14,14 +14,18 @@
 
 `brew list`
 
-- Update an installed formula (passing no formula updates all installed formulae):
+- Update an installed formula (passing no `{{formula}}` updates all installed formulae):
 
 `brew upgrade {{formula}}`
 
-- Update brew itself:
+- Fetch the newest version of Linuxbrew and all formulae from GitHub:
 
 `brew update`
 
+- Show formulae that have an updated version available:
+
+`brew outdated`
+
 - Display information about a formula (version, installation path, dependencies, etc.):
 
 `brew info {{formula}}`
diff --git a/pages/osx/brew.md b/pages/osx/brew.md
index 52e733e330..452de58e8e 100644
--- a/pages/osx/brew.md
+++ b/pages/osx/brew.md
@@ -14,14 +14,18 @@
 
 `brew list`
 
-- Update an installed formula (passing no formula updates all installed formulae):
+- Update an installed formula (passing no `{{formula}}` updates all installed formulae):
 
 `brew upgrade {{formula}}`
 
-- Update brew itself:
+- Fetch the newest version of Homebrew and all formulae from GitHub:
 
 `brew update`
 
+- Show formulae that have an updated version available:
+
+`brew outdated`
+
 - Display information about a formula (version, installation path, dependencies, etc.):
 
 `brew info {{formula}}`