doc: clarify assert.fail doc

Trott · Trott · commit 70fb06a90bf9 · 2015-12-09T16:43:48.000-08:00
PR-URL: nodejs#4186 Reviewed-By: Michaël Zasso <mic.besace@gmail.com> Reviewed-By: Roman Klauke <romaaan.git@gmail.com> Reviewed-By: Minwoo Jung <jmwsoft@gmail.com>
diff --git a/doc/api/assert.markdown b/doc/api/assert.markdown
@@ -62,8 +62,9 @@ Tests shallow, coercive equality with the equal comparison operator ( `==` ).
 
 ## assert.fail(actual, expected, message, operator)
 
-Throws an exception that displays the values for `actual` and `expected`
-separated by the provided operator.
+Throws an `AssertionError`. If `message` is falsy, it displays the values for
+`actual` and `expected` separated by the provided `operator`. Otherwise, it
+displays `message` (and does not use `actual`, `expected`, and `operator`).
 
 ## assert.ifError(value)
 
