From 53e1ba327400f809ed9279aa6eadbe5a47290e76 Mon Sep 17 00:00:00 2001
From: Martin Afanasjew <martin@afanasjew.de>
Date: Wed, 6 Jan 2016 08:14:27 +0100
Subject: [PATCH] manpage: document '--dry-run' for 'prune' command

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

diff --git a/Library/Homebrew/manpages/brew.1.md b/Library/Homebrew/manpages/brew.1.md
index aeb54be14f..294b34fb05 100644
--- a/Library/Homebrew/manpages/brew.1.md
+++ b/Library/Homebrew/manpages/brew.1.md
@@ -343,10 +343,13 @@ With `--verbose` or `-v`, many commands print extra debugging information. Note
     Pin the specified <formulae>, preventing them from being upgraded when
     issuing the `brew upgrade` command. See also `unpin`.
 
-  * `prune`:
+  * `prune` [`--dry-run`]:
     Remove dead symlinks from the Homebrew prefix. This is generally not
     needed, but can be useful when doing DIY installations.
 
+    If `--dry-run` or `-n` is passed, show what would be removed, but do not
+    actually remove anything.
+
   * `reinstall` <formula>:
     Uninstall then install <formula>
 
diff --git a/share/doc/homebrew/brew.1.html b/share/doc/homebrew/brew.1.html
index 54856e9a49..bc724c34c8 100644
--- a/share/doc/homebrew/brew.1.html
+++ b/share/doc/homebrew/brew.1.html
@@ -271,8 +271,11 @@ precedence over <code>--verbose</code>).</p>
 valid version is <code>v1</code>.</p></dd>
 <dt><code>pin</code> <var>formulae</var></dt><dd><p>Pin the specified <var>formulae</var>, preventing them from being upgraded when
 issuing the <code>brew upgrade</code> command. See also <code>unpin</code>.</p></dd>
-<dt class="flush"><code>prune</code></dt><dd><p>Remove dead symlinks from the Homebrew prefix. This is generally not
-needed, but can be useful when doing DIY installations.</p></dd>
+<dt><code>prune</code> [<code>--dry-run</code>]</dt><dd><p>Remove dead symlinks from the Homebrew prefix. This is generally not
+needed, but can be useful when doing DIY installations.</p>
+
+<p>If <code>--dry-run</code> or <code>-n</code> is passed, show what would be removed, but do not
+actually remove anything.</p></dd>
 <dt><code>reinstall</code> <var>formula</var></dt><dd><p>Uninstall then install <var>formula</var></p></dd>
 <dt><code>rm</code>, <code>remove</code>, <code>uninstall</code> [<code>--force</code>] <var>formula</var></dt><dd><p>Uninstall <var>formula</var>.</p>
 
diff --git a/share/man/man1/brew.1 b/share/man/man1/brew.1
index 882c2ee7c5..838609a8a6 100644
--- a/share/man/man1/brew.1
+++ b/share/man/man1/brew.1
@@ -367,9 +367,12 @@ If \fB\-\-json=\fR\fIversion\fR is passed, the output will be in JSON format\. T
 Pin the specified \fIformulae\fR, preventing them from being upgraded when issuing the \fBbrew upgrade\fR command\. See also \fBunpin\fR\.
 .
 .TP
-\fBprune\fR
+\fBprune\fR [\fB\-\-dry\-run\fR]
 Remove dead symlinks from the Homebrew prefix\. This is generally not needed, but can be useful when doing DIY installations\.
 .
+.IP
+If \fB\-\-dry\-run\fR or \fB\-n\fR is passed, show what would be removed, but do not actually remove anything\.
+.
 .TP
 \fBreinstall\fR \fIformula\fR
 Uninstall then install \fIformula\fR