manpage: add missing document

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

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

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.
 

share/man/man1/brew.1

@@ -101,7 +101,7 @@ If \fB\-\-no\-fetch\fR is passed, Homebrew will not download \fIURL\fR to the ca
 The options \fB\-\-set\-name\fR and \fB\-\-set\-version\fR each take an argument and allow you to explicitly set the name and version of the package you are creating\.
 .
 .TP
-\fBdeps [\-\-1] [\-n] [\-\-union] [\-\-tree] [\-\-all] [\-\-installed]\fR \fIformulae\fR
+\fBdeps [\-\-1] [\-n] [\-\-union] [\-\-tree] [\-\-all] [\-\-installed] [\-\-skip\-build] [\-\-skip\-optional]\fR \fIformulae\fR
 Show dependencies for \fIformulae\fR\. When given multiple formula arguments, show the intersection of dependencies for \fIformulae\fR, except when passed \fB\-\-tree\fR, \fB\-\-all\fR, or \fB\-\-installed\fR\.
 .
 .IP
@@ -122,6 +122,9 @@ If \fB\-\-all\fR is passed, show dependencies for all formulae\.
 .IP
 If \fB\-\-installed\fR is passed, show dependencies for all installed formulae\.
 .
+.IP
+By default, \fBdeps\fR shows dependencies for \fIformulae\fR\. To skip the \fB:build\fR type dependencies, pass \fB\-\-skip\-build\fR\. Similarly, pass \fB\-\-skip\-optional\fR to skip \fB:optional\fR dependencies\.
+.
 .TP
 \fBdiy [\-\-name=<name>] [\-\-version=<version>]\fR
 Automatically determine the installation prefix for non\-Homebrew software\.
@@ -240,6 +243,13 @@ Download and patch \fIformula\fR, then open a shell\. This allows the user to ru
 If \fB\-\-git\fR is passed, Homebrew will create a Git repository, useful for creating patches to the software\.
 .
 .TP
+\fBirb [\-\-example]\fR
+Enter the interactive Homebrew Ruby shell\.
+.
+.IP
+If \fB\-\-example\fR is passed, several examples will be shown\.
+.
+.TP
 \fBleaves\fR
 Show installed formulae that are not dependencies of another installed formula\.
 .
@@ -355,6 +365,10 @@ Search for \fItext\fR in the given package manager\'s list\.
 Instantiate a Homebrew build environment\. Uses our years\-battle\-hardened Homebrew build logic to help your \fB\./configure && make && make install\fR or even your \fBgem install\fR succeed\. Especially handy if you run Homebrew in a Xcode\-only configuration since it adds tools like make to your PATH which otherwise build\-systems would not find\.
 .
 .TP
+\fBswitch\fR \fIname\fR \fIversion\fR
+Symlink all of the specific \fIversion\fR of \fIname\fR\'s install to Homebrew prefix\.
+.
+.TP
 \fBtap\fR [\fItap\fR]
 Tap a new formula repository from GitHub, or list existing taps\.
 .