From 5eab79e70f6887869d3b38adcd74296218de9269 Mon Sep 17 00:00:00 2001
From: Xu Cheng <xucheng@me.com>
Date: Sun, 6 Sep 2015 15:37:47 +0800
Subject: [PATCH] manpage: add unlink --dry-run

---
 Library/Homebrew/manpages/brew.1.md | 5 ++++-
 share/doc/homebrew/brew.1.html      | 7 +++++--
 share/man/man1/brew.1               | 7 +++++--
 3 files changed, 14 insertions(+), 5 deletions(-)

diff --git a/Library/Homebrew/manpages/brew.1.md b/Library/Homebrew/manpages/brew.1.md
index 71b5dc3df8..5adcb21808 100644
--- a/Library/Homebrew/manpages/brew.1.md
+++ b/Library/Homebrew/manpages/brew.1.md
@@ -429,11 +429,14 @@ Note that these flags should only appear after a command.
 
     Example: `brew install jruby && brew test jruby`
 
-  * `unlink` <formula>:
+  * `unlink [--dry-run]` <formula>:
     Remove symlinks for <formula> from the Homebrew prefix. This can be useful
     for temporarily disabling a formula:
     `brew unlink foo && commands && brew link foo`.
 
+    If `--dry-run` or `-n` is passed, Homebrew will list all files which would
+    be unlinked, but will not actually unlink or delete any files.
+
   * `unlinkapps [--local]` [<formulae>]:
     Removes links created by `brew linkapps`.
 
diff --git a/share/doc/homebrew/brew.1.html b/share/doc/homebrew/brew.1.html
index 8767081e16..62d11cee80 100644
--- a/share/doc/homebrew/brew.1.html
+++ b/share/doc/homebrew/brew.1.html
@@ -378,10 +378,13 @@ formula.</p>
 launched with access to IRB or a shell inside the temporary test directory.</p>
 
 <p>Example: <code>brew install jruby &amp;&amp; brew test jruby</code></p></li>
-<li><p><code>unlink</code> <var>formula</var>:
+<li><p><code>unlink [--dry-run]</code> <var>formula</var>:
 Remove symlinks for <var>formula</var> from the Homebrew prefix. This can be useful
 for temporarily disabling a formula:
-<code>brew unlink foo &amp;&amp; commands &amp;&amp; brew link foo</code>.</p></li>
+<code>brew unlink foo &amp;&amp; commands &amp;&amp; brew link foo</code>.</p>
+
+<p>If <code>--dry-run</code> or <code>-n</code> is passed, Homebrew will list all files which would
+be unlinked, but will not actually unlink or delete any files.</p></li>
 <li><p><code>unlinkapps [--local]</code> [<var>formulae</var>]:
 Removes links created by <code>brew linkapps</code>.</p>
 
diff --git a/share/man/man1/brew.1 b/share/man/man1/brew.1
index d7e33e54a3..e059285830 100644
--- a/share/man/man1/brew.1
+++ b/share/man/man1/brew.1
@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "BREW" "1" "August 2015" "Homebrew" "brew"
+.TH "BREW" "1" "September 2015" "Homebrew" "brew"
 .
 .SH "NAME"
 \fBbrew\fR \- The missing package manager for OS X
@@ -409,7 +409,10 @@ If \fB\-\-debug\fR is passed and the test fails, an interactive debugger will be
 Example: \fBbrew install jruby && brew test jruby\fR
 .
 .IP "\(bu" 4
-\fBunlink\fR \fIformula\fR: Remove symlinks for \fIformula\fR from the Homebrew prefix\. This can be useful for temporarily disabling a formula: \fBbrew unlink foo && commands && brew link foo\fR\.
+\fBunlink [\-\-dry\-run]\fR \fIformula\fR: Remove symlinks for \fIformula\fR from the Homebrew prefix\. This can be useful for temporarily disabling a formula: \fBbrew unlink foo && commands && brew link foo\fR\.
+.
+.IP
+If \fB\-\-dry\-run\fR or \fB\-n\fR is passed, Homebrew will list all files which would be unlinked, but will not actually unlink or delete any files\.
 .
 .IP "\(bu" 4
 \fBunlinkapps [\-\-local]\fR [\fIformulae\fR]: Removes links created by \fBbrew linkapps\fR\.