manpage: add missing document

Closes Homebrew/homebrew#38351.
Closes Homebrew/homebrew#38960.

Signed-off-by: Xu Cheng <xucheng@me.com>

1 files changed, 13 insertions, 1 deletions

diff --git a/Library/Homebrew/manpages/brew.1.md b/Library/Homebrew/manpages/brew.1.md
index 57c49cae9..38e4550da 100644
--- a/Library/Homebrew/manpages/brew.1.md
+++ b/Library/Homebrew/manpages/brew.1.md
@@ -94,7 +94,7 @@ Note that these flags should only appear after a command.
     The options `--set-name` and `--set-version` each take an argument and allow
     you to explicitly set the name and version of the package you are creating.
 
-  * `deps [--1] [-n] [--union] [--tree] [--all] [--installed]` <formulae>:
+  * `deps [--1] [-n] [--union] [--tree] [--all] [--installed] [--skip-build] [--skip-optional]` <formulae>:
     Show dependencies for <formulae>. When given multiple formula arguments,
     show the intersection of dependencies for <formulae>, except when passed
     `--tree`, `--all`, or `--installed`.
@@ -113,6 +113,10 @@ Note that these flags should only appear after a command.
 
     If `--installed` is passed, show dependencies for all installed formulae.
 
+    By default, `deps` shows dependencies for <formulae>. To skip the `:build`
+    type dependencies, pass `--skip-build`. Similarly, pass `--skip-optional`
+    to skip `:optional` dependencies.
+
   * `diy [--name=<name>] [--version=<version>]`:
     Automatically determine the installation prefix for non-Homebrew software.
 
@@ -222,6 +226,11 @@ Note that these flags should only appear after a command.
     If `--git` is passed, Homebrew will create a Git repository, useful for
     creating patches to the software.
 
+  * `irb [--example]`:
+    Enter the interactive Homebrew Ruby shell.
+
+    If `--example` is passed, several examples will be shown.
+
   * `leaves`:
     Show installed formulae that are not dependencies of another installed formula.
 
@@ -333,6 +342,9 @@ Note that these flags should only appear after a command.
     in a Xcode-only configuration since it adds tools like make to your PATH
     which otherwise build-systems would not find.
 
+  * `switch` <name> <version>:
+    Symlink all of the specific <version> of <name>'s install to Homebrew prefix.
+
   * `tap` [<tap>]:
     Tap a new formula repository from GitHub, or list existing taps.