Merge pull request #1200 from MikeMcQuaid/man-note-date-change

man: note --fail-if-changed date behaviour change.

Library/Homebrew/dev-cmd/man.rb

@@ -4,6 +4,8 @@
 #:    If `--fail-if-changed` is passed, the command will return a failing
 #:    status code if changes are detected in the manpage outputs.
 #:    This can be used for CI to be notified when the manpages are out of date.
+#:    Additionally, the date used in new manpages will match those in the existing
+#:    manpages (to allow comparison without factoring in the date).
 
 require "formula"
 require "erb"

docs/brew.1.html

@@ -529,7 +529,9 @@ which link to it for each library the keg references.</p></dd>
 
 <p>If <code>--fail-if-changed</code> is passed, the command will return a failing
 status code if changes are detected in the manpage outputs.
-This can be used for CI to be notified when the manpages are out of date.</p></dd>
+This can be used for CI to be notified when the manpages are out of date.
+Additionally, the date used in new manpages will match those in the existing
+manpages (to allow comparison without factoring in the date).</p></dd>
 </dl>
 
 

manpages/brew-cask.1

 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "BREW\-CASK" "1" "September 2016" "Homebrew" "brew-cask"
+.TH "BREW\-CASK" "1" "October 2016" "Homebrew" "brew-cask"
 .
 .SH "NAME"
 \fBbrew\-cask\fR \- a friendly binary installer for macOS

manpages/brew.1

 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "BREW" "1" "September 2016" "Homebrew" "brew"
+.TH "BREW" "1" "October 2016" "Homebrew" "brew"
 .
 .SH "NAME"
 \fBbrew\fR \- The missing package manager for macOS
@@ -730,7 +730,7 @@ If \fB\-\-reverse\fR is passed, print the dylib followed by the binaries which l
 Generate Homebrew\'s manpages\.
 .
 .IP
-If \fB\-\-fail\-if\-changed\fR is passed, the command will return a failing status code if changes are detected in the manpage outputs\. This can be used for CI to be notified when the manpages are out of date\.
+If \fB\-\-fail\-if\-changed\fR is passed, the command will return a failing status code if changes are detected in the manpage outputs\. This can be used for CI to be notified when the manpages are out of date\. Additionally, the date used in new manpages will match those in the existing manpages (to allow comparison without factoring in the date)\.
 .
 .P
 \fBpull\fR [\fB\-\-bottle\fR] [\fB\-\-bump\fR] [\fB\-\-clean\fR] [\fB\-\-ignore\-whitespace\fR] [\fB\-\-resolve\fR] [\fB\-\-branch\-okay\fR] [\fB\-\-no\-pbcopy\fR] [\fB\-\-no\-publish\fR] \fIpatch\-source\fR [\fIpatch\-source\fR]